OSA System Management Bridge Version 1.0.3.8 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 OSA System Management Bridge code. 1.2 Limitations - NA 1.3 Enhancements - NA 1.4 Level of Recomendations and Prerequisites for the Upate: 1.5 Dependencies 2.0 Change History 2.1 External Release 1.0.3.8 1. Fix the problem where an unfinished user authentication causes a SMBridge crash on winXP or lower platform, as evidenced by following error on screen: Dr Watson has created an error log for the following program, SMBridge.exe. 2.2 External Release 1.0.3.7 1. Fix error codes generated by new random retry interval. 2.3 External Release 1.0.3.6 1. Change session keep alive heart-beat interval to a random value between 800ms to 1200ms. This will solve the SOL session lost when pinging or two sessions are established for one BMC. 2.4 External Release 1.0.3.5 1. Change session keep alive heart-beat to 1100ms to solve the SOL session lost when pinging. 2.5 External Release 1.0.3.4 1. Fix the problem of smbridge reporting "Invalide data filed" when executing console command. 2.6 External Release 1.0.3.3 1. Implement the retry for BMC not acknowledging an SOL packet 2. Fix smbridge session timeout crashs smbridge when smbridge SOL session actived. 2.7 Internal Release 1.0.3.3 1. Implement the retry for BMC not acknowledging an SOL packet 2.8 External Release 1.0.3.2 1. Fix defect which sends out IPMI retry packet and incorrectly increase the internal software sequencing numbers. 2. Enable the enhancement to support both ISOL and SOL1.0 over RMCP. ---------------------------------------------------------- 2.9 External Release 1.0.3.1 1. Fix defect which sends out error sol character. 2. Fix for performance of both ISOL and SOL1.0 over RMCP implemented in release 1.0.3.0. ---------------------------------------------------------- 2.10 Release 1.0.3.0 1. Implement SysRq feature for Linux Operating Sytems. 2. Enhance to support both ISOL and SOL1.0 over RMCP. ---------------------------------------------------------- 2.11 External Release 1.0.2.0 1. Implement all the feature of solproxy 1.0.1 3.0 Installation and Setup Instructions The procedure to update the BMC is as follows: 3.1 Insert OSA SMBridge Installation CD into the drive, and wait a few seconds for a welcome screen to appear: 3.2 Click “Next” and the End User License Agreement (EULA) window will appear. 3.3 Click “Yes” to accept the License Agreement to continue the installation. The install program will prompt for the destination folder. The default folder can be changed by clicking the “Browse” button. When you finish, click “Next”. 3.4 Then the installation program will prompt for a TCP/IP port number and an IP address that will be used in Server Mode. IP address: Specifies the server IP address that OSA SMBridge will bind and service. Since a computer may have multiple valid NIC IP addresses, SMBridge allows you to restrict access to it via a single IP address. Specify “INADDR_ANY” as the IP address if any of the multiple NIC IP addresses can be bound to SMBridge. Specify “127.0.0.1” or “localhost” as the IP address if SMBridge should only accept local connections. Specify a specific IP address if only this IP address can be bound to SMBridge. Port: Specifies the port number that OSA SMBridge will listen on. These two values will be recorded in the smbridge.cfg file for the automatic startup of OSA SMBridge as a service daemon. (See Configuration information in the 4.0 Section below.) 3.5 User could specify the Telnet Session Timeout value and “Power Off” Command Timeout value for Server Mode. Session timeout: Specifies the number of minutes without any keyboard activity that signals a “session timeout” event. An established telnet session will be closed when this event is triggered. “Power Off” timeout: Specifies the number of seconds to wait for an IPMI power off command (graceful or forced) to complete. If time has exceeded the timeout value and the power status is still on, an error code will be returned to indicate that the “Power Off” command may have failed. The necessary time duration for a system to power off is platform and operating system specific, particularly when graceful shutdown is used. User should choose a timeout value that works for most platforms and systems. 3.6 Review the settings you have selected before copying files. 3.7 A progress bar will appear to show the installation process. 3.8 Click “Finish” to complete the installation. 3.0.1 Installation on Linux System 3.0.1.1. Login as “root”. 3.0.1.2. Insert the OSA SMBridge CD into the CD-ROM drive. 3.0.1.3. Enter the following command to mount the CD: mount /mnt/cdrom. 3.0.1.4. Go to the directory where the installation RPM package is located: cd /mnt/cdrom 3.0.1.5. Run the RMP package to begin installing: rpm –i osasmbridge-1.0.2-0.i386.rpm. When the installation is finished 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 shall be created. 3.0.2 Uninstalling OSA SMBridge 3.0.2.1 Uninstalling OSA SMBridge from Windows System To uninstall OSA SMBridge, use the Add/Remove Programs Utility in the Control Panel. 3.0.2.2 Uninstalling OSA SMBridge from Linux System 3.0.2.1. Login as “root”; 3.0.2.2. Enter the following command to remove all the installed packages. rpm –e osasmbridge 3.0.2.3. A success message should be returned to show that OSA SMBridge is uninstalled successfully. 4.0 Configuration Information 4.1 OSA 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. Possible 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 an OSA SMBridge telnet session. There are three candidate values: "INADDR_ANY", "127.0.0.1" and a valid IP address, which respectively means that OSA 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. 4.3 PORT This item defines the port number when you telnet OSA SMBridge. If it is absent, system will use "623" as the default port. 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. 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. 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. 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. 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". 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. 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. 5.0 Unattended Mode 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 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. 8.0 Disclaimer