Installing the Client

When you finish preparing your network for a WAN boot installation, you can choose from the following ways to install the system.

Table 12-2 Methods to Install the Client

Method	Description	Instructions
Noninteractive installation	Use this installation method if you want to install keys on the client and set the client configuration information before you boot the client.	To install keys on the client before the installation, see Installing Keys on the Client. To perform a noninteractive installation, see To Perform a Noninteractive WAN Boot Installation.
Interactive installation	Use this installation method if you want to set the client configuration information during the boot process.	To Perform an Interactive WAN Boot Installation
Installing with a DHCP server	Use this installation method if you configured the network DHCP server to provide client configuration information during the installation.	To configure a DHCP server to support a WAN boot installation, see (Optional) Providing Configuration Information With a DHCP Server. To use a DHCP server during your installation, see To Perform a WAN Boot Installation With a DHCP Server.
Installing with local CD media	If your client OBP does not support WAN boot, boot the client from a local copy of the Solaris Software CD.	To determine if the client OBP supports WAN boot, see To Check the Client OBP for WAN Boot Support. To install the client with a local copy of the Solaris Software CD, see To Perform a WAN Boot Installation With Local CD Media.

To Perform a Noninteractive WAN Boot Installation

Use this installation method if you prefer to install keys and set client configuration information before you install the client. You can then boot the client from the WAN and perform an unattended installation.

This procedure assumes that you have either installed keys in the client's OBP, or that you are performing an insecure installation. For information about installing keys on the client before your installation, see Installing Keys on the Client.

If the client system is currently running, bring the system to run level 0.
```
# init 0
```
The ok prompt is displayed.
At the ok prompt on the client system, set the network boot argument variables in OBP.
```
ok setenv network-boot-arguments host-ip=client-IP,
router-ip=router-ip,subnet-mask=mask-value,
hostname=client-name,http-proxy=proxy-ip:port,
file=wanbootCGI-URL
```
Note - The line breaks in this command sample are included for formatting purposes only. Do not enter a carriage return until you finish typing the command.

setenv network-boot-arguments

Instructs the OBP to set the following boot arguments

host-ip=client-IP

Specifies the IP address of the client

router-ip=router-ip

Specifies the IP address of the network router

subnet-mask=mask-value

Specifies the subnet mask value

hostname=client-name

Specifies the host name of the client

(Optional) http-proxy=proxy-ip:port

Specifies the IP address and port of the network's proxy server

file=wanbootCGI-URL

Specifies the URL of the wanboot-cgi program on the web server
Boot the client.
```
ok boot net - install
```
net - install

Instructs the client to use the network boot argument variables to boot from the WAN

The client installs over the WAN. If the WAN boot programs do not find all the necessary installation information, the wanboot program prompts to provide the missing information. Type the additional information at the prompt.

Example 12-4 Noninteractive WAN Boot Installation

In the following example, the network boot argument variables for the client system myclient are set before the machine is booted. This example assumes that a hashing key and encryption key are already installed on the client. For information about installing keys before you boot from the WAN, see Installing Keys on the Client.

ok setenv network-boot-arguments host-ip=192.168.198.136,
router-ip=192.168.198.129,subnet-mask=255.255.255.192
hostname=myclient,file=http://192.168.198.135/cgi-bin/wanboot-cgi
ok boot net - install
Resetting ...




Sun Blade 100 (UltraSPARC-IIe), No Keyboard
Copyright 1998-2003 Sun Microsystems, Inc.  All rights reserved.
OpenBoot 4.x.build_28, 512 MB memory installed, Serial #50335475.
Ethernet address 0:3:ba:e:f3:75, Host ID: 83000ef3.



Rebooting with command: boot net - install
Boot device: /pci@1f,0/network@c,1  File and args: - install

The following variables are set.

The client IP address is set to 192.168.198.136.
The client's router IP address is set to 192.168.198.129.
The client's subnet mask is set to 255.255.255.192.
The client's host name is set to seahag.
The wanboot-cgi program is located at http://192.168.198.135/cgi-bin/wanboot-cgi.

To Perform an Interactive WAN Boot Installation

Use this installation method if you want to install keys and set client configuration information at the command line during the installation.

This procedure assumes that you are using HTTPS in your WAN installation. If you are performing an insecure installation that does not use keys, do not display or install the client keys.

Assume the same user role as the web server user on the WAN boot server.
Display the key value for each client key.
```
# wanbootutil keygen -d -c -o net=net-ip,cid=client-ID,type=key-type
```
net-ip

The IP address of the subnet for the client you want to install.

client-ID

The ID of the client you want to install. The client ID can be a user-defined ID or the DHCP client ID.

key-type

The key type you want to install on the client. Valid key types are 3des, aes, or sha1.

The hexadecimal value for the key is displayed.
Repeat the previous step for each type of client key you are installing.
If the client system is currently running, bring the client to run level 0.
At the ok prompt on the client system, set the network boot argument variables in OBP.
```
ok setenv network-boot-arguments host-ip=client-IP,router-ip=router-ip,
subnet-mask=mask-value,hostname=client-name,
http-proxy=proxy-ip:port,bootserver=wanbootCGI-URL
```
Note - The line breaks in this command sample are included for formatting purposes only. Do not enter a carriage return until you finish typing the command.

