C H A P T E R 2 - Initial Configuration

C H A P T E R 2

Initial Configuration

This chapter describes how to set up and boot the switch and how to access the command-line interfaces (CLI).

This chapter contains the following sections:

Initial Set Up"

Accessing the Command-Line Interface

Event and Message Logs

System Log Proxy

Initial Set Up

The Sun IB switch is initialized with a default IP address (10.0.0.1), a default IP mask (255.255.255.0) and a default IP router (10.0.0.5) when shipped, so that the switch could be used with no pre-configurations. However, without the configuration described in the following procedure, access to the switch could be limited, and the use of the System Log proxy would be impossible.

The IP address, IP mask, and IP router values can be changed either by using the setupsc command (see setupsc) in ALOM CLI accessed through the default IP address or through the serial line or by connecting a serial cable between your host and the switch and following the steps below. If you are replacing a switch in a running cluster, read Appendix D before setting the IP address.

1. To connect to the switch, enter the following command on the host:

# tip -9600 /dev/ttya

2. Power on the switch.

When the switch boots, press CTRL-X on the keyboard to stop the boot at the boot monitor with the > prompt.

3. Issue the following commands:

> set ipv4-addr 129.189.145.52

> set ipv4-mask 255.255.255.0

> set ipv4-router 129.189.145.5

Note - Ensure that you use your own IP addresses instead of those shown in the example. Use only numerical IP addresses. Symbolic host names are not supported.

Note - If you need to get back to the boot monitor to change any addresses, do the following:
Connect to the serial management port. Reboot the switch while you press CTRL-X on the keyboard.

4. To continue booting the switch, issue the boot command:

> boot

The system boots. When the system is booted, it asks for a username.

5. Log in with the username admin:

Sun Advanced Lights Out Manager for Sun IB Switch 9P

Copyright 2003-2005 Sun Microsystems, Inc. All Rights Reserved.

username: admin

Password:

sc>

No default password is set. Press the Return key.

6. To access all the ALOM commands, set the password for the admin user:

sc> password

Enter new password: type your password

Enter new password again: type your password again

New password set for user admin successfully

sc>

Accessing the Command-Line Interface

The Sun IB switch uses the ALOM command-line interface (CLI).

To Access the CLI

1. Log in as admin and enter in the password you just set up:

Sun Advanced Lights Out Manager for Sun IB Switch 9P

Copyright 2003-2005 Sun Microsystems, Inc. All Rights Reserved.

ALOM-B 1.2

username: admin

password:

2. Use the setdate command to synchronize the switch with the time at your site:

sc> setdate mmddHHMMccyy.SS

Note - ALOM uses Coordinated Universal Time (UTC). ALOM does not accept time zone conversions or daylight time changes.

You can use all the setdate command options or just set the time:

This example sets the time to August 30, 2005, at 11:28 (11:28 AM) (Coordinated Universal Time).

sc> setdate 083011282005

Tue Aug 30 11:28:03 UTC 2005

This example sets the time to 11:28 (11:28 AM) of the current month, day, and year (Coordinated Universal Time).

sc> setdate 1128

Tue Aug 30 11:28:03 UTC 2005

3. Type help at the sc> prompt to get a list of the valid CLI commands.

sc> help

flashupdate [-v] [-y] [-F] -s IPaddress -f pathname

help [command]

logout

password

poweroff [-y] [-f] [-r] [-F] {frulist}

poweron [-F] {frulist}

removefru [-y] [-f] [-F] {frulist}

resetsc [-y][-F]

setbp [-i]

setdate [mmdd]HHMM[.SS] | mmddHHMM[cc]yy[.SS]

setdefaults [-y]

setlocator {on|off}

setupsc

showbp [-r]

showdate

showenvironment [-v] [{frulist}]

showfru {frulist}

showib [-v]

showlocator

showlogs [-b lines | -e lines | -v] [-g lines] [-t] {frulist}

showplatform [-v] [{frulist}]

showsc

showusers

useradd username

userdel username

userpassword username

userperm username [a] [u] [c] [r]

usershow [username]sc>

See Chapter 3 for a full description of the CLI commands.

4. Install and set up the system log (syslog) proxy.

