Sun Open Telecommunications Platform 2.0 Administration Guide

Upgrading Sun OTP Using Standard Upgrade

This section describes the procedure to upgrade Sun OTP using the standard upgrade method. It includes both the GUI and CLI procedures, and details about how to upgrade the remaining service and install the security service.

ProcedureTo Upgrade Sun OTP from 1.1 to Sun OTP 2.0 Using the GUI

Before You Begin

Upgrade Sun OTP 1.1 Provisioning Server to Version 2.0

  1. Open a browser and log in to the Sun OTP application provisioning service on the Sun OTP provisioning server.

    Go to URL https://install server:9090 where install server is either the IP address or the fully qualified name of the Sun OTP provisioning server.

  2. Type the user name and password.

    The user name is otpadmin. The password is the password provided in the password file while setting up the Sun OTP provisioning server.

  3. Click OTP Upgrade in the left panel.

  4. Set up the configuration for upgrade by creating two variable sets.

    Run this plan on all the Sun OTP hosts.

    1. Click Set up Configuration and click run.

    2. Click the select from list... option corresponding to the /com/sun/OTP/Utilities/OTPConfig directory.

    3. Click create set to create a new variable set.

    4. Type a new variable set name in the Set Name field.

    5. Click the check boxes for the appropriate plan variables for which you want to type the values.

    6. Type the values for the appropriate plan variables in the text fields. For description about the Sun OTP plan settings and the clustered Sun OTP host plan worksheet, see Appendix A Sun OTP Upgrade Plan Worksheet.


      Note –

      Do not specify the values for the zone-related variables and specify RAW for the spsRAConnectionType variable.


    7. Click save to save the variable set.

    8. Close the select variable setting from list... screen.

    9. Under variable settings, click the drop-down list corresponding to the /com/sun/OTP/Utilities/OTPConfig directory and choose the new variable set.

    10. Click select from list... corresponding to the /com/sun/OTPupgrade/Upgrade directory.

    11. Click create set to create a new variable set.

    12. Type a new variable set name in the Set Name field.

    13. Type the values for the following variables:

      logFile - Path of the log file that would contain the output of upgrade operation. For example, /var/OTP/OTPUpgrade.log.

      upgradeType - standard

    14. Click save to save the variable set.

    15. Close the select variable setting from list... screen.

    16. Under variable settings, click the drop-down list corresponding to the /com/sun/OTPupgrade/Upgrade directory and choose the new variable set.

    17. Type the host name in the target host field.

    18. Enter and confirm the password.

      The password is the password provided in the password file while setting up the Sun OTP provisioning server. The password can be 8 to 12 alphanumeric characters. You need to use this password and the user name otpadmin as the access credentials for all Sun OTP components including Web SSO.

    19. Click run plan (includes preflight).

  5. Back up the Sun OTP system management data.

    Run this plan only on the first Sun OTP host that is running the Sun OTP system management service.

    1. Click Backup Data and click run.

    2. Type the host name in the target host field.

    3. Click run plan (includes preflight).

  6. Upgrade the operating system.

    Run this plan on all the Sun OTP hosts.

    1. Click Upgrade OS and click run.

    2. Type the host name in the target host field.

    3. Click run plan (includes preflight).

      The plan is complete after initiating the patch upgrade process. You need to monitor the consoles on all the hosts and wait until the completion of patch upgrade cluster.

  7. Upgrade the Sun OTP high availability service.

    Run this plan on all the Sun OTP hosts.

    1. Click Upgrade HA Services and click run.

    2. Type the host name in the target host field.

    3. Click run plan (includes preflight).

  8. Upgrade the NEP application and the NEP application agent

    If a NFS agent is used as part of the hosted application, upgrade the NFS agent before activating Sun Cluster. You can upgrade the agents later too. For more details on upgrading Sun Cluster, see Chapter 8, Upgrading Sun Cluster Software, in Sun Cluster Software Installation Guide for Solaris OS.


    Note –

    The upgrade procedure is specific to the hosted application, and can be automated by NEP's end-to-end upgrade. See the application documentation for instructions.


  9. Activate the new cluster environment by rebooting all the Sun OTP hosts.

    /usr/sbin/init 6

  10. Perform the common steps for all types of upgrade. See Upgrade Remaining Services and Install the Security Service.

