Remote Management Solution

User Manual Part # 40-01-00003 for versions 4.0 to 4.4.5

Rackable Systems, Inc.

5. Inc.4. Rackable Systems. Inc. 2003-2005. .Roamer™ Remote Management Solution User’s Manual v. Inc. Trademarks used in this manual: Rackable Systems. Part # 40-01-00003 Copyright © Rackable Systems. and Rackable are trademarks of Rackable Systems. All rights reserved. Inc. disclaims any proprietary interest in trademarks and trade names other than its own. Rackable Systems.4..

Introduction Overview Centralized Management Organization of this manual Chapter 2 – Accessing the Module Remote Management Functions Networking Configuring a Linux Serial Console Microsoft Windows Serial Access Console (SAC) Chapter 3 – Menu Options Menu Access Menu Commands Note: VT100+ Statefulness Chapter 4 – Shell Mode Shell Mode Commands Chapter 5 – Server Commands LCD Access from the OS Linux scripting sample Appendix I: Connector Diagram Appendis II: RJ45 Pinout Diagram Contact Information 2 2 2 3 4 4 4 5 5 6 6 6 7 9 9 11 11 11 12 13 14 Page 1 .Table of Contents Chapter 1 .

and shell mode. so Page 2 . Organization of this Manual This manual provides details on using the Roamer™ Remote Management Solution. Initial power-on surge from a large rack of servers can cause electrical breakers to trip. The module has three modes: pass-through mode. This device is then available via the regular network as a central access point to all servers being managed remotely via the module. CPU load. When initially connected. However. This provides the ability to see the console messages. If the OS supports a serial console session. or maintenance message • LED or LCD can be used to help the operations staff locate servers to be serviced • Remote monitoring of the system power status and ambient case temperature • Power delay functionality minimizes peak power spike during rack-wide power on.Introduction Overview The Rackable Systems Roamer™ remote management solution provides standard motherboards with enhanced remote control capabilities as well as serial redirection. reducing spike power requirements by up to 52% All functionality can be scripted for automation through a serial port or from the local OS. Entering CTRL-6 will give access to the module commands in menu mode. Unresponsive systems can be given a “hard” reset or powered down. A server’s internal temperature can be monitored by the module’s temperature sensor. the session will be started in pass-through mode.Chapter 1 . accessed from the local OS or externally as above The module also allows for serial redirection when this function is supported by the underlying opterating system. hostname. Roamer provides true lights-out management of servers and clusters. and Windows 2003. Centralized Management Roamer is accessed via a standard RJ45 serial connection. Shell mode is designed for advanced scripting can be entered via a proper escape sequence – see the Chapter 4 for more information on shell mode. including: • Console access via serial redirection through the internal motherboard serial header (including BIOS access) • Management across LAN or isolated serial management network when used with a terminal server • Power control: out-of-band access allows rebooting/turning on and off servers • LCD screen can display text such as IP address. The Roamer prevents this by implementing a user assigned power-on delay value. The module options for remote management can be accessed by: • a menu that is accessible from a serial or telnet (when accessed via a terminal server) session • shell mode. this will be accessible in pass-through mode. A problematic server can be flagged for maintenance with an LED or a text message on its LCD. menu mode. Each module can be accessed directly via any terminal emulation package. in a typical data center. resulting in dramatically reduced workload for system administrators while improving overall availability. Examples of such devices include the Digi CM32 console management server and Cyclades TS-3000 terminal server. This session is available via the serial header on the motherboard. and obtain logging output or a management shell on the server over a serial connection. the standard method for remote management consists of installing a console management device and wiring each server to this device. Administration can be performed on countless servers from one central location through a simple serial connection. including most distributions of Linux.

and other. The BIOS settings can be changed through this interface.most boot processes are visible. Page 3 . This manual will guide you through these. allowing remote management of BIOS settings. Please take the time to read this manual in its entirety before attempting installation or operation. useful features of the Roamer.

