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

This chapter explains how to install and configure the Sun Java System App Server Plug-In. The chapter contains the following information:

• Acquiring the Sun Java System Application Server Plug-In

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

• Upgrading Considerations

Acquiring the Sun Java System Application Server Plug-In

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

Acquiring the Sun Java System App Server Plug-In is a two-step process. First, you must add the package file that contains the Sun N1 Service Provisioning System containers plug-in JAR file to your system. Then, you must import the Sun N1 Service Provisioning System containers plug-in JAR file to the Master Server.

Once the package file is added to your system, the Sun Java System Application Server Plug-In 3.0 is available for import from two different JAR files. Choose the correct file depending upon your situation.

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

• If you have already imported the previous version of the Sun Java System App Server Plug-In, acquire the com.sun.sjsas81_2.0_3.0.jar file.

1. Add the file containing the JAR file for Solaris, Linux, or Windows:

   • Adding the Sun Java System Application Server Plug-In for Solaris

   • Adding the Sun Java System Application Server Plug-In for Linux

   • Adding the Sun Java System Application Server Plug-In for Windows

2. Import the JAR file into the Sun N1 Service Provisioning System. See Importing the Sun Java System Application Server Plug-In to the Sun N1 Service Provisioning System

Adding the Sun Java System Application Server Plug-In for Solaris

The Sun Java System App Server Plug-In for Solaris is contained in the SUNWspssas package.

To Add the Sun Java System App Server Plug-In for Solaris

Steps

1. In a terminal window, become superuser.

2. Move to the directory containing the plug-in package.

3. Type the following command and press Return.

   # pkgadd —d . SUNWspssas

   The standalone JAR file is in the /opt/SUNWn1sps/plugins/com.sun.sjsas81/ directory. The upgrade JAR file is in the /opt/SUNWn1sps/plugins/com.sun.sjsas81/Upgrade directory.

Adding the Sun Java System Application Server Plug-In for Linux

The Sun Java System App Server Plug-In for Linux is contained in the sun-spssas-3.0-1.noarch.rpm file.

To Add the Sun Java System App Server Plug-In for Linux

Steps

1. In a terminal window, become superuser.

2. Move to the directory containing the sun-spssas-3.0-1.noarch.rpm file.

3. Type the following command and press Return.

   # rpm —i package_directory/sun-spssas-3.0-1.noarch

   The standalone JAR file is in the /opt/sun/N1_Service_Provisioning_System/plugins/com.sun.sjsas81 directory. The upgrade JAR file is in the /opt/sun/N1_Service_Provisioning_System/plugins/com.sun.sjsas81/Upgrade directory.

Adding the Sun Java System Application Server Plug-In for Windows

The Sun Java System App Server Plug-In for Windows is contained in the sun-spssas-3.0.msi file.

To Add the Sun Java System App Server Plug-In forWindows

Steps

1. Move to the directory containing the sun-spssas-3.0.msi file.

2. Double-click the sun-spssas-3.0.msi file.

   The Installer GUI starts. The JAR file is copied to the C:\Program Files\N1 Service Provisioning System\plugins\com.sun.sjsas81 directory. The upgrade JAR file is in the C:\Program Files\N1 Service Provisioning System\plugins\com.sun.sjsas81\Upgrade directory.

Importing the Sun Java 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 System App Server Plug-In, you will need to upgrade to the new plug-in.

To Import the Sun Java System App 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.2 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 of the JAR file.

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

   • If you have already imported a previous version of the Sun Java System Application Server Plug-In 3.0, select the com.sun.sjsas81_2.0_3.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 System Application Server Plug-In 3.0 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 System App Server Plug-In for the first time, plugin-filename is com.sun.sjsas81_3.0.jar.

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

How to Patch the Sun Java System App Server Plug-In

Steps

1. Check the Support site for available patches for the Sun Java System App Server Plug-In.

2. To apply the patch, follow the instructions in the patch README file.

Upgrading Considerations

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

The following components might be affected:

• Clusters

• Domains

• JDBC Resources

• JMS Resources

• Managed Server Instances

• Threadpool Resources

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.