setenv network-boot-arguments

Instructs the OBP to set the following boot arguments

host-ip=client-IP

Specifies the IP address of the client

router-ip=router-ip

Specifies the IP address of the network router

subnet-mask=mask-value

Specifies the subnet mask value

hostname=client-name

Specifies the host name of the client

(Optional) http-proxy=proxy-ip:port

Specifies the IP address and port of the network's proxy server

bootserver=wanbootCGI-URL

Specifies the URL of the wanboot-cgi program on the web server

Note - The URL value for thebootserver variable must not be an HTTPS URL. The URL must start with http://.
At the client ok prompt, boot the system.
```
ok boot net -o prompt - install
```
net -o prompt - install

Instructs the client to boot and install from the network. The wanboot program prompts the user to enter client configuration information at the boot> prompt.

The boot> prompt is displayed.
Install the encryption key.
```
boot> 3des=key-value
```
3des=key-value
Specifies the hexadecimal string of the 3DES key that is displayed in Step 2.
If you use an AES encryption key, use the following format for this command.
```
boot> aes=key-value
```
Install the hashing key.
```
boot> sha1=key-value
```
sha1=key-value

Specifies the hashing key value that is displayed in Step 2.
Type the following command to continue the boot process.
```
boot> go
```
The client installs over the WAN.
If prompted, type client configuration information on the command line.
If the WAN boot programs do not find all the necessary installation information, the wanboot program prompts to provide the missing information. Type the additional information at the prompt.

Example 12-5 Interactive WAN Boot Installation

In the following example, the wanboot program prompts you to set the key values for the client system during the installation.

Display the key values on the WAN boot server.

# wanbootutil keygen -d -c -o net=192.168.198.0,cid=010003BA152A42,type=sha1
b482aaab82cb8d5631e16d51478c90079cc1d463
# wanbootutil keygen -d -c -o net=192.168.198.0,cid=010003BA152A42,type=3des
9ebc7a57f240e97c9b9401e9d3ae9b292943d3c143d07f04

The previous example uses the following information.

net=192.168.198.0

Specifies the IP address of the client's subnet

cid=010003BA152A42

Specifies the client's ID

b482aaab82cb8d5631e16d51478c90079cc1d463

Specifies the value of the client's HMAC SHA1 hashing key

9ebc7a57f240e97c9b9401e9d3ae9b292943d3c143d07f04

Specifies the value of the client's 3DES encryption key

If you use an AES encryption key in your installation, change type=3des to type=aes to display the encryption key value.

Set the network boot argument variables in the OBP on the client.

ok setenv network-boot-arguments host-ip=192.168.198.136,
router-ip=192.168.198.129,subnet-mask=255.255.255.192,hostname=myclient,
bootserver=http://192.168.198.135/cgi-bin/wanboot-cgi

The following variables are set.

The client IP address is set to 192.168.198.136.
The client's router IP address is set to 192.168.198.129.
The client's subnet mask is set to 255.255.255.192.
The client's host name is set to myclient.
The wanboot-cgi program is located at http://192.168.198.135/cgi-bin/wanboot-cgi.

Boot and install the client.

ok boot net -o prompt - install
Resetting ...


Sun Blade 100 (UltraSPARC-IIe), No Keyboard
Copyright 1998-2003 Sun Microsystems, Inc.  All rights reserved.
OpenBoot 4.x.build_28, 512 MB memory installed, Serial #50335475.
Ethernet address 0:3:ba:e:f3:75, Host ID: 83000ef3.



Rebooting with command: boot net -o prompt                            
Boot device: /pci@1f,0/network@c,1  File and args: -o prompt

boot> 3des=9ebc7a57f240e97c9b9401e9d3ae9b292943d3c143d07f04

boot> sha1=b482aaab82cb8d5631e16d51478c90079cc1d463

boot> go

The previous commands perform the following tasks.

Installs the 3DES encryption key with the value 9ebc7a57f240e97c9b9401e9d3ae9b292943d3c143d07f04 on the client
Installs the HMAC SHA1 hashing key with the value b482aaab82cb8d5631e16d51478c90079cc1d463 on the client
Starts the installation

To Perform a WAN Boot Installation With a DHCP Server

If you configured a DHCP server to support WAN boot options, you can use the DHCP server to provide client configuration information during the installation. For more information about configuring a DHCP server to support a WAN boot installation, see (Optional) Providing Configuration Information With a DHCP Server.

This procedure makes the following assumptions.

The client system is running.
You have either installed keys on the client, or you are performing an insecure installation.
For information about installing keys on the client before your installation, see Installing Keys on the Client.
You have configured your DHCP server to support the SbootURI and SHTTPproxy WAN boot options.
These options enable the DHCP server to provide the configuration information that is required by WAN boot.
For information about how to set installation options on your DHCP server, see Preconfiguring System Configuration Information With the DHCP Service (Tasks).

