test

Sun Java System Portal Server 7.1 Update 1 Release Notes

Installing or Upgrading Portal Server 7.1 Update 1

You can install Portal Server 7.1 Update 1 using the Java ES installer. On the Solaris and Linux platforms, you can upgrade the existing Portal Server 7.1 to Portal Server 7.1 Update 1 using the patch.

This section contains the following:

Installing Portal Server 7.1 Update 1

To install Portal Server 7.1 update 1, download the install bits and run the installer.

Note –

Portal Server 7.1 Update 1 can be installed on the Windows platform using the evaluation installer and is certified to be only a developer platform. The ReadMe file associated with the evaluation installer has information on how to install Portal Server on the Windows platform.

For more information about installation on the Solaris and Linux platforms, refer to Chapter 1, Installing Sun Java System Portal Server 7.1, in Sun Java System Portal Server 7.1 Configuration Guide. The Configuration guide contains information, such as hardware and operating system requirements, software requirements, and verifying the Portal Server 7.1 installation. Information in the Configuration guide is applicable for Portal Server 7.1 and Portal Server 7.1 Update 1.

Upgrading Portal Server 7.1 to Portal Server 7.1 Update 1

On the Solaris and Linux platforms, you can upgrade Portal Server 7.1 to Portal Server 7.1 Update 1 using the patch. If your Portal Server installation is not Portal Server 7.1, you need to upgrade your existing Portal Server to Portal Server 7.1 and then upgrade to Portal Server 7.1 Update 1 using the patch. For more information on upgrading Portal Server, refer to Sun Java Enterprise System 5 Upgrade Guide for UNIX.

Use the following procedure to upgrade Portal Server 7.1 to Portal Server 7.1 Update 1.

ProcedureTo Upgrade Portal Server 7.1 to 7.1 Update 1 on the Solaris Platform

  1. Download the following patches from Sunsolve:

    For SPARC: 124301-01 and for the x86 platform: 124302-01.

    If you need to upgrade to the localized version of Portal Server 7.1 Update 1, download the patch, 125301-02.

    Note –

    If you have upgraded Portal Server 7.0 to Portal Server 7.1, use the following localization patches:

    On the Solaris platform: 123254-03

    On the x86 platform: 124590-03

  2. Change the directory to the patch location and run the following command to add the patch or patches:

    patchadd patch-id

  3. Restart the web container.

    For Sun Java System Application Server:

    /ApplicationServer_base/Appserver/bin/asadmin stop-domain domain1

    /ApplicationServer_base/Appserver/bin/asadmin start-domain --user admin --password password domain1

    For Sun Java System Web Server:

    /var/opt/SUNWwbsvr7/https-host.domain-name/bin/stopserv

    /var/opt/SUNWwbsvr7/https-host.domain-name/bin/startserv

  4. Restart common agent container.


    /usr/share/bin/cacaoadm stop 
