C H A P T E R 3 - Software Configuration

C H A P T E R 3

Software Configuration

This chapter contains the following sections:

Section 3.1, Operating Systems

Section 3.2, Installing Diskless Clients

Section 3.3, Hot Swap Information

Section 3.4, Retrieving Device Information

Section 3.5, Downloading and Installing SunVTS Software

3.1 Operating Systems

The Netra CP3010 board supports the Solaris 10 OS and subsequent compatible versions, and the Solaris 9 9/05 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 Netra CP3010 Board Product Notes (819-1181) 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 Installing Diskless Clients

The following procedures describes 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 root (i.e.; superuser) password on your diskless server to perform the following tasks.

3.2.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.2.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 into the network server as superuser and change directories to the /usr/sadm/bin directory.

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

# ./smosservice add -u root -p root_password -- -x mediapath=image_directory -x platform=sparc.sun4u.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, either 10 or 9.

locale is the locale that you want to use

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

For example, if the following entries were used for each variable, the command would appear as follows.

root_password = root_password

image_directory = /export/install

locale = en_US

n = 10 (for Solaris 10)

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

4. Download and install additional patches.

Refer to the Netra CP3010 Board Product Notes (819-1181) for the latest information on the patches available for the Netra CP3010 board. The document can be downloaded from the following web site:

http://www.sun.com/documentation

Follow the instructions in the Netra CP3010 Board Product Notes (819-1181) for downloading and applying patches to a diskless clients boot server.

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

3.2.2 Adding a Diskless Client

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

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

2. Log into the patched boot server as superuser.

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

the client's IP address

the client's ethernet address

the client's host name

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

# cd /usr/sadm/bin

5. Set up the diskless clients.

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

# ./smdiskless add -- -i ip_address -e ethernet_address -n host_name\

-x os=sparc.sun4u.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, if the following entries were used for each variable, the command would appear as follows.

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

# ./smdiskless add -- -i 129.144.214.999 -e 8:0:20:22:b3:aa -n client_host -x os=sparc.sun4u.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

You have to 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:

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.3 Hot Swap Information

The Netra CP3010 board supports hot-swapping and includes a blue Hot-Swap LED.

3.3.1 Hot-Swapping the Netra CP3010 Board

If the Solaris OS is running on a Netra CP3010 board and you open the board's latches, you see a message that the operating system will shut down in one minute. When the operating environment drops to the OpenBoot PROM prompt level, you can safely remove the board.

3.3.1.1 Hot-Swap LED

The blue Hot-Swap LED, located on the front panel of the Netra CP3010 board (FIGURE 1-1), blinks when a hot-swap is initiated, and lights steady when the board is ready to be removed from the system.

Unlatching the bottom latch on the Netra CP3010 board initiates the hot-swap sequence. The LED lights steady when the board can be safely removed from the system. The reverse is true when a Netra CP3010 board is installed into the system. Once the Netra CP3010 board is installed into the system and the bottom latch is latched, the blue hot-swap LED blinks until the board is ready and then turns off. The green LED lights steady when the board is ready.

FIGURE 3-1 shows the hot-swap latch and Hot-Swap LED.

FIGURE 3-1 Hot-Swap Latch and Hot-Swap LED

Figure showing hot-swap LED and bottom latch which activates the hot-swap.

3.4 Retrieving Device Information

You use the Solaris platform information and control library (PICL) framework for obtaining the state and condition of the Netra CP3010 board.

The PICL framework provides information about the system configuration that it maintains in the PICL tree. Within this PICL tree is a subtree named frutree, which represents the hierarchy of system FRUs with respect to a root node in the tree called chassis. The frutree represents physical resources of the system. The PICL tree is updated whenever a change occurs in a device's status.

The prtpicl -v command shows the condition of all devices in the PICL tree. Sample output from the prtpicl command related to the Netra CP3010 board is shown in FIGURE 3-2.

FIGURE 3-2 Sample Output of the prtpicl -v Command

Figure showing sample output of prtpicl -v command.

TABLE 3-1 shows the frutree entries and properties that describe the condition of the Netra CP3010 board.

TABLE 3-1 PICL Frutree Entries and Description for the Netra CP3010 Board
Frutree Entry:Property	Entry Description	Example of Condition
CPU (location) :`State`	The state of the receptacle, or slot	`connected`
CPU (fru) :`Condition`	The condition of the board, or occupant	`ok`
CPU (fru) :`State`	The state of the board, or occupant	`configured`
CPU (fru) :`FRUType`	The FRU type	`bridge/fhs`

For more information on the PICL framework, refer to the picld(1M) man page.

3.5 Downloading and Installing SunVTS Software

SunVTS trademark software is a comprehensive suite that tests and validates the Netra CP3010 board by verifying the configuration and function of most hardware controllers and devices on the board. 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

To obtain SunVTS documentation, contact your local customer service representative or field application engineer.

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.