test

Sun N1 Service Provisioning System User's Guide for BEA WebLogic 9 Plug-in 1.0

ProcedureHow to Install an Application

To install an Application Archive component, either directly from the component procedures or with an Application Archive With Plan component, you must use a WebLogic Managed Server or cluster as the target host. The installation process performs two main tasks:

Steps

  1. In the Common Tasks section in the browser interface, click WebLogic 9.

  2. Click the Components link.

    The Components page is displayed.

  3. Navigate to the location of the Application Archive or Application Archive With Plan component that you want to deploy.

    Click the Change Folder link to browse through the file system to select the location of the application archive.

  4. In the Component column, click the Application Archive or Application Archive With Plan component that you want to deploy.

    The Components Details page is displayed.

  5. In the Component Procedures table, select the type of deployment that you want to perform.

    • To deploy the application and start the application on the target host, click the Run link in the Install: Default row.

      Use this procedure to directly install an Application Archive component.

    • To deploy the application with a Deployment Plan, click the Run link in the Install: deployAppPlan row.

      Use this procedure to install an Application Archive component that is grouped with a Deployment Plan in an Application Archive With Plan container component.

    • To deploy the application to the target host, but not start and activate the application, click the Run link in the Install: Distribute or Install: DistributeAppPlan row.

      Use this procedure if you want to start the application in Administration Mode, rather than in general mode. Click the Run link for the Install: DistributeAppPlan procedure if you are using an Application Archive With Plan component.

    The Plans Details Run page is displayed.

  6. In the Plan Parameters area, select the variable settings for the ApplicationArchive component that you plan to deploy.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • To create a new set of variable settings, select Create Set.

        The following list provides commonly updated variables for the ApplicationArchive component.

        variable set name

        Required. A name for the new variable set you create

        deploymentName

        Required. Specifies the deployment name for the application.

        installName

        Required. Specifies the name of the Application Archive to deploy.

        appVersion

        Optional. Specifies the version of the application to deploy. Specify a value for this variable to enable the redeployment of your application.

        stagingMode

        Required. Specifies the staging mode for the deployment of the application. The valid values are stage(default), nostage, and external_stage.

        stage deploys the container resources to the Administration Server, and the WebLogic software copies the application archive files to the target hosts.

        nostage makes the application archive files accessible to the target hosts, but does not copy the application archive files to the target hosts.

        external_stage deploys the container resources to the Administration Server, and the N1 SPS software deploys the application archive files to the staging area of the target hosts.

        target

        Required. Specifies the target host for the deployment.

        subModuleTargets

        Optional. Specifies the application submodule targets for the deployment.

        adminServerHostName

        Required. Specifies the logical host name for the Administration Server for the domain.

        adminDomainRootDir

        Required. Specifies the root directory for the Administration Server for the domain.

        installPath

        Required. Specifies the installation location for the application archive.

        If you specify stage or external_stage for the stagingMode variable, specify the location on the Administration Server to install the application archive.

        If you specify nostage for the stagingMode variable, specify the network path to the application archive. This location must be accessible to the target host through NFS.

      • If you want to use another component's variable settings, click Import Set From Component.

        The Import Variable Settings window displays.

        1. If necessary, navigate to the Folder that contains the component with the variable settings you want to import.

        2. Select the component version.

          Note –

          Variable settings can vary between component versions. Ensure that the current components and the component from which you want to import variable settings share common variables. If the component from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable settings are not imported.

        3. Click Import Variable Settings.

          The variables settings are imported, and are displayed in the table.

        4. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

      • If you want to use component variable settings that are stored in a file, follow these steps.

        1. In the Import Sets from File text field, enter the path to the variable settings file that you want to use.

          To browse through the file system to find the appropriate file, click the Browse button.

        2. Click Import.

          The variables settings are imported, and are displayed in the table.

          Note –

          If the file from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable set is not imported.

        3. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

  7. Select the target host or target host set.

    Target either a Managed Server or WebLogic Cluster.

    Note –

    The target host must be a member of the com.sun.weblogic#DeploymentTargetHS host set.

  8. In the Plan Parameters section, specify any options that you want to use with the install plan.

    • (Optional) If you want to pass any Java arguments to the weblogic.Deployer command during the installation, type the arguments in the Java Arguments Used for weblogic.Deployer field.

      For information on how to perform deployment tasks using the weblogic.Deployer command, see BEA's WebLogic Server weblogic.Deployer Command-Line Reference document.

    • If you want to wait for a specified period to enable the previous version of the application to retire before installing the application, type a numerical value in seconds in the Optional: Second to Wait Before Previous Application Retires text field.

    • If you want to install and start the application in Administration Mode, type true in the Start Application in Admin Mode text field.

      You might want to start the application in Admin Mode for development systems.

      If you want to start the application in General Mode for production systems, set this value to false.

  9. Click Run Plan (includes preflight).

    The application is deployed to the target host or host set.