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

ProcedureHow to Register and Configure Sun Cluster HA for N1 Service Provisioning System Master Server as a Failover Data Service

This procedure assumes that you installed the data service packages. Perform this procedure if you want to install the N1 Grid Service Provisioning System master server in the global zone.

If you did not install the Sun Cluster HA for N1 Service Provisioning System packages, go to Installing the Sun Cluster HA for N1 Service Provisioning System Packages.

  1. Become superuser or assume a role that provides solaris.cluster.verb RBAC authorization on one of the nodes in the cluster that will host N1 Grid Service Provisioning System Master Server.

  2. Prepare the parameter file, which is required by the Sun Cluster HA for N1 Service Provisioning System Master Server.


    Caution – Caution –

    The parameter files need to be available on every node that can host the N1 Grid Service Provisioning System Master Server data service. For a failover configuration store them on the shared storage. The parameter files cannot differ for a specific instance of N1 Grid Service Provisioning System Master Server on the various nodes. For a zone you must install it on the shared storage of this zone.



    # cd /opt/SUNWscsps/master/bin
    # cp pfile desired place
    

    Choose a location on the shared storage for the pfile. Edit the parameter file pfile and follow the comments within that file. For example:


    #!/usr/bin/ksh
    #
    # Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
    # Use is subject to license terms.
    #
    
    #ident   "@(#)pfile.ksh 1.2     06/03/17 SMI"
    
    # Set the Centerrun specific environment variables which the start, stop
    # and check fuctions will use
    #
    # User          Centerrun User
    # Basepath      Absolute path to N1 Grid Service Prosioning Systems Apache Basedir directory
    # Host          Hostname to test Apache Tomcat
    # Tport         Port where the N1 Grid Service Prosioning Systems Apache Tomcat instance
    #               is configured to listen
    # TestCmd       Apache Tomcat test command, this variable needs different contents, depending on
    #               your master server configuration.
    #               Your master server answers http request, configure:
    #               TestCmd="get /index.jsp"
    #               Your master server answers https request, configure:
    #               TestCmd="/index.jsp"
    # ReturnString  Use one of the strings below according to your N1 Grid Service Prosioning Systems
    #               Server Version.
    #               Version 4.1 and 5.x = SSL|Service
    # Startwait     Sleeping $Startwait seconds after completion of the
    #               start command
    # WgetPath      If the Master server is configured to answer https requests only, the absolute path
    #               to the wget command is needed here. Omit this variable if your master server answers
    #               on http requests.
    #               example: WgetPath=/usr/sfw/bin/wget
    #               Optional
    User=
    Basepath=
    Host=
    Tport=
    TestCmd="get /index.jsp"
    ReturnString="SSL|Service"
    Startwait=
    WgetPath=

    Note –

    If you configured your master server to answer https requests, you need to install a https capable wget. Follow the comments in the parameter file to configure the TestCmd variable.


    The following is an example for a N1 Grid Service Provisioning System 4.1 Master Server.


    User=sps
    Basepath=/global/sps/N1_Service_Provisioning_System_4.1
    Host=N1spsma-lh
    Tport=8080
    TestCmd="get /index.jsp"
    ReturnString="SSL|Service"
    Startwait=20
    WgetPath=

    This example is from an N1 Grid Service Provisioning System 4.1 Master Server. The Apache Tomcat is configured to listen on Port 8080. The default start page contains the string Service, or the string SSL if you configured it to respond on the SSL Port.

  3. Configure the registration scripts for each required N1 Grid Service Provisioning System Master Server instance.


    # cd /opt/SUNWscsps/master/util
    # cp spsma_config desired place
    

    Edit the spsma_config file and follow the comments within that file. For example:


    #
    # Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
    # Use is subject to license terms.
    #
    
    #ident   "@(#)spsma_config.ksh 1.2     06/03/17 SMI"
    
    # This file will be sourced in by spsma_register and the parameters
    # listed below will be used.
    #
    # These parameters can be customized in (key=value) form
    #
    #        RS - name of the resource for the application
    #        RG - name of the resource group containing RS
    #      PORT - name of the port number to satisfy GDS registration
    #        LH - name of the LogicalHostname SC resource
    #     PFILE - name of the parameter file for additional variables
    #    HAS_RS - name of the HAStoragePlus SC resource
    #
    # The following variables need to be set only if the agent runs in a
    # failover zone
    #
    #              ZONE - Zonename where the zsmf component should be registered
    #           ZONE_BT - Resource name of the zone boot component
    #           PROJECT - A project in the zone, that will be used for the PostgreSQL
    #                     smf service.
    #                     If the variable is not set it will be translated as :default for
    #                     the smf credentialss.
    #                     Optional
    #
    
    
    RS=
    RG=
    PORT=8080
    LH=
    PFILE=
    HAS_RS=
    
    # failover zone specific options
    
    ZONE=
    ZONE_BT=
    PROJECT=

    The following is an example for the Sun Cluster HA for N1 Service Provisioning System Master Server.


    RS=N1spsma-res
    RG=N1spsma-rg
    PORT=8080
    LH=N1spsma-lh
    PFILE=/global/mnt1/N1spsma-pfile
    HAS_RS=N1spsma-hastplus-res
    

    The PORT variable is needed to satisfy the requirements of the generic data service.

  4. After editing spsma_config register the resource.


    # ksh ./spsma_register -f desired_place/spsma_config
    Registration of resource N1spsma-rs succeeded
    Validate resource N1spsma-rs in resourcegroup spsma-rg
    Validation of resource spsma-rs succeeded
    #
  5. Enable each N1 Grid Service Provisioning System Master Server resource.


    # clresource status
    

    # clresource enable N1spsma-resource
    
  6. (Optional) Repeat Step 2 to Step 5 for each N1 Grid Service Provisioning System Master Server instance you need.