This chapter explains how to install and configure the WebSphere plug-in. The chapter contains the following information:
Acquiring the WebSphere 5.1 plug-in is a two-step process. First, you must add the package file that contains the WebSphere 5.1 plug-in JAR file to your system. Then you must import the WebSphere 5.1 plug-in JAR file.
The IBM WebSphere Application Server 5.1 solution is packaged as a plug-in to the Sun N1 Service Provisioning System software. Plug-ins are packaged in JavaTM Archive (JAR) files. The plug-in files for the WebSphere Application Server solution are available from the Sun N1 Service Provisioning System Supplement CD or from the Sun Download Center.
Once the package file is added to your system, the WebSphere Plug-In is available for import from two different JAR files. Choose the correct file depending on your situation.
If you are importing the WebSphere Plug-In for the first time, acquire the com.sun.was_3.0.jar file.
If you have already imported the previous version of the WebSphere Plug-In, acquire the com.sun.was_2.0_3.0.jar file.
Add the package containing the JAR file.
Import the JAR file – Importing the WebSphere Plug-In to the Sun N1 Service Provisioning System
The WebSphere 5.1 plug-in is contained in the SUNWspswas package.
In a terminal window, become superuser.
Move to the directory containing the plug–in package.
Type the following command and press Return.
# pkgadd -d . SUNWspswas
The standalone JAR file is in the /opt/SUNWn1sps/plugins/com.sun.was/ directory. The upgrade JAR file is in the /opt/SUNWn1sps/plugins/com.sun.was/Upgrade directory.
The WebSphere 5.1 plug-in is contained in the sun-spswas-3.0-1.noarch.rpm file.
In a terminal window, become superuser.
Move to the directory containing the sun-spswas-3.0-1.noarch.rpm file.
Type the following command and press Return.
# rpm –i sun-spswas-3.0-1.noarch.rpm
The standalone JAR file is in the /opt/sun/N1_Service_Provisioning_System/plugins/com.sun.was/ directory. The upgrade JAR file is in the /opt/sun/N1_Service_Provisioning_System/plugins/com.sun.was/Upgrade directory.
The WebSphere 5.1 plug-in is contained in the SUNWspswas.msi file.
Move to the directory containing the sun-spswas-3.0.msi file.
Double-click the sun-spswas-3.0.msi file.
The Installer GUI start. The JAR file is copies to the C:\Program Files\N1 Service Provisioning System\plugins\com.sun.was directory. The upgrade JAR file is in the C:\Program Files\N1 Service Provisioning System\plugins\com.sun.was/Upgrade directory.
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 WebSphere Plug-In you need to upgrade to the new plug-in.
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
In the Administrative section of the browser interface main window, click Plug-ins.
In the Action column of the Plug-ins page, click Import.
Navigate to the location of the JAR file.
If you are importing the WebSphere Plug-In for the first time, select the com.sun.was_3.0.jar file.
If you have already imported a previous version of the WebSphere Plug-In, select the com.sun.was_2.0_3.0.jar file.
Click the Continue to Import button.
When the import complete successfully, a plug-in details page appears and shows you the objects that the plug-in provides.
You can also import a plug-in by using the command line.
To import a plug-in file from the CLI, type:
% cr_cli -cmd plg.p.add -path plugin-filename -u username -p password |
If you are importing the WebSphere Plug-In for the first time, plugin-filename is com.sun.was_3.0.jar.
If you have already imported the previous version of the WebSphere Plug-In, plugin-filename is com.sun.was_2.0_3.0.jar.
The WebSphere plug-in requires some minor modifications of the basic provisioning system configuration to allow communication between applications and to allow sufficient time for plans to run.
Import the plug-in.
See .
Set the WebSphere 3.0 session variables: WS_DEFAULT_USER and WS_DEFAULT_PASSWORD.
These variables are used during standalone application server installation, deployment manager installation, and node federation.
Install the CLI on the machine running the Master Server.
Create a virtual host to represent the provisioning system's command-line interface (CLI).
If virtual host cliHost exists and the host type is com.sun.sap#cliHT, do not create another cliHost.
Use the following attributes to define the virtual host.
host: cliHost
host type: com.sun.was#cliHT
cliLoc: the absolute path to the CLI.
For example, InstallPath/cli/bin/cr_cli
parent host: The remote agent located on the Master Server.
Install and start the Remote Agent software on the machine running the Master Server.
Go to the Master Server's Host Edit page and select the Include Remote Agent On This Physical Host option.
Modify the Master Server's config.properties file.
The allowSessionIDOnHosts value enables the plug-in communicate with the Master Server through the CLI and Remote Agent interface.
The defaultPlanTimeout value enables you to increase the amount of time that a plan can run. The value is represented in seconds. Add this line if you need to increase the default plan run time from the 30–minute (1800 second) default value. The above example is an arbitrary value of 100 minutes (6000 seconds).
The pe.nonPlanExecNativeTimeout value is in seconds. Add this line if your site needs to increase the time for execNative timeouts.
pe.nonPlanExecNativeTimeout=2400 |
Add the following lines to the file.
config.allowSessionIDOnHosts=masterserver pe.defaultPlanTimeout=6000 |
The config.properties file's default location is /opt/SUNWn1sps/N1_Service_Provisioning_System_5.2/server/config.
Restart the Master Server.
The following information is related to viewing previous versions of components after upgrading.
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:
Click the appropriate component procedure on the Common Tasks page.
The Component Detail page appears.
On the Component Details page, click Version History.
A list of components and versions appears.
Click the appropriate link.
Check the SunSolve site for available patches for the WebSphere 3.0 plug-in. To apply the patch, follow the instructions in the patch README file.