C H A P T E R 3

Software Installation

This chapter contains the following sections:

- Section 3.1, Operating Systems and Patches

- Section 3.2, Firmware Updates

- Section 3.3, Mandatory /etc/system File Entry

- Section 3.4, Installing Diskless Clients

- Section 3.5, Downloading and Installing SunVTS Software

##

3.1 Operating Systems and Patches

The Sun Netra CP3060 blade server supports the Solaris 10 6/06 OS and subsequent compatible versions, with supported Netra patches. The Solaris OS software can be downloaded from the Sun download center at:

`http://www.sun.com/download`

Note - Refer to the Sun Netra CP3060 Blade Server Product Notes (819-4966) for information on the Netra patches at `http://www.sun.com/documentation`.

For information on these versions of the Solaris OS, including installation, see the appropriate Solaris Documentation Collection at the Sun Documentation web site at:

`http://www.sun.com/documentation`

##

3.2 Firmware Updates

The Sun Netra CP3060 firmware updates can be downloaded from the Sun download center at:

`http://www.sun.com/download`

Note - For information on firmware updates, refer to the Sun Netra CP3060 Blade Server Product Notes (819-4966) which are available online at `http://www.sun.com/documentation`.

##

3.3 Mandatory `/etc/system` File Entry

A mandatory entry must be listed in the `/etc/system` file to ensure the optimal functionality of the blade server.

The following entry must be in the `/etc/system` file:

`set pcie:pcie_aer_ce_mask=0x1`

Check that the entry is present before deploying the blade server.

### To Check and Create the Mandatory `/etc/system` File Entry

1. Log in as superuser.

2. Check the `/etc/system` file to see if the mandatory line is present.

TABLE 3-1
    # more /etc/system
    *ident  "@(#)system     1.18 05/06/27 SMI" /* SVR4 1.5 */
    *
    * SYSTEM SPECIFICATION FILE
    .
    .
    .
    set pcie:pcie_aer_ce_mask=0x1
    .

3. If the entry is not there, add it.

Use an editor to edit the `/etc/system` file and add the entry.

4. Reboot the server.

##

3.4 Installing Diskless Clients

The following procedures describe how to create a boot server for diskless clients and how to add new diskless clients to the patched boot server. For additional instructions on installing diskless clients, refer to the appropriate Solaris Documentation Collection at the Sun Documentation web site at:

`http://www.sun.com/documentation`

You must have a superuser password on your diskless server to perform the following tasks.

### 3.4.1 Creating a Boot Server for Diskless Clients

Note - This procedure sets up a boot server by starting the operating environment services required for diskless clients. Once you have set up the boot server, see Section 3.4.2, Adding a Diskless Client for instructions on adding diskless clients to the boot server.

1. Verify that the IP addresses for all other network interfaces on the boot server have corresponding hostnames in the hosts database.

2. Log in to the network server as superuser and change to the `/usr/sadm/bin` directory.

TABLE 1
    # cd /usr/sadm/bin

3. Use the `smosservice` command to add boot services to the installation server.

Note - The following command is a single long entry. Do not press the Return key until you have typed the entire text string shown in the following command.

TABLE 2
    # ./smosservice add -u root -p root_password -- -x mediapath=image_directory -x platform=sparc.sun4v.Solaris_n -x cluster=SUNWCXall -x locale=locale

Where:

- root_password is the root password for the installation server

- image_directory is the path to the directory where the Solaris install image is stored

- N is the Solaris OS version you are using.

- locale is the locale that you want to use

Refer to the `smosservice`(1M) man page for more information and options.

For example:

TABLE 3
    # ./smosservice add -u root -p root_password -- -x mediapath=/export/install -x platform=sparc.sun4v.Solaris_10 -x cluster=SUNWCXall -x locale=en_US

Where:

- root_password = `root_password`

- image_directory = `/export/instal`l

- locale = `en_US`

- n = `10` (for Solaris 10)

4. Download and install additional patches.

Refer to the Sun Netra CP3060 Blade Server Product Notes (819-4966) for the latest information on the patches available for the Sun Netra CP3060 blade server. The document can be downloaded from the following web site:

