C H A P T E R  1

Performing General Administrative Tasks

This chapter describes how to perform general administrative tasks on the Sun Fire V215 and V245 servers. The following topics are discussed:


Understanding the System Prompts

The following default server prompts are used by the Sun Fire V215 and V245 servers:

FIGURE 1-1 shows the relationship between the three prompts and how to change from one prompt to another.


FIGURE 1-1 System Prompt Flow Diagram

Process flow diagram. This diagram describes how to go obtain ALOM, OpenBoot PROM, or Solaris superuser prompts by using a console or by using the shutdown, halt, or init 0 commands.



Controlling Server Power

This section contains procedures for controlling the server power.



caution icon

Caution - Before you remove or replace a system configuration card or DVD Dual drive, the server must be completely powered down by removing the power cord(s).





Tip - For detailed information on controlling server power with the ALOM software, go to: http://docs.sun.com




procedure icon To Power On the Server By Using the On/Standby Button



caution icon

Caution - Never move the system when the system power is on. Movement can cause catastrophic hard drive failure. Always power off the system before moving it.



1. Connect the server to an AC power source.

After the power cord is connected, the server automatically goes into Standby power mode.

2. Turn on power to any peripherals and external storage devices you have connected to the server.

Read the documentation supplied with the device for specific instructions.

3. Press the On/Standby button.

Verify that the LED for the On/Standby button illuminates.


procedure icon  To Power Off the Server By Using the On/Standby Button



Note - Applications running on the Solaris OS can be adversely affected by a poorly executed system shutdown. Ensure that you have gracefully shut down any applications before powering off the system.



1. Notify users that the system will be powered down.

2. Back up the system files and data, if necessary.

3. Press and release the On/Standby button.

The system begins an orderly software system shutdown.



Note - Pressing and releasing the On/Standby button initiates an orderly software shutdown. Pressing and holding the switch for four seconds causes an immediate hardware shutdown. Whenever possible, initiate an orderly shutdown. Forcing an immediate hardware shutdown can corrupt the hard drive and cause loss of data.



4. Wait for the front panel green power indicator to blink slowly.


procedure icon  To Power On the Server From the System Controller

You can power on the server from the system controller by using the poweron command at the SC console.

single-step bulletTo initiate the power-on sequence, issue the poweron command.

You see an sc> alert message on the system console. This indicates that the system has reset.


sc> poweron
SC Alert: Host System has Reset
sc>


Communicating With the System

To install your system software or to diagnose problems, you need some way to interact at a low level with the system. The system console is Sun's facility for doing this. You use the system console to view messages and issue commands. There can be only one system console per computer.

The serial management port (SER MGT) is the default port for accessing the system console upon initial system installation. After installation, you can configure the system console to accept input from and send output to different devices.

The system console displays status and error messages generated by firmware-based tests during system startup. After those tests have been run, you can enter special commands that affect the firmware and alter system behavior.

After the operating system is booted, the system console displays UNIX system messages and accepts UNIX commands.

Using the System Console

To use the system console, you need to attach an input/output device to the system. Initially, you might have to configure that hardware, and load and configure appropriate software as well.

You must also ensure that the system console is directed to the appropriate port on the server's back panel, generally, the one to which your hardware console device is attached (see FIGURE 1-2). You do this by setting the input-device and output-device OpenBoottrademark configuration variables.



Note - The connectors in FIGURE 1-2 are not representative of the physical location of the connectors on the server.




FIGURE 1-2 Directing the System Console

This illustration is a conceptual drawing showing the relationship between the system console and the external ports.


Connecting Through the Serial Management and Network Management Ports

On Sun Fire V215 and V245 servers, the system console comes preconfigured. Input and output is enabled only by means of hardware devices connected to the serial or network management ports. However, because the network management port is not available until you assign it an IP address, your first connection must be to the serial management port (SER MGT).

Typically, you connect one of the following hardware devices to the serial management port:

This provides for secure access at the installation site.

Using a TIP line enables you to use windowing and operating system features on the system making the connection to the server.

The serial management port is not a general-purpose serial port. If you want to use a general-purpose serial port with your server, to connect a serial printer, for instance, use the SER TTYB serial port on the back panel of the server. The Solaris OS sees this port as TTYB.

