test

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

Installing the Application Server With a Custom Exception File

A custom exception file enables you to create a unique set of variables by which to deploy an application server.

This section describes the following tasks:

ProcedureHow to Create Custom Exception File Components

The custom exception file enables you to provide and check in a custom exception file to SPS. You can then use the custom exception file to deploy the application server instead of the default exception file which is provided by the plug–in.

Before You Begin

The custom exception file must be available on the machine where the custom exception file component is created.

Steps

  1. Create the custom exception file.

    For more information, see Exception File Example

  2. In the Common Task ssection of the N1 SPS browser interface, click SAP.

  3. In the Application Server With Custom Exception File section of the SAP Tasks page, click Create Component.

  4. Provide the component information.

    Component

    This is a required field. This is the component name.

    Type

    Leave this value as com.sun.sap#AppServerWithExceptionFile.

    Platform

    Select a specific platform or leave the default value of system#any.

    Label

    Short description of the component.

    Description

    A description of the component.

  5. Import Exception File from host.

    1. Click the Select From List link.

    2. Select a host from the Current Hosts Found list.

    3. Click the Add Host to Main Window button.

    4. Click Refresh.

    5. Navigate to the exception file and click to select it.

  6. Select additional options if desired.

  7. Click the Check In Selected Item button.

    The Check In window is displayed.

  8. Specify the component name.

    You can change the component name if you wish. For example, MyCustomExceptionFileComponent.

  9. Click the Change Folder link.

  10. Change to the /com/sun/n1aa/exceptionfiles directory.

    For more information, see Chapter 6, Setting Up Folders, in Sun N1 Service Provisioning System 5.2 System Administration Guide.

  11. Click the Change To Selected Folder button.

  12. Click the Continue to Check In button.

    The Components table is displayed.

ProcedureHow to View All Exception File Components

Steps

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

  2. In the Application Server With Custom Exception File section of the SAP Tasks page, click View All Components.

  3. Click the View Current Component Check-Ins button.

    The Default Exception File and any previously checked in Custom Exception files are displayed.

    If you do not see the components you checked in, click on the Change Folder link and change the folder to the one in which you created the components.

ProcedureHow to Create Application Server Components

This task creates an SAP Application Server component in the SPS database. This SAP Application Server is used by the Sun N1 Advanced Architecture for SAP Solutions to deploy and create a new SAP Application Server at the OS level.

Steps

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

  2. In the Application Server With Custom Exception File section of the SAP Tasks page, click Create Component.

  3. Populate the component information.

    Note –

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

    Component

    This is a required field. This is the component name. The format of the component name is ASWithcustom-exception-filename, where custom-exception-filename is the previously created component.

    For example, ASWithMyCustomExceptionFile. This component needs to be in the /com/sun/n1aa/exceptionfiles directory.

    Type

    Leave this value as com.sun.sap#AppServerWithExceptionFile.

    Platform

    Select a specific platform or leave the default value of system#any.

    Label

    A short description.

    Description

    An description of the component.

    Referenced Components

    1. Click the Reference Existing link for the Exception File component.

    2. Select the exception file.

    3. Click the Reference Checked Components button.

      The Add Component Variables table appears.

      Note –

      This table will be empty if there are no component variables

    4. Click the Continue to Reference Components button.

  4. Populate the Component Variables.

    resourceName

    Required for the Sun Cluster environment.

    groupName

    This is a required field.

    Note –

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

    installPath

    Install location.

    ciLhName

    Required for the default environment installation. Central instance logical host.

    asLhName

    Required for the default environment. Application server logical host.

    sapSid

    Required for the default environment. SAP system ID (3 upper case alphanumeric.) The first character must be an alphabetic letter.

    asSystemInstanceNumber

    Required for the default environment. Application Server instance number.

    ciInstanceName

    This is a required field. Central Instance number. Generated from variable input.

    instanceSize

    Application Server instance size. Default value: medium.

    envType

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

    accServiceID

    Required for the SAP AC environment. SAP AC service ID.

    srmProject

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

    isNewSAPVersion

    This is a required field. TRUE means the central scripts are user to start and stop the application server. FALSE means instance specific start and stop scripts from the SAP user home directory will be used to start and stop the application server. Default value: TRUE

    createdBy

    Identifies the installer of the component.

  5. Click Check In.

  6. Click Continue to Check In.

    You have completed the creation of the application server with custom exception file component.

ProcedureHow to View All Application Server Components

Steps

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

  2. In the Application Server With Custom Exception File section of the SAP Tasks page, click View All Components.

    The components table is displayed.

ProcedureHow to Create an Application Server With Custom Exception File Install Plan

Steps

  1. Select the Application Server with Custom Exception File component.

    Perform one of the following options to begin the plan creation task:

    • If you are in the Components Details window.

      1. Select default: install

    • If you enter from the Common Tasks page.

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

      2. In the Application Server With Custom Exception File section of the SAP Tasks page, click View All Components.

      3. Select the appropriate application server with custom exception file component.

      4. Select the default:install procedure from the component procedures table.

  2. Click Generate Plan With Checked Procedures.

    The plans details advanced edit page appears.

  3. Type the plan name

    The format of the plan name is Installcomponent-namePlan. For example, InstallASWithMyCustomExceptionFilePlan.

  4. Edit the plan definition.

    1. Delete <paramList> through </paramList>

    2. Delete <argList> through </argList>

  5. Click the Check In button.

    The Plans Details Edit Check In window appears.

    Note –

    The following warning might appear and can be ignored.


    warning – plan names and/or paths differ

  6. Click the Continue To Check In button.

    The Plans Details window appears.

  7. Click Done.

    The Plans table is displayed.