Creating a New Portal on a Remote Node

This section explains how to create a new portal on a remote node. When you create a new portal on a remote node, you should install Access Manager SDK (AMSDK) and a compatible web container. When you install AMSDK, you need to provide the details of Access Manager and Identity Server that you installed for the Portal Server installation. You need to install Portal Server in the Configure Now or Configure Later mode. All the procedures that are explained in this section use the web container of the first portal installation for the second portal installation on a remote node.

When you install AMSDK, provide the same encryption key, am password, and LDAP password that are used for Access Manager on Node 1.

After you install AMSDK and the web container, you can use any one of the following options to create a new portal:

• Using Portal Server in the Configure Now Mode: When you create a new portal in the Configure Now mode, you can create only one portal on a node. The installer prevents you from creating another portal on a node where you already have a portal.

• Using Portal Server in the Configure Later Mode: When you create a new portal in the Configure Later mode, you can create several portals on the same node. You need to create web container instances and change the example files. You can create portals by running the psconfig command.

• Using the psadmin command: Using the psadmin command, you can create several portals on the same node. You need to create web container instances, and run the psadmin create-portal sub command.

To Create a New Portal on Application Server 9.1 in the Configure Now Mode

Before You Begin

Ensure the following:

• Portal Server, Access Manager, and Common Agent Container are up and running on the first node. Execute the following command on Node 1: PortalServer-base/SUNWportal/bin/psadmin list-portals -u user-name -f admin-password

1. Invoke the Portal Server 7.2 GUI installer and select Application Server 9.1, Access Manager SDK, and Portal Server and install them in the Configure Now mode.

2. Provide the Access Manager host and the Directory Server host information.

3. Change the name of the portal.

   For example, first portal will be portal1. Change the second portal name to portal2.

To Create a New Portal on Application Server 9.1 in the Configure Later Mode

Before You Begin

Ensure the following:

• Portal Server, Access Manager, and Common Agent Container are up and running on the first node. Execute the following command on Node 1: PortalServer-base/SUNWportal/bin/psadmin list-portals -u user-name -f admin-password

1. Install Access Manager SDK and Application Server 9.1 in the Configure Now mode using the Java ES installer.

2. Start the Application Server 9.1 Administration Server.

   ApplicationServer_base/appserver/bin/asadmin start-domain --user admin_user --password admin_password domain-name

3. Install Portal Server in the Configure Later mode using the Portal Server 7.2 GUI installer.

4. Complete the Portal Server installation.

   PortalServer_base/bin/psconfig --config example7.xml

To Configure Common Agent Container When Running as Root and Portal Running as Non-root

Follow these steps when the Common Agent Container process is running as root and Portal Server is running as non-root. If the Common Agent Container process is running as the same non-root user as Portal Server, skip the following steps.

• Edit the cacao.properties file.

  On Solaris installation, you can find the cacao.properties file in the /etc/cacao/instances/default/private/ directory.

• In the cacao.properties file, set the following system properties for Common Agent Container JVM.

  • -Dcom.sun.portal.non.root.user=user id

  • -Dcom.sun.portal.non.root.group=user group

    where user id is the UNIX user id of the non-root user and user group is the UNIX group to which the non-root user belongs. For example, the system properties for Common Agent Container JVM looks like the following:

    # Flags to pass to the Cacao VM java.flags=-Xms128M -Xmx256M -Dcom.sun.management.jmxremote -Dfile.encoding=utf-8 -Dcom.sun.portal.log.config.file=/etc/opt/SUNWportal/PSAdminLogConfig.properties -Djava.awt.headless=true -Dcom.sun.portal.non.root.user=xyz -Dcom.sun.portal.non.root.group=staff

  • Restart the Common Agent Container.

To Create a New Portal on Application Server 9.1 Using the psadmin Command

Before You Begin

Ensure the following:

• Portal Server, Access Manager, and Common Agent Container are up and running on the first node. Execute the following command on Node 1: PortalServer-base/SUNWportal/bin/psadmin list-portals -u user-name -f admin-password

1. Install Access Manager SDK and Application Server 9.1 in the Configure Now mode using the Java ES installer.

2. Start the Application Server 9.1.

   ApplicationServer_base/appserver/bin/asadmin start-domain --user admin_user --password admin_password domain-name

3. Run the installer and install Portal Server software in the Configure Later mode.

4. Configure Common Agent Container and Java DB.

   PortalServer_base/bin/psconfig --config example2.xml

5. Verify that the Common Agent Container is working properly.

   PortalServer_base/SUNWportal/bin/psadmin list-portals -u amadmin -f ps_password

6. Copy the PortalServer_base/SUNWportal/template/Webcontainer.properties.SJSAS91 file to a PortalServer_base/SUNWportal/bin/secondportal.properties file.

7. Edit the following properties in the secondportal.properties file.

   • Host=hostname.domain

   • Port=8080

   • Scheme=http

   • WebContainerType=SJSAS91

   • WebContainerInstallDir=/opt/SUNWappserver/appserver

   • WebContainerInstanceName=server

   • WebContainerDomainName=domain1

   • WebContainerInstanceDir=/opt/SUNWappserver/appserver/domains/domain1

   • WebContainerDocRoot=/opt/SUNWappserver/appserver/domains/domain1/docroot

   • WebContainerAdminHost=hostname.domain

   • WebContainerAdminPort=4848

   • WebContainerAdminScheme=https

   • WebContainerAdminUid=admin id

   • WebContainerAdminPassword=ApplicationServer admin password

   • WebContainerMasterPassword=ApplicationServer master password

   • ClusterID=cluster id

8. Create the new portal.

   PortalServer_base/SUNWportal/bin/psadmin create-portal -u amadmin -f ps_password -p secondportal --uri /portal -w secondportal.properties

9. Restart the web container.

10. Verify that the new portal has been created.

    PortalServer_base/SUNWportal/bin/psadmin list-portals -u amadmin -f ps_password