Setting up a virtual portal in a portal farm

If you plan on creating and using virtual portals within a portal farm, there are additional steps that are recommended to have a successful virtual portal within a portal farm environment. The basic problem if this procedure is not followed is that the virtual portal artifacts have different object ID's in each Portal farm member, which can cause problems if the initial HTTP requests prior to establishing a session end up getting routed to different Portal farm members. By following this procedure, we ensure that all Portal farm members can service these initial HTTP requests.

About this task

Perform the following steps to set up a virtual portal in a portal farm:
Note: These instructions only apply if you create a farm with independent servers, each with its own Release database.

Procedure

  1. Create and configure your virtual portal. For more information see Virtual portals.
  2. Change to the following directory:
  3. Use the following command to export content from your virtual portal:
    Table 1. Command to export content from your virtual portal by operating system
    Operating system Command
    Windows xmlaccess.bat -in ExportRelease.xml -user wpsadmin -password wpsadminpwd -url http://hostname:port/wps/config/virtualportalContext -out virtualportal_output.xml
    AIX HP-UX Linux Solaris z/OS ./xmlaccess.sh -in ExportRelease.xml -user wpsadmin -password wpsadminpwd -url http://hostname:port/wps/config/virtualportalContext -out virtualportal_output.xml
    IBM i xmlaccess.sh -in ExportRelease.xml -user wpsadmin -password wpsadminpwd -url http://hostname:port/wps/config/virtualportalContext -out virtualportal_output.xml
    Note: The exported configuration is stored in the virtualportal_output.xml file.
  4. Run the create-virtual-portal configuration task on each portal farm to create an empty virtual portal, using the same name as the virtual portal you created in the first step. For more information see Tasks for administering virtual portals, Creating a virtual portal, and Task: create-virtual-portal.
  5. Use the following command to import content from the first virtual portal into the virtual portals created on each portal farm:
    Table 2. Command to import content from the first virtual portal into the virtual portals created on each portal farm by operating system
    Operating system Command
    Windows xmlaccess.bat -in virtualportal_output.xml -user wpsadmin -password wpsadminpwd -url http://hostname:port/wps/config/virtualportalContext -out Output.xml
    AIX HP-UX Linux Solaris z/OS ./xmlaccess.sh -in virtualportal_output.xml -user wpsadmin -password wpsadminpwd -url http://hostname:port/wps/config/virtualportalContext -out Output.xml
    IBM i xmlaccess.sh -in virtualportal_output.xml -user wpsadmin -password wpsadminpwd -url http://hostname:port/wps/config/virtualportalContext -out Output.xml