test

Sun Cluster Data Service for N1 Grid Service Provisioning System for Solaris OS

Appendix A Deployment Example: Installing N1 Grid Service Provisioning System in the Global Zone

This appendix presents a complete example of how to install and configure the N1 Grid Service Provisioning System application and data service in the global zone. It presents a simple two-node cluster configuration. If you need to install the application in any other configuration, refer to the general-purpose procedures presented elsewhere in this manual. For an example of N1 Grid Service Provisioning System installation in a non-global failover zone zone, see Appendix B, Deployment Example: Installing N1 Grid Service Provisioning System in the Failover Zone or for a non-global zone see Appendix C, Deployment Example: Installing N1 Grid Service Provisioning System in the Zone according to your zone type.

Target Cluster Configuration

This example uses a two-node cluster with the following node names:

This configuration also uses the logical host name ha-host-1.

Software Configuration

This deployment example uses the following software products and versions:

This example assumes that you have already installed and established your cluster. It illustrates installation and configuration of the data service application only.

Note –

The steps for installing N1 Grid Service Provisioning System in a cluster that runs on Solaris version 9 OS are identical to the steps in this example.

Assumptions

The instructions in this example were developed with the following assumptions:

Installing and Configuring N1 Grid Service Provisioning System Master Server on Shared Storage in the Global Zone

The tasks you must perform to install and configure N1 Grid Service Provisioning SystemMaster Server in the global zone are as follows:

ProcedureExample: Preparing the Cluster for N1 Grid Service Provisioning System Master Server

  1. Install and configure the cluster as instructed in Sun Cluster Software Installation Guide for Solaris OS.

    Install the following cluster software components on both nodes.

    • Sun Cluster core software

    • Sun Cluster data service for N1 Grid Service Provisioning System

  2. Beginning on the node that owns the file system, add the sps user. 


    phys-schost-1# groupadd -g 1000 sps
phys-schost-2# groupadd -g 1000 sps
phys-schost-1# useradd -g 1000 -d /global/mnt3/sps -m -s /bin/ksh sps
phys-schost-2# useradd -g 1000 -d /global/mnt3/sps -m -s /bin/ksh sps

ProcedureExample: Configuring Cluster Resources for N1 Grid Service Provisioning System Master Server

  1. Register the necessary data types on one node.


    phys-schost-1# clresourcetype register SUNW.gds SUNW.HAStoragePlus

  2. Create the N1 Grid Service Provisioning System resource group. 


    phys-schost-1# clresourcegroup create RG-SPSMA

  3. Create the logical host.


    phys-schost-1# clreslogicalhostname create -g RG-SPSMA ha-host-1

  4. Create the HAStoragePlus resource in the RG-SPSMA resource group.


    phys-schost-1# clresource create -g RG-SPSMA -t SUNW.HAStoragePlus -p AffinityOn=TRUE \
-p FilesystemMountPoints=/global/mnt3,/global/mnt4 RS-SPSMA-HAS

  5. Enable the resource group.


    phys-schost-1# clresourcegroup online -M RG-SPSMA

ProcedureExample: Installing the N1 Grid Service Provisioning System Master Server Software on Shared Storage

These steps illustrate how to install the N1 Grid Service Provisioning System software. As long as only one node is mentioned it needs to be the node where your resource group is online.

  1. Prepare the shared memory of the default project on both nodes. 


    phys-schost-1# projmod -a -K "project.max-shm-memory=(priv,536870912,deny)" default
phys-schost-2# projmod -a -K "project.max-shm-memory=(priv,536870912,deny)" default
    Note –

    This example is valid for Solaris 10 only. Use appropriate methods on Solaris 9.

  2. Install the N1 Grid Service Provisioning System binaries on one node.


    phys-schost-1# cd /installation_directory
phys-schost-1# ./cr_ms_solaris_sparc_pkg_5.2.sh

    Answer on the following cluster relevant questions as follows:


    • What base directory ...
default: /opt/SUNWn1sps) [<directory>] /global/mnt3/sps


    • Which user will own the N1 SPS Master Server distribution?
(default: n1sps) [<valid username>] sps


    • Which group on this machine will own the
N1 SPS Master Server distribution?
(default: n1sps) [<valid groupname>] sps


    • What is the hostname or IP address for this Master Server?
(default: phys-schost-1) ha-host-1

    For all the other values, you can accept the defaults, or chose appropriate values. For the simplicity of this example we assume the default values of all port values.

  3. Start the master server as user sps.


    phys-schost-1# su - sps
phys-schost-1$ cd /global/mnt3/sps/N1_Service_Provisioning_System_5.2/server/bin
phys-schost-1$ ./cr_server start

  4. Prepare the PostgreSQL database for monitoring


    phys-schost-1$ cd /opt/SUNWscsps/master/util