See Installing and Setting Up the System Log Proxy for instructions.

Event and Message Logs

The Sun IB switch provides the following types of logs and related messages:

Errors and important state changes related to a specific FRU are logged as part of the dynamic FRU information in non-volatile memory on the FRU itself. (This helps in diagnosing problems associated with FRUs being returned to Sun.)

Local system events are logged to the ALOM non-volatile event log and displayed on serial console and active Telnet connections.

Syslog servers support integration with event and message logs for the entire site and facilitate remote management through NetConnect and similar services.

System Log Proxy

Events occurring at or detected by software running at the switch are reported through system log (syslog) messages. The syslog messages are transferred to a Solaris host through a syslog proxy mechanism. The SUNWsibs9p Solaris package contains the necessary Solaris software and must be installed on a Solaris host in order to retrieve these messages from the switch.

Note - The switch will function fine without the syslog proxy installed, but the messages will be lost.

Installing and Setting Up the System Log Proxy

If you already have the syslog proxy installed or running, please stop it and remove the proxy first. See Removing the System Log Proxy.

The SUNWsibs9p Solaris package is available from the following web site:

http://www.sun.com/download

To Install the System Log Proxy

1. Become superuser:

$ su

Password:

2. Install the package on a Solaris host that connects to the switch:

# cd /tmp

# cp path_of_SUNWsibs9p_tarfile .

# gunzip SUNWsibs9p.tar.gz

# tar xvf SUNWsibs9p.tar

# pkgadd -d .

The package is now installed and the binaries and start scripts reside in the /opt/SUNWsibs9p/bin directory.

To Set Up the System Log Proxy

Before you can start the syslog proxy, you must update the config file with the IP address(es) of the IB switch(es) you want to access. Update two columns in each line of the config file (see format inside the config file). The config file is named /opt/SUNWsibs9p/bin/start_syslog.config

1. You can start the proxy in either of the following two ways:

a. Reboot the host system.

b. Perform a manual start:

$ /opt/SUNWsibs9p/bin/start_syslog -d /opt/SUNWsibs9p/bin start &

Multiple hosts can have a syslog proxy for the same IB switch running, but only one host actually receives and logs the messages.

2. Check to see which proxy is currently the selected proxy for the cluster:

$ /opt/SUNWsibs9p/bin/start_syslog -d /opt/SUNWsibs9p/bin who

The proxy receives messages from the switch and transfers them to the Solaris host syslog API for further processing, depending on the configuration of
/etc/syslog.conf file. Then the proxy logs the message in an appropriate system log, writes it to the system console, forwards it to a list of users, or forwards it to syslogd on another host over the network. Default user LOG_ALERT is used to add the syslog messages in the /var/adm/messages file on the host.

3. You can use the tail command to watch the messages:

$ tail -f /var/adm/messages

Note - If communication between the switch and the host is broken the 40 first messages are queued into a FIFO in the switch and are dequeued on the host when the proxy gets communication again. If the syslog proxy is never started or the switch syslog message FIFO is full, the next messages will be lost.

4. Verify that you have started the proxy:

$ ps -ef | grep syslog

You should see output similar to the following:

root 772 671 ...... /opt/SUNWsibs9p/bin/syslogProxy_x86 129.159.145.81 2740 start

root 292 1 0 14:08:36 ? 0:00 /usr/sbin/syslogd

root 671 667 ...... /bin/sh /opt/SUNWsibs9p/bin/start_syslog -d /opt/SUNWsibs9p/bin start

root 796 671 ...... /opt/SUNWsibs9p/bin/syslogProxy_x86 129.159.145.82 2740 start

Note - It is important that the start_syslog script is running all the time to ensure that the proxy is restarted if communication between the switch and the host times out or as a failover in case another proxy in the cluster is stopped.

You have now completed the initial configuration of the Sun IB switch.

Removing the System Log Proxy

If you need to remove the syslog proxy, use the following procedure.

To Remove the Proxy

1. Check to ensure that the proxy is running:

$ ps -ef | grep syslog

2. Stop the proxy:

$ /opt/SUNWsibs9p/bin/start_syslog -d /opt/SUNWsibs9p/bin stop

3. Remove the proxy:

$ pkgrm SUNWsibs9p