test

Sun N1 Service Provisioning System User's Guide for SAP Plug-In 1.0

Creating and Managing SAP Central Instances

The Common Tasks page of the software enables you to create and manage SAP Central Instances.

This section describes the following tasks:

ProcedureHow to Create an SAP Central Instance

This task creates the SAP Central Instance component.

Note –

This task is a markOnly task.

Steps

  1. In the Common Tasks section of the N1 SPS browser interface, click SAP.

  2. In the SAP Central Instance section of the SAP Tasks page, click Create.

  3. Click Run.

  4. In the Plan Parameters table, select the variable settings for the CentralInstance component.

    • If the variable settings have been created for this component, select the appropriate settings from the drop-down menu.

    • If the variable settings are not available from the drop-down menu:

      1. Click Select From List.

        The Select Variable Settings From List window displays.

        • To create a new variable settings set, click Create Set and type a Set Name.

          The following list provides commonly updated variables for the CentralInstance component. To create a value for the component variable, click the check box in the component variable's row.

          Note –

          For information about component variables ending in UserExit, see User Exits.

          groupName

          This is a required field.

          Note –

          In the Sun Cluster environment, the groupName must equal the Sun Cluster resource group name.

          groupDescription

          Description of the group.

          resourceName

          Required for the Sun Cluster environment. The resourceName must equal the Sun Cluster resource name for the Sun Cluster envType.

          envType

          Identifies if this component will be deployed to a Default, Sun Cluster, or SAP AC environment. Value can be ac, sc, or default.

          createdBy

          Identifies the installer of the component.

          ciLhName

          Required field. Logical host name for the SAP Central Instance.

          sapSid

          Required field. The SAP system ID consists of three uppercase alphanumeric characters. The first character must be alphabetic.

          systemInstanceNumber

          Required field. The SAP Central Instance number consists of two digits.

          accServiceID

          Required for the SAP AC environment. The service ID of the SAP Central Instance (only applicable in the SAP AC environment).

          srmProject

          The Solaris Resource Management (SRM) project name. Default value: default.

      2. Click Save.

    • To use component variables from another component, click Import Set.

      For more information about importing variable sets, see How to Run a Plan in Sun N1 Service Provisioning System 5.2 Operation and Provisioning Guide.

  5. Select a target host or target host set.

  6. Click the Run Plan (Includes Preflight) button.

    The Deployment Results page is displayed. If the plan fails, error messages are displayed.

    Note –

    There is no code verification to enforce the required fields for the Sun Cluster and SAP AC environments when the components are created in the Sun N1 Service Provisioning System.

ProcedureHow to Delete an SAP Central Instance

This task deletes the SAP Central Instance component in the SPS database. It does not delete anything at the OS level.

Note –

This task is a markOnly task.

Steps

  1. In the Common Tasks section of the N1 SPS browser interface, click SAP.

  2. In the SAP Central Instance section of the SAP Tasks page, click Delete.

  3. Click Run.

  4. Select a target host or target host set.

  5. Provide the plan variable.

    Install path where the Central Instance is installed

    This is a required field. If you do not know the install path, return to the SAP Tasks page and click the View All link.

  6. Click the Run Plan (Includes Preflight) button.

    The Deployment Results page is displayed. If the plan fails, error messages are displayed.

ProcedureHow to Start an SAP Central Instance

Prior to starting the SAP Central Instance, the plug-in does not check any dependencies. After the startup, the plug-in verifies that the main processes are running. The main processes for the SAP Central Instance are:

The plug-in starts the SAP CI instance by calling the SAP script startsap_DVEBMGS_instance-num_logical-host. If the default installation did not create this script, you need to create this script manually in the home directory of user sidadm.

Steps

  1. In the Common Tasks section of the N1 SPS browser interface, click SAP.

  2. In the SAP Central Instance section of the SAP Tasks page, click Start.

  3. Click Run.

  4. Select a target host or target host set.

  5. Provide the plan variables.

    Install path of the Central Instance component

    This is a required field. If you do not know the install path, return to the SAP Tasks page and click the View All link.

    Force start the SAP Central Instance

    This option is required when the target host does not meet the SAPS requirement to start the SAP instance. See the SAP installation guide for minimum requirements for starting the SAP instance.

    Note –

    This is only applicable in the SAP AC environment.

  6. Click the Run Plan (Includes Preflight) button.

    The Deployment Results page is displayed. If the plan fails, error messages are displayed.

ProcedureHow to Stop an SAP Central Instance

If the SAP component is offline, the plan will complete successfully without any further action. If the SPS component is not offline, the plan stops the SAP component. If a normal stop fails and you have selected the Force Stop option, the plan will perform a hard stop by killing the main processes. The plan then verifies that the SAP component is offline. If it is, the plan completes successfully. If the SAP component is not offline, the plan fails. The processes used to determine the status are:

The plug–in stops the SAP CI instance by calling the SAP script stopsap_DVEBMGS_instance-num–logical-host.

Steps

  1. In the Common Tasks section of the N1 SPS browser interface, click SAP.

  2. In the SAP Central Instance section of the SAP Tasks page, click Stop.

  3. Click Run.

  4. Select a target host or target host set.

  5. Provide the plan variables.

    Install path of the Central Instance component

    This is a required field. If you do not know the install path, return to the SAP Tasks page and click the View All link.

    Force stop SAP Central Instance after the graceful stop failed in the default environment

    This option is selected by default. In SC and AC environments, the corresponding Sun Cluster command or SAP AC command is called to start the component.

  6. Click the Run Plan (Includes Preflight) button.

    The Deployment Results page is displayed. If the plan fails, error messages are displayed.

ProcedureHow to View All SAP Central Instances

Steps

  1. In the Common Tasks section of the N1 SPS browser interface, click SAP.

  2. In the SAP Central Instance section of the SAP Tasks page, click View All.

    The Hosts Where Installed table is displayed.

ProcedureHow to Check the Online Status of SAP Central Instances

If the main processes are present on the system, the resource is considered online. If any of the main processes are not present on the system, the plug-in identifies the resource as offline.

The main processes are:

Steps

  1. In the Common Tasks section of the N1 SPS browser interface, click SAP.

  2. In the SAP Central Instance section of the SAP Tasks page, click Online Status.

  3. Provide the plan variable.

    Install path of the SAP Central Instance component

    This is a required field. If you do not know the install path, return to the SAP Tasks page and click the View All link.

  4. Click the Run Plan (Includes Preflight) button.

    The Deployment Results page is displayed. If the plan fails, error messages are displayed.

ProcedureHow to Check the Offline Status of SAP Central Instances

If the main processes are present on the system, the resource is considered online. If any of the main processes are not present on the system, the plug-in identifies the resource as offline.

The main processes are:

Steps

  1. In the Common Tasks section of the N1 SPS browser interface, click SAP.

  2. In the SAP Central Instance section of the SAP Tasks page, click Offline Status.

  3. Provide the plan variable.

    Install path of the SAP Central Instance component

    This is a required field. If you do not know the install path, return to the SAP Tasks page and click the View All link.

  4. Click the Run Plan (Includes Preflight) button.

    The Deployment Results page is displayed. If the plan fails, error messages are displayed.