Installing the OS Provisioning Plug-In

Acquiring the OS Provisioning Plug-In

The OS provisioning plug-in is packaged as a plug-in to the N1 SPS software. Plug-ins are packaged in Java^TM Archive (JAR) files. The plug-in files for the OS provisioning plug-in are available from the N1 SPS Supplement CD or from the Sun Download Center.

The OS provisioning plug-in is available for import from two different JAR files. Choose the correct file depending upon your situation.

• If you are importing the OS provisioning plug-in for the first time, use the com.sun.n1osp_2.0.jar file.

• If you have already imported the previous version of the OS provisioning plug-in, use the com.sun.n1osp_1.0_2.0.jar file.

Adding the OS Provisioning Plug-In to the N1 SPS

To make a given plug-in known to the N1 SPS product, you need to import the plug-in. To import 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.

1. In the Administrative section of the N1 SPS 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.

4. Click the Continue to Import button.

When the import completes successfully, a plug-in details page appears that shows you the objects that the plug-in provides.

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

• If you have not previously used the OS provisioning plug-in, use the following command to import the plug-in:

  % cr-cli -cmd plg.p.add -path com.sun.osp_2.0.jar -u username -p password

• If you already have an older version of the OS provisioning plug-in, use the following command to import the plug-in:

  % cr-cli -cmd plg.p.add -path com.sun.osp_1.0_2.0.jar -u username -p password

How to Upgrade the OS Provisioning Plug-In

To upgrade the OS provisioning plug-in from version 1.0 to version 2.0, follow these steps:

Steps

1. Upgrade the N1 SPS software to version 5.1, as explained in Chapter 10, Upgrading to the N1 Service Provisioning System 5.1, in Sun N1 Service Provisioning System 5.1 Installation Guide.

2. Acquire and import the com.sun.osp_1.0_2.0.jar file.

3. Upgrade the OS provisioning (control) server.

   You must use the OS provisioning plug-in 2.0 software to recreate any existing OS provisioning servers. See Creating the OS Provisioning Server

4. For Solaris provisioning, upgrade the JET Solaris image server.

   You must use the OS provisioning plug-in 2.0 software to recreate any existing JET Solaris image servers. See How to Create the JET Solaris Image Server.

5. Change the variable for the remote agent in any existing Solaris OS profiles.

   The product_version_spsra variable in the profile must reflect the current N1 SPS RA software version. Edit any existing profiles and change the value of the product_version_spsra variable to 5.1. For more information about this variable, see Component Variables for N1 SPS Remote Agents.

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.

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

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