After you have assigned an IP address to the network management port (NET MGT), you can connect an Ethernet-capable device to the system console through your network. This provides for remote monitoring and control. In addition, up to eight simultaneous connections to the system controller sc> prompt are available through the network management port.

Configuring an Alternative System Console

In the default configuration, system controller alerts and system console output appear interspersed in the same window. After initial system installation, you can redirect the system console to take its input from and send its output to a graphics card's port.

For the following reasons, the best practice is to leave the console port in its default configuration:

You change the system console configuration by setting OpenBoot configuration variables. See Using the OpenBoot Configuration Variables.

Accessing the System Console Through a Graphics Monitor

The Sun Fire V215 and V245 servers are shipped without a mouse, keyboard, monitor, or frame buffer for the display of bitmapped graphics. To install a graphics monitor on the server, you must install a graphics accelerator card into a PCI slot, and attach a monitor, mouse, and keyboard to the appropriate front or rear USB ports.

After starting the system, you might need to install the correct software driver for the PCI card you have installed. For detailed hardware instructions, see Accessing the System Console Through a Local Graphics Monitor.



Note - POST diagnostics cannot display status and error messages to a local graphics monitor.



Connecting to the System Console

Output from POST, OpenBoot, and the Solaris OS is displayed in the system console using the network console on the system controller. Use the following procedure to connect to the system console.


procedure icon  To Connect to the System Console

single-step bulletExecute the console command, and use the -f option to force the console to be attached to your session.

Multiple users can be connected to the console, but only one can be attached.


sc> console -f
Enter #. to return to ALOM.

Accessing the System Console Through a Terminal Server

The following procedure assumes that you are accessing the system console by connecting a terminal server to the serial management port (SER MGT) of the server.



Note - The figure in this section shows the Sun Fire V245 server; however, the procedure applies to the Sun Fire V215 as well.




procedure icon  To Access The System Console Through a Terminal Server

1. Complete the physical connection from the serial management port to your terminal server.

The serial management port on the server is a data terminal equipment (DTE) port. The pinouts for the serial management port correspond with the pinouts for the RJ-45 ports on the Serial Interface Breakout Cable supplied by Cisco for use with the Cisco AS2511-RJ terminal server. If you use a terminal server made by another manufacturer, check that the serial port pinouts of the server match those of the terminal server you plan to use.


FIGURE 1-3 Patch Panel Connection Between a Terminal Server and a Sun Fire V245 Server

This illustration shows how to connect a patch cable between a terminal server, patch panel, and the serial management port on the server.


TABLE 1-1 shows the cross-overs that the cable must perform.

 


TABLE 1-1 Pin Crossovers for Connecting to a Typical Terminal Server

Sun Fire V245 Serial Port (RJ-45 Connector) Pin

Terminal Server Serial Port Pin

Pin 1 (RTS)

Pin 1 (CTS)

Pin 2 (DTR)

Pin 2 (DSR)

Pin 3 (TXD)

Pin 3 (RXD)

Pin 4 (Signal Ground)

Pin 4 (Signal Ground)

Pin 5 (Signal Ground)

Pin 5 (Signal Ground)

Pin 6 (RXD)

Pin 6 (TXD)

Pin 7 (DSR /DCD)

Pin 7 (DTR)

Pin 8 (CTS)

Pin 8 (RTS)


2. Open a terminal session on the connecting device, and type:


% telnet IP-address-of-terminal-server port-number

For example, for a server connected to port 10000 on a terminal server whose IP address is 192.20.30.10, you would type:


% telnet 192.20.30.10 10000

Accessing the System Console Through a TIP Connection

This procedure assumes that you are accessing the system console by connecting the serial port of another Sun system to the serial management port of the Sun Fire V245 server (FIGURE 1-4).



Note - The figure in this section shows the Sun Fire V245 server; however, the procedure applies to the Sun Fire V215 as well.




FIGURE 1-4 TIP Connection Between a Sun Fire V245 Server and Another Sun System

This illustration shows a TIP connection between the serial port on another Sun system and the serial management port on the server.



procedure icon  To Access the System Console Through the TIP Connection

1. Connect the RJ-45 serial cable.

The cable and adapter connect between another Sun system's serial port (typically TTYB) and the serial management port on the rear panel of the server.

