Avocent System Management Bridge (SMBridge) Version 2.0 Installation README File CONTENTS ________ 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Configuration Information 5.0 Unattended Mode 6.0 Web Sites and Support Phone Number 7.0 Trademarks and Notices 8.0 Disclaimer ________ 1.0 Overview 1.1 This README file contains the latest information about installing the Avocent System Management Bridge code. 1.2 Limitations - NA 1.3 Enhancements - Supports IPMI 2.0 1.4 Level of Recomendations and Prerequisites for the Upate: 1.5 Dependencies 3.0 Installation and Setup Instructions 3.1 The procedure to install / update SMBridge on windows system: 3.1.1 Insert SMBridge Installation CD into the drive, and wait a few seconds for a welcome screen to appear. 3.1.2 Click next and the End User License Agreement (EULA) window will appear. 3.1.3 Click next to accept the License Agreement to continue the installation. The install program will prompt for the user name, company name and destination folder. The default folder can be changed by clicking the browse button. When you finish, click next. 3.1.4 Review the settings you have selected before copying files. 3.1.5 A progress bar will appear to show the installation process. 3.1.6 Click Finish to complete the installation. 3.2 Installation on Linux System 3.2.1. Login as root 3.2.2. Insert the SMBridge CD into the CD-ROM drive. 3.2.3. Enter the following command to mount the CD: mount /mnt/cdrom. 3.2.4. Go to the directory where the installation RPM package is located: cd /mnt/cdrom 3.2.5. Run the RMP package to begin installing: rpm smbridge-2.0.15-1.i386.rpm. When the installation is completed successfully, 5 files are copied to the following directories: /etc/init.d/smbridge /etc/smbridge.cfg /usr/bin/smbridge /var/log/smbridge /var/log/smbridge/LICENSE Additionally, the symbolic link /usr/sbin/smbridge will be created. 3.3 Uninstalling SMBridge 3.3.1 Uninstalling SMBridge from Windows System: To uninstall SMBridge, use the Add/Remove Programs utility in Control Panel. 3.3.2 Uninstalling SMBridge from Linux System 3.3.2.1. Login as root 3.3.2.2. Enter the following command to remove all the installed packages. rpm -e smbridge 3.3.2.3. A message should be returned to show that SMBridge is uninstalled successfully. 4.0 Configuration Information 4.1 SMBridge provides server management ability via two distinct modes of operation, a "Command Line Interface" mode (CLI) and an "Interactive Server" mode (Server). CLI Mode: In CLI mode, SMBridge supports out-of-band (OOB) access (through LAN or serial port) to a remote server. It enables SMBridge users to execute IPMI control commands in a native command line to manage the remote server. To ease the use of this utility, SMBridge also supports an interactive usage, invoked by -interactive option. Server Mode: In server mode, SMBridge is started as a background service or daemon after SMBridge package is installed. This service/daemon can be connected using any standard telnet client. After connected, user will be provide a command line interface with SMBridge> prompt. All commands provided in CLI SMBridge interactive mode can also work for server mode. In addition, two commands are added: console and reboot. These two commands allow administrators to view and change the BIOS settings, access to Linux serial console and Microsoft's EMS/SAC interfaces. The SOL protocol coupled with the remote system's BIOS console redirection makes it work. SMBridge must be correctly configured and running before an incoming telnet connection can be accepted. The configuration file is a text file where the value of some runtime parameters is defined. For MS Windows operating systems the default configuration file is located in the Windows installation directory. For the Linux operating systems the default configuration file is installed in the /etc directory. The default SMBridge configuration file typically includes four key configuration parameters as depicted in the example configuration file below: Any line starting with "#" is treated as a comment. Sample configuration parameters are: # SMBridge Configuration File ip=INADDR_ANY port=623 session_timeout=30 4.2 IP This item defines what kind of connection can be accepted to establish a SMBridge telnet session. There are three candidate values: "INADDR_ANY", "127.0.0.1" and a valid IP address, which respectively means that SMBridge accepts the telnet request to any server, the localhost and the machine occupying the IP address specified. If this parameter is absent, system will use "127.0.0.1" (or localhost) as the default value of this parameter. This item is only effective for server mode. 4.3 PORT This item defines the port number when you telnet SMBridge. If it is absent, system will use "623" as the default port. This item is only effective for server mode. 4.4 SESSION_TIMEOUT If there is no keyboard activity for this timeout period, the telnet session will be closed. This timeout value is specified in minutes. If it is absent, system will use the value of 30 minutes as the default value. This item is only effective for server mode 4.5 POWER_OFF_TIMEOUT "Power Off" timeout is only used during the reboot command, in order to abort waiting for the "Power Off" command to complete. If wait time exceeds the timeout value and the power status is still on, an error code will be returned to indicate the "Power Off" command has failed. This timeout value is specified in seconds. If it is absent, system will use the value of 45 seconds as the default value. This item is effective for both CLI mode and server mode. 4.6 SOL_LOSS_SILENT This parameter specifies how the system behaves when one or more SOL packets are lost. Possible values are: 0 and 1. If it is set to be 0 or it is absent, system will print error message on the screen each time a SOL packet is lost. Otherwise, when the value is 1, system will silently ignore the error. The default value is 0. This item is only effective for server mode. 4.7 SOL_LOSS_THRESHOLD This parameter specifies how many SOL packets can be lost before SOL is deactivated. The default value is 0, that is, system will deactivate sol and end the sol session when any SOL packet is lost. This item is only effective for server mode. 4.8 SET_BOOT_OPTION This parameter controls whether the "reboot" command sets the BIOS boot option to enable console redirection. Possible values are: on, off and auto. The default value is "auto" when the parameter is absent. If the value is "on", the reboot command will always set the BIOS flag to enable BIOS console redirection after reboot. If the value is "off", then the reboot command will not change BIOS settings. If the value is "auto", the reboot command will check whether BIOS supports this flag. If it is supported, then the system behaves as if the value is "on", otherwise behaves as if the value is "off". This item is only effective for server mode. 4.9 RETRY_COUNT This parameter defines the number of times the system will retry an IPMI or SOL request when it does not get a reply from the BMC. The default value is 10. This item is effective for both CLI mode and server mode. 4.10 RETRY_INTERVAL This parameter defines the time interval between two system retries. The value is in ticks where each tick is 0.5 second long. The default value is 2, that is, the interval between two retries is 1 second long. This item is effective for both CLI mode and server mode. 4.11 LOCAL_AUTHENTICATION Configure how to handle user authentication. There are 3 available options: disable: do NOT do authentication for both local and remote connection. enable: always do authentication for both local and remote connection. remote: only do authentication when user is connecting from remote. This item is only effective for server mode. 5.0 Unattended Mode Please refer to related Installshield document on how to run a silent installation. 6.0 Web Sites and Support Phone Number 6.1 IBM Support Web Site: http://www.pc.ibm.com/support 6.2 IBM eserver xSeries Web Site: http://www.ibm.com/eserver/xseries 6.3 If you have any questions about this update, or problems applying the update, go to the following Help Center World Telephone Numbers and URL: http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html 7.0 Trademarks and Notices 7.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: - IBM - xSeries - eServer 7.2 Other company, product and service names may be trademarks or service marks of others. 8.0 Disclaimer THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. UT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. S.