Importing portal sites

Use the Import wizard to retrieve an existing portal site from a WebSphere® Portal server.

To create a new portal project, it is recommended that you import an existing portal site from WebSphere Portal server into Rational® Software Development Platform. Importing is also useful for updating the configuration of a project that already exists in your workspace.

The portal site configuration on WebSphere Portal server contains the following resources: the global settings, the resource definitions, the portal content tree, and the page layout. Importing these resources from WebSphere Portal server to Rational tools overwrites duplicate resources within the existing portal project. Non-duplicate resources from the server configuration are copied into the existing portal project. Likewise, resources that are unique to the portal project are not affected unless you choose the Delete project on overwrite option in the Import wizard.

Rational tools use the XML configuration interface to import a portal site configuration, and optionally retrieves files under the Web application directory. When creating a new portal project, retrieving files is mandatory. To retrieve files, Rational tools must have access to the directory described above via copy or FTP. You define this access method on the Portal server. For more details on defining a Portal server for import, see Defining servers for publishing or importing portals.

  1. Select File > Import.
  2. Within the Select page, click Portal for your import source; then click Next.
  3. Within the Import Portal Project page, select a portal server that you want to use. If the server dialog box is empty, click New to define a server. For more information on defining a server for import, refer to Defining servers for publishing or importing portals.
  4. From the Portal project combo box, either choose the name of the portal project or enter a name for your portal project for import.
  5. Under Import Options, choose whether you want to import the configuration and files, or the configuration only.

    If you choose to import the configuration and files, the files under the Web application directory (For example, websphere_installation_directory/installedApps/node/wps.ear) are imported. The files include the JSP, CSS, and image files for themes and skins.

    Also within the Import Options dialog box is a check box labeled Delete project on overwrite. This option is only active if you are importing to an existing portal project. If you select this option, the existing portal project and all of its artifacts are completely deleted before the overwrite.

Notes and Limitations
  • The Library directory entry on the Publishing Settings page of the server configuration for WebSphere Portal Server Attach servers and WebSphere Portal for Import, Export & Deploy servers was added in the Rational Software Development Platform v6.0.0.1. It is used for importing and deployment of property files in portal projects. When you specify a Library directory in your server configuration and have the proper access to the directory, the workbench will automatically import the property files from the portal server. The Library directory entry is required for WebSphere Portal v5.1 servers; it is optional, but recommended for WebSphere Portal v5.0 servers. See Defining the Library directory for properties files for details.
  • The Portal configuration in an imported project does not contain all of the configuration information from the Portal server. If you deploy the imported project to another server, it won't have complete configuration information.
  • Import requires either copy or FTP access to the websphere_installation_directory/installedApps/node/wps.ear directory. In addition, importing a WebSphere Portal v5.1 portal project requires that you have either copy or FTP access to the portal_installation_directory/share/app/nls. If your firewall does not permit access to these directories, you cannot import from the WebSphere Portal server.
  • If you only have FTP access to above directory, even if the firewall is configured to allow FTP, the import may still fail because more than 3,000 files are transferred. To increase your chances of a successful import, specify passive mode in the server configuration.
  • If the portal server has more than one label or page of the same ordinal, the order of top level labels and pages in the newly imported portal project may be different from the order that was on the portal server.
  • If JSP files or Java™ classes within the portal server refer to classes that are in external JAR files, there may be compilation errors after the project is imported. You need to import any external JAR files, which can be located in the websphere_installation_directory/lib or portal_installation_directory/shared/app directories on the remote portal server, to your development machine, and add them to Java build path of your portal project. To set the Java build path, follow these steps:
    1. From the Project Explorer view, highlight the project, right-click and select Properties.
    2. In the left pane, select Java Build Path.
    3. In the right pane, select the Libraries tab.
    4. Add the referenced JAR.
    5. Click OK to save the configuration.
  • A portal project that has been imported from a WebSphere Portal 5.1.0.1 server cannot run in the WebSphere Portal 5.1.0.0 test environment.
Related tasks
Creating new portal projects
Defining the Library directory for properties files
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.