/usr/share/bin/cacaoadm start

  5. Run the following command to ensure that the common agent container is working.

    /usr/share/bin/cacaoadm status

  6. If the localization packages have been upgraded, set the Portal Server console JVM's locale to en_US.UTF-8.

    export LC_ALL=en_US.UTF-8

    export LANG=en_US.UTF-8

  7. Run the following command to update Portal Server to 7.1 Update 1.

    PortalServer-base/opt/SUNWportal/bin/psupdate -a

    Refer to the following table for more information on how to run the psupdate script.

    Question 

    Action 

    Have you restarted all your servers (cacao, web container)? 

    Type Y if you have restarted the common agent container and the web container. 

    Type N if you have not restarted the common agent container and the web container. If you type N, the script aborts. You need to restart the common agent container and the web container, and invoke the psupdate script.

    Please enter the host name on which this installation resides (excluding domain name):  

    Enter the host name on which the installation resides. For example, i-planet-14. 

    Please enter the fully qualified host name on which this installation resides: 

    Enter the fully qualified host name on which the installation resides. For example, i-planet-14.red.iplanet.com 

    Please enter the name of the Portal configuration directory: 

    Default name of the configuration directory is /etc/opt/SUNWportal.

    Are Portal web applications installed using the web container name?

    The script automatically detects the web container that you used to install Portal Server 7.1. 

    Please enter the port of the web container's Administration Server

    For Sun Java System Application Server, default value is 4849. 

    For Sun Java System Web Server, default value is 8989. 

    Please enter the name of the web container's administrator

    Type the administrator ID. 

    Please enter the web container's administrator's password:

    Type the administrator's password. 

    Please enter the Access Manager administrator's id: 

    Type the Access Manager administrator's id. By default, the administrator ID is amadmin.

    Please enter the Access Manager administrator's password:  

    Type the Access Manager administrator's password. 

    Do you wish redeployment to be constrained to local Portal instances? 

    Type Y if you want redeployment to occur only on Portal Server instances hosted on this machine. Portal installations using web container clusters should not select this option. Type N if you wish redeployment to occur on all instances of all Portals for which this machine hosts at least one instance. This option is required for those Portal installations that are using a web container cluster. 

    Do you wish to (re)install the Enterprise Sample? 

    Type Y if you wish to reinstall Enterprise Sample. Default value is N. 

    If you have customized your sample and select Y, the sample will be overwritten. 

    Please enter the Access Manager LDAP User password:  

    Type Access Manager LDAP User password. Default value is N. 

    If you have customized your sample and select Y, the sample will be overwritten. 

    Do you wish to (re)install the Developer Sample? 

    Type Y if you wish to reinstall Developer Sample. Default value is N. 

    If you have customized your sample and select Y, the sample will be overwritten. 

    Do you wish to (re)install the Community Sample? 

    Type Y if you wish to reinstall Developer Sample. Default value is N. 

    If you have customized your sample and select Y, the sample will be overwritten. 

    Is the Community database running? 

    Type Y if the community database is running. 

  8. Restart the common agent container and web container.

ProcedureTo Upgrade Portal Server 7.1 to 7.1 Update 1 on the Linux Platform

  1. Download the following patch from Sunsolve:

    124303-01

  2. Change the directory to the patch location and run the update script.

  3. (Optional) If you want to upgrade to the localized version of Portal Server 7.1 Update 1, download the patch, 125302-02 , and install it.

    1. Install each rpm file using the following command:

      rpm -Fvh /patch-id/file-name.rpm

      For example, rpm -Fvh /125302-02/sun-portal-base-l10n-7.1-1.1.i386.rpm

  4. Restart the web container.

  5. Restart common agent container.

    /opt/sun/cacao/bin/cacaoadm stop

    /opt/sun/cacao/bin/cacaoadm start

  6. Run the following command to ensure that the common agent container is working.

    /opt/sun/cacao/bin/cacaoadm status

  7. If the localization packages have been upgraded, set the Portal Server console JVM's locale to en_US.UTF-8.

    export LC_ALL=en_US.UTF-8

    export LANG=en_US.UTF-8

  8. Run the following command to update Portal Server to 7.1 Update 1.

    PortalServer-base/opt/SUNWportal/bin/psupdate -a

  9. Restart the common agent container and web container.

ProcedureTo Remove the Patch

  1. Run the following command.

    patchrm patch-id

  2. Restart the web container and common agent container.

  3. Run the following command to roll back to Portal Server 7.1 .

    psupdate -r

  4. Restart the common agent container and web container.

Upgrading Portal Server 7.0 to Portal Server 7.1 Update 1

To update Portal Server 7.0 to Portal Server 7.1 Update 1, you need to upgrade Portal Server 7.0 to Portal Server 7.1. For more information on how to upgrade to Portal Server 7.1, refer to Sun Java Enterprise System 5 Upgrade Guide for UNIX.

Note –

Do not use the localization patches specified in the Upgrade guide.

When you upgrade from Portal Server 7.0 to Portal Server 7.1, use the following localization patches:

SPARC 

123254-03 

x86 

124590-03 

Linux 

123255-02 

Note –

If you have used the patches mentioned in the table above, you are not required to use the localization patches when you upgrade Portal Server 7.1 to Portal Server 7.1 Update 1.

For more information on upgrading, refer to Upgrading Portal Server 7.1 to Portal Server 7.1 Update 1.

Installing Portal Server 7.1 Update 1 on the Windows Platform

For more information on installing Portal Server 7.1 Update 1 on the Windows platform, refer to the README file present in the Windows installer zip file.