Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Portal Server 6.1 Migration Guide

Chapter 13
Upgrading Sun™ ONE Portal Server Software from Version 6.0 to Version 6.1

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

This chapter contains the following sections:

The Upgrade Process

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

  1. Installing Sun ONE Portal Server 6.1 software into an existing instance of Sun™ ONE Identity Server 6.0.
  2. Restoring the Sun ONE Portal Server 6.0 customized files.
  3. Finishing miscellaneous other tasks to complete the upgrade.

    4. Note

    The steps in the process must be performed in the order they are listed here.

Installing Sun ONE Portal Server 6.1 Software

Install the Sun ONE Portal Server 6.1 software.

  1. 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 installation program is located.
  3. Type:

    4. ./pssetup

  4. Specify if you accept the license agreement. To accept, type yes.

    Note

    Although this product will run without a license, you must either purchase a Binary Code License from, or accept the terms of a Binary Software Evaluation license with Sun Microsystems, to legally use this product.

  5. Do not remove the Sun™ ONE Directory Server and Sun ONE Identity Server components when the installation program detects their presence and prompts to remove them. Select the option to Remove the Portal Server only.
  6. At the Uninstall Portal Server in upgrade mode? y/[n] option, type y.
  7. When prompted, type the appropriate administrator passwords.
  8. Select the option to install the Sun ONE Portal Server.
  9. Select the Deployment type.

    10. If installing on an application server, refer to the appropriate appendix in the Sun ONE Portal Server Installation Guide for additional information.

    Tip

    Anytime during the installation, you can view the installation log at /var/sadm/install/logs/pssetup.pid/install.log for a status on the installation. To view the log file during installation, for example, enter:

    tail -f /var/sadm/install/logs/pssetup.installpid/setup.log

    Here, pid is the process id for pssetup process. After installation, check this log for errors during installation.

    A listing of the default configuration settings displays.

  10. At the Use these settings? [y]/n prompt, select n.

    11. A series of configuration prompts will display.

  11. Set the appropriate settings for the configuration.

    12. At the Install Sample Portal? [y]/n prompt, select n.

    At the Install in upgrade mode? y/[n] prompt, select y.

    When the installation program upgrade mode option is chosen, the existing Sun ONE Portal Server 6.0 installation is scanned and user modified files are copied, saved, and renamed to filenames with a .pre61 extension.

    Note

    The upgrade mode tags the following files as updated even when the content has not changed:

    /etc/opt/SUNWps/desktop/desktopconfig.properties
    /    BaseDir/SUNWam/locale/psDesktop.properties
    /    BaseDir/SUNWam/locale/psNetMail.properties
    /    BaseDir/SUNWam/locale/psRewriter.properties
    /    BaseDir/SUNWam/locale/psSearch.properties
    /    BaseDir/SUNWam/public_html/docs_en_US/ps/SunONE.jpg

    A updated listing of the default configuration settings displays.

  12. At the Use these settings? [y]/n prompt, select y.

When the install completes, the Sun ONE Portal Server 6.1 system will be started automatically. To complete the upgrade, you must still restore the customized files.

Restoring Customized Files

When the installation program upgrade mode option is chosen, the existing Portal Server 6.0 installation is scanned and user modified files are copied, saved, and renamed to filenames with a .pre61 extension. At the completion of the install, the Sun ONE Portal Server is started; however, the installation is not running with any of your previous template or JSP customizations. you must run the restoremodfiles script to restore these customizations. The restoremodfiles script accepts a directory name as a parameter. The script does the following:

By default, desktop customizations are stored in /etc/opt/SUNWps/desktop/default. The script is located in the /BASEDIR/SUNWps/bin directory. For example, if the base install directory on a Web Server deployment is /opt, to run the script with the directory parameter option of /etc/opt/SUNWps/desktop/, type the following at your system prompt:

/opt/SUNWps/bin/restoremodfiles /etc/opt/SUNWps/desktop/

On a application server deployment, if the base install directory is /opt/SUNWappserver7, to run the script with the directory parameter option of /etc/opt/SUNWps/desktop/, type the following at your system prompt:

/opt/SUNWappserver7/SUNWps/bin/restoremodfiles /etc/opt/SUNWps/desktop/

Completing the Upgrade

To complete the upgrade process, you need to do the following:

You have now completed the upgrade process. Your Sun ONE Portal Server 6.1 system should be up and running with all of the previous existing data and customizations.

Uninstalling a Sun ONE Portal Server Upgrade Installation

The Remove All option of the Sun ONE Portal Server installation program (pssetup) does not completely uninstall an upgrade installation of the Sun ONE Portal Server 6.1 software. This option will leave information in the product registry. To avoid these issues, do the following to uninstall a Sun ONE Portal Server upgrade installation.

On a Web Server Deployment

  1. Run the Sun ONE Portal Server installation program (pssetup) and choose the Remove Portal Server Only option to remove all the Sun ONE Portal Server packages.
  2. Run the Sun ONE Identity Server uninstall script located at BaseDir/uninstall to remove all the Sun ONE Identity Server packages.
  3. Run the utility located at /usr/bin/prodreg and verify that the Sun ONE Identity Server software has been removed from the product registry.

On an Application Server Deployment

  1. Run the Sun ONE Portal Server installation program (pssetup) and choose the Remove Portal Server Only option to remove all the Sun ONE Portal Server packages.
  2. Run the Sun ONE Portal Server installation program (pssetup) and choose the Remove Identity Server Only option to remove the Sun ONE Identity Server packages.
  3. Run the Sun ONE Identity Server uninstall script located at BaseDir/uninstall to remove the Sun ONE Directory Server and its configuration contained in the SUNWamutl and SUNWamdsc packages.
  4. Run the utility located at /usr/bin/prodreg and verify that the Sun ONE Identity Server software has been removed from the product registry.


Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.