How to Group Application Archives and Deployment Plans in a Container

Steps

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

2. Click Create in the Application Archive With Deployment Plan Container: section of the WebLogic Common Tasks page.

   The Component Details Edit page is displayed.

3. Type a name for the container component.

4. Select the appropriate platform for you container from the Platform drop down menu.

5. Type a label for this container component

6. Type a description for this component component.

7. Select the Application Archive components and deployment plan that you want to group together.

   1. In the Referenced Components table, select the component type that you want to include in your Application Archive container from the Type drop down menu.

      • To specify an Application Archive, select the com.sun.weblogic9#ApplicationArchive component type.

      • To specify a Deployment Plan, select the com.sun.weblogic9#DeploymentPlan component type.

   2. Select the component that you want to include in the Application Archive container.

      • To use an existing component, follow these steps.

        1. Click the Reference Existing link in the Actions column.

           The Reference Existing Components in Current Component window is displayed.

        2. Select the component in the Reference Existing Components in Current Component window.

           Click the Change Folder link to navigate through the file system to find the component that you want to use.

      • To use a new component, follow these steps.

        1. Click the Check In New link in the Actions column.

           The Components Details Edit page is displayed.

        2. Type a name for this component.

        3. (Optional) Type a label for this component.

        4. (Optional) Type a description for this component.

        5. In the Import From Host field, specify the system from which you want to capture the application.

           You can specify the system in two different ways.

           • Type the name of the system from which you want to capture the application, then click the Refresh link.

           • Click the Select From List link, then select the system from the Current Found Hosts list in the Select Host From List window.

        6. Navigate through the hierarchy to find the application to capture.

        7. Select the appropriate options for your application.

           You can set the following options for your application.

           • Check in an application archive that has not changed since a previous check in.

           • Assign user and group ownership permissions to the application.

           • If you are checking in a plan, you can designate the plan as a configuration template. If you check the Configuration Template check box, all the component variables for you plan will be added to the container that holds your plan and all associated components. You can then edit these variables when you deploy your application with this container.

        8. In the Path of the Resource Descriptor File field, type the path to the resource descriptor file for this component.

           A resource descriptor file specifies the owner, group, and permission settings to use for the files and directories that comprise the resource of a component. For more information about resource descriptor files, see Using a Resource Descriptor File in Sun N1 Service Provisioning System 5.2 XML Schema Reference Guide.

        9. Click Check-in Selected Item.

        10. Confirm the information on the check-in page, then click Continue to Check-in.

8. Repeat the previous step for each Application Archive or Deployment Plan that you want to include in your Application Archive container.

9. In the Component Variables table, set the variable settings for the Application Archive container.

   • To create new variables, follow these steps.

     1. In the text field in the Variable column of the first row, type the name of the variable you want to create.

     2. In the text field in the Prompt column, type a description of the variable.

     3. In the text field in the Value for This Component column, type the variable value that you want to use.

     4. Click the Create link.

   • To edit existing variable values, follow these steps.

     1. Select the checkbox for the variable that you want to edit.

     2. Type the variable value in the text field in the Value for This Component column.

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

        deploymentName

        Required. Specifies the deployment name to be used for the application.

        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 submodule targets for the deployment.

        adminServerHostName

        Required. Specifies the logical host name 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.

10. Click Check In.

11. Confirm the information on the check-in page, then click Continue to Check-in.