If the client system is currently running, bring the system to run level 0.
```
# init 0
```
The ok prompt is displayed.
At the ok prompt on the client system, set the network boot argument variables in OBP.
```
ok setenv network-boot-arguments dhcp,hostname=client-name
```
setenv network-boot-arguments

Instructs the OBP to set the following boot arguments

dhcp

Instructs the OBP to use the DHCP server to configure the client

hostname=client-name

Specifies the host name you want to assign to the client
Boot the client from the network.
```
ok boot net - install
```
net - install

Instructs the client to use the network boot argument variables to boot from the WAN

The client installs over the WAN. If the WAN boot programs do not find all the necessary installation information, the wanboot program prompts to provide the missing information. Type the additional information at the prompt.

Example 12-6 WAN Boot Installation With a DHCP Server

In the following example, the DHCP server on the network provides client configuration information. This sample requests the host name myclient for the client.

ok setenv network-boot-arguments dhcp, hostname=myclient

ok boot net - install
Resetting ...



Sun Blade 100 (UltraSPARC-IIe), No Keyboard
Copyright 1998-2003 Sun Microsystems, Inc.  All rights reserved.
OpenBoot 4.x.build_28, 512 MB memory installed, Serial #50335475.
Ethernet address 0:3:ba:e:f3:75, Host ID: 83000ef3.



Rebooting with command: boot net - install
Boot device: /pci@1f,0/network@c,1  File and args: - install

To Perform a WAN Boot Installation With Local CD Media

If your client's OBP does not support WAN boot, you can install with a Solaris Software - 1 CD inserted in the client's CD-ROM drive. When you use a local CD, the client retrieves the wanboot program from the local media, rather than from the WAN boot server.

This procedure assumes that you are using HTTPS in your WAN installation. If you are performing an insecure installation, do not display or install the client keys.

Follow these steps to perform a WAN boot installation from a local CD.

Assume the same user role as the web server user on the WAN boot server.
Display the key value for each client key.
```
# wanbootutil keygen -d -c -o net=net-ip,cid=client-ID,type=key-type
```
net-ip

The network IP address for the client you are installing.

client-ID

The ID of the client you are installing. The client ID can be a user-defined ID or the DHCP client ID.

key-type

The key type you are installing on the client. Valid key types are 3des, aes, or sha1.

The hexadecimal value for the key is displayed.
Repeat the previous step for each type of client key you are installing.
On the client system, insert the Solaris Software - 1 CD in the CD-ROM drive.
Power on the client system.
Boot the client from the CD.
```
ok boot cdrom -o prompt -F wanboot - install
```
cdrom

Instructs the OBP to boot from the local CD-ROM

-o prompt

Instructs the wanboot program to prompt the user to enter client configuration information

-F wanboot

Instructs the OBP to load the wanboot program from the CD-ROM

- install

Instructs the client to perform a WAN boot installation

The client's OBP loads the wanboot program from the Solaris Software - 1 CD. The wanboot program boots the system, and the boot> prompt is displayed.
Type the encryption key value.
```
boot> 3des=key-value
```
3des=key-value
Specifies the hexadecimal string of the 3DES key that is displayed in step Step 2.
If you use an AES encryption key, use the following format for this command.
```
boot> aes=key-value
```
Type the hashing key value.
```
boot> sha1=key-value
```
sha1=key-value

Specifies the hexadecimal string that represents the hashing key value that is displayed in step Step 2.
Set the network interface variables.
```
boot> variable=value[,variable=value*]
```
Type the following variable and value pairs at the boot> prompt.
host-ip=client-IP

Specifies the IP address of the client.

router-ip=router-ip

Specifies the IP address of the network router.

subnet-mask=mask-value

Specifies the subnet mask value.

hostname=client-name

Specifies the host name of the client.

(Optional) http-proxy=proxy-ip:port

Specifies the IP address and port number of the network's proxy server.

bootserver=wanbootCGI-URL

Specifies the URL of the wanboot-cgi program on the web server.

Note - The URL value for thebootserver variable must not be an HTTPS URL. The URL must start with http://.

You can enter these variables in the following ways.
- Type one variable and value pair at the boot> prompt, then press the Return key.
```
boot> host-ip=client-IP
boot> subnet-mask=mask-value
```
- Type all the variable and value pairs on one boot> prompt line, then press the Return key. Type commas to separate each variable and value pair.
```
boot> host-ip=client-IP,subnet-mask=mask-value,
router-ip=router-ip,hostname=client-name,
http-proxy=proxy-ip:port,bootserver=wanbootCGI-URL
```
Type the following command to continue the boot process.
```
boot> go
```
The client installs over the WAN. If the WAN boot programs do not find all the necessary installation information, the wanboot program prompts to provide the missing information. Type the additional information at the prompt.

Example 12-7 Installing With Local CD Media

In the following example, the wanboot program on a local CD prompts you to set the network interface variables for the client during the installation.