such as the Digi CM32 or Cyclades TS-3000. Figure 1: putty Configuration Options This session is initiated from a terminal program such as HyperTerminal. Rackable Systems stocks a line of cables with the proper pinouts for connecting the module. Figure 1 shows the relevant option settings for using “putty”. providing remote access to console messages for analysis: these messages can also be routed to a console messages server • access to the BIOS settings via pass-through mode during boot • management functions in menu or shell mode The module also allows for serial redirection. a straight through ethernet patch cable can be used. providing the ability to see the console messages. When connecting the module to most Cyclades brand terminal servers. so all boot processes are visible. This device is then available via an ethernet network as a central access point to all servers being managed remotely. allowing remote management of BIOS settings. This session is available via the COM header on the motherboard. Minicom. please refer to Appendix II for the module’s serial RJ45 pinout. The BIOS setting can be changed through this interface. or VanDyke SoftwareTM SecureCRT TM. Connecting via one of these sessions requires: • Protocol: serial • Port: dependent upon client machine • Baud rate: 9600 (unless changed – see menu options) • Data/Parity/Stop bit settings: 8N1 • Flow control: none The “putty” utility in Windows can be used as the terminal session to access the module. For modern Digi or Cisco brand equipment. Page 4 . Each module is connected to this device via the serial interface. or collect the console messages to a centralized console server. For other equipment. Networking The module can be accessed via: • a direct telnet session through the console manager (such as unix telnet or putty in Windows) • connecting directly from a laptop using terminal emulation software (such as minicom or Hyperterm) Centralized management is provided using a terminal server (also called a serial concentrator or console manager).Chapter 2 – Accessing the Module Remote Management Functions The Rackable Systems Roamer™ remote management solution provides three basic levels of functionality: • serial redirection in pass-through mode.

