Sun Open Telecommunications Platform 2.0 Developer's Guide

ProcedureTo Install Sun OTP on a Clustered System

Before You Begin

Make sure that you complete the tasks described in Prerequisite Tasks for Sun OTP Installation.

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

    Go to the URL https://install server:9090 where install server is 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. Add Sun OTP hosts to the Sun OTP provisioning server. Repeat this step on each Sun OTP host.

    1. Click Host Setup in the left menu to display the Host Setup page.

    2. Click hosts in the central menu to display the hosts page.

    3. In the host field, type the name of the new Sun OTP host.

    4. (Optional) In the description field, type a description of the new Sun OTP host.

    5. Click create.

      The host details edit page is displayed.

    6. To include the remote agent, select the include remote agent on this physical host check box.

    7. Choose SSH (encrypted) or RAW from the connection type drop-down list.

      SSH (encrypted) is the recommended value.

    8. Type the host name in the ip address or name field.

    9. Type the appropriate entry according to the connection type.

      Figure 9–1 Add OTP Hosts to the Provisioning Server Screen

      Add OTP Hosts to the Provisioning Server Screen

      • If you chose SSH (encrypted) from the connection type drop-down list, type the following entry in the advanced parameters field.

        cprefix=/opt/SUNWn1sps-ra/N1_Service_Provisioning_System/agent,sshargs=-l|n1spsotp

      • If you chose RAW from the connection type drop-down list, type 7000 in the port field.

    10. Click add to host sets.

    11. Select com.sun.solaris#SolarisHostSet from the add host sets drop-down list.

    12. Click add host to selected host sets.

    13. Scroll to the bottom of the page and click save.

      The host preparation is in progress and Sun OTP host is added to the hosts list on the Sun OTP provisioning server.

    14. In the hosts page, click the name of the host that is added.

    15. Click update remote agent.

    16. After successful update, click prepare remote agent.

      The host is prepared for provisioning.

  4. (Optional but recommended) Create host sets.

    It is recommended to create two host sets. One host set will contain all the Sun OTP additional hosts in the cluster and the other host set will contain the previously created host set and the first cluster host.

    1. Click Host Setup.

    2. Click host sets to display the host sets page.

    3. Click create.

    4. Type the name of the host set in the host set field.

    5. Click select from list.

    6. Select the hosts that you want to add to the host set.


      Note –

      Select only the Sun OTP host names and not the zone host names.


    7. Click add hosts to main window.

    8. Click add host.

    9. Click save.

  5. Click OTP Setup to display the Sun Open Telecommunications Platform installation steps page.

  6. Configure Sun OTP installation plan variables. Repeat this step on each Sun OTP host.

    1. Click Setup Configuration and click run.

      The SetupConfig screen appears.

    2. Type the host name on which you want to install Sun OTP in the target host field.

    3. Enter the password for the otpadmin user in the Enter otpadmin password field.

    4. Confirm the password in the Confirm otpadmin password field.

    5. Click select from list under variable settings.

      The select variable setting from list... screen appears.

    6. At the bottom of the select variable setting from list... screen, click create set to create a new variable set.

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

    8. Click the check boxes for the appropriate plan variables for which you want to enter the values.

      Figure 9–2 Configure OTP Plan Variables Screen

      Configure OTP Plan Variables Screen

    9. Type the values for the appropriate plan variables in the text fields. Refer to Appendix A, Sun OTP Plan Worksheet to determine the values for these variables.

    10. Click save to save the variable set.

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

    12. In the SetupConfig screen, click the drop-down list under variable settings, and choose the new variable set.

    13. Click run plan (includes preflight).

  7. Install the OS patches on the additional Sun OTP hosts.

    1. Click Patch and click run.

      The Patch screen appears.

    2. Choose the additional cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

  8. Install the OS patches on the first Sun OTP host.

    1. Click Patch and click run.

      The Patch screen appears.

    2. Type the first Sun OTP host name in the target host field.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

      When the plan completes, wait for the first Sun OTP host to boot into multi-user mode.

  9. Install and configure the Sun OTP high availability service on the first Sun OTP host.

    1. Click Install Availability Service and click run.

      The InstallAvailability1 screen appears.

    2. Type the first Sun OTP host name in the target host field.

      Figure 9–3 Install Availability Service Screen

      Install Availability Service Screen

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

      When the plan completes, wait for the first Sun OTP host to reboot.

    4. Click Configure Availability Service and click run.

      The InstallAvailability2 screen appears.

    5. Type the first Sun OTP host name in the target host field.

    6. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

  10. Install and configure the Sun OTP high availability service on the additional Sun OTP hosts.

    1. Click Install Availability Service and click run.

      The InstallAvailability1 screen appears.

    2. Choose the additional cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

      When the plan completes, wait for the Sun OTP host to reboot.

    4. Click Configure Availability Service and click run.

      The InstallAvailability2 screen appears.

    5. Choose the additional cluster host set from the target host set drop-down list.

    6. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

  11. (Applicable for zones) Create and configure a non-global zone on all the Sun OTP hosts.

    1. Click Configure Solaris Containers and click run.

      The InstallZones screen appears.

      This step also installs the remote agent in the non-global zone.

    2. Choose the cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

  12. (Applicable for zones) Configure SSH for the remote agent in the newly created non-global zone on the Sun OTP host.


    Note –

    Perform this step only when you have chosen SSH (encrypted) connection type between Sun OTP application provisioning service master server and the remote agent.


    1. Log in to the non-global zone on the Sun OTP host.

      zlogin zonename

      Where zonename is the name of the non-global zone.

    2. Set a password for n1spsotp user.

    3. Log in as spsotp user (su - spsotp) on the Sun OTP provisioning server.

    4. Append the ssh public key of the spsotp user from the Sun OTP provisioning server to the authorized ssh keys located in the home directory of the n1spsotp user on each non-global zone on Sun OTP host.

      cat /var/otp/.ssh/id_rsa.pub | ssh n1spsotp@zonehostname "tee >> /export/home/n1spsotp/.ssh/authorized_keys2"

      where zonehostname is the zone host name of Sun OTP host.

  13. Create shared storage on the clustered Sun OTP system.

    The shared storage is used for high availability of Sun OTP system management service and Sun OTP application provisioning service. These services are installed on the shared storage. If one host fails, the shared storage is mounted onto the other host and services will be restarted.

    The shared storage will contain the otp-system-rg resource group.

    1. Click Setup Shared Storage and click run.

      The CreateSharedStorage screen appears.

      Ensure that the shared storage has at least 4 GB space.

    2. Click select from list... under variable settings.

      The select variable setting from list... screen appears.

    3. At the bottom of the select variable setting from list... screen, click create set to create a new variable set.

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

    5. Provide values for the following parameters:

      • rootDisk - Name of the root disk.

      • diskSlice - Name of the disk slice where Solaris Volume Manager (SVM) database is created.

      • mntPoint - Name of the mount point. The value must be /var/js.

      • diskGroup - Name of the disk group. For example, sm-dg.

      • hostList - List of all the Sun OTP hosts. Separate the host names by a colon. For example, hostname1:hostname2.

      • metasetDID - Name of the valid shared did. For example, d5.

        Type the command cldevice list -v to determine the shared did.

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

    7. In the CreateSharedStorage screen, click the drop-down list under variable settings, and choose the new variable set.

    8. Choose the cluster host set from the target host set drop-down list.

    9. Click run plan (includes preflight).

  14. Install and configure the Sun OTP system management service in the global zone on all the Sun OTP hosts.

    1. Click Install System Management Service and click run.

      The InstallManagement screen appears.

      Figure 9–4 Install System Management Service Screen

      Install System Management Service Screen

    2. Choose the cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

  15. Install and configure the Sun OTP application provisioning service in the global zone on all the Sun OTP hosts.

    1. Click Install Provisioning Service and click run.

      The InstallProvisioning screen appears.

    2. Choose the cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

  16. (Applicable for zones) Update and prepare the new zone host with the Sun OTP provisioning server.

    1. Click Host Setup in the left panel.

    2. Click hosts.

    3. In the hosts page, click the name of the host that is added.

    4. Click update remote agent.

    5. After successful update, click prepare remote agent.

  17. (Applicable for zones) Configure Sun OTP installation plan variables for the new zone host.

    1. Click OTP Setup to display the Sun Open Telecommunications Platform installation steps page.

    2. Click Setup Configuration and click run.

    3. Choose the same variable set that you chose in Step 6.

    4. Type the zone host name in the target host field.

    5. Click run plan (includes preflight).

  18. Install and configure the Sun OTP security service on all the Sun OTP hosts.

    1. Click Install Security Service and click run.

      The InstallSecurity screen appears.

      Figure 9–5 Install Security Service Screen

      Install Security Service Screen

    2. Choose the cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.

  19. Configure and enable high availability for Sun OTP services on all the Sun OTP hosts.

    1. Click Configure Components and click run.

      The Configure screen appears.

      This step creates and starts resource groups for Sun OTP system management service, Sun OTP application provisioning service, and Sun OTP security service. This step also configures and starts master-to-master replication (MMR).

    2. Choose the cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).

      The page is reloaded and a progress bar is displayed during the process.


      Note –

      Self-contained Sun OTP provisioning server uses a specific logical host name and IP address defined at the beginning of the Sun OTP installation. However, to make Sun OTP application provisioning service highly available, the server is moved to a different logical host name (logical host name for management and provisioning services) at the end of this plan. After this plan is finished, this new logical host name has to be used to access the Sun OTP provisioning server.


  20. Install Web SSO.


    Note –

    When you install Sun OTP through GUI installation from a self-contained Sun OTP provisioning server, you need to verify the completion status of the previous plan (Configure and Enable HA plan) through the /var/OTP/SUNWotp.log file before running the Install Web SSO plan. The file must have the line that reads “enableHA - COMPLETED”.


    1. Click Install Web SSO and click run.

      The InstallWebSSO screen appears.

    2. Choose the cluster host set from the target host set drop-down list.

    3. Click run plan (includes preflight).


    Note –

    Monitor the /var/OTP/SUNWotp-debug.log file to check whether the resource group otp-system-rg has been restarted. If the resource group has not been restarted, restart the resource group manually by typing the following command on any host of the cluster.

    /usr/cluster/bin/clrg online otp-system-rg


    The installation log files, input files generated for the plans, installation registry information, and the debug log files are stored in the /var/OTP directory.

See Also

On a two-host cluster, if you chose no for quorumAutoConfiguration during variable set creation, you must manually select and configure the quorum disk as described in To Configure the Quorum Disk on a Two-Host Cluster.