Chapter 3 Installing and Configuring the Solaris Plug-In

This chapter contains the following information:

• Acquiring the Solaris Plug-In

• Adding the Solaris Plug-In to the N1 Grid Service Provisioning System

• Customizing the Solution for Your Environment

Acquiring the Solaris Plug-In

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

The Solaris Plug-In is available for import from two different JAR files. Choose the correct file depending upon your situation.

• If you are importing the Solaris Plug-In for the first time, acquire the com.sun.solaris_2.0.jar file.

• If you have already imported the previous version of the Solaris Plug-In, acquire the com.sun.solaris_1.0_2.0.jar file.

Adding the Solaris Plug-In to the N1 Grid Service Provisioning System

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

How to Import the Solaris 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 N1 Grid Service Provisioning System 5.0 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 Solaris Plug-In for the first time, select the com.sun.solaris_2.0.jar file.

   • If you have already imported a previous version of the Solaris Plug-In, select the com.sun.solaris_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 Solaris Plug-In Using the CLI

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

Step

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 Solaris Plug-In for the first time, plugin-filename is com.sun.solaris_2.0.jar.

• If you have already imported the previous version of the Solaris Plug-In, plugin-filename is com.sun.solaris_1.0_2.0.jar.

Customizing the Solution for Your Environment

Before you deploy Solaris zones from the Master Server, you must modify the Master Server config.properties file.

How to Customize the config.properties File

Steps

1. On the Master Server, using a text editor, access the config.properties file.

   By default, the configuration file for the Master Server resides in the following directory: /opt/SUNWn1sps/N1_Grid_Service_Provisioning_System_5.0/server/config

2. Add the following lines to the config.properties file:

   config.allowSessionIDOnHosts=masterserver 
             pe.defaultPlanTimeout=6000  

   The config.allowSessionIDOnHosts variable enables the plug-in to communicate with the Master Server through the N1 Grid Service Provisioning System Remote Agent and Command Line Interface (CLI).

   By default, the timeout value for plans is set to 1800 seconds or 30 minutes. In some instances, such as when executing a plan on older hardware, the amount of time that is needed for a plan to complete exceeds 30 minutes. To increase the plan timeout value, add the pe.defaultPlanTimeout line to the config.properties file. In the example that is shown, the value is set to 100 minutes.

3. After you modify the config.properties file, you must restart the Master Server.