Chapter 3 Installing and Configuring the Sun Java Enterprise System Application Server Plug-In

This chapter explains how to install and configure the Sun Java Enterprise System Application Server plug-in. The chapter contains the following information:

• Acquiring the Sun Java Enterprise System Application Server Plug-In

• Adding the Sun Java Enterprise System Application Server Plug-In to the Sun N1 Service Provisioning System

• Upgrading Considerations

Acquiring the Sun Java Enterprise System Application Server Plug-In

Sun Java Enterprise System Application Server Plug-In is packaged as a plug-in to the Sun N1 Service Provisioning System software. Plug-ins are packaged in Java^TM Archive (JAR) files. The plug-in files for the Sun Java Enterprise System Application Server Plug-In are available from the Sun N1 Service Provisioning System Supplement CD or from the Sun Download Center.

The Sun Java Enterprise System Application Server Plug-In is available for import from two different JAR files. Choose the correct file depending upon your situation.

• If you are importing the Sun Java Enterprise System Application Server Plug-In for the first time, acquire the com.sun.sjsas81_2.0.jar file.

• If you have already imported the previous version of the Sun Java Enterprise System Application Server Plug-In, acquire the com.sun.sjsas81_1.0_2.0.jar file.

Adding the Sun Java Enterprise System Application Server Plug-In to the Sun N1 Service Provisioning System

To make a given plug-in known to the Sun N1 Service Provisioning System, you need to import the plug-in to the Master Server. If you have already imported a previous version of the Sun Java Enterprise System Application Server Plug-In, you need to upgrade to the new plug-in.

How to Import the Sun Java Enterprise System Application Server Plug-In Using the Browser Interface

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

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. Browse to the location where you downloaded the JAR file.

   • If you are importing the Sun Java Enterprise System Application Server Plug-In for the first time, select the com.sun.sjsas81_2.0.jar file.

   • If you have already imported a previous version of the Sun Java Enterprise System Application Server Plug-In, select the com.sun.sjsas81_1.0_2.0.jar file.

4. 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.

How to Import the Sun Java Enterprise System Application Server Plug-In Using the CLI

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

Step

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

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

• If you are importing the Sun Java Enterprise System Application Server Plug-In for the first time, plugin-filename is com.sun.sjsas81_2.0.jar.

• If you have already imported the previous version of the Sun Java Enterprise System Application Server Plug-In, plugin-filename is com.sun.sjsas81_1.0_2.0.jar.

Upgrading Considerations

The following information is related to viewing previous versions of components after upgrading.

The following components might be affected:

• Domains

• JDBC Resources

• Managed Server Instances

How to Access Previous Versions of a Component

When you upgrade to a new version of a plug-in, the Common Tasks page for the plug-in is updated to provide links to components that are installed with the new plug-in version. This feature enables you to easily view components that contain the most current features and improvements. Components that rely on old functionality are not linked to from the Common Tasks page.

If you have trouble finding a component that you previously installed, the component was likely created from the previous version of the plug-in.

Follow these steps to view or work with a previous version of the component:

Steps

1. Click the appropriate component procedure on the Common Tasks page.

   The Component Detail page appears.

2. On the Component Details page, click Version History.

   A list of components and versions appears.

3. Click the appropriate link.

   1. To perform a task with a component, click the version number or the details link that applies to the component that you want to use.

   2. To view where a component is installed, click Where Installed.