phys-schost-1$ ksh ./db_prep_postgres \
> /global/mnt3/sps/N1_Service_Provisioning_System_5.2

  5. Stop the master server and leave the user sps.


    phys-schost-1$ cd /global/mnt3/sps/N1_Service_Provisioning_System_5.2/server/bin
phys-schost-1$ ./cr_server stop

ProcedureExample: Modifying the N1 Grid Service Provisioning System Master Server Configuration and Parameter Files

  1. Copy the N1 Grid Service Provisioning System configuration file from the agent directory to its deployment location. 


    phys-schost-1# cp /opt/SUNWscsps/master/util/spsma_config /global/mnt3
phys-schost-1# cp /opt/SUNWscsps/master/bin/pfile /global/mnt3

  2. Add this cluster's information to the spsma_config configuration file.

    The following listing shows the relevant file entries and the values to assign to each entry. 


    .
.
.
RS=RS-SPSMA
RG=RG-SPSMA
PORT=8080
LH=ha-host-1
PFILE=/global/mnt3/pfile
HAS_RS=RS-SPSMA-HAS

  3. Save and close the file.

  4. Add this cluster's information to the parameter file pfile.

    The following listing shows the relevant file entries and the values to assign to each entry. 


    .
.
.
User=sps
Basepath=/global/mnt3/sps/N1_Service_Provisioning_System_5.2
Host=ha-host-1
Tport=8080
TestCmd="get /index.jsp"
ReturnString="SSL|Service"
Startwait=20
WgetPath=

  5. Save and close the file.

ProcedureExample: Enabling the N1 Grid Service Provisioning System Master Server Software to Run in the Cluster

  1. Run the spsma_register script to register the resource. 


    phys-schost-1# ksh /opt/SUNWscsps/master/util/spsma_register \
-f /global/mnt3/spsma_config

  2. Enable the resource.


    phys-schost-1# clresource enable RS-SPSMA

Installing and Configuring N1 Grid Service Provisioning System Remote Agent on Shared Storage in the Global Zone

The tasks you must perform to install and configure N1 Grid Service Provisioning System Remote Agent in the global zone are as follows:

ProcedureExample: Preparing the Cluster for N1 Grid Service Provisioning System Remote Agent

  1. Install and configure the cluster as instructed in Sun Cluster Software Installation Guide for Solaris OS.

    Install the following cluster software components on both nodes.

    • Sun Cluster core software

    • Sun Cluster data service for N1 Grid Service Provisioning System

  2. Beginning on the node that owns the file system, add the sps user. 


    phys-schost-1# groupadd -g 1000 sps
phys-schost-2# groupadd -g 1000 sps
phys-schost-1# useradd -g 1000 -d /global/mnt3/sps -m -s /bin/ksh sps
phys-schost-2# useradd -g 1000 -d /global/mnt3/sps -m -s /bin/ksh sps

ProcedureExample: Configuring Cluster Resources for N1 Grid Service Provisioning System Remote Agent

  1. Register the necessary data types on one node.


    phys-schost-1# clresourcetype register SUNW.gds SUNW.HAStoragePlus

  2. Create the N1 Grid Service Provisioning System resource group. 


    phys-schost-1# clresourcegroup create RG-SPSRA

  3. Create the logical host.


    phys-schost-1# clreslogicalhostname create -g RG-SPSRA ha-host-1

  4. Create the HAStoragePlus resource in the RG-SPSRA resource group.


    phys-schost-1# clresource create -g RG-SPSRA -t SUNW.HAStoragePlus -p AffinityOn=TRUE \
> -p FilesystemMountPoints=/global/mnt3,/global/mnt4 RS-SPSRA-HAS

  5. Enable the resource group.


    phys-schost-1# clresourcegroup online -M RG-SPSRA

ProcedureExample: Installing the N1 Grid Service Provisioning System Remote Agent Software on Shared Storage

These steps illustrate how to install the N1 Grid Service Provisioning System software. As long as only one node is mentioned it needs to be the node where your resource group is online.

    Install the N1 Grid Service Provisioning System binaries on one node.


    phys-schost-1# cd /installation_directory
phys-schost-1# ./cr_ra_solaris_sparc_5.2.sh

    Answer on the following cluster relevant questions as follows:


    • What base directory ...
default: /opt/SUNWn1sps) [<directory>] /global/mnt3/sps


    • Which user will own the N1 SPS Remote Agent distribution?
(default: n1sps) [<valid username>] sps


    • Which group on this machine will own the
N1 SPS Remote Agent distribution?
(default: n1sps) [<valid groupname>] sps


    • What is the hostname or IP address of the interface on which the
Agent will run?
(default: phys-schost-1) ha-host-1

    For all the other values, you can accept the defaults, or chose appropriate values. For the simplicity of this example we assume the default values of all port values.