`http://www.sun.com/documentation`

Follow the instructions in the Sun Netra CP3060 Blade Server Product Notes (819-4966) for downloading and applying patches to a diskless clients boot server.

5. After the patches are installed, follow the procedure in Section 3.4.2, Adding a Diskless Client.

### 3.4.2 Adding a Diskless Client

1. Prepare a patched boot server for the diskless clients.

Follow the steps in Section 3.4.1, Creating a Boot Server for Diskless Clients to create a boot server for the diskless clients.

2. Log in to the patched boot server as superuser.

3. Collect the following information for the diskless client you are adding:

- Client’s IP address

- Client’s Ethernet address

- Client’s host name

4. Change directories to the `/usr/sadm/bin` directory.

TABLE 4
    # cd /usr/sadm/bin

5. Set up the diskless clients.

For each diskless client, type the following command as superuser:

TABLE 5
    # ./smdiskless add -- -i ip_address -e ethernet_address -n host_name\
    -x os=sparc.sun4v.Solaris_n -x root=/export/root/host_name \
    -x swap=/export/swap/host_name -x swapsize=swap_size -x tz=time_zone \
    -x locale=locale -x ns=name_service -x nameserver=name_server

Where:

- ip_address is the client’s IP address

- ethernet_address is the client’s Ethernet address

- host_name is the client’s host name

- n is the Solaris OS version you are using, either `10` or `9`.

- swap_size is the size of the swap space that you will be using. The default is `24`, however your swap space should be the same amount as your memory

- time_zone is the client’s time zone

- locale is the client’s locale

- name_service is the client’s nameservice

- name_server is the nameserver’s hostname

Refer to the `smdiskless`(1M) man page for more information and options.

For example:

TABLE 6
    # ./smdiskless add -- -i 129.144.214.999 -e 8:0:20:22:b3:aa -n client_host -x os=sparc.sun4v.Solaris_10 -x root=/export/root/client_host -x swap=/export/swap/client_host -x swapsize=999 -x tz=US/Pacific -x locale=en_US -x ns=NIS -x nameserver=nameserver_host

Where:

- ip_address = `129.144.214.999`

- ethernet_address = `8:0:20:22:b3:aa`

- host_name = `client_host`

- n = `10` (for Solaris 10)

- swap_size = `128`

- time_zone = `US/Pacific`

- locale = `en_US`

- name_service = `NIS`

- name_server = `nameserver_host`

You must type your superuser password again after typing this command. The installation process should take roughly 5 minutes per client and about 15-30 minutes for the operating environment service to install; however, no progress is displayed on screen while the process is running. Do not cancel or kill the process until the process has successfully completed.

You should see messages similar to the following after a few moments, confirming that the command went through successfully the second time:

TABLE 7
    Login to client_host as user root was successful.
    Download of com.sun.admin.osservermgr.cli.OsServerMgrCli from client_host was
    successful.

6. Boot the diskless client.

##

3.5 Downloading and Installing SunVTS Software

SunVTS software is a comprehensive suite that tests and validates the Sun Netra CP3060 blade server by verifying the configuration and function of most hardware controllers and devices on the blade server. SunVTS software is used to validate a system during development, production, inspection, troubleshooting, periodic maintenance, and system or subsystem stressing. SunVTS software can be tailored to run on machines ranging from desktops to servers with modifiable test instances and processor affinity features.

You can perform high-level system testing by using the appropriate version of SunVTS software. For detailed information on SunVTS support and downloads, refer to the following web site:

`http://www.sun.com/oem/products/vts/`

Ensure that the SunVTS software version is compatible with the Solaris OS version being used. Information on the version of the SunVTS software installed can be found in the file:

`/opt/SUNWvts/bin/.version`

For the latest version of SunVTS document, go to: `http://www.sun.com/documentation`

Note - For security reasons, only a superuser is permitted to run SunVTS software. Installation and starting instructions are included with the software when it is downloaded.

Copyright © 2009 Sun Microsystems, Inc. All rights reserved.