From an operating system (OS) provisioning perspective, installation consists of three phases:
Installing the N1 Grid SPS software, , as explained in N1 Grid Service Provisioning System 5.0 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:
The OS provisioning plug-in is packaged as a plug-in to the N1 Grid SPS software. Plug-ins are packaged in JavaTM Archive (JAR) files. The plug-in files for the OS provisioning plug-in are available from the N1 Grid SPS Supplement CD or from the Sun Download Center.
To make a given plug-in known to the N1 Grid 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 N1 Grid Service Provisioning System 5.0 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.
Browse to the location where you downloaded the com.sun.isp_1.0.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. Use the following command:
% cr-cli -cmd plg.p.add -path com.sun.isp_1.0.jar -u username -p password |
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.
In the Common Tasks section of the N1 Grid 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. |
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.
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 -comp + -vs + -pto 30 -nto 10 |
The target should be the OS provisioning server. In the example, the N1 Grid SPS Master Server is used as the OS provisioning server.
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 Grid 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 Grid 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.
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.