Solaris Express Installation Guide: Network-Based Installations

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. 

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. 

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. 

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

  1. If the client system is currently running, bring the system to run level 0.


    # init 0
    

    The ok prompt is displayed.

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

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


See Also

For more information about how to set network boot arguments, see set(1).

For more information about how to boot a system, see boot(1M).

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

  1. Assume the same user role as the web server user on the WAN boot server.

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

  3. Repeat the previous step for each type of client key you are installing.

  4. If the client system is currently running, bring the client to run level 0.

  5. 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://.


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

  7. 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
    
  8. Install the hashing key.


    boot> sha1=key-value
    
    sha1=key-value

    Specifies the hashing key value that is displayed in Step 2.

  9. Type the following command to continue the boot process.


    boot> go
    

    The client installs over the WAN.

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

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.


See Also

For more information about how to display key values, see wanbootutil(1M).

For more information about how to set network boot arguments, see set(1).

For more information about how to boot a system, see boot(1M).

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

  1. If the client system is currently running, bring the system to run level 0.


    # init 0
    

    The ok prompt is displayed.

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

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

See Also

For more information about how to set network boot arguments, see set(1).

For more information about how to boot a system, see boot(1M).

For more information about how to configure a DHCP server, see (Optional) Providing Configuration Information With a DHCP Server.

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

  1. Assume the same user role as the web server user on the WAN boot server.

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

  3. Repeat the previous step for each type of client key you are installing.

  4. On the client system, insert the Solaris Software - 1 CD in the CD-ROM drive.

  5. Power on the client system.

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

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

  9. 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
      
  10. 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.

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.

Boot and install the client.


ok boot cdrom -o prompt -F wanboot - 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 cdrom -F wanboot - install                            
Boot device: /pci@1f,0/network@c,1  File and args: -o prompt

boot> 3des=9ebc7a57f240e97c9b9401e9d3ae9b292943d3c143d07f04

boot> sha1=b482aaab82cb8d5631e16d51478c90079cc1d463

boot> host-ip=192.168.198.124

boot> subnet-mask=255.255.255.128

boot> router-ip=192.168.198.1

boot> hostname=myclient
boot> client-id=010003BA152A42

boot> bootserver=http://192.168.198.135/cgi-bin/wanboot-cgi

boot> go

The previous commands perform the following tasks.


See Also

For more information about how to display key values, see wanbootutil(1M).

For more information about how to set network boot arguments, see set(1).

For more information about how to boot a system, see boot(1M).