From an operating system (OS) provisioning perspective, installation consists of three phases:
Installing the N1 SPS software, , as explained in Sun N1 Service Provisioning System 5.2 Installation Guide
Installing the OS provisioning plug-in
Installing the operating system environment that you want to provision
All three installation phases likely also have configuration steps.
This chapter includes the following information:
Acquiring the OS Provisioning Plug-In is a two-step process. First, you must add the package file that contains the OS Provisioning Plug-In JAR file to your system. Then you must import the OS Provisioning Plug-In JAR file. Perform the following steps to add the plug-in to your Master Server.
Add the file containing the JAR file:
The OS Provisioning Plug-In is packaged as a plug-in to the N1 Service Provisioning System software. The plug-in files for the OS Provisioning Plug-In are available from the N1 SPS 5.2 DVD or from the Sun Download Center.
For instructions about how to add the plug-in package to your system, see the following procedures.
Import the JAR file.
Once the package file is added to your system, the OS Provisioning Plug-In is available for import from two different JAR files. Choose the correct file depending on your situation.
If you are importing the OS Provisioning Plug-In for the first time, acquire the n1-basedir/com.sun.n1osp/com.sun.n1osp_3.0.jar file.
If you have already imported the previous version of the OS Provisioning Plug-In, acquire the n1-basedir/com.sun.n1osp/Upgrade/com.sun.n1osp_2.0_3.0.jar file.
For instructions about how to import the plug-in JAR file, see Adding the OS Provisioning Plug-In to N1 SPS.
The plug-in product name plug-in is contained in the SUNWspsosp 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 package_directory SUNWspsosp
The standalone JAR file is in the /opt/SUNWn1sps/plugins/com.sun.n1osp/ directory. The upgrade JAR file is in the /opt/SUNWn1sps/plugins/com.sun.n1osp/Upgrade directory.
The plug-in product name plug-in is contained in the sun-spsosp-3.0-1.noarch.rpm file.
In a terminal window, become superuser.
Move to the directory containing the sun-spsosp-3.0-1.noarch.rpm file.
Type the following command and press Return.
# rpm -i package_directory sun-spsosp-3.0-1.noarch.rpm
The standalone JAR file is in the /opt/sun/N1_Service_Provisioning_System/plugins/com.sun.n1osp/ directory. The upgrade JAR file is in the /opt/sun/N1_Service_Provisioning_System/plugins/com.sun.n1osp/Upgrade directory.
The plug-in product name plug-in is contained in the sun-spsosp-3.0.msi Microsoft Installer (MSI) package file.
Move to the directory containing the sun-spsosp-3.0.msi file.
Double-click the sun-spsosp-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.n1osp directory.
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.2 System Administration Guide.
In the Administrative section of the N1 SPS browser interface main window, click Plug-ins.
In the Action column of the Plug-ins page, click Import.
Browse to the location of the JAR file.
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.n1osp_3.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.n1osp_2.0_3.0.jar -u username -p password |
To upgrade the OS provisioning plug-in from version 2.0 to version 3.0, follow these steps:
Upgrade the N1 SPS software to version 5.2, as explained in Chapter 10, Upgrading to the Sun N1 Service Provisioning System 5.2, in Sun N1 Service Provisioning System 5.2 Installation Guide.
Acquire and import the com.sun.n1osp_2.0_3.0.jar file.
For instructions about how to install the OS Provisioning Plug-In, see Installing the OS Provisioning Plug-In.
Upgrade the OS provisioning (control) server.
You must use the OS provisioning plug-in 3.0 software to recreate any existing OS provisioning servers. See Creating the OS Provisioning Server
Upgrade the OS image servers in your environment.
You must use the OS provisioning plug-in 3.0 software to recreate any existing OS image servers.
For instructions about how to create a JET Solaris image server, see How to Create the JET Solaris Image Server.
For instructions about how to create a Red Hat Linux image server, see Creating a RedHat Linux Image Server.
For instructions about how to create JET SuSe Linux image server, see Creating a SuSe Linux Image Server.
For instructions about how to create a Windows image server, see Setting Up the Windows Server.
When you recreate the boot and install servers, you must use the value that you used previously for the installPath variable. If the previous installPath variable value is no longer valid, you must create a new boot and install server with the valid installPath variable value.
Change the variable for the remote agent in any existing 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.2. For more information about this variable, see Component Variables for Solaris Remote Agents.
If the OS Provisioning Plug-In package for the Solaris OS fails to install, remove the package, then try to install the package again.
If you want to use new variables in the OS Provisioning Plug-In 3.0, you must recreate the target hosts in your N1 SPS environment. For more information about how to create target hosts, see Chapter 9, Target Hosts for OS Provisioning.
If you prefer to use your existing target host definitions, you can continue to provision these hosts with the OS Provisioning Plug-In 3.0.
Starting with the release N1 SPS 5.2 release, the OS Provisioning Plug-In 3.0 uses default values for N1 SPS 5.2 paths. If you are using the N1 SPS 5.1 release, the OS Provisioning Plug-In, you must edit the sps_cli variable value in your plans to enable the OS Provisioning Plug-In 3.0. Edit this value in the following procedures.
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.
Although the OS provisioning plug-in has been imported, you cannot provision an operating system until you create and set up an OS provisioning server.
At the end of this task, the OS provisioning software is installed on the OS provisioning server. In addition, the DHCP service is installed on the OS provisioning server.
For OS Provisioning servers that are running the Solaris OS, you must install the Java 2 SE 1.4.2 release on the system before you create the OS Provisioning server. The Java 2 SE 1.4.2 release must be located in, or linked to, the /usr/bin/java directory.
For OS Provisioning servers that are running RedHat Enterprise Linux, you must install the Java 2 SE 1.4.2 32–bit release and the DHCP RPM for your RedHat distribution on the system before you create the OS Provisioning server. The Java 2 SE 1.4.2 release must be located in, or linked to, the /usr/bin/java directory. If a 64–bit Java version is installed on the system, link /opt/SUNWn1osp/lib/libgridos.so to /opt/SUNWn1osp/lib/libgridos_rhel3_x86_64.so. Verify that the host name of the OS Provisioning server resolves to a primary interface on the system, and not a loopback address.
In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.
On the OS Provisioning Common Tasks page, click Create in the OSP Control Server section.
On the Plans Details page, click Run.
Choose variables to use for this plan.
To use an existing variables set, select a name from the drop-down menu in the Service component row of the Plan Parameters table.
To create a new variables set, click Select from List in the Service component row of the Plan Parameters table.
Click Create Set.
Type a name for the variables set.
Change variables as needed.
Variable Name |
Description |
---|---|
installPath |
Base directory into which to install the OS provisioning software. |
vhost_name |
Name of the virtual host that represents the OS provisioning server. |
host_dir |
Path to directory in which target host files reside. |
profile_dir |
Path to directory in which OS profile resides. |
subnet_dir |
Path to directory in which subnet files reside. |
logs_console_dir |
Path to directory in which logs and console files reside. |
run_provisioniing_foreground |
Specifies whether to run the provisioning operation in the foreground. If you set this variable value to true, all deployments are run in the foreground. You cannot reset this value for individual deployments. Note – To enable this feature, you must disable locking of physical hosts, which is an unsupported configuration. For more information about how to disable physical locking of hosts, see Running Deployment Jobs in the Foreground. |
java_bin |
Path to the Java binary. |
dhcpd_bin |
Path to the DHCP daemon binary. |
sps_cli |
Location of the N1 SPS command line interface (CLI) binaries. Note – If you are using the OS Provisioning Plug-In 3.0 with the N1 SPS 5.1 release, you must edit this value to point to the location of the cr_cli directory in your environment. Do not accept the default value. |
Save the variables set.
Select the variables set that you just saved from the drop-down menu in the Service component row of the Plan Parameters table.
Select the host on which you want to create the OS provisioning server.
Click Run Plan (includes preflight).
This plan takes some time to run, usually approximately 15 minutes. While the installation is proceeding, click on the Details links in the Plan Run window to see progress.
To verify that the OS provisioning server is created successfully, click the Hosts link in the left side of the provisioning server window.
You should see the name of the virtual host appended with -osp. For example, if you installed on host masterserver, the virtual host is masterserver-osp.
In some environments, you might want to use your network's DHCP server rather than the ISC DHCP server that is created and started after you complete the previous procedure. If you want to disable the ISC DHCP server that is set up by the provisioning software, see Disabling the Plug-In Provided DHCP.
If your OS provisioning server is located on the same physical host as the boot and install server, you must configure the interfaces on the system before your provision any target hosts. The OS provisioning server does not automatically configure the interfaces of the boot and install server.
To create the server from the command line, type a command similar to the following example:
# cr_cli -cmd pe.p.run -u admin -p admin -PID "NM:/com/sun/n1osp/untyped/Service-create" \ -tar H:NM:masterserver,H:NM:bikickstart -comp - -vs + -pto 30 -nto 10 |
The target should be the OS provisioning server. In the example, the N1 SPS Master Server is used as the OS provisioning server.
In some environments, you might want to use your network's DHCP server rather than the ISC DHCP server that is created and started after you complete the previous procedure. If you want to disable the ISC DHCP server that is set up by the provisioning software, see Disabling the Plug-In Provided DHCP.
The OS provisioning server provides DHCP service. The DHCP service has to listen on all the subnets that will be used to provision the targets. In the N1 SPS interface, you need to identify the subnets to be used for provisioning targets so that the OS provisioning server can respond to DHCP requests. The OS provisioning service will create the interfaces with the required addresses on the provisioning server (if not already created) during the provisioning operation.
To manage the subnet from the browser interface, follow these steps.
In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.
On the OS Provisioning Common Tasks page, click Manage in the OSP Subnets section.
On the Component Details page, click the Run action in the Create row.
Choose variables to use for this plan.
To use an existing variables set, select a name from the drop-down menu in the Service component row of the Plan Parameters table.
To create a new variables set, click Select from List in the Service component row of the Plan Parameters table.
Click Create Set.
Type a name for the variables set.
Change variables as needed.
Variable |
Description |
Example |
---|---|---|
installPath |
Subnet address |
10.42.42.0 |
mask |
Subnet mask |
255.255.255.0 |
gateway |
Gateway for the subnet |
10.42.42.1 |
host_interface |
Interfaces on the OS provisioning server to be used for this subnet |
hme0 |
host_address |
Host address that is assigned to the host_interface |
10.42.42.1 |
The OS provisioning software creates the interfaces and assigns the addresses during provisioning operation, if those values are not set already.
Save the variables set.
Select the variables set that you just saved from the drop-down menu in the Service component row of the Plan Parameters table.
Select the virtual host to which this subnet applies.
The virtual host for the OS provisioning server ends in -osp.
Click Run Plan (includes preflight).
To manage the subnet from the command line, follow these steps:
Create the variables set.
Type a command similar to the following example:
# cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/untyped/Subnet -name "subnet1" \ -u admin -p admin -vars "installPath=10.42.42.0;mask=255.255.255.0;gateway=10.42.42.1; \ host_interface=ce8000;host_address=10.42.42.1" |
For more information about the variables, see Step 4 in How to Identify the Subnet for the OS Provisioning Server (Browser Interface).
Run the plan to create the subnet using the variables set created in the previous step.
Type a command similar to the following example:
# cr_cli -cmd pe.p.run -u admin -p admin -PID NM:/com/sun/n1osp/untyped/Subnet-create \ -tar H:NM:masterserver-osp -comp - -vs subnet1 -pto 30 -nto 10 |
You can use several subnets to provision operating systems. The following steps explain how to add a new subnet to the OS provisioning server.
Verify that the OS provisioning server, the boot and install server for the applicable operating system, and the target host are in the same IP network. Configure the network interfaces on your boot and install server.
Create a new subnet component as described in How to Identify the Subnet for the OS Provisioning Server (Browser Interface).
For IP connectivity, you have two options:
Create new IP addresses for the OS provisioning server .
Use existing IP addresses, but create a route for DHCP packets to reach from the target to the OS provisioning server.
Create new interfaces on the boot and install servers for the new subnet or define routes so that the boot and install server can be reached by the target.
Verify that the file system shares are updated to deliver the OS media in this new subnet.
Verify that the targets are in this subnet.
Edit the profile you want to provision for IP addresses to be in the new subnet.