Sun Java System Portal Server 7.1 Configuration Guide

Setting Up Administrator Console and Command-Line Interface on a Remote Host

This section explains how to set up Portal Server administrator console or command-line interface on a remote host. In this scenario, you can install Portal Server on a node and can set up administrator console or command-line interface on another node. On the node where you set up administrator console or command-line interface, you need to install a web container and Portal Server packages. You need to install Portal Server packages in the Configure Later mode.

The psconsole of Portal Server can be installed only on Web Server or Application server. If you install Portal Server on any of the compatible web containers, such as BEA WebLogic or IBM WebSphere, you need to install psconsole on Web Server or Application Server.

ProcedureTo Set Up an Administrator Console on a Remote Host on Web Server 7.0

  1. Install Portal Server 7.1 on Node 1 in the Configure Now mode.

  2. Install Web Server on Node 2 in the Configure Now mode.

  3. Install Portal Server in the Configure Later mode on Node 2.

  4. Create the following directory structure in your current directory.

    mkdir -p WEB-INF/classes/

    mkdir -p WEB-INF/lib/

  5. Create a property file, WEB-INF/classes/pasconnect.properties, with the property value pair pas.host=node1.domain.com.

  6. Copy the cacao_cacao.jar file into the WEB-INF/lib directory.

    The cacao_cacao.jar file is located in the following directories:

    • For Solaris platform: /usr/lib/cacao/lib

    • For Linux platform: /cacao_base/sun/cacao/share/lib

  7. In the psconsole.war file, add the following content.

    jar -uvf /PortalServer_base/SUNWportal/admin/psconsole.war WEB-INF

  8. Deploy the updated psconsole.war file to the Web Server instance.

ProcedureTo Set Up an Administrator Console on a Remote Host on Application Server 8.2

  1. Install Portal Server 7.1 on Node 1 in the Configure Now mode.

  2. Install Application Server 8.2 on Node 2 in the Configure Now mode.

  3. Install Portal Server in the Configure Later mode on Node 2.

  4. Stop the common agent container on node 2.

    /usr/lib/cacao/bin/cacaoadm stop

  5. Run the following command on Node 2:

    /usr/lib/cacao/bin/cacaoadm create-keys -f

  6. Start the common agent container on Node 2 .

    /usr/lib/cacao/bin/cacaoadm start

  7. Create the following directory structure in your current directory.

    mkdir -p WEB-INF/classes/

    mkdir -p WEB-INF/lib/

  8. Create a property file, WEB-INF/classes/pasconnect.properties, with the property value pair pas.host=node1.domain.com.

  9. Copy the cacao_cacao.jar file into the WEB-INF/lib directory.

    The cacao_cacao.jar file is located in the following directories:

    • For Solaris platform: /usr/lib/cacao/lib

    • For Linux platform: /cacao_base/sun/cacao/share/lib

  10. In the psconsole.war file, add the following content.

    jar -uvf /PortalServer_base/SUNWportal/admin/psconsole.war WEB-INF

  11. Deploy the updated psconsole.war file to the Application Server instance.

  12. Add the following in the /domains/domain1/server.policy file.


    grant {
    permission java.util.PropertyPermission "*","read,write";
    permission java.lang.RuntimePermission "writeFileDescriptor";
    permission java.lang.RuntimePermission "createClassLoader";
    permission java.io.FilePermission "\${/}-", "read,write,execute,delete";
    
    // Used by psconsole app
    permission java.security.SecurityPermission "insertProvider.SunSASL";
    permission java.security.SecurityPermission "insertProvider.SunJSSE";
    permission java.lang.RuntimePermission "getProtectionDomain";
    
    };
  13. Restart the Application Server instance.


    Note –

    Step 12 is not required if the security manager is disabled for the Application Server domain where psconsole is deployed. This is achieved by commenting out the following JVM option for security policy in the domain.xml file.


    <jvm-options>-Djava.security.policy=${com.sun.aas.instanceRoot}
    /config/server.policy</jvm-options>

ProcedureTo Setup Command-Line Interface on a Remote Host on Web Server 7.0 or Application Server 8.2

  1. Install the Portal Server 7.1 on Node 1 in the Configure Now mode.

  2. Install Web Server 7.0 or Application Server 8.2 on Node 2 in the Configure Now mode.

  3. Install Portal Server 7.1 on Node 2 in the Configure Later mode.

  4. In the PortalServer_base/SUNWportal/samples/psconfig/example2.xml file, replace tokens with the node information for Node 2.

  5. Run the following command:

    PortalServer_base/SUNWportal/bin/psconfig --config example2.xml

  6. In the pasconnect.properties file, change the property value as pas.host=node1.domain.com.

    The pasconnect.properties file is located in the following directories:

    • For Solaris platform: /etc/opt/SUNWportal

    • For Linux platform: /etc/SUNWportal