2. Ensure that the /etc/remote file on the Sun system contains an entry for hardwire.

Most releases of Solaris OS software shipped since 1992 contain an /etc/remote file with the appropriate hardwire entry. However, if the Sun system is running an older version of Solaris OS software, or if the /etc/remote file has been modified, you might need to edit it. See Modifying the /etc/remote File for details.

3. In a shell tool window on the Sun system, type:


% tip hardwire 

The Sun system responds by displaying:


connected 

The shell tool is now a TIP window directed to the server through the Sun system's serial port. This connection is established and maintained even when the server is completely powered off or just powering on.



Note - Use a shell tool or a CDE terminal (such as dtterm), not a command tool. Some tip(1) commands might not work properly in a command tool window.



Modifying the /etc/remote File

This procedure might be necessary if you are accessing the server using a TIP connection from a Sun system running an older version of the Solaris OS software. You might also need to perform this procedure if the /etc/remote file on the Sun system has been altered and no longer contains an appropriate hardwire entry.

This procedure assumes that you are logged in as superuser to the system console of a Sun system that you intend to use to establish a TIP connection to the Sun Fire V245 server.


procedure icon  To Modify the /etc/remote File

1. Determine the release level of Solaris OS software installed on the Sun system. Type:


# uname -r

The system responds with a release number.

2. Take one of the following actions, depending on the number displayed.

The Solaris OS software shipped with an appropriate entry for hardwire in the /etc/remote file. If you have reason to suspect that this file was altered and the hardwire entry was modified or deleted, check the entry against the following example, and edit it as needed.


hardwire:\   
	:dv=/dev/term/b:br#9600:el=^C^S^Q^U^D:ie=%$:oe=^D:



Note - If you intend to use the Sun system's serial port A rather than serial port B, edit this entry by replacing /dev/term/b with /dev/term/a.



Check the /etc/remote file and add the following entry, if it does not already exist.


hardwire:\   
	:dv=/dev/ttyb:br#9600:el=^C^S^Q^U^D:ie=%$:oe=^D:



Note - If you intend to use the Sun system's serial port A rather than serial port B, edit this entry by replacing /dev/ttyb with /dev/ttya.



The /etc/remote file is now properly configured. Continue establishing a TIP connection to the system console. See Accessing the System Console Through a TIP Connection.

If you have redirected the system console to TTYB and want to change the system console settings back to use the serial management and network management ports, see Using the OpenBoot Configuration Variables.

Accessing the System Console Through an Alphanumeric Terminal

This procedure assumes that you are accessing the system console by connecting the serial port of an alphanumeric terminal to the serial management port of the Sun Fire V245 server.


procedure icon  To Access the System Console Through an Alphanumeric Terminal

1. Attach one end of the serial cable to the alphanumeric terminal's serial port.

Use a null modem serial cable or an RJ-45 serial cable and null modem adapter. Connect this cable to the terminal's serial port connector.

2. Attach the opposite end of the serial cable to the serial management port on the server.

3. Connect the alphanumeric terminal's power cord to an AC outlet.

4. Set the alphanumeric terminal to receive:

Refer to the documentation accompanying your terminal for information about how to configure the terminal.

You can issue system commands and view system messages using the alphanumeric terminal. Continue with your installation or diagnostic procedure, as needed. When you are finished, type the alphanumeric terminal's escape sequence.

Accessing the System Console Through a Local Graphics Monitor

After initial system installation, you can install a local graphics monitor and configure it to access the system console. You cannot use a local graphics monitor to perform initial system installation, nor can you use a local graphics monitor to view power-on self-test (POST) messages.

To install a local graphics monitor, you must have the following items:


procedure icon  To Access the System Console Through a Local Graphics Monitor

1. Install the graphics card into an appropriate PCI slot.

Installation must be performed by a qualified service provider. For further information, refer to the Sun Fire V215 and V245 Servers Service Manual or contact your qualified service provider.

2. Attach the monitor's video cable to the graphics card's video port.

Tighten the thumbscrews to secure the connection.

3. Connect the monitor's power cord to an AC outlet.

4. Connect the USB keyboard cable to one of the USB ports on the rear panel and the USB mouse cable to the USB port on the keyboard.

