Sun Java System Portal Server 7 Installation Guide

Instructions to Upgrade and Verify Upgrade

This section contains the following:

ProcedureTo Upgrade to Portal Server 7 Software on Solaris

  1. Go to the directory where you have downloaded the software and unzip the Portal Server zip file.

  2. Go to Product/portal_svr/Tools/upgrade/bin directory and type ./psupgrade.

    The upgrade script requires you to provide the following:

    • Access Manager server administrator's password.

    • Access Manager ldapuser password

    • Directory Server Directory Manager password.

    • Web container administrator's password.

    • Web container Master Password in case of Application Server 8.1 for Portal Server software installation.

    • Secure remote access certificate database password if Secure Remote Access was previously installed on this machine.

    • Secure Remote Access log user password if Secure Remote Access or its constituents were previously installed on this machine.

    When you upgrade, the upgraded Portal Server installation is located at PortalServer6.3.1-base/SUNWportal directory, where PortalServer6.3.1-base is the name of the directory in which the Java Enterprise System 3 Portal Server was installed.

  3. Restart the Portal Server web container and Gateway (if Gateway was installed and upgraded).

  4. If you performed an upgrade on Application Server 8.1, do the following:

    • Remove any line breaks in the server classpath value.

    • Remove the classpath entry corresponding to jss3.jar.

  5. If you performed an upgrade on Web Server 6.1, do the following after Access Manager upgrade and before starting Portal Server upgrade:

    • Edit Web Server's server.xml file.

    • Modify classpathsuffix entry jss3.jar to jss4.jar.

    • Add PortalServer6.3.1-base/lib/ to serverclasspath.

    • Add PortalServer6.3.1-base/lib/ to nativelibraryprefix.

ProcedureTo Upgrade to Portal Server 7 Software on Linux

  1. Go to the directory where you have downloaded the software and unzip the software file.

  2. Go to Product/portal_svr/Tools/upgrade/bin directory and type ./psupgrade.

    The upgrade script requires you to provide the following:

    • Access Manager server administrator's password.

    • Access Manager ldapuser password

    • Directory Server Directory Manager password.

    • Web container administrator's password.

    • Web container Master Password in case of Application Server 8.1 for Portal Server software installation.

    • Secure Remote Access certificate database password if Secure Remote Access was previously installed on this machine.

    • Secure Remote Access log user password if Secure Remote Access or its constituents were previously installed on this machine.

  3. Restart the Portal Server web container and Gateway (if you installed and upgraded the gateway).

  4. If you performed an upgrade on Application Server 8.1, do the following:

    • Remove any line breaks in the server classpath value.

    • Remove the classpath entry corresponding to jss3.jar.

  5. If you performed an upgrade on Web Server 6.1, do the following after Access Manager upgrade and before starting Portal Server upgrade:

    • Edit Web Server's server.xml file.

    • Modify classpathsuffix entry jss3.jar to jss4.jar.

    • Add PortalServer6.3.1-base/lib/ to serverclasspath.

    • Add PortalServer6.3.1-base/lib/ to nativelibraryprefix.

  6. Install sun-mobileaccess rpms from the installer after the upgrade if they are missing. Use the following command to see if the sun-mobileaccess rpms are missing:

    rpm -qa | grep sun-mobileaccess

ProcedureTo Upgrade A Gateway-Only Node

  1. Install Directory server from the Java Enterprise System stack.

  2. Perform the following:

    1. cd to Product/portal_svr/Tools/upgrade/resource/jes3

    2. Issue the following command:

      /usr/jdk/entsys-j2se/bin/jar --xf upgraderesource.jar upgrade.xml

    3. Edit the upgrade.xml file.

      After the line:

      <replace file="${PS_70_PRODUCT_DIR}/lib/ServiceLDIFMap.properties" 
      token="psWSRPConsumer2.ldif" value=""/>

      Include the following two lines in the upgrade.xml file.

      <replace file="${PS_70_PRODUCT_DIR}/template/PortalDomainConfig.properties"  
      token="domain.data.host=" value="GATEWAY_HOST_NAME"/>
      <replace file="${PS_70_PRODUCT_DIR}/template/PortalDomainConfig.properties"  
      token="domain.data.port=" value="LOCAL_DIRECTORY_SERVER_PORT"/>
    4. Modify the following lines:

      Change <target name="fetchGlobalDP" > to <target name="fetchGlobalDP" if="PORTAL_INSTALLED">

      Change <target name="fetchOrgDP" > to <target name="fetchOrgDP" if="PORTAL_INSTALLED">

      Change <target name="uploadGlobalDP" > to <target name="uploadGlobalDP" if="PORTAL_INSTALLED">

      Change <target name="uploadOrgDP" > to <target name="uploadOrgDP" if="PORTAL_INSTALLED">

    5. Issue the following command:

      /usr/jdk/entsys-j2se/bin/jar -uf upgraderesource.jar upgrade.xml

  3. Copy the security folder from /etc/opt/SUNWcacao/security from the Portal Server machine to the Gateway machine.

  4. Start Directory Server.

  5. Start the cacao server.

  6. Run the command ./psupgrade.

    A failure occurs. You can ignore.

  7. Copy the psconfig file from /var/tmp/pconfigupgradeXXXXXxml to /tmp/psconfig.xml.

  8. Replace the following unreplaced tokens in the psconfig.xml file:

    • JAVA_BASE_DIR. For example, use /usr/jdk/entsys-j2se.

    • HOSTNAME.DOMAIN:PORTNO

    • mydomain.com with the gateway domain

  9. Run the command /opt/SUNWportal/bin/psconfig --config /tmp/psconfig.xml

  10. Restart the web container.

ProcedureTo Ensure Upgrade to Portal Server 7 was Successful

  1. Access the Access Manager software administration console from your browser. To access, type http://hostname/amconsole.

  2. Access the Portal Server Desktop. To access, type protocol://fully-qualified-hostname:port/portal-URI.

    If the sample Portal desktop displays without any exception, then your upgrade was successful. Try logging in as a user to ensure that the sample Portal desktop displays without errors.

  3. Access the Portal Server software administration console. To access, type protocol://fully-qualified-hostname:port/psconsole.

    Verify that it displays information about Portal Server7 software. Ensure that a Portal with portal-id Upgraded is created.