Capturing and Managing Sun Java System App Server Applications

This section describes how to manage Sun Java System App Server applications.

The Sun Java System App Server Plug-In supports two types of application deployments:

• Enterprise Applications (EARs)

• Web Applications (WARs)

Managing the Application is a two step process involving:

1. Capturing the Application in to the Sun N1 Service Provisioning System Master Server.

2. Installing and Uninstalling the Application.

How to Capture Sun Java System App Server Enterprise Applications

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS Application Tasks->Enterprise Applications (EARs) click Create New.

3. Enter a component directory for this component. The com/sun/sjsas81 namespace is not valid.

4. Enter a label for this component.

5. Enter a description for this component.

6. Enter the host where the EAR file is located.

   To select the host from a list, click Select From List.

7. Navigate to the location of the EAR.

   1. If you know the path to the EAR, enter it in com.sun.sjsas81#EntappCT path.

   2. To browse the selected host, select the directory and click Open Highlighted Item.

8. Select the EAR and click Open Highlighted Item.

9. Click Check In Selected Item.

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

How to Capture Sun Java System App Server Web Applications

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS Application Tasks->Web Applications (WARs) click Create New.

3. Enter a component directory for this component. The com/sun/sjsas81 namespace is not valid.

4. Enter a label for this component.

5. Enter a description for this component.

6. Enter the host where the WAR file is located.

   To select the host from a list, click Select From List.

7. Navigate to the location of the WAR.

   1. If you know the path to the WAR, enter it in com.sun.sjsas81#WebappCT path.

   2. To browse the selected host, select the directory and click Open Highlighted Item.

8. Select the WAR and click Open Highlighted Item.

9. Click Check In Selected Item.

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

Managing Sun Java System App Server Enterprise Applications

The following are component procedures for the Sun Java System App Server EAR Management:

install: default

Deploys the EAR to the target host and marks the component installed in the Sun N1 Service Provisioning System database.

install: markOnly

Marks the component installed in the Sun N1 Service Provisioning System database.

uninstall: default

Undeploys the EAR from the target host and marks the component as uninstalled in the Sun N1 Service Provisioning System database.

uninstall: markOnly

Marks the component as uninstalled in the Sun N1 Service Provisioning System database.

How to Install a Sun Java System App Server Enterprise Application

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS Application Tasks->Enterprise Applications (EARs) click View All.

3. Click the name of the EAR you want to install.

4. Under Component Procedures click the Run action next to install: default.

5. In the Plan Parameters area, select the variable settings for the EAR you want to install.

   • 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 Install component.

       variable set name

       Required. A name for the new variable set you create.

       installIdentifier

       A unique ID to associate the EAR with an Install component.

       domainName

       The domain name in which this EAR will be installed

       targetName

       The cluster name or server instance where the EAR will be deployed.

     • To use variable components 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.

6. Select the target host.

7. Deselect the Target Host Set checkbox.

8. If you want to run a detailed check (preflight) before installing, select Perform Detailed Preflight.

9. Click the Run Plan (includes preflight) button.

How to Uninstall a Sun Java System App Server Enterprise Application

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS Application Tasks->Enterprise Applications (EARs) click View All.

3. Click the name of the EAR you want to uninstall.

4. Under Component Procedures click the Run action next to uninstall: default.

5. Select the installation from which you want the EAR removed.

6. Click the Run Selected Installations button.

7. Click the Run Plan (includes preflight) button.

Managing Sun Java System App Server Web Applications

The following are component procedures for the Sun Java System App Server WAR Management:

install: default

Deploys the WAR to the target host and marks the component installed in the Sun N1 Service Provisioning System database.

install: markOnly

Marks the component installed in the Sun N1 Service Provisioning System database.

uninstall: default

Undeploys the WAR from the target host and marks the component as uninstalled in the Sun N1 Service Provisioning System database.

uninstall: markOnly

Marks the component as uninstalled in the Sun N1 Service Provisioning System database.

How to Install a Sun Java System App Server Web Application

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS Application Tasks->Web Applications (WARs) click View All.

3. Click the name of the WAR you want to install.

4. Under Component Procedures click the Run action next to install: default.

5. In the Plan Parameters area, select the variable settings for the WAR you want to install.

   • 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 Install component.

       variable set name

       Required. A name for the new variable set you create.

       installIdentifier

       A unique ID to associate the WAR with an Install component.

       domainName

       The domain name in which this WAR will be installed

       targetName

       The cluster name or server instance where the WAR will be deployed.

     • To use variable components 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.

6. Select the target host.

7. Deselect the Target Host Set checkbox.

8. Under Plan Variables set the context root of the web application.

9. If you want to run a detailed check (preflight) before installing, select Perform Detailed Preflight.

10. Click the Run Plan (includes preflight) button.

How to Uninstall a Sun Java System App Server Web Application

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS Application Tasks->Web Applications (WARs) click View All.

3. Click the name of the WAR you want to uninstall.

4. Under Component Procedures click the Run action next to uninstall: default.

5. Select the installation from which you want the WAR removed.

6. Click the Run Selected Installations button.

7. Click the Run Plan (includes preflight) button.