Sun Java logo     Previous      Contents      Index      Next     

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

Chapter 13
Upgrading from Sun ONE Identity Server 6.0 to Sun™ ONE Identity Server 6.1

This chapter provides an overview and a description of the process required to upgrade Sun ONE Identity Server 6.0 software to Sun ONE Identity Server 6.1 software in order 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 Identity Server Upgrade Process

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

  1. Backing up and removing the Sun ONE Identity Server 6.0 installation.
  2. Installing the Sun ONE Identity Server 6.1 software.
  3. Completing the upgrade.

Backing Up and Removing the Sun ONE Identity Server 6.0 Installation

The Sun ONE Identity Server 6.1 software includes a script (pre60to61upgrade) that backs up the Sun ONE Identity Server 6.0 configuration and removes all the Sun ONE Identity Server 6.0 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/
identity_svr/Tools/ directory.

Note

Back up the AMConfig.properties file before executing the pre60to61upgrade script.

  1. Log in to the machine and become superuser.

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

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

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

  3. Type:

    4. ./pre60to61upgrade

    A log of the pre60to61upgrade processing is output to /var/sadm/install/logs/Sun_ONE_Identity_Server_upgrade_log.time_stamp

  4. Make sure that the Sun ONE Directory Server is running on the correct port. At the following prompts, verify the appropriate settings. Press Enter to accept the values.

    5. Directory Server fully-qualified hostname.:
    Directory Server port (389):
    Top-Level Administrator DN:
    Top-Level Administrator password:
    Enter directory to store back up files (/opt):

Installing Sun ONE Identity Server 6.1 Software

Install the Sun ONE Identity Server 6.1 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 Identity Server.

  2. If you are not already working in the directory where you downloaded the product, use the cd command to change to that directory. 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, check the checkbox for the Sun ONE Identity Server 6.1 component and for the type of Web Container you will be upgrading (Sun ONE Web Server, Sun ONE Application Server , BEA WebLogic, or IBM WebSphere), uncheck all the other checkboxes (Sun ONE Directory Server, Administration Server, App Server, Message Queue), and click Next.
  9. A warning message displays indicating that the Sun ONE Identity Server requires the Sun ONE Directory Server be installed or that Sun ONE Identity Server be configured to access a remote Directory Server. Click Continue.
  10. Check the Upgrade existing J2SE SDK radio button and click OK.
  11. On the Shared Component Upgrades Required panel, review the list of shared components that must be upgraded and click Next.
  12. Verify the target installation directories and click Next.
  13. 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.
  14. On the Configuration Type Panel, select Custom Configuration and click Next.
  15. A series of configuration panels will display depending on the type of Web Container you chose to upgrade to. Verify the settings on each of these panels and accept the settings by clicking Next. The following entries specified should match the values that were set for the original Sun ONE Identity Server 6.0 installation:

    16. directory root suffix
    directory manager password
    admin user
    admin password
    directory server host
    directory server port
    console deployment descriptor
    services deployment descriptor

    Refer to the AMConfig.properties file from the Sun ONE Identity Server 6.0 installation backup for any values of which you are not sure.

  16. On the Identity Server (1 of 6) panel,
    1. Verify the settings for the Administrator User ID, Administrator Password, LDAP User ID.
    2. Enter the Identity Server Internal LDAP Authentication User Password and retype password to confirm.
    3. Enter the Password Encryption Key value from the AMConfig.properties file from the Sun ONE Identity Server 6.0 installation.

      4. Note

      The value of the encryption key for Sun ONE Identity Server 6.0 is static. The upgrade will fail if any other value is provided.

    4. Click Next to continue.
  17. On the Identity Server (2 of 6) panel, select the appropriate Web Container for your implementation and click Next.
  18. On the Identity Server (3 of 6) panel, verify the settings for the Web Container and click Next.
  19. On the Identity Server (4 of 6) panel, verify the configuration settings and click Next.
  20. On the Identity Server (5 of 6) panel,
    1. Verify the Directory Server Host, the Identity Server Directory Root Suffix, and the Directory Manager DN. Directory Server Port: 389
    2. Enter 389 as the Directory Server Port and enter the correct Directory Manager Password.
    3. Click Next to continue.
  21. On the Identity Server (6 of 6) panel, at the “Is Directory Server provisioned with user data?’ query specify Yes.
  22. Verify the Organization Marker Object Class, the Organization Naming Attribute, the User Marker Object Class, and the User Naming Attribute and click Next.
  23. Click No in response to the following Info message:

    24. This Directory Server does not have Identity Server 6.1 DIT. Do you want the installation program to load the DIT into your Directory Server?

  24. On the Ready to Install panel, click Next.
  25. 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 Identity Server 6.1 software includes a script (Upgrade60DitTo61) that upgrades the directory and schema information. When the Sun ONE Identity Server 6.1 software is installed, this script is copied into /opt/SUNWam/migration/60to61/scripts/ directory. In addition to the running this 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. Change directories to where the Upgrade60DitTo61 script is located. For example,

    2. cd /opt/SUNWam/migration/60to61/scripts

  2. Type:

    3. ./Upgrade60DitTo61

  3. At the following prompts, verify the appropriate settings. Press Enter to accept the values.

    4. Directory Server fully-qualified hostname.:
    Directory Server port (389):
    Directory Manager DN ( cn=Directory Manager ):
    Directory Manager ( cn=Directory Manager ) password:
    Top-Level Administrator DN (uid=amAdmin,ou=People,dc=red,dc=iplanet,dc=com ):
    Top-Level Administrator (uid=amAdmin,ou=People,dc=red,dc=iplanet,dc=com ) password:

    The script displays the following message:

    IS_dit_version = 6.0
    Deleting DSS Service.
    Upgrading 6.0 schema.
    modifying entry cn=schema
    Create DIT succeeded.
    Before proceeding, you MUST restart the directory server.
    Hit return when ready.

  4. In another terminal window, stop and restart the Sun ONE Directory Server using the following commands:

    5. /DS_BASEDIR/slapd-HOSTNAME/stop-slapd
    /DS_BASEDIR/slapd-HOSTNAME/start-slapd

  5. In the first terminal window, enter return.

    6. The script continues processing the directory and schema information. When complete, the script displays the following message:

    Success 0: Sucessfully completed.
    Upgrade completed.

  6. To make the upgrade changes take effect,
    1. Stop and restart the Sun ONE Directory Server again.
    2. Stop and start the web container. For example, on a Sun ONE Web Server, type the following commands to change directories to the web server script location and run the start and stop scripts:

      3. cd /opt/SUNWwbsvr/https-HOSTNAME
      ./stop
      ./start

This completes the basic upgrade process. Your Sun ONE Identity Server 6.1 should be running with the directory and schema information from your previous installation. Access the Sun ONE Identity Server Administration console to verify that the upgrade process completed successfully.



Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.