5. Obtain the ok prompt.

6. Set OpenBoot configuration variables, as appropriate.

If you have changed the default input and output devices, change the settings back to the defaults by typing:


ok setenv input-device keyboard
ok setenv output-device screen



Note - There are many other system configuration variables. Although these variables do not affect which hardware device is used to access the system console, some of them affect which diagnostic tests the system runs and which messages the system displays at its console.



7. To cause the changes to take effect, type:


ok reset-all

The system stores the parameter changes, and boots automatically when the OpenBoot configuration variable auto-boot? is set to true (the default value).



Note - To store parameter changes, you can also power cycle the system using the front panel Power button.



You can issue system commands and view system messages using your local graphics monitor. If you want to redirect the system console back to the serial management and network management ports, see Using the OpenBoot Configuration Variables.

Using the OpenBoot Configuration Variables

The system console is directed to the serial management and network management ports (SER MGT and NET MGT). If you have connected a graphics monitor the output is directed to that device by default. You can also redirect the system console back to the serial management and network management ports.

Certain OpenBoot configuration variables control from where system console input is taken and to where its output is directed. The following table shows how to set these variables in order to use the serial management and network management ports, or a local graphics monitor as the system console connection.


TABLE 1-2 OpenBoot Configuration Variables That Affect the System Console

OpenBoot Configuration Variable Name

Setting for Sending System Console Output to:

Serial and
Network Management Ports

Local Graphics Monitor/USB Keyboard and Mouse*

output-device

virtual-console

screen

input-device

virtual-console

keyboard


* POST output is still directed to the serial management port, as POST has no mechanism to direct its output to a graphics monitor.

The serial management port does not function as a standard serial connection. If you want to connect a conventional serial device (such as a printer) to the system, you must connect it to TTYA not the serial management port.

It is important to note that the sc> prompt and POST messages are only available through the serial management port and network management port. In addition, the ALOM console command is ineffective when the system console is redirected to a local graphics monitor.

Switching Between the ALOM System Controller and the System Console

The Sun Fire V215 and V245 servers feature two management ports, labeled SER MGT and NET MGT, located on the server's rear panel. If the system console is directed to use the serial management and network management ports, these ports provide access to both the system console and the ALOM, each on a separate channel (see FIGURE 1-5).


FIGURE 1-5 Separate System Console and System Controller Channels

 [ D ]


If the system console is configured to be accessible from the serial management and network management ports, when you connect through one of these ports you can access either the ALOM command-line interface or the system console. You can switch between the ALOM interface and the system console at any time, but you cannot access both at the same time from a single terminal window or shell tool.

The prompt displayed on the terminal or shell tool tells you which channel you are accessing:



Note - If no text or prompt appears, it might be that no console messages were recently generated by the system. If this happens, pressing the terminal's Enter or Return key should produce a prompt.



To reach the system console from the ALOM system controller, type the console command at the sc> prompt. To reach the ALOM system controller from the system console, type the system controller escape sequence, which by default is #. (pound period).


Resetting the Server

At times, you might need to reset the server. Follow the instructions in this section to do so. If the server is not responding to the reset, you will have to cycle the power. This section includes a procedure to cycle the power.


procedure icon  To Reset the Server

single-step bulletIf it is necessary to reset the server, use the uadmin command.


# uadmin 2 1

To simply reset the server, it is not necessary to power the system off and on.


procedure icon  To Power Cycle the Server

If a simple reset does not clear a problem, you can power the server off and on with this procedure.

1. Shut down the Solaris OS.

At the Solaris OS prompt, issue the uadmin command to halt the Solaris OS and to return to the ok prompt.


# uadmin 2 0
WARNING: proc_exit: init exited
syncing file systems... done
Program terminated
ok

2. Switch from the system console prompt to the SC console prompt by issuing the #. escape sequence.


ok #.
sc>

3. Issue the poweroff command.


sc> poweroff -fy
SC Alert: SC Request to Power Off Host Immediately.

4. Issue the poweron command.


sc> poweron
sc> SC Alert: Host System has Reset

5. Reconnect to the system console using the console command.


sc> console -f
Enter #. to return to ALOM.

The server outputs various messages, followed by the ok prompt.