ProcedureTo Upgrade Remaining Services and Install the Security Service Using GUI

  1. Upgrade the Sun OTP application provisioning service.

    Run this plan simultaneously on all the Sun OTP hosts.

    1. Click OTP Upgrade in the left panel.

    2. Click Upgrade Provisioning Services.

    3. Type the host name in the target host field.

    4. Click run plan (includes preflight).

      Monitor the debug log in the /var/OTP/SUNWotp-debug.log file and wait until the reconfiguration of Sun OTP application provisioning service before running the next plan.

  2. Upgrade the Sun OTP system management service.

    Run this plan on all the Sun OTP hosts.

    1. Click Upgrade Management Service and click run.

    2. Type the host name in the target host field.

    3. Click run plan (includes preflight).

  3. Install the Sun OTP security service.

    Run this plan on all the Sun OTP hosts.

    1. Click OTP Setup in the left panel.

    2. Click Install Security Service and click run.

    3. Type the host name in the target host field.

    4. Click run plan (includes preflight).

  4. Configure the Sun OTP AHE components as highly available services.

    Run this plan only on the first Sun OTP host.

    1. Click Configure Components and click run.

    2. Type the host name in the target host field.

    3. Click run plan (includes preflight).

  5. Restore the Sun OTP system management data that was backed up.

    Run this plan only on the first Sun OTP host.

    1. Click OTP Upgrade in the left panel.

    2. Click Restore Data and click run.

    3. Type the host name in the target host field.

    4. Click run plan (includes preflight).

  6. Install Web SSO.

    Run this plan on all the Sun OTP hosts.

    1. Click OTP Setup in the left panel.

    2. Click Install WebSSO and click run.

    3. Type the host name in the target host field.

    4. Click run plan (includes preflight).

ProcedureTo Upgrade Sun OTP from 1.1 to 2.0 Using CLI

Before You Begin

Upgrade Sun OTP 1.1 Provisioning Server to Version 2.0

  1. Log in as root (su - root) to the Sun OTP provisioning server.

  2. Copy the input_otp.dat file to a NFS-mounted directory.

    cp /opt/SUNWotp/cli/templates/input_otp.dat /export/

  3. Edit the /export/input_otp.dat file to add the values for each variable.

    For description about the Sun OTP plan settings and the clustered Sun OTP host plan worksheet, see Appendix A Sun OTP Upgrade Plan Worksheet.


    Note –

    Do not specify the values for the zone-related variables and specify RAW for the spsRAConnectionType variable.


    For each host, specify the values for the following upgrade-related variables.

    h1_UpgradelogFile - Path of the log file that would contain the output of upgrade operation. For example, /var/OTP/OTPUpgrade.log.

    upgradeType - standard.

  4. Set up the configuration for upgrade.

    /opt/SUNWotp/cli/deploy_otp -u S -f /export/input_otp.dat -o "-P passwordfile"

    passwordfile is the absolute path of the password file. You can create this file in your home directory. The password file must contain a line with a valid password for all Sun OTP components. The password can be 8 to 12 alphanumeric characters. You need to use this password and the user name otpadmin as the access credentials for all Sun OTP components including Web SSO.

  5. Back up the Sun OTP system management data.

    /opt/SUNWotp/cli/deploy_otp -u b -f /export/input_otp.dat -o "-B hostname"

    hostname is the first host name that is running the Sun OTP system management service.

  6. Upgrade the operating system.

    /opt/SUNWotp/cli/deploy_otp -u P -f /export/input_otp.dat

    The command is complete after initiating the patch upgrade process. You need to monitor the consoles on all the hosts and wait until the completion of patch upgrade cluster.

  7. Upgrade the Sun OTP high availability service.

    /opt/SUNWotp/cli/deploy_otp -u a -f /export/input_otp.dat

  8. Upgrade the NEP application and the NEP application agent

    If a NFS agent is used as part of the hosted application, upgrade the NFS agent before activating Sun Cluster. You can upgrade the agents later too. For more details on upgrading Sun Cluster, see Chapter 8, Upgrading Sun Cluster Software, in Sun Cluster Software Installation Guide for Solaris OS.


    Note –

    The upgrade procedure is specific to the hosted application, and can be automated by NEP's end-to-end upgrade. See the application documentation for instructions.


  9. Activate the new cluster environment by rebooting all the Sun OTP hosts.

    /usr/sbin/init 6

  10. Perform the common steps for all the types of upgrade. See Upgrade Remaining Services and Install the Security Service .

ProcedureTo Upgrade Remaining Services and Install the Security Service Using CLI

  1. Upgrade the Sun OTP application provisioning service.

    /opt/SUNWotp/cli/deploy_otp -u p -f /export/input_otp.dat

    This command reconfigures the Sun OTP application provisioning service.

    When the command is complete, monitor the debug log in the /var/OTP/SUNWotp-debug.log file and wait until the reconfiguration of the Sun OTP application provisioning service.

  2. Upgrade the Sun OTP system management service.

    /opt/SUNWotp/cli/deploy_otp -u m -f /export/input_otp.dat

  3. Install the Sun OTP security service.

    /opt/SUNWotp/cli/deploy_otp -i s -f /export/input_otp.dat

  4. Configure the Sun OTP AHE components as highly available services.

    /opt/SUNWotp/cli/deploy_otp -c h -f /export/input_otp.dat

  5. Restore the Sun OTP system management data that was backed up.

    /opt/SUNWotp/cli/deploy_otp -u r -f /export/input_otp.dat -o "-R hostname"

    hostname is the first host name where Sun OTP system management data was backed up.

  6. Install Web SSO.

    /opt/SUNWotp/cli/deploy_otp --install websso --file /export/input_otp.dat