14.3 Importing portal data

This section describes how to import a Portal Data Export ZIP file to a portal.

NOTE:Remember that, during the import, your target application server must be running but not currently servicing user requests.

To import portal data:

  1. On the Tools page, select Portal Data Import from the navigation menu on the left.

    The Portal Data Import panel displays:

    Description: Description: Illustration
  2. Specify the following general import settings:

    Setting

    What to do

    Archive

    Click the Browse button to select the Portal Data Export ZIP file to import. For example:

    
    PortalData.21-Oct-05.09.12.16.zip
    

    Import security settings?

    Select one of the following:

    • Yes — If you want to import the permissions that the Portal Data Export ZIP file specifies for access to pages and portlets by users, groups, and containers. Make sure that the users, groups, and containers involved exist in the target portal’s identity vault; permissions for missing entities will fail to be imported.

    • No — If you want to ignore the permissions that the Portal Data Export ZIP file specifies.

  3. Click the View Import Archive button.

    The panel displays more specifics about your selected Portal Data Export ZIP file and how you want to import it:

    Description: Description: Illustration
  4. Specify the following detailed import settings:

    Setting

    What to do

    Replace existing data?

    Select one of the following:

    • Yes — If you want the contents of the Portal Data Export ZIP file to overwrite corresponding pages and portlets that already exist in the target portal. For example, if the Portal Data Export ZIP file contains a shared page named MyPage and the target portal contains a shared page named MyPage, that existing page will be overwritten in the target portal.

    • No — If you want to skip the import for all existing pages and portlets.

    Access level for imported objects

    Select one of the following:

    • All Users — For unrestricted access to imported pages and portlets.

    • Administrator only — For restricted access to imported pages and portlets.

    If you chose to import security settings, then this access level is applied only to those imported pages and portlets where a security setting failed to be imported (typically because specified users, groups, or containers do not exist in the target portal’s identity vault).

    If you chose not to import security settings, then this access level is applied to all pages and portlets that are imported.

    Import group settings?

    (If you chose to import security settings) Select one of the following:

    • Yes — If you want to import the default container page and default shared page assignments that the Portal Data Export ZIP file specifies for groups. Make sure that the groups involved exist in the target portal’s identity vault; assignments for missing groups will fail to be imported.

    • No — If you want to ignore the default page assignments that the Portal Data Export ZIP file specifies for groups.

    Import Container Pages

    Import Shared Pages

    Import Portlets

    Follow the onscreen instructions to select the pages and portlets that you want to import from the Portal Data Export ZIP file to the target portal.

    NOTE:Some portlets that you have not selected for import might still be imported. If you import a page that contains a portlet, but do not select that portlet for import, the portlet is still imported (to ensure that a runtime error does not occur for the imported page).

    Please map the portlet application names... Archive/Local

    Use the Archive and Local dropdown menus to map the portlet application names in the archive (Portal Data Export ZIP file) to existing portlet applications on the local (target) application server.

  5. When you’re ready to begin the import, click the Import Portal Data button.

    When the import completes, the Portal Data Import Results panel displays:

    Description: Description: Illustration

    Unsuccessful imports display in red. To troubleshoot import (or export) problems, look at your application server’s system console or log file (such as jboss/server/IDM/log/server.log) for messages from the following user application log:

    com.novell.afw.portal.util