Controlling the Locator Indicator

This section explains how to turn the Locator indicator on and off and how to check the status of the Locator indicator.


procedure icon  To Turn the Locator Indicator On

single-step bulletDo one of the following:


procedure icon  To Turn the Locator Indicator Off

single-step bulletDo one of the following:


procedure icon  To Display Locator Indicator Status

single-step bulletDo one of the following:


Selecting a Boot Device

The boot device is specified by the setting of an OpenBoot configuration variable called boot-device. The default setting of this variable is disk net. Because of this setting, the firmware first attempts to boot from the system hard drive, and if that fails, from the on-board NET0 Gigabit Ethernet interface.

This procedure assumes that you are familiar with the OpenBoot firmware and that you know how to enter the OpenBoot environment. If you want to boot from a networked device, you must connect the network interface to the network.


procedure icon  To Select a Boot Device

single-step bulletAt the ok prompt, type:


ok setenv boot-device device-specifier

where device-specifier is one of the following:



Note - The Solaris OS modifies the boot-device variable to its full path name, not the alias name. If you choose a nondefault boot-device variable, the Solaris OS specifies the full device path of the boot device.





Note - You can specify the name of the program to be booted as well as the way the boot program operates. For more information, refer to the OpenBoot 4.x Command Reference Manual for your specific Solaris OS release.



If you want to specify a network interface other than an on-board Ethernet interface as the default boot device, you can determine the full path name of each interface by typing:


ok show-devs

The show-devs command lists the system devices and displays the full path name of each PCI device.


Updating the Firmware

The flashupdate command updates both the service processor firmware and the host firmware.

The flash image consists of the following components:

To use the features and fixes in subsequent firmware releases, perform this procedure.


procedure icon  To Update the Firmware

1. Ensure that the SC Ethernet management port is configured.

This is required to access the new flash image over the network.

2. Open a Telnet session and connect to the system controller, as in the following example.


% alternate 129.xxx.xx.xx
Trying 129.xxx.xx.xx...
Connected to 129.xxx.xx.xx.
Escape character is'^]'.
Use is subject to license terms.
Symptom) Advanced Lights Out Manager 1.0.11 ()
Please login:

Substitute the IP address of your system controller.

3. Login as admin, using the password you defined during the configuration of the system controller.


Please login: admin 
Please Enter password: password
sc>

4. Execute flashupdate command.

The flashupdate SC command updates the system controller flash image. The flashupdate command requires the following information:

The command usage is as follows:

flashupdate [-s IP-address -f pathname] [-v]

5. Reset the system controller.

After the flash has been updated, you must reset the system controller for the new image to take effect. To reset the system controller, issue the resetsc command. When you issue this command, you will be prompted to confirm that you want to reset the system controller. Reply y when prompted.



Note - To bypass the confirmation prompt, you can use the -y flag with the resetsc command. If resetsc is issued from a Telnet session, upon reset the Telnet session will be terminated. The output from the reset will be displayed on the serial console on the system controller.




sc> resetsc
Are you sure you want to reset the SC [y/n]? y
User Requested SC Shutdown

The system controller resets, runs diagnostics, and returns to the login prompt. The following example is for the serial console.


ALOM POST 1.0
 
 
Dual Port Memory Test, PASSED.
 
TTY External - Internal Loopback Test
          TTY External - Internal Loopback Test, PASSED.
 
TTYC - Internal Loopback Test
          TTYC - Internal Loopback Test, PASSED.
 
TTYD - Internal Loopback Test
          TTYD - Internal Loopback Test, PASSED.
 
....................
 
 
Full VxDiag Tests - PASSED
 
 
 
    Status summary  -  Status = 7FFF
 
       VxDiag    -          -  PASSED
       POST      -          -  PASSED
       LOOPBACK  -          -  PASSED
 
       I2C       -          -  PASSED
       EPROM     -          -  PASSED
       FRU PROM  -          -  PASSED
 
       ETHERNET  -          -  PASSED
       MAIN CRC  -          -  PASSED
       BOOT CRC  -          -  PASSED
 
       TTYD      -          -  PASSED
       TTYC      -          -  PASSED
       MEMORY    -          -  PASSED
       MPC885    -          -  PASSED
 
 
Please login: