test

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

Chapter 3 Installing and Configuring the SAP Plug-In

This chapter explains how to install and configure the SAP plug-in. This chapter discusses the following topics:

Before Installing the SAP Plug-In

The general tasks you need to do before installing the SAP plug-in are:

  1. Install the SPS Master Server (MS), Remote Agent (RA), and Command Line Interface (CLI) on the Master Server host.

    For more information, see the Sun N1 Service Provisioning System 5.2 Installation Guide.

  2. Install the SPS Remote Agent (RA) on all SAP machines and prepare them.

    For more information, see Non-Interactive Installation of a Remote Agent on Linux and UNIX Systems in Sun N1 Service Provisioning System 5.2 Installation Guide.

  3. Install all SAP central instances and Oracle databases.

    Note –

    Make sure they are virtualized.

    For more information, see the SAP HA Switchover Document for an overview of virtualization and How to Enable Failover SAP Instances to Run in a Cluster in Sun Cluster Data Service for SAP Guide for Solaris OS.

  4. For instances that are under the control of Sun Cluster, perform the following steps:

    1. Ensure that the clusters are installed and set up correctly.

    2. Ensure that all Sun Cluster data services are installed.

    3. Ensure that all Sun Cluster resource groups and resources are set up correctly.

    For more information, see Sun Cluster Software Installation Guide for Solaris OS.

  5. For instances that are under the control of SAP AC, make sure the server is installed and set up correctly.

  6. Although the following items can be managed locally on the file system, they should be managed by NIS, NIS+, or LDAP.

    • Update all SAP machines' /etc/services file with port information for all SAP instances.

    • Ensure that all SAP users, (sidadm) are present on the system. Users are defined locally in /etc/password.

    • Ensure that all logical host names are present on the system. Logical host are defined in /etc/hosts.

    • Group information must be maintained. Groups are defined in /etc/group.

    • An appropriate project must be created for each resource. See the project(4) man page for more details on the project file and related information on creating a project.

  7. Directories for SAP must be present on the servers. You can create these directories in one of the following methods:

    • Use the plug-in nfsshare or nfsmount components

    • Mount manually through NFS

    • Create the directories manually on each target servers

    • Use automounter

      Note –

      Management of the automounter map is required.

Acquiring the SAP Plug-In

Acquiring the SAP plug-in is a two-step process. First, you must add the package file that contains the SAP plug-in JAR file to your system. Then you must import the SAP plug-in JAR file.

The SAP plug-in is packaged as a plug-in to the Sun N1 Service Provisioning System software. The plug-in files for the SAP plug-in are available from the Sun N1 Service Provisioning System 5.2 Supplement CD or from the Sun Download Center.

  1. Add the file containing the JAR file:

  2. Import the JAR file - Importing the SAP Plug-In.

Adding the SAP Plug-In for Solaris

The SAP plug-in is contained in the SUNWspssap package.

ProcedureTo Add the SAP Plug-In Package for Solaris

Steps

  1. Log in to Master Server.

  2. Become superuser.

  3. Move to the directory containing the plug-in package.

  4. Type the following command and press Return.

    # pkgadd -d package_directory SUNWspssap

    The JAR file is in the /opt/SUNWn1sps/plugins/com.sun.sap/ directory.

Importing the SAP Plug-In

To make a given plug-in known to the Sun N1 Service Provisioning System product, you need to import the plug-in.

To import a plug-in, follow these steps as explained in detail in Chapter 5, Plug-In Administration, in Sun N1 Service Provisioning System 5.2 System Administration Guide.

ProcedureHow to Import the SAP Plug-In Using the Browser Interface

Steps

  1. In the Administrative section of the browser interface main window, click Plug-ins.

  2. In the Action Column of the Plug-ins page, click Import.

  3. Click the Browse button and navigate to the location of the JAR file.

  4. Select the JAR file and click Open.

  5. Click the Continue to Import button.

    When the import completes successfully, a plug-in details page appears and shows you the objects that the plug-in provides.

ProcedureHow to Import the SAP Plug-In Using the CLI

You can also import a plug-in archive file by using the command line.

Step

    To import a plug-in file from the CLI, type:


    % cr_cli -cmd plg.p.add -path plugin-filename -u username -p password

Customizing the Solution for Your Environment

After the plug-in is imported, perform the following steps:

ProcedureHow to Configure the Master Server

These steps should be performed prior to importing the SAP plug-in.

Steps

  1. Review the ReadMe.txt file to make sure that all configuration tasks have been completed.

  2. Create session variables.

    These variables are used when maintaining SAP instances in the SAP AC environment and creating SAP users or logical hosts in LDAP.

    • SAP_DEFAULT_AC_ADMIN_PASSWORD

    • SAP_DEFAULT_AC_ADMIN_USER

    • SAP_DEFAULT_AC_PORT

    • SAP_DEFAULT_AC_SERVER

    • AUTHENTICATE_ACC_SERVER_CERT

    For more information about session variables, see How to Create Session Variables.

  3. Create a virtual host with the Master Server as its parent.

    This is created for the purpose of running the SPS CLI.

    Note –

    If virtual host cliHost exists and its host type is com.sun.was#cliHT, do not create another cliHost.

    For more information, see Virtual Hosts in Sun N1 Service Provisioning System 5.2 System Administration Guide.

    1. In the Host Setup section of the browser interface main window, click Hosts.

    2. Type cliHost in the Host field.

    3. Select the com.sun.sap#cliHT host type.

    4. Click Create.

    5. Select the Virtual Host option.

    6. Modify the cliLoc attribute to the fully qualified path of the CLI.

      For example, /SPS–INSTALL–PATH/cli/bin/cr_cli.

    7. Set the Master Server as the Virtual Host parent.

      1. Click the Select From List link.

      2. Select the host from the Current Found Host list.

      3. Click Add Host to Main Window.

    8. Click Save.

  4. Add the following lines to the /SPS–INSTALL–PATH//server/config/config.properties file:


    config.allowSessionIDOnHosts=masterserver
pe.defaultPlanTimeout=6000
pe.nonPlanExecNativeTimeout=2400

    The config.allowSessionIDOnHosts line lets the plug-in communicate with the Master Server through the Sun N1 Service Provisioning System Remote Agent/CLI interface.

    The pe.defaultPlanTimeout line is in seconds. Add this line if your site needs to increase the default plan from its 30 minute, 1800 second, value.

    The pe.nonPlanExecNativeTimeout line is in seconds. Add this line if your site needs to increase the time for execNative time outs.

    The config.properties file is in the SPS–INSTALL–PATH/server/config directory.

  5. Restart the Master Server after the changes have been made to the config.properties file.

ProcedureHow to Create Session Variables

Repeat this procedure for each session variable that you create.

Before You Begin

Session variables need to be set only if you have an SAP AC environment and you intend to administer components by using this plug-in.

Steps

  1. From the Common Tasks page, click the Session Variables link.

  2. Click the Create link.

  3. Create the session variable.

    1. Type the session variable name.

    2. (Optional) Select the Display As Password check box.

    3. (Optional) Type a description.

    4. Type the value of the session variable.

    5. Type the admin user password.

  4. Click Save.

After Installing the SAP Plug-In

After you have installed the SAP plug-in, perform the tasks in this section.

ProcedureHow To Create SAP Hosts

Steps

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

  2. Click Create.

  3. Type the host name.

  4. Set the Host Type to com.sun.sap#SAPHT.

  5. Type a comma-delimited list of the environment types that can exist on this Remote Agent in the envType field.

  6. (Optional) Type the SAPS value.

  7. Select the Include Remote Agent on This Physical Host check box.

  8. Select a connection type.

  9. Type the IP address or name.

  10. Type a port number.

  11. Click Save.

    For more information, see Chapter 2, Managing Hosts, Host Types, Host Sets, and Host Searches, in Sun N1 Service Provisioning System 5.2 System Administration Guide.

ProcedureHow To Create the Post Installation Environment

The following should be performed to establish the environment for the SAP plug-in:

Before You Begin

Create SAP Hosts. For more information, see How To Create SAP Hosts.

Steps

  1. Prepare the Master Server and Remote Agents.

    For more information, see How to Prepare a Physical Host in Sun N1 Service Provisioning System 5.2 System Administration Guide.

  2. Perform any of the Utilities for SAP group tasks, as necessary.

  3. Create a group component.

    Other components set dependency on the group component.

    For more information, see Creating and Managing Groups.

  4. Add a logical host component to the group.

    For more information, see Creating and Managing Logical Hosts

  5. Add a storage management component to the group for groups that also contain an SAP Central Instance or database components.

    For more information, see Creating and Managing HA Storage Devices.

  6. Add an NFS share component to the group for groups that also contain an SAP Central Instance or database components.

    For more information, see Sharing and Managing Network File Systems.

  7. Add a Central Instance or Oracle component to the group.

    For more information, see Creating and Managing SAP Central Instances or Creating and Managing Oracle Databases.

  8. Add an NFS Mount component for groups that also contain SAP Application Server.

    See Mounting and Managing Network File Systems.

Deleting the SAP Plug-In

This section describes how to delete a plug-in from the Sun N1 Service Provisioning System. For more information, see Deleting Plug-Ins in Sun N1 Service Provisioning System 5.2 System Administration Guide.

ProcedureHow to Delete the SAP Plug-In

Steps

  1. Delete all objects created by all versions of the plug-in.

    These objects include the system services that are installed automatically when a host is prepared.

  2. In the Common Tasks section of the N1 SPS browser interface, click Plans.

  3. Navigate to the RemoveSAPSystemServicePlan plan.

  4. Click the Details link.

  5. Click Run.

  6. Select target host or target host set.

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

ProcedureHow to Delete the SAP Plug-In From the Command Line

Step

    From the CLI directory, type the following command.


    ./cr_cli -cmd plg.p.del -ID plugin-ID -u admin -p password

    For example, ./cr_cli -cmd plg.p.del -ID 010011242111-1146106455699-00215-1170512625 -u admin -p admin

Patching the SAP Plug-In

Check the SunSolve site for available patches for the SAP plug-in. To apply a patch, follow the instructions in the patch README file.