To take advantage of this facility. 4.conf.Configuring a Linux® Serial Console The Linux serial console is available via the module while in pass-through mode.): s1:2345:respawn:/sbin/agetty -L -t 60 ttyS1 9600 vt102 Add the following to /etc/securetty to allow root logins: ttyS1 Alternate serial logins for /etc/inittab: a. Please see the Microsoft Windows documentation for usage of this feature.txt for further information about setting up services on serial ports in Linux.conf: console=tty0 console=ttyS1. see /usr/src/linux*/Documentation/serial-console. add the following to your kernel command line in either /etc/grub. mgetty: s1:2345:respawn:/sbin/mgetty ttyS1 b. 3. Another good source of inforomation on the subject is the Linux Serial HOWTO at the L inux Documentation Project (www. 2. This functionality is fully supported by the Remote Management Module in pass-through mode.9600 Add the following to /etc/inittab (See alternate serial logins for other options. Bash shell (if you want a root shell without a login prompt. Be wary of the security concerns here. To get kernel messages. Linux should be configured as follows: 1. Microsoft® Windows® Serial Access Console (SAC) In Microsoft Windows 2003. Page 5 .): s1:2345:respawn:/bin/bash </dev/ttyS1 >/dev/ttyS1 2>&1 If you have installed Linux kernel source documentation on your system. tldp. or /etc/lilo. Microsoft introduced a serial console known as which provides advanced administrative functions and a command shell over a serial port.

Reset the Phantom | | ESC . The + and – keys are used to change the current setting. Once the session is established. the menu prompt on the module is reached by entering the key sequence Ctrl-6 (in Hyperterminal. in module versions starting with 4. The menu ends with a prompt for a command.3 certain menu functions require a password phrase to be entered before accessing the menu function.Change the Baud Rate | | B .Enter a new power on delay The power on delay selection on the management menu prompts the user for a delay value. The contrast setting can range from 0 to 100. a menu will be displayed.Turn the Server On | | R . This function requires the “P4Confirm” password.Save LCD Message | | T . +---------------------------------------------+ | Rackable Systems | | Remote Management Module | | Copyright 2004 | | Firmware v4. The ESCAPE key is used to save the setting. independent of its current state. Tech Note: For this feature to work. When this key sequence is entered.Start/Stop Blinking Selecting this command will toggle the blink state of the LED(s).Show Saved LCD Message: Yes | | X . If power on delay is set to 10 seconds.Erase the LCD | | I . the help menu will read “Start Blinking”. Valid inputs are one number followed by a carriage return or a two digit number.Local OS Access: Yes | | P . If the LED is not blinking or is on.5 Help Menu Choose this menu item to adjust the LCD contrast for optimal viewing. This value can range from 0 to 99.4. if the server is turned on within 10 seconds. the module will exit the menu and return to serial redirection. the help menu will read “Stop Blinking”. If the LED is blinking. D . C – Adjust LCD contrast Figure 2: Roamer 4.4. If no input is received for 15 seconds.0. Each option is described in the following section. In all cases. Ctrl-Shift-6). If the “?” is entered. To keep the user from inadvertently making a mistake.Reset the Server | | S . the BIOS must be set to keep the machine powered off after a hard power reset. B . the module will turn it off due to the power on delay Page 6 . This option will only be visible if the LCD is present. A value of 30 is the default system setting.Enter a new power on delay | | E .Turn the LED On | | M . Phantom [? for Help]: Server is on/off From this prompt.Quit | | | | Choose a command | +---------------------------------------------+ Menu Commands A – Change Baud Rate This command can be used to change the default baud rate. The escape key will return to the standard interface status.View LCD Message | | W . any of the management menu options can be selected. The 99 setting instructs the module not to turn on the server automatically.Power Sense: Reset | | L .Enter LCD message | | N . The default is 9600.5 | | | | A .Start Blinking | | C . this password is “P4Confirm”.Chapter 3 – Menu Options Menu Access Access to the Rackable Systems Roamer™ remote management solution will normally be via a console manager or serial concentrator.Read Temperature | | V .Adjust LCD contrast | | D . The power on delay actually cycles the power. The value is read upon startup or reset and determines the amount of time to wait in seconds before turning the server on. and the server loses and regains hard power. the following prompt will be displayed.

In the simplest ‘line mode’ of a terminal session. Most applications will use the “Reset” option. the likelihood of seeing some garbage characters when initially connecting. These more complex vt100+ sequences are sent in output from some shell programs. cursor positioning. This option should be set before shipping from Rackable Systems. it will be unaware of the state of the vt100 term. the text output from the serial port is somewhat directly represented on a virtual terminal. If set to“No”. or other normal serial line-mode communications. but the behavior exists for firmware versions up to 4. The message is displayed after the user enters 40 characters.setting. then another sequence of characters to return to normal output mode. This is important in serial redirection because if your terminal enters the serial conversation somewhere mid-control character. This terminal mode is common in UNIX login prompts. enters a total of two carriage returns. Non alphanumeric characters do not have representative fonts on the LCD and should not be used. This is not abnormal. or enters one full 20 character line with another line having a carriage return. P . and will misinterpret the immediate stream of characters. Messages with lines shorter than twenty characters can be displayed by entering a carriage return after the desired number of characters. The module will automatically advance to the second line after the 20th character is received. special graphical characters. or simply by waiting until a clearing control sequence is eventually sent by the BIOS that corrects the client behavior. this menu item will not be present. E . and will not affect scripting or expect scripts that rely on direct communication without regard for vt state. This behavior is most often seen on PC BIOS. by clearing your client terminal state. The display consists of two lines of twenty character text. or clearscreen. then the module will be able to accept commands originating from the motherboard serial port. This setting dictates what serial port configuration commands can originate from. shells. This option will only be visible if the LCD is present.3. On the output terminal. and is usually remedied by reentering the menu. If the LED is currently on. If the LED is currently blinking. and other more advanced character output. the help menu will display “Turn the LED on”. the menu will display “Turn the LED off”. This is a function of the client terminal. this will probably seen as apparently random garbage output. As PC BIOS redirection is up to 75% vt control characters.Erase the LCD This function clears the LCD display and is only visible when an LCD is attached to the module. various control sequences are sent to represent color changes.Local OS Access\ Note: VT100+ Statefulness aka. M – Enter LCD message LCD messages are sent to the module with this command. then it will only accept configuration commands from the front panel serial port. L – Turn the LED On/Off This command toggles power to the LED(s). and will not occur at normal login prompt. If the LED is presently off. in that to represent a terminal command such as a ‘clrscr’. When more complex text mode ‘drawing’ is required. send a sequence of characters to represent the clearscreen. and not of the serial stream. Garbled output when first connecting to the module or when bringing up the menu. but may need to be reset if somehow changed after shipping. If the setting is set to “Yes”. These control sequences are ‘stateful’ in nature. the server must send specific high ASCII characters to send the client terminal into control mode. N . I – Power Sense The power sense option toggles between sensing server power on the reset header or on the J7 connector. This is changed in development versions. and the Windows Serial Access Console (SAC). or when initially entering the menu (which is unaware of your client terminal state) is fairly high.4. and in great quantity in all PC BIOS serial redirection output.Turn the Server On/Off Page 7 .

which is set correctly at the factory (varies based on motherboard platform).Power Sense” setting. the help menu will read “Turn the server off”. The user will be prompted for confirmation before the server is reset. If the server is detected to be off. Confirmation from the user is required for this function. The menu item on the help screen (figure 2). (See W – Show Saved LCD) T – Read Temperature This command displays the current temperature of the module sensor. The message will not be erased if power is removed. R .Reset the Server This function allows the user to perform a remote hard reset of the attached server. ? – Help Menu This command displays the screen shown in Figure 2 and waits for a valid menu selection. but can be changed in the field. V – View LCD Message This function will return the current contents of the LCD display. check the “I . and is used to upgrade the module firmware to a new version. The menu prompt also displays the current state of the server’s power. The system default is “Yes”. This function requires the “P4Confirm” password. S – Save LCD Message This function saves the current LCD text to the module’s memory. This option will only be visible if the LCD is present. U – Upgrade This command is only usable on software versions after and including 4. the help menu item will read “Turn the server on”. The response is displayed in two lines of 20 characters exactly as it appears on the LCD. If the server is detected to be on.This function allows the user to either turn on or turn off the attached server remotely. The temperature is in Fahrenheit degrees. This screen will be updated once per second until the ESCAPE key is pressed. Page 8 .3. W – Show Saved LCD Message This function toggles the flag for showing a saved LCD message upon server startup. ESC – Quit This command exits the menu prompt on the module and allows serial pass through to the server. will update to show the current state of the flag. The saved message can be displayed upon the server’s startup.4. Some menu items may be absent if the related hardware is missing. Note: If this feature doesn’t appear to be working.

‘1’.0-98 sec.J7 header ‘?’ . Failure will occur if the 8 bit value is out of range. ‘1’.setting ‘?’ .set to 115200 ‘?’ .set to 19200 ‘3’ .turn LED on ‘?’ . Failure will occur if the parameter is not ‘0’. Failure will occur with “P0” and “P1” if the module fails to change the power state. or ‘?’. Shell mode is entered by sending the byte 0x1Dh to the module while it is at the menu prompt.query setting ‘0’ . Erase LCD Change Power Sense Pin Toggle LED E Ix Failure will occur if command is issued without an LCD attached. A response of ‘B’ indicates blinking. Failure will occur if the 8 bit value is out of range. This mode is meant to be controlled by third party software which can be GUI based.turn LED off ‘1’ . “PT” is supported for legacy compatibility. or ‘?’. 0x63 . the module doesn’t display a menu prompt and only returns short responses to requests.Off ‘?’ .query setting ‘T’ .allow mb menu access ‘?’ . Set Power-up Delay Dx [0x00-0x62] . ‘1’. No confirmation is required for any of the commands. New selection will take effect after module reset.set to 38400 ‘4’ . Failure will occur if no LCD is attached. Shell mode is exited by sending the byte 0x1E (Ctrl-6).turn server on ‘0’ .query setting Responses Success: “ok\r” Failure: “er\r” Query: “[1-5]\r” Comments Failure will occur if the parameter is out of range.set to 9600 ‘2’ . Failure will occur if the parameter is not ‘0’. Lx Display LCD Message M[40 chars] Motherboard Menu Access Nx ‘0’ . Baud rate will take effect after power cycle or module reset.query setting None ‘0’ . Shell Mode Commands Action Change Baud Rate Cmd Ax Parameters ‘1’ .toggle state ‘1’ .query setting ‘0’ .turn server off ‘?’ .query power state Success: “ok\r” Failure: “er\r” Change Server Power State Px Success: “ok\r” Failure: “er\r” Query: “[0-1]\r” Page 9 . The LCD data must be padded with spaces to total 40 characters.start blinking [0x00-0x64] . or ‘?’.Chapter 4 – Shell Mode The Rackable Systems Roamer™ remote management solution has a second mode of operation named “shell mode”.query setting 40 characters of LCD data x is a single byte. Failure will occur if the parameter is not ‘0’. In this mode.set to 57600 ‘5’ .B]\r” Success: “ok\r” Failure: “er\r” Failure will occur if the parameter is not ‘0’ or ‘1’.stop blinking ‘1’ .reset header ‘1’ .no mb menu access ‘1’ . Toggle LED Blinking Set LCD Contrast Bx Cx Success: “ok\r” Failure: “er\r” Success: “ok\r” Failure: “er\r” Query: “[8 bit value]\ r” Success: “ok\r” Failure: “er\r” Query: “[8 bit value]\ r” Success: “ok\r” Failure: “er\r” Success: “ok\r” Failure: “er\r” Query: “[0-1]\r” Success: “ok\r” Failure: “er\r” Query: “[0-1. x is a single byte.

This message can be displayed upon module startup by setting “Show Saved LCD Message on Startup” to ‘1’. There are no failures for this not show message ‘1’ .show message ‘?’ . Temperature is returned in degrees Celsius and padded with zeroes to 3 characters. Failure will occur if no LCD is attached. Failure will occur if the parameter is not ‘0’. This command has no failure. Failure will occur if no temperature sensor is detected. The byte 0x1E is the Ctrl-6 character. ‘1’.query setting None None X [0x1E] Page 10 . Get Temperature T None Success: “XXX \r” Failure: “er\r” Retrieve Current LCD Message Show Saved LCD Message on Startup Reset the Module Exit Shell Mode V None Success: “[40 characters]\r” Failure: “er\r” Success: “ok\r” Failure: “er\r” Query: “[0-1]\r” Success: “ok\r” Success: “ok\r” Wx ‘0’ . or ‘?’.Action Reset Server Save Current LCD Message R S Cmd None None Parameters Responses Success: “ok\r” Success: “ok\r” Failure: “er\r” Comments Reset pulse is 500ms. Failure will occur if no LCD is attached.

The message is displayed after the server sends 40 characters. #find ip address on eth0 $ _ = `ifconfig eth0 |grep inet`.local under SuSE Linux. #uncomment this to debug your LCD message #print “LCD:\n $mesg\n $inet \n”. CPU utilization. Either file can be found in /etc/rc. try performing any LCD programming before agetty is launched (usually by init/inittab) in a startup rc.[0-9]+\. The module will automatically advance to the second line after the 20th character is received. or one full 20 character line with another line having a carriage return and line feed. To get around this. job rates. $|=1. This functionality can be scripted.”>/dev/$dev”)||die “ERROR: can not write to /dev/$dev\n”. a total of two carriage returns and line feeds. The server can only send direct write commands to the module while it is not at a menu prompt and is not in shell mode. Messages with lines shorter than twenty characters can be displayed by sending a carriage return and line feed after the desired number of characters. #write to lcd open(LCD. This is generally done in rc. chomp $mesg. or boot. agetty locks the serial port and does not allow access by other programs. Any of the menu options are available through the script mode to the local OS as described in the previous chapter. This allows management functionality such as displaying the hostname and IP address at boot time. ($inet) = ( /([0-9]+\. #get hostname $mesg=`hostname`. or other real-time information on the LCD panel. print LCD “LCD:\n $mesg\n $inet \n”. allowing updates to the LCD panel with real-time information.d file. In the very common situation where agetty is running on the serial port (as a login prompt on the port).[0-9]+\.local under Red Hat Linux. or displaying current IO rates.d/. Note that the execution environment must have access to the serial port in order for this scripting to work.Chapter 5 – Server Commands LCD Access from the OS The Rackable Systems Roamer™ remote management solution has the ability to write directly to the LCD panel from the local OS. Tying this together with the ability to change the contrast on the LCD or to make the LED turn on or blink can be a powerful method for visually identifying servers that our outside of normal operational parameters. Linux scripting sample The following is a sample Perl script setting the LCD to display the hostname and IP address dynamically: #!/usr/bin/perl –w #set default serial device $dev=”ttyS1”. Page 11 .[0-9]+)/ ).

Appendix I: Connector Diagram Page 12 .

Pin 1 2 3 4 5 6 7 8 Name RTS DSR RxD SG SG TxD DTR CTS Description Request to Send (from motherboard/Phantom) Data Set Ready Receive Data Signal Ground Signal Ground Transmit Data Data Terminal Ready Clear to Send (from motherboard/Phantom) Pin 1 Pin 8 Page 13 .Appendix II: RJ45 Serial Pinout Reference graphic is the male RJ45 connector that plugs into the module serial port. This is with the jumper position in position “A”. from the perspective of looking head-on into the connector.

321. (Technical Support) Page 14 (#40-01-00003 Cover Dated e-copy) .408.rackable. 1933 Milmont Ave.Rackable Systems Inc.240. 95035 USA Support: +1.5230 Return Material Authorization (RMA): +1.8000 Option 4 Fax: (General Information) support@rackable.408.408.722.8000 Customer Service (General): (Documentation Support) Website: http://www.240. Milpitas.0293 Email: customerservice@rackable.

Sign up to vote on this title
UsefulNot useful