ProcedureExample: Modifying the N1 Grid Service Provisioning System Remote Agent Configuration File

  1. Copy the N1 Grid Service Provisioning System configuration file from the agent directory to its deployment location. 


    phys-schost-1# cp /opt/SUNWscsps/remoteagent/util/spsra_config /global/mnt3

  2. Add this cluster's information to the spsra_config configuration file.

    The following listing shows the relevant file entries and the values to assign to each entry. 


    .
.
.
RS=RS-SPSRA
RG=RG-SPSRA
PORT=8080
LH=ha-host-1
USER=sps
BASE=/global/mnt3/sps/N1_Service_Provisioning_System
HAS_RS=RS-SPSRA-HAS

  3. Save and close the file.

ProcedureExample: Enabling the N1 Grid Service Provisioning System Remote Agent Software to Run in the Cluster

  1. Run the spsra_register script to register the resource. 


    phys-schost-1# ksh /opt/SUNWscsps/remoteagent/util/spsra_register \
> -f /global/mnt3/spsra_config

  2. Enable the resource.


    phys-schost-1# clresource enable RS-SPSRA

Installing and Configuring N1 Grid Service Provisioning System Local Distributor on Shared Storage in the Global Zone

The tasks you must perform to install and configure N1 Grid Service Provisioning System Local Distributor in the global zone are as follows:

ProcedureExample: Preparing the Cluster for N1 Grid Service Provisioning System Local Distributor

  1. Install and configure the cluster as instructed in Sun Cluster Software Installation Guide for Solaris OS.

    Install the following cluster software components on both nodes.

    • Sun Cluster core software

    • Sun Cluster data service for N1 Grid Service Provisioning System

  2. Beginning on the node that owns the file system, add the sps user. 


    phys-schost-1# groupadd -g 1000 sps
phys-schost-2# groupadd -g 1000 sps
phys-schost-1# useradd -g 1000 -d /global/mnt3/sps -m -s /bin/ksh sps
phys-schost-2# useradd -g 1000 -d /global/mnt3/sps -m -s /bin/ksh sps

ProcedureExample: Configuring Cluster Resources for N1 Grid Service Provisioning System Local Distributor

  1. Register the necessary data types on one node.


    phys-schost-1# clresourcetype register SUNW.gds SUNW.HAStoragePlus

  2. Create the N1 Grid Service Provisioning System resource group. 


    phys-schost-1# clresourcegroup create RG-SPSLD

  3. Create the logical host.


    phys-schost-1# clreslogicalhostname create -g RG-SPSLD ha-host-1

  4. Create the HAStoragePlus resource in the RG-SPSLD resource group.


    phys-schost-1# clresource create -g RG-SPSLD -t SUNW.HAStoragePlus -p AffinityOn=TRUE \
> -p FilesystemMountPoints=/global/mnt3,/global/mnt4 RS-SPSLD-HAS

  5. Enable the resource group.


    phys-schost-1# clresourcegroup online -M RG-SPSLD

ProcedureExample: Installing the N1 Grid Service Provisioning System Local Distributor Software on Shared Storage

These steps illustrate how to install the N1 Grid Service Provisioning System software. As long as only one node is mentioned it needs to be the node where your resource group is online.

    Install the N1 Grid Service Provisioning System binaries on one node.


    phys-schost-1# cd /installation_directory
phys-schost-1# ./cr_ld_solaris_sparc_5.2.sh

    Answer on the following cluster relevant questions as follows:


    • What base directory ...
default: /opt/SUNWn1sps) [<directory>] /global/mnt3/sps


    • Which user will own the N1 SPS Local Distributor distribution?
(default: n1sps) [<valid username>] sps


    • Which group on this machine will own the
N1 SPS Local Distributor distribution?
(default: n1sps) [<valid groupname>] sps


    • What is the hostname or IP address of this machine?
(default: phys-schost-1) ha-host-1

    For all the other values, you can accept the defaults, or chose appropriate values. For the simplicity of this example we assume the default values of all port values.

ProcedureExample: Modifying the N1 Grid Service Provisioning System Local Distributor Configuration File

  1. Copy the N1 Grid Service Provisioning System configuration file from the agent directory to its deployment location. 


    phys-schost-1# cp /opt/SUNWscsps/localdist/util/spsld_config /global/mnt3

  2. Add this cluster's information to the spsld_config configuration file.

    The following listing shows the relevant file entries and the values to assign to each entry. 


    .
.
.
RS=RS-SPSLD
RG=RG-SPSLD
PORT=8080
LH=ha-host-1
USER=sps
BASE=/global/mnt3/sps/N1_Service_Provisioning_System
HAS_RS=RS-SPSLD-HAS

  3. Save and close the file.

ProcedureExample: Enabling the N1 Grid Service Provisioning System Local Distributor Software to Run in the Cluster

  1. Run the spsra_register script to register the resource. 


    phys-schost-1# ksh /opt/SUNWscsps/localdist/util/spsld_register \
> -f /global/mnt3/spsld_config

  2. Enable the resource.


    phys-schost-1# clresource enable RS-SPSLD