Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Portal Server 6 2004Q2 Migration Guide 

Chapter 15
Upgrading Sun™ ONE Portal Server Software from Version 6.1 to Version 6.2

This chapter provides an overview and discussion on how to upgrade your Sun™ ONE Portal Server system from the 6.1 software release to the 6.2 software release.

This chapter contains the following sections:

Overview of the Sun ONE Portal Server Upgrade Process

The Sun ONE Portal Server 6.1 to 6.2 upgrade process involves the following high-level steps:

  1. Running Sun ONE Portal Server 6.2 preupgrade script to remove the Sun ONE Portal Server 6.1 packages and backup any modified templates.
  2. Installing the Sun ONE Portal Server 6.2 software using the Sun Java™ Enterprise System installer.
  3. Completing the upgrade.

Removing Sun ONE Portal Server 6.1 Packages and Backing Up Templates

The Sun ONE Portal Server 6.2 software includes a script (preupgrade) that backs up any modified templates and removes all the Sun ONE Portal Server 6.1 packages. This script is located on the Sun Java™ Enterprise System media. For example, the Solaris SPARC version of this script is located in /orion/s9orion/orion1of2_sparc.s9_orion/latest/Solaris_sparc/Product/
portal_svr/Tools directory.

  1. Log in to the machine and become superuser.

    2. You will need root access to uninstall the Sun ONE Portal Server.

  2. Change directories to where the preupgrade script is located. For example,

    3. cd /orion/pointproducts/Solaris_sparc/Product/portal_svr/Tools

  3. Type:

    4. ./preupgrade

    The script processes each Sun ONE Portal Server 6.1 installed package for user modifications, saves any modifications to /tmp/ps_backup, and then removes each Sun ONE Portal Server 6.1 package.

Installing Sun ONE Portal Server 6.2 Software

Install the Sun ONE Portal Server 6.2 software using the Sun Java™ Enterprise System installer program located on the Sun Java™ Enterprise System media. For example, the Solaris SPARC version of the installer is located in /orion/s9orion/orion1of2_sparc.s9_orion/latest/Solaris_sparc directory.

  1. If you have not already done so, log in to the machine and become superuser.

    2. You will need root access to install the Sun ONE Portal Server.

  2. Change directories to where the installer is located. For example,

    3. cd /orion/s9orion/orion1of2_sparc.s9_orion/latest/Solaris_sparc

  3. If you used the su command to become root on your system, use the xhost command to grant access to your display. For example, use the following command to grant access to all users:

    4. xhost +

  4. Type the following command to launch the installer:

    5. ./installer

  5. At the Welcome screen, click Next.
  6. Review the Software License Agreement and click Yes, Accept License to accept.
  7. Specify the appropriate language support for the system and click Next.
  8. On the Select Components tab, uncheck any previously checked boxes and check only the Sun ONE Portal Server 6.2 checkbox.
  9. A warning message displays indicating that the Sun ONE Portal Server requires the Sun ONE Application Server or Sun ONE Web Server be installed or that Sun ONE Portal Server be configured to an existing Web Container. Click Continue.
  10. On the Shared Component Upgrades Required panel, review the list of shared components that must be upgraded and click Next.
  11. Verify the target installation directories and click Next.
  12. If the Checking System Requirements panel indicates that any patches are needed, cancel the install and add any required patches. Otherwise, click Next to continue.
  13. On the Configuration Type Panel, select Minimal Configuration and click Next.

    14. Note

    You must install using the Minimal Configuration option to be able to restore the previous Portal Server configuration.

  14. On the Ready to Install panel, click Next.
  15. On the Installation Complete panel, select the appropriate button to view the Summary or the Install Log and click Close.

Completing the Upgrade

The Sun ONE Portal Server 6.2 software includes a script (postupgrade) that restores user modified templates from the Sun ONE Portal Server 6.1 installation. This script is located on the Sun Java™ Enterprise System media. For example, the Solaris SPARC version of this script is located in /orion/s9orion/orion1of2_sparc.s9_orion/latest/Solaris_sparc/
Product/portal_svr/Tools directory. In addition to the running the postupgrade script, you must also verify some deployment information, deploy the Portal WAR file, and configure some security, login, and authentication information.

Perform the following steps to complete the upgrade process.

  1. Open the /etc/opt/SUNWps/PSConfig.properties file with a text editor and verify that it contains correct values for the following variables:

    2. DEPLOY_DIR=
    DEPLOY_DOCROOT=
    DEPLOY_DOMAIN=

    For example, on systems deployed in the default directory of a Sun ONE Web Server installation, the settings for DEPLOY_DIR, and DEPLOY_DOCROOT would be

    DEPLOY_DIR=/opt/SUNWwbsrvr
    DEPLOY_DOCROOT=/opt/SUNWwbsrvr/docs

  2. Type the following command to deploy the Portal WAR file
  1. Change directories to where the postupgrade script is located. For example,

    2. cd /orion/pointproducts/Solaris_sparc/Product/portal_svr/Tools

  2. Type:

    3. ./postupgrade

  3. When prompted, enter the Sun ONE Identity Server administration password.
  4. When prompted, enter the LDAP User password.

Perform the following steps after running the postupgrade script:

  1. Open the /JDK_dir/jre/lib/java.security file and verify that it contains the following line:

    2. login.configuration.provider=com.sun.identity.authentication.config. AMConfiguration

  2. Restart the web container.
  1. Log in to the Sun ONE Identity Server Administration console.
  2. Select the Service Configuration tab.
  3. Select Core and then Organization Authentication Modules.
  4. Click Add Membership and then Save.
  5. From the Service Configuration tab, select Membership and specify amldapuser in the Password for Root User Bind.
  6. Click Save.
  7. From the Service Configuration tab, select Core under Authentication Configuration and specify the Login Success URL as /portal/dt.
  8. Click Save.
  9. Restart the web container.

You have now completed the upgrade process. Your Sun ONE Portal Server 6.2 system should be up and running with all of the previous existing data and customizations. You should access your Portal Desktop to verify that all the files have been upgraded successfully.

Localizing Online Help

After a successful upgrade, the channel help URLs will not have the locale in the URL. For example, the URLs will be similar to:

http://host/portal/docs/online_help/...

To localize the online help, update the display profile documents and provide the correct <ConditionalProperties> definition. For example, for the locale en_US use the <ConditionalProperties> definition to define the helpURL as:

<ConditionalProperties condition="locale" value="en">

  <ConditionalProperties condition="locale" value="US">

    <String name="helpURL"
      value="online_help/user_help/desktop/desktopTOC.html"
      advanced="true"/>

  </ConditionalProperties>

</ConditionalProperties>

After defining the helpURL, the Desktop Channel Help URL will be similar to:

http://host/portal/docs/en_US/online_help/...



Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.