Home

User`s Manual

1. rent lease or lend the Software or Documentation or use it for commercial time sharing rental or service bureau use You shall not and shall not authorize any third party to modify alter adapt reverse engineer disassemble create derivative works of or decompile the Software and you agree that you do not have the right to obtain or use any source code for the Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 5 User s Manual for OSA System Management Bridge Software or any part of it The preceding sentence is limited by the following The parties acknowledge that in the European Union countries a software directive by the European Union Commission mandates that a licensee of software shall be lawfully entitled to decompile such software for the purpose of obtaining the information necessary to achieve the interoperability of an independently created computer program with other programs provided among other things that such information has not previously been readily available and such decompilation is confined to the parts of the licensed program which are necessary to achieve interoperability You acknowledge that OSA makes such information available to you and that accordingly you shall not claim or exercise any such right of decompilation You agree that you will not provide access to the Software to any person for any purpose other than processing your internal data for the intended use of the Softw
2. C Program Files OSA gt smbridge ip 192 168 1 77 power status Status on C Program Files OSA gt smbridge 1 192 168 1 77 power cycle C Program Files OSA gt smbridge ip 192 168 1 77 power reset C Program Files OSA gt smbridge 1 192 168 1 77 power off force C Program Files OSA gt Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 23 User s Manual for OSA System Management Bridge sel Synopsis sel status sel get begin index end index2 max last sel clear sel set time yyyy mm dd hh mm ss Description This command allows user to perform some operations on the system event log such as displaying the total number of records in the event log deleting all the records displaying contents of the event log or setting timestamp Subcommands status Display the total number of system event log records get Print all or part of the event logs clear Remove all the records in the event log set Settimestamp for the event log Options begin 1 Specify the record from which to begin displaying end 2 Specify the record to which to end displaying count Specify the maximum of the records to be displayed If the value of argument count is bigger than the total number of the records this option will lapse The last record to be displayed will be the last one in the event log last Specify the number of re
3. or localhost as the default value of this parameter gt port This item defines the port number when you telnet OSA SMBridge If it is absent system will use 623 as the default port gt 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 gt 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 gt 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 itis 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 gt 501 1055 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 gt Set boot option Copyright
4. 2004 OSA Technologies an Avocent Company All Rights Reserved 41 User s Manual for OSA System Management Bridge 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 otherwise behaves as if the value is off gt 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 gt 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 Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 42 User s Manual for OSA System Management Bridge Appendix D Error Messages In case of a functional failure a non zero error code is returned as the exit status of the executable Additionally an error message will be printed to stderr
5. GUARANTEE THAT THE SOFTWARE IS FREE OF DEFECTS WILL RUN ERROR FREE OR UNINTERRUPTED OR WILL MEET YOUR REQUIREMENTS OR THAT OSA WILL CORRECT ALL PROGRAM ERRORS SOME LAWS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES SO TO THAT EXTENT THIS LIMITATION MAY NOT APPLY TO YOU OSA FURTHER DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTIES REGARDING LACK OF VIRUSES ACCURACY OR COMPLETENESS OF RESPONSES RESULTS SATISFACTORY QUALITY LACK OF NEGLIGENCE AND LACK OF WORKMANLIKE EFFORT NO LIABILITY FOR CONSEQUENTIAL DAMAGES IN NO EVENT WILL OSA OR ITS LICENSORS BE LIABLE FOR ANY SPECIAL INCIDENTAL CONSEQUENTIAL PUNITIVE OR INDIRECT DAMAGES WHATSOEVER INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF PROFITS BUSINESS INTERRUPTION LOSS OF INFORMATION OR OTHER PECUNIARY LOSS ARISING OUT OF THE USE OR INABILITY TO USE THE PRODUCT OR THE PERFORMANCE INTERRUPTION OR FAILURE OF THE PRODUCT IRRESPECTIVE OF THE CAUSE OF ACTION EVEN IF OSA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES SO TO THAT EXTENT THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU You acknowledge and agree that it is the intention of OSA to give its third party licensors and suppliers the benefit of the covenants made by you in this EULA and you agree that the limitations of liability and disclaimers stated in this EULA also apply to OSA s licensors and suppliers as intended
6. 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 InstallShield Wizard Input Session PowerOff Timeout Please specify the Session Timeout minutes that OSA SMBridge will be closed if there is no keyboard activity and PowerOff Timeout seconds that the power status will be still on if power IPMI command is issued Session Er Power ff 60 InstallShield Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 12 User s Manual for OSA System Management Bridge 6 Review the settings you have selected before copying files InstallShield Wizard Start Copying Files Review settings before copying files Setup has enough information to start copying the prog
7. U username Specify the username used to connect to the server It can be omitted if the argument value is null p password Specify the password used to connect to the server It can be omitted if the argument value is null Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 19 User s Manual for OSA System Management Bridge Note Session option com cannot be used independently and one or more SMBridge commands must follow it C WINNT System32 cmd exe C Program Files OSA gt smbridge com 1 baud 19266 flow none u admin p admin pomm wer status Status off C Program Files OSA gt Commands The table below lists the OSA SMBridge commands available in the CLI mode with a brief description Command Description identify Controls the identification LED on the front panel sysinfo Retrieves and displays the system information ower Controls power state of the managed server sel Performs some operations on the system event log Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 20 User s Manual for OSA System Management Bridge identify Synopsis identify on t seconds off Description This command is used to control identification LED on the front panel Subcommands on Turn on the LED If the BMC supports IPMI extension Chassis Identify On command then identify on turns the LED on indefinitely until id
8. an Avocent Company All Rights Reserved 7 User s Manual for OSA System Management Bridge or indirectly the Software or Documentation or any copies thereof or any products utilizing the Software or such documentation in violation of any applicable laws or regulations U S GOVERNMENT RESTRICTED RIGHTS The Software and Documentation are considered to be commercial computer software and commercial computer software documentation respectively pursuant to DFAR Section 227 7202 and FAR Section 12 212 as applicable Use duplication or disclosure of the Software and or Documentation by the U S Government is subject to the restrictions set forth in DFAR Section 227 7202 for military agencies and FAR Section 12 212 for civilian agencies OSA reserves all rights not expressly granted herein Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 8 User s Manual for OSA System Management Bridge Installation Steps Installation on Windows System 1 Insert OSA SMBridge Installation CD into the drive and wait a few seconds for a welcome Screen to appear InstallShield Wizard x Welcome to the InstallShield Wizard for OSA SMBridge The InstallShield Wizard will install OSA SMBridge on your computer To continue click Next If it does not appear in the Windows file browser double click on the setup exe file under the CD ROM drive to bring up this screen Copyright c 2004 O
9. beneficiaries hereof Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 6 User s Manual for OSA System Management Bridge YOU AGREE THAT IN ANY EVENT OSA S CUMULATIVE LIABILITY FOR ALL CLAIMS ARISING OUT OF OR IN CONNECTION WITH THIS EULA INCLUDING WITHOUT LIMITATION FROM OR IN CONNECTION WITH THE LICENSE OR THE USE OR IMPROPER FUNCTIONING OF THE SOFTWARE EACH A CLAIM WILL NOT EXCEED THE AMOUNT PAID BY YOU TO PURCHASE THE SOFTWARE OSA S THIRD PARTY SUPPLIERS AND LICENSORS WILL HAVE NO LIABILITY FOR ANY CLAIMS YOU AGREE THAT THE ABOVE LIMITATIONS OF LIABILITY APPLY REGARDLESS OF THE BASIS ON WHICH YOU ARE ENTITLED TO CLAIM INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT INCLUDING WITHOUT LIMITATION FUNDAMENTAL BREACH OR TORT INCLUDING WITHOUT LIMITATION NEGLIGENCE GROSS NEGLIGENCE NEGLIGENT MISREPRESENTATION PRODUCT LIABILITY OR OTHER FAULT OF OSA OR ITS THIRD PARTY SUPPLIERS AND LICENSORS EVEN IF OSA OR ITS THIRD PARTY SUPPLIERS AND LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOTWITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE OF ANY REMEDY YOU AGREE THAT THESE LIMITATIONS ON POTENTIAL LIABILITIES WERE AN ESSENTIAL ELEMENT IN SETTING CONSIDERATION UNDER THIS EULA GENERAL This EULA constitutes the entire agreement between you and OSA and supersedes any prior agreement concerning the Product OSA is not bound by any provision of any purchase order receipt acceptance
10. replace F1 and Esc plus numeric 2 to replace F2 For additional information and guidance please refer to Appendix B When use HyperTerminal as a SMBridge telnet client on Windows Server 2003 platform errors occurred why A On Windows Server 2003 platform you should upgrade HyperTerminal to the private edition Also you should turn off automatic wrap function by clearing the checkbox Wrap lines that exceed terminal width in HyperTerminal ASC II Setup HyperTerminal Properties Setting ASC II Setup to get a clean and clear display Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 38 User s Manual for OSA System Management Bridge Appendix A Configuring a Remote Server for OOB Access Before SMBridge can be used to manage a remote server the BMC and BIOS of the remote server must have correct settings OSA SMBridge does not configure any of the network settings for the target BMC or the management host A 1 BMC configuration If OOB LAN is to be used the following settings of remote BMC should be configured in advance so that the BMC has a working LAN connection to the management host gt OOB IP address gt Subnet mask gt Default gateway address Some older platforms require that network MAC addresses be configured manually gt address gt Default gateway MAC address In newer platforms BIOS or the NIC enable the setting of these MAC addresses automatic
11. the system boots It allows a telnet client both local and remote to interact with a Remote BMC through IPMI session to realize power and system management or communicate with a hardware designated serial port of a remote server using the LAN channel Using SOL access administrators can view and change the BIOS settings over LAN Linux serial console and Microsoft s EMS SAC interfaces can also be accessed When BIOS Console Redirection to serial port is enabled at the remote server any application that uses the BIOS to read from or write to the system console will have its IO redirected to the designated serial port When SOL is activated the BMC firmware reads any data written to the serial port and transmits it to the OSA SMBridge as LAN packets OSA SMBridge then forwards the data to the telnet client as TCP IP packets Conversely any keyboard activity at the telnet client is sent to the BMC via OSA SMBridge BMC then writes the packets to the system serial IO port This communication scheme enables the viewing and configuration of the BIOS settings of a managed node as well as resetting the node remotely via a telnet client One SMBridge session supports one SOL session with one BMC at a time Starting the OSA SMBridge daemon To support telnet connections OSA SMBridge must be started as a background service or daemon On MS Windows System start the daemon by clicking Start Settings Control Panel Administra
12. 05 24 23 55 131 System Event OEM S em Boot Event 2664 65 24 23 61 51 131 System Event specific Www 1 MEX IL Program Files OSA gt Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 25 User s Manual for OSA System Management Bridge 2004 05 24 23 2004 05 24 23 2004 05 24 23 2004 05 24 23 AALONGS uon n ow ow 66 14 880 25 880 55 91 51 91 52 Program Files OSA gt _ System Event System Event System Event System Event System Event Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 sel get begin 2 max 5 2004 05 25 14 3 Sensor specific Sensor specific OEM System Boot Event Sensor specific Sensor specific C Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 sel get last 56 9 2664 06 64 88 5 9 2004 06 04 808 58 2004 06 04 00 57 56 57 56 58 26 C Program Files OSA gt _ System Event System Event System Event Sensor specific Sensor specific OEM System Boot Event Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 sel set time 2004 06 04 mE 12 12 12 C Program Files OSA gt Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 26 User s Manual for OSA System Management Bridge Interactive Server Mode Telnet Remote Server In Server Mode OSA SMBridge runs as a background service or daemon and automatically starts each time
13. L THE SOFTWARE OR IF INSTALLED ALREADY YOU MUST UNINSTALL THE SOFTWARE AND 2 DO NOT USE THE SOFTWARE OR DOCUMENTATION The license grant hereunder is conditioned upon the terms of this EULA and OSA is not willing to enter into this EULA if you are not willing to accept these terms DEFINITIONS Documentation means electronic or printed materials that accompany the Software to provide instructions for installation operation and use OSA means OSA Technologies Inc and its successors and assigns OSA Distributor means any distributor that OSA authorizes to distribute the Product Platform means those supported products as specified in writing by OSA or an OSA Distributor as applicable Product means the Software and Documentation Software means the OSA software in object code format which accompanies this EULA you means the company you represent INTELLECTUAL PROPERTY PROTECTION The Product is owned by OSA or its licensors and is protected by United States and international copyright and other intellectual property laws and international trade provisions You acknowledge that the Software and Documentation contain unpublished information and embody valuable trade secrets proprietary to OSA and its licensors You agree to hold all such information and trade secrets in confidence OSA and its licensors reserve all rights in the Product not expressly granted in this EULA This license and your right to use the Product
14. MBridge gt reboot force Powering off Powering on Activating remote console now Remote console is now active and ready for user input PEHK 0 00 40 vT100 TCP IP SCROLL caps TEN To exit an active SOL session use the character sequence The characters should be typed without a long delay between them Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 37 User s Manual for OSA System Management Bridge Trouble Shooting Q Do OSA SMBridge commands correspond one to one to IPMI commands A OSA SMBridge is only concerned with the most useful IPMI commands It aims to provide a set of powerful commands to empower the system administrator to accomplish his most common management tasks effortlessly while shielding him from common human errors Therefore OSA SMBridge commands may not correspond one to one to IPMI commands Q Can a server be managed by multiple IPMI connections simultaneously Yes a server can be managed by multiple IPMI connections at the same time as long as the BMC supports more than one concurrent connection Q When the BIOS Console of a remotely managed node is redirected tried to press F1 button to enter BIOS setup interface but it does not work why A Some telnet clients may not support F1 and F2 function keys When using telnet in an ASCII command prompt interfaces on MS Windows platforms you can use Esc plus numeric 1 to
15. NEUERBARE Rode 41 PME tetro e net A 4 IPMI Session Option com 19 IPMI Session Option 1 19 L EAN ac nate rhe Rate 4 P POT ii aeter rto aura ieee 4l d eer d ntes Ge t I E ees 23 power off 41 R IeDOOL o rerit 37 retry COUN ine tres 42 retry intervala inane one 42 S Selaanteu SIRENS SR ene aceite ient 24 Server Modes 3 session timeoUt eeeeeseeerereeerereree eene 41 set boot option 41 dr ebd ett ues 4 eruere uet e 4 34 sol loss silent eeeeeeeeee eene 41 sol loss threshold eee 41 e ert s 22 T Telnet Clients et nee 29 Trouble Shooting sss 38 U User Login ederet erm eth ets 30 Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 45
16. ORKINGIN ee re SYNTACTIC RULES 25 5 6 ric oerte tii ose GLOBAL OPTIONS coves E Ee SAO T exe oe EE EC CASA FE E RE EU e AREE Ee UTR Help Option help siehe Itt petet ce eb TIPMI Session ODHori ip i eee tt tet TIPMI Session Option comin esci dee e de e a t teense e ee dee Ratten MO MCRIEEED e identify testes lease RAYT T INTERACTIVE SERVER MODE STARTING THE OSA SMBRIDGE DAEMON 2222 PEENET CLIENTS e i eee W ORKING IN SERVER MODE te tare eur gue eee Via Windows Command Prompl 3 3 i nte ete etd cute ete teh FERRE D SUE ee Pete organe een Via Windows HyperTerminal Console eee eese eee eene nennen teen nren nennen Via TAnUX SWELL eae oD EEE tes USER EOGIN irte GETTING HEEP taie tere EU RU OI UU OU COMMANDS EE Commands inherited from the mode eese eene nennen eene nennen nennen A A ete AEE e A Irem d dae PRA Re eux A TROUBLE SHOOTING ccsssssssssssessessrsessssssessessssessessssessessesessessssessessssessessssessesessessessssessesersesees APPENDIX A CONFIGURING A REMOTE SE
17. RVER FOR A 1 BMC CONFIGURATION AJ BIOS CONFIGURATION ete mro eret rer rete APPENDIX B TELNET CLIENTS USE AND CONFIGURATION cerent enean APPENDIX C CONFIGURE OSA SMBRIDQGE eese eene APPENDIX D ERROR MESSAGES eese esee eee estne estan tata sensa D 1 OSA DEFINED COMPLETION CODES Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved User s Manual for OSA System Management Bridge Introduction The OSA System Management Bridge SMBridge is a console application for remote server management It allows cost effective administration of servers using IPMI 1 5 protocol and the Serial Over LAN SOL protocol SMBridge provides server control and management ability via two distinct modes of operation a Command Line Interface mode CLI and an Interactive Server mode Server CLI Mode In mode OSA SMBridge supports out of band access through LAN or serial port to a remote server It enables OSA SMBridge users to execute IPMI control commands in a native command line to manage the remote server OSA SMBridge allows an administrator with user level privilege to a remote BMC to e Display the current power status Display the 16 byte system GUID of the manage
18. Request not supported in present BMC state OxD5 current BMC state A9h Processing errors BMC busy BMC out of processing resources 0xCO transient errors Destination timeout Error BMC timeout while processing command BMC out of storage space BMC out of storage space required to process 4 disappear upon of mu command m command Invalid reservation id Invalid reservation id 0xC5 Duplicate command Cannot execute duplicated request OxCF SDR busy Sensor Data Record Repository in update OxDO mode Device busy Device in firmware update mode OxD1 BMC unavailable BMC initialization in progress 0 2 BMC out of sessions No session slots are available for connection 0x81 0x82 request 0x83 AEh Unexpected Invalid LUN Invalid Logical Unit Number in request OxC2 IPMI errors Unspecified error Unspecified error OxFF AFh Unknown error Unknown error OSA unknown error Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 44 User s Manual for OSA System Management Bridge Index B BIOS configuration 39 4 BMC configuration seen 39 C 3 Configure OSA SMBridge 41 CODNECE cer tree hehe 33 Console fete P ern 36 Error Messages nete 43 F ERU insere ead en 4 G 3c itt tto nitidi ee 4 H Help Option sisi edet item 18 1 identify ee ete 21 ID eec ee ER
19. SA Technologies an Avocent Company All Rights Reserved 9 User s Manual for OSA System Management Bridge 2 Click Next and the End User License Agreement EULA window will appear InstallShield Wizard License Agreement Please read the following license agreement carefully Press the PAGE DOWN key to see the rest of the agreement END USER LICENSE AGREEMENT PLEASE READ THIS END USER LICENSE AGREEMENT EULA BETWEEN YOU AND OSA TECHNOLOGIES INC CAREFULLY BEFORE USING THE SOFTWARE DEFINED BELOW AND DOCUMENTATION DEFINED BELOW THAT 15 PROVIDED WITH THIS EULA BY USING THE SOFTWARE OR DOCUMENTATION YOU ACKNOWLEDGE THAT YOU HAVE READ AND UNDERSTOOD ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT AND YOU WILL BE CONSENTING BE BOUND BY THEM IF YOU gt Do you accept all the terms of the preceding License Agreement If you choose No the setup will close To install OSA SMBridge you must accept this agreement InstallShield 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 InstallShield Wizard Choose Destination Location Select folder where Setup will install files Setup will install OSA SMBridge in the following folder To install to this folder click Next To install to a diffe
20. The text of the error message is what appears in the Message column in the table below Error messages will always be printed in a parsable format as follows Error lt cma gt lt hex code gt lt message gt Example Error Activate 0xA1 Connection timeout D 1 OSA Defined COMPLETION CODES Code Classification Message Description IPMI Error Connection Connection timeout BMC not responding Invalid authentication type Auth Type Error A2h Communication Communication Error Network stack or serial communication error errors Data Error Data packet format error 0xC6 OxC7 OxC8 OxCA Not connected Not connected to a remote server yet A3h Authorization Insufficient privilege for Insufficient privilege level to execute 0 4 errors command command Login not authorized Invalid BMC username pass word Insufficient privilege for Valid username password has insufficient 0x86 command privilege to login using the current communication channel A5h Initialization Authentication failure Request for a session from the local or remote errors proxy was rejected Currently this is either due to providing invalid OS credentials In the future Active Directory integration can also cause this Access denied Trying to access the proxy from a forbidden IP address Unknown language Unknown Language code Invalid IP address Ip resol
21. User s Manual for OSA System Management Bridge OSA System Management Bridge User s Guide Revision History Version Description September 27 2004 Second draft Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 1 User s Manual for OSA System Management Bridge TABLE OF CONTENTS INTRODUCTION M M TARGET AUDIENCES i500 5 e nett a at Mens A Oe GI OSSARY t aic te ut end Ne o nina asi SUPPORTED PLATFORMS est etur ex END USER LICENSE AGREEMENT ia Goa eed ove Exe Onr m INSTALLATION ON WINDOWS SYSTEM retener nnn nnn INSTALLATION ON LINUX SYSTEM nennen POST INSTALLATION UNINSTALLING OSA SMBRIDGE eese Uninstalling OSA SMBridge from Windows Uninstalling OSA SMBridge from Linux COMMAND LINE INTERFACE MODE eres W
22. agement Controller is a micro controller that provides the intelligence in the IPMI structure LAN Local Area Network is a shared medium peer to peer communication network that broadcasts information for all station to receive in a moderate size geographic area GUID Globally Unique Identifier is a random number used in software applications Each generated GUID is supposed to be unique FRU Field Replaceable Unit identifies a module or component that will typically be replaced in its entirety as part of a field service repair operation Supported Platforms SMBridge supports the following platforms Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved Redhat Linux 7 2 Redhat Linux 8 0 Redhat Linux 9 0 Redhat Linux Enterprise Server 3 0 Microsoft Windows XP Microsoft Windows 2000 Professional Microsoft Windows 2000 Server Microsoft Windows Server 2003 User s Manual for OSA System Management Bridge END USER LICENSE AGREEMENT PLEASE READ THIS END USER LICENSE AGREEMENT EULA BETWEEN YOU AND OSA TECHNOLOGIES INC CAREFULLY BEFORE USING THE SOFTWARE DEFINED BELOW AND DOCUMENTATION DEFINED BELOW THAT IS PROVIDED WITH THIS EULA BY USING THE SOFTWARE OR DOCUMENTATION YOU ACKNOWLEDGE THAT YOU HAVE READ AND UNDERSTOOD ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT AND YOU WILL BE CONSENTING TO BE BOUND BY THEM IF YOU DO NOT ACCEPT THESE TERMS AND CONDITIONS THEN 1 DO NOT INSTAL
23. ally Also for OOB Serial OSA SMBridge assumes a working connection between the management node and the correct serial I O port of the target BMC using a Null Modem Cable For both OOB LAN and OOB Serial BMC login authentication information should be specified including gt User name gt User password gt User Privilege A 2 BIOS configuration OSA SMBridge does not configure any BIOS settings and assumes that BIOS Console Redirection is enabled and redirects console to the correct serial I O port for the target BMC to intercept Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 39 User s Manual for OSA System Management Bridge Appendix B Telnet Clients Use And Configuration Before establishing a telnet session with SMBridge administrator should configure the telnet clients to get correct and clear displaying Any telnet client application supporting VT100 emulation mode can work as a SMBridge telnet client SMBridge has been tested on three telnet clients Microsoft Telnet You can use the MS Microsoft Telnet from a Windows Command Prompt as your telnet client without any additional configuration However this client may not support F1 and F2 function keys that are needed to enter BIOS settings Interface of a remotely managed node after BIOS Console is redirected to the client side Instead you can use Esc plus numeric 1 to replace F1 and Esc plus numeric 2
24. are UPDATES AND UPGRADES OSA may from time to time in its sole discretion and without any obligation to do so make updates and or upgrades to the Software available via the Internet or other sources such updates and upgrades shall be deemed to be included within the definition of Software and shall be subject to the terms and conditions of this EULA This EULA does not entitle you to any support maintenance assistance or the like with respect to the Software or the Documentation WARRANTY OSA warrants that on the date of delivery of the Software the Software will substantially conform to the specifications set forth in the Documentation Your sole and exclusive remedy under the foregoing warranty shall be for OSA to use commercially reasonable efforts to correct any substantial non conformity of the Software reported to OSA in writing within the warranty period All errors shall be reported to OSA support at the following email address Support OSATechnologies com The foregoing warranty shall not apply to any error in the Software that is caused by the use or operation of the Software other than on the Platform DISCLAIMER OF OTHER WARRANTIES OSA DISCLAIMS ALL OTHER WARRANTIES WHETHER EXPRESS IMPLIED STATUTORY OR OTHERWISE INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY NONINFRINGEMENT FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OTHERWISE ARISING OUT OF ANY SAMPLE SPECIFICATION OR PROPOSAL OSA DOES NOT
25. confirmation correspondence or otherwise unless OSA specifically agrees to the provision in a written executed document If any provision of this EULA shall be held to be invalid illegal or unenforceable such provision shall be enforced to the maximum extent permitted by law and the remaining provisions shall not be affected This EULA is governed by the laws of the State of California without reference to conflicts of laws provisions You agree that all disputes arising out of or in connection with this EULA shall be subject to the exclusive jurisdiction of and venue in the federal and state courts within Santa Clara County California U S A and you irrevocably consent to the personal and exclusive jurisdiction and venue of these courts You may not assign or transfer this EULA or any rights or obligations under this EULA Any assignment or transfer of this EULA made in contravention of the terms hereof shall be null and void Subject to the foregoing this EULA shall be binding on and inure to the benefit of the parties respective successors and permitted assigns OSA may assign its rights under this EULA to its affiliates and to any successor by way of merger acquisition consolidation reorganization or sale or all or substantially all of its assets which relate to this EULA without action on your part in which case references to OSA herein shall be deemed to refer to the assignee You are responsible for the payment of any taxes including yo
26. cords to be printed starting from the last record then counting backwards time yyyy mm dd hh mm ss Specify a point in time as the value of timestamp It should be in the format of yyyy mm dd hh mm ss yyyy Year It should be a valid calendar year number and include 4 digits such as 1999 mm Month It should be a valid calendar month number from 01 to 12 such as 06 June 11 November dd Day It should be a valid calendar day number from 01 to 31 hh Hour It should be a valid hour number from 00 to 23 mm Minute It should be a valid minute number from 00 to 59 ss Second It should be a valid second number from 00 to 59 Synopsis of Default Subcommand sel If no subcommand is specified this command will act the same as sel status Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 24 User s Manual for OSA System Management Bridge C Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 sel status 58 system event log records C Program Files OSA gt When executing sel get command the system event log records are displayed using a tabular format The column headers are Ordinal Number Message Timestamp Sensor Number Sensor Type and Brief Description C Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 sel get 1 2084 05 25 13 58 43 9 Event Logging Disabled Log Area Reset Clear rity Transition to OK 2094 95 25 14 00 131 System Event S
27. d server Display all field replaceable units FRU present in the system Display the BMC firmware information Display summary information about the event log Display the logged events one event per line An administrator with operator level privilege to a remote BMC can additionally e Power on off or cycle a server e Initiate a hard power off or graceful shutdown of the system e Delete the system event log Turn on off the blinking system identifier Set a timestamp for the event log Server Mode In Server Mode OSA SMBridge allows a local or remote telnet client to connect with a Remote BMC to realize power and system management or communicate with the hardware designated serial port Server mode is available when SMBridge is started as a background service or daemon Then administrator can access SMBridge remotely via a telnet client Any standard telnet client application such as HyperTerminal on Microsoft Windows or telnet on Linux can be used to access the server s features The SOL protocol coupled with the remote system s BIOS console redirection allows administrators to view and change the BIOS settings over LAN Linux serial console and Microsoft s EMS SAC interfaces can also be accessed over LAN using SOL Target Audiences The target audiences for this manual are Linux or MS windows system administrators who need access to the system console in early stages of the boot cycle or for pre boot configuration Administra
28. ed description of this command will display INNT System32 cmd exe C Program Files OSA gt smbridge help power BMC Management Utility SMBRIDGE Version 1 8 0 1 Copyright 2004 OSA Technologies Avocent Company All Rights Reserved power Control power status of the remote managed server power status ion icycle ireset power off force DESCRIPTION This command is used to display the current power status of the managed server turn on off or reset the server SUB COMMANDS status Display the current power status of the server the returned value is on or off on Turn on the server off Issue a graceful shutdown IPMI command cycle Turn off the seruer first after a period of time then turn it on reset Pulse the system reset signal regardless of the power state force This option will simulate pressing the power button and will force the system off C Program Files OSA gt _ Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 18 User s Manual for OSA System Management Bridge IPMI Session Option ip Synopsis smbridge ip bmc ip address bmc host name u username p password Description This option is used to establish a connection to a remote server via LAN channel while the IP port specified in installation default value is 623 is used implicitly Options ip bmc ip address bmc host name Specify the OOB IP address or h
29. ed from the CLI mode The identify sysinfo power and sel commands are exactly the same as the corresponding commands in the CLI mode In CLI mode these commands operate on the remote server specified with the IPMI session global option In the Server mode the commands operate on the remote server specified with the connect command For example the proper use of the command power is depicted in the following image 015 File Edit Call Transfer Help ciae amp 5 OSA System Management Bridge SMBridge 5 Version 1 6 6 2 Copyright lt c gt 2084 OSA Technologies an Avocent Company All Rights Reserved SMBridge gt connect ip 192 168 1 77 u admin p admin SMBridge gt power status Status on SMBridge gt Connected 0 00 39 100 TCP IP SCROLL CAPS Capture Print echo Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 32 User s Manual for OSA System Management Bridge Additionally four new commands connect reboot sol console are introduced that are only available in the Server mode Each new command will be described in the section below connect Synopsis connect ip bmc ip address bmc host name u username p password Description This command is approximately equivalent to the CLI Mode global options and is used to establish an IPMI connection with the remote server A connection to the remote server is necessary before usin
30. ensor specific 2664 85 24 23 98 257 131 System Event Sensor specific 2084 05 24 23 00 55 131 System Event OEM System Boot 2084 05 24 23 61 51 131 System Event Sensor specific 2604 65 24 23 61 52 131 System Event Sensor specif ic 2004 05 24 23 02 22 131 System Event OEM System Boot 2084 05 24 23 56 12 131 System Event Sensor specific 2004 05 24 23 56 15 131 System Event Sensor specif 2604 65 24 23 56 45 131 System Event OEM System Boot 2084 05 24 23 57 28 131 System Event Sensor specif ic 2084 05 24 23 57 28 131 System Event Sensor specific 2084 05 25 00 09 40 131 System Event pecific 2604 65 25 66 69 44 131 System Event Sensor specific 2084 05 25 80 12 16 131 System Event Sensor specif ic 2084 05 25 00 12 17 131 System Event Sensor specific 2004 05 25 66 15 22 131 System Event Sensor specif 2664 65 25 66 15 22 131 System Event Sensor specific 2084 05 25 21 59 58 1131 System Event Sensor specific 2004 05 25 22 64 27 131 System Event Sensor specif ic 2604 65 25 22 85 12 131 System Event Sensor specific 2004 05 25 22 05 12 131 System Event Sensor specif ic 2094 95 25 22 38 13 132 Button Power Button pressed Severity Tran gp TONE O wu wu u n m uw n m m n m m m i Files 0SA gt smbridge admin p admin ip 192 168 1 77 sel get begin 2 end 5 76 131 System Event Sensor ecific 1131 System Event Sensor specific 2004
31. entify off is used to turn the LED off Otherwise the LED will be turned on for the maximum allowed time of 255 seconds off Turn off the LED Options 4 seconds Specify how long the LED will be turned on It should be no longer than 255 seconds Synopsis of Default Subcommand identify If no subcommand is specified this command will act the same as identify on A WINNT system32 cmd exe C Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 identify on t 10 C Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 identify off C Program Files OSA gt Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 21 User s Manual for OSA System Management Bridge sysinfo Synopsis sysinfo fru id Description This command retrieves and displays the system information including information about FRU and BMC Subcommands fru Return FRU related information id Return BMC related information Synopsis of Default Subcommand sysinfo If no subcommand is specified this command will act the same as sysinfo id AWINNT System32 cmd exe C Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 sysinfo id DeviceID 32 DeviceRevision 1 FirnwareVers ion 31 13 IpmiVersion 1 5 ManufacturerID 343 Product ID 27 Status OK SDRVers ion 1 5 Guid 666666066 6666 6660 6606 H9800008000000 C Program Files OSA gt _ C WINNT System32 c
32. g any other commands to perform server management Once connect command is executed the connection will remain active until the user quits SMBridge or uses connect command again to connect to a different server Options ip bmc ip address bmc host name Specify the OOB IP address or hostname of the remote managed server u username Specify the username used to connect to the server p password Specify the password used to connect to the server asdf HyperTerminal 101 File Edit Call Transfer Help 281 alal OSA System Managanont Bridge lt SMBridge gt Version 1 0 0 2 2004 OSA Technologies an Avocent Company All Rights Reserved Copyright lt c gt SMBridge gt connect ip 192 168 1 77 u admin p admin SMBridge gt _ P Connected 0 01 06 VT100 SCROLL CAPS Capture Print echo Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 33 User s Manual for OSA System Management Bridge sol Synopsis sol enable disable sol config baud baud rate priv privilege lever retry count retry count retry interval interval Description This command allows user to configure sol session parameters of a remote BMC SMBridge will respond with an error if sol is used before connect has established an IPMI session Subcommands enable Allow user to enable SOL of the currently connected server disable Allow user to d
33. ght c 2004 OSA Technologies an Avocent Company All Rights Reserved 34 User s Manual for OSA System Management Bridge asdf HyperTerminal Be x File Edit view Call Transfer Help Dis 231 alal es OSA System Management Bridge lt SMBridge gt Version 1 8 8 2 Copyright 2884 OSA Technologies an Avocent Company All Rights Reserved SMBridge gt connect ip 192 168 1 77 u admin p admin SMBridge gt sol disable Serial Over LR N Disabled SMBridge gt _ 4 Connected 0 00 32 vT100 SCROLL CAPS Capture Print echo Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 35 User s Manual for OSA System Management Bridge console Synopsis console Description This command allows the user to establish the SOL session with the currently connected server SMBridge will respond with an error if console is used before connect has established an IPMI session asdf HyperTerminal B Pii xi File Edit view Call Transfer Help Die 2319281 eel set max priviledge of SOL SMBridge gt console OSA System Management Bridge SMBridge gt Version 1 0 0 2 4 OSA Technologies an Avocent Company All Rights Reserved Copyright 2 SMBridge gt connect ip 192 168 1 77 u admin p admin SMBridge gt console Remote console is now active and ready for user input Connected 0 00 43 ivr100 SCROLL CAPS NUM Capture Print echo P
34. ion 2 Create a new TCP IP connection providing the IP address of OSA SMBridge Server and the port number you have specified in OSA SMBridge installation process the default value is 623 The Emulation mode is VT100 Note The IP address and port number you provide should conform to the ones defined in OSA SMBridge configuration file smbridge cfg For more details refer to Configure OSA SMBridge in Appendix C 3 Upon successful execution you are ready to login SMBridge Via Linux Shell 1 OpenaLinux shell 2 Enter the telnet command and provide the IP address of OSA SMBridge Server and the port number you have specified in OSA SMBridge installation process the default value is 623 For example telnet 192 168 1 24 623 Note The IP address and port number you provide should conform to the ones defined in OSA SMBridge configuration file smbridge cfg For more details refer to Configure OSA SMBridge in Appendix C 3 Upon successful execution you are ready to login SMBridge Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 29 User s Manual for OSA System Management Bridge User Login When user attempts to establish a telnet session SMBridge will authenticate the connection request leveraging the host system s authentication mechanism If the telnet connection request is from the local host SMBridge will not authenticate the user since he has already been authenticated by the local h
35. isable SOL of the currently connected server config Allow user to configure SOL baud rate and privilege level Options baud baud rate Specify the communication baud rate over serial channel such as 9600 and 19200 It should be in conformity with the one set in the managed server priv privilege level Specify the minimum privilege level required to establish a SOL session Possible values are user operator and admin retry count retry count Specify 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 retry interval retry interval Specify 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 Synopsis of Default Subcommand sol If no subcommand is specified this command will display the current status of sol session asdf HyperTerminal _ lani File Edit Call Transfer Help al 3 ala SMBridge gt sol enable Status Serial Over LAN Enabled Current settings Baud Rate 19 2K Minimum required privilege OPERATOR SMBridge gt sol config baud 19288 priv operator Configure and set the SOL session Current settings Minimum required privilege Baud Rate 19 2K SMBridge gt Connected 0 01 13 VT100 SCROLL CAPS Capture Print echo Copyri
36. md exe C Program Files OSA gt smbridge u admin p admin ip 192 168 1 77 sysinfo fru ChassisT ype 23 BoardLangCode BoardMf gDateT ime 2662 12 31 17 36 00 BoardManuf acturer Intel BoardProduct Name SE7581WU2 BoardSerialNumber 6667E 64D726613 BoardPartNumber 99386 1808 BoardFRUFileID FRU Ver 61 Product LangCode ProductManuf acturerName Intel C Program Files OSA gt Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 22 User s Manual for OSA System Management Bridge power Synopsis power status power off force cycle reset Description This command is used to display the current power status of the managed server turn on off or reset the server Subcommands status Display the current power status of the server the returned value is on or off on Turnon the server off Issue a graceful shutdown IPMI command cycle Turn off the server first after a period of time turn it on reset Pulse the system reset signal regardless of the power state Options force This option will simulate pressing the power button and will force the system off Synopsis of Default Subcommand power If no subcommand is specified this command will act the same as power status INNTsystem32 cmd exe C Program Files OSA gt smbridge ip 192 168 1 77 power status Status off C Program Files OSA gt smbridge ip 192 168 1 77 power
37. me windowing environments such as KDE this can be simply done by using the Settings menu to configure the keyboard behavior Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 40 User s Manual for OSA System Management Bridge Appendix C Configure OSA SMBridge 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 SMBridge Configuration File ip INADDR ANY port 623 session_timeout 30 power_off_timeout 60 Any line starting with is treated as a comment Possible configuration parameters are gt 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
38. of telnet clients can be used e Ina MS Windows environment you can use a Command Prompt window as your console e Ina MS Windows environment you can also use any telnet application supporting VT100 emulation mode such as HyperTerminal bundled by MS Windows platforms as your console e In a Linux environment you can use a shell such as csh or ksh as your console To find out more about how to use and configure different telnet clients refer to Appendix B Depending on the console you use there are different steps for accessing OSA SOL Manager For ease of description we call the computer where OSA SMBridge is installed OSA SMBridge Server Working in Server Mode Important note Before working in the Server mode you should ensure that OSA SMBridge has been successfully started as a background service or daemon Via Windows Command Prompt 1 Open a Command Prompt window 2 Enter the telnet command in the command line and provide the IP address of OSA SMBridge Server and the port number you have specified in OSA SMBridge installation process the default value is 623 For example telnet 192 168 1 24 623 Note The IP address and port number you provide should conform to the ones defined in OSA SMBridge configuration file smbridge cfg For more details refer to Configure OSA SMBridge in Appendix C 3 Upon successful execution you are ready to login SMBridge Via Windows HyperTerminal Console 1 Open a HyperTerminal sess
39. ost OS system by virtue of being logged on to the system Otherwise the user will be prompted to input valid a user name and password After a successful login a telnet session is established and a command prompt is displayed for the user to interactively execute SMBridge commands Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 30 User s Manual for OSA System Management Bridge Getting Help When user has entered SMBridge Server Mode he can key in help command in the command line to know what commands he can use to accomplish management tasks Synopsis help cma Description A command list and a capsule description of options are printed if no argument is given When there is an argument specifying which command the detailed description of this command will display Argument cmd Specify the command that will be printed with detailed description asdf HyperTerminal inl xl File Edit view Call Transfer Help 251 26 SMBridge gt help sol sol sol Allow user to enable disable SOL of now connected server or config baud rate and max priviledge parameter of SOL SYNOPSIS sol enable i disable lt config baud 9600 i 1928801 priu adminiuser toperator gt DESCRIPTION This command allows user to enable disable SOL of now connected server or config baud rate and max priviledge parameter of SOL SUB COMMANDS enable Allow user to enable SOL of no
40. ostname of the remote managed server u username Specify the username used to connect to the server It can be omitted if the argument value is null p password Specify the password used to connect to the server It can be omitted if the argument value is null Note Session option ip cannot be used independently and one or more SMBridge commands must follow it 95 C WINNT system32 cmd exe C Program Files OSA gt smbridge ip 192 168 1 77 u admin p admin power status Status off C Program Files OSA gt IPMI Session Option com Synopsis smbridge com ser a port baud baud_rate flow flow control u username p password Description This option is used to establish a connection to a remote server via Serial channel Options serial port Specify the serial port when establish an IPMI session to the managed server In windows system it can be 1 2 and so on In Linux system it can be ttySO ttyS1 ttyS2 and so on baud baud rate Specify the communication baud rate over serial channel such as 9600 and 19200 It should be in conformity with the one set in the managed server flow control Specify the controlling manner of the flow data There are 3 ways to handle flow control CTS XON and NONE CTS means Hardware Flow Control since the control is handled by hardware XON means Software Flow Control because the flow control manner is via software NONE means no flow control
41. r argument argument is repeatable argument argument argument argument is default value if no argument is expression entire expression within is repeatable The general syntax of SMBridge commands in this mode is as follows smbridge global option command command Where a command is sub cmd cmd option amp argument Both global options and command specific options are always in the form of option argument i e help max 20 u John etc Arguments with embedded tabs or spaces must be enclosed in matching or quotes for example user John Smith time 2003 03 03 14 35 34 Every command has one Default Subcommand The Default Subcommand is typically but not always the equivalent of reading and displaying of the current setting or status for the command Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 17 User s Manual for OSA System Management Bridge Global Options OSA SMBridge has the following global options Help Option help Synopsis smbridge help Description This option is used to get help for Asummary page for all commands Asummary of all subcommands for a single command e Adetailed description of a cmd sub cmd combination Options help cmd A command list and a capsule description of options are printed if no argument is given When there is an argument specifying which command the detail
42. r sbin smbridge shall be created Post Installation After successful installation SMBridge Server will start automatically as a daemon Before SMBridge can be used to manage a remote server the BMC and BIOS of the remote server should be configured correctly For more information refer to Configuring a remote server for OOB Access in Appendix A Also you need to know how to correctly set OSA SMBridge runtime parameters For this part refer to Appendix C Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 14 User s Manual for OSA System Management Bridge Uninstalling OSA SMBridge Uninstalling OSA SMBridge from Windows System To uninstall OSA SMBridge use the Add Remove Programs Utility in the Control Panel Uninstalling OSA SMBridge from Linux System 1 Login as root 2 Enter the following command to remove all the installed packages rpm osasmbridge 3 Asuccess message should be returned to show that OSA SMBridge is uninstalled successfully Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 15 User s Manual for OSA System Management Bridge Command Line Interface Mode IPMI Session In mode OSA SMBridge supports out of band access through LAN or serial port to a single server at a time By connecting to the BMC of the remote server SMBridge can realize cost effective remote management However multiple IPMI sessions can run sim
43. ram files If you want to review or change any settings click Back If you are satisfied with the settings click Next to begin copying files Current Settings Destination Directory C Program Files 0SA Input INADDR ANY Port 623 SessionTimeout 30 imeout 60 InstallShield 7 A progress bar will appear to show the installation process InstallShield Wizard Setup Status OSA SMBridge Setup is performing the requested operations Installing C Program Files OSA SMBridge exe 39 InstallShield Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 13 User s Manual for OSA System Management Bridge 8 Click Finish to complete the installation InstallShield Wizard InstallShield Wizard Complete Setup has finished installing 054 SMBridge on your computer Installation on Linux System 1 Login as root 2 Insert the OSA SMBridge CD into the CD ROM drive 3 Enter the following command to mount the CD mount mnt cdrom 4 Go to directory where the installation RPM package is located cd mnt cdrom 5 Run the RMP package to begin installing rpm osasmbridge 1 0 2 0 386 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 us
44. rent folder click Browse and select another folder Destination Folder C Program Files OSA Browse InstallShield Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 10 User s Manual for OSA System Management Bridge 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 InstallShield Wizard Input IP Port Please specify the IP address and TCP IP port number that OSA SMBridge will bind and serve Port 623 InstallShield ce Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 11 User s Manual for OSA System Management Bridge 5 User could specify the Telnet Session Timeout value and
45. ress F2 to enter BIOS Setup Utility asdf HyperTerminal edel x File Edit Call Transfer Help Dia 2381 alal BIOS SETUP UTILITY Main Advanced Security Server Boot Exit 7 a Selects Power on state i i for Numlock i Setting items on this screen to incorrect i PCI Conf iguration Peripheral Configuration Memory Configuration Advanced Chipset Control Reset Config Data Connected 0 01 30 100 SCROLL CAPS Capture Print echo Z Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 36 User s Manual for OSA System Management Bridge To exit an active SOL session use the character sequence The characters should be typed without a long delay between them reboot Synopsis reboot force Description This command combines power control with establishing a SOL session in one atomic operation It is equivalent to executing the commands power off power on and activate sol in turn Options force Used to force a power off condition If this option is omitted the reboot command will be executed using a graceful shutdown 0 1 THO RBO SEV TUO MAD EBD Die 231 aal e OSA System Management Bridge SMBridge Version 1 1 1 1 Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved SMBridge gt connect ip 192 168 1 7 u admin p admin S
46. terminate automatically if you violate any part of this EULA In the event of termination you must destroy the original and all copies of the Product or return them to OSA GRANT OF LICENSE Upon your acceptance of this EULA and provided you observe the terms of this EULA OSA grants you a nontransferable nonsublicensable nonexclusive license to either a use the Software on the Platform to the extent specified in use rights provided to you in writing by OSA or an OSA Distributor as applicable OR b if there are no use rights specified in writing to you by OSA or an OSA Distributor as applicable you may use the Software on the Platform Customer may use the Product solely on its own private network No copies of the Software shall be made without OSA s written consent TITLE TO SOFTWARE AND RESTRICTIONS Title to the Software including any online user documentation and software contained therein and all translations thereof shall remain with OSA You shall not remove alter cover or obfuscate any copyright notices or other proprietary rights notices placed or embedded by OSA on or in any Software or Documentation You shall not a disclose the results of any benchmark tests relating to the Software or b announce promote present display criticize or advertise the Software or Documentation to anyone You may not sublicense or otherwise distribute the Software or Documentation to any third party You will not sell resell for a profit
47. tive Tools Services OSA SMBridge Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 27 User s Manual for OSA System Management Bridge OSA SMBridge Properties Local Computer E 21 General Log On Recovery Dependencies Service name OSA SMBridge Display name OSA SMBridge Description Path to executable C Program Files OSA pxyservice exe Startup type Automatic Y Service status Started Stari Stop Pause You can specify the start parameters that apply when you start the service from here On Linux system you can go to directory etc init d and use the following commands to start stop OSA SMBridge daemon service smbridge start smbridge stop of 192 168 1 193 PuTTY root localhost ftp In the CLI Mode you can also use d option to start OSA SMBridge as a daemon smbridge d c config file gt Options d Used to start SMBridge as a daemon c config file gt Specify the configuration file that SMBridge may start with If a config file is not specified then SMBridge Server will operate with default configuration settings For a list of configuration parameters and their default values please refer to Configure OSA SMBridge in Appendix C Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 28 User s Manual for OSA System Management Bridge Telnet Clients A variety
48. to replace F2 Microsoft HyperTerminal MS HyperTerminal bundled with MS Windows platform has been tested as a SMBridge telnet client and should satisfy most users needs To ensure a clear and correct displaying user should turn off automatic wrap function by clearing the checkbox Wrap lines that exceed terminal width in HyperTerminal ASC II Setup HyperTerminal Properties Setting ASCII Setup If HyperTerminal is used to connect to a Windows Console user should select VT100 as the emulation mode lt F1 gt and lt F2 gt function keys are supported in this case Additionally for Windows Server 2003 Enterprise edition HyperTerminal may not work correctly as a SMBridge telnet client until you upgrade it to the private edition If HyperTerminal is used to connect to a Linux Console redirected by SOL the function and arrow keys may not work based on the tty settings of the remote application gt Linux Telnet In a Linux environment you can use the standard Linux telnet executed from any Linux shell Such as csh or ksh as the telnet client However pressing F1 and F2 function keys may not generate the required vt100 key codes If the Linux shell is running outside of an X Windows environment the generated key codes will most likely be wrong If however the shell is running as a window in an X Windows environment it is possible to configure X Windows to generate vt100 key codes for function keys In so
49. tors can also use these tools to monitor the proper operation of the system hardware and operating system Graceful shutdown is an optional IPMI command and may or may not be implemented by the target BMC Initiating a graceful shutdown for a platform that does not support the feature should return an error code Copyright c 2004 OSA Technologies an Avocent Company All Rights Reserved 3 User s Manual for OSA System Management Bridge Glossary This Manual uses the following glossary and abbreviations Term Definition SMBridge System Management Bridge OOB Out Of Band Pre OS or OS absent management scheme The BMC allows the retrieval of firmware information and performs shutdown and reboot functions in the absence of an OS IPMI Intelligent Platform Management Interface is an industry standard for management of peripherals used in enterprise computers based on Intel amp architecture The key characteristic of IPMI is that inventory monitoring logging and recovery control functions are available independent of the main processors BIOS and OS SOL Serial Over LAN enables suitably designed servers to transparently redirect the serial character stream of a baseboard UART Universal Asynchronous Receiver Transmitter to from a remote client via the LAN The architecture requires software running on the BMC and client software running on a management workstation and or a central network proxy BMC Baseboard Man
50. ultaneously on the same node To facilitate command scripting upon successful execution SMBridge commands return with an exit code of zero and will output the execution results in a parsable format If an error is encountered the program exits with a non zero error code and output the error in a parsable format Working in CLI mode On Windows System 1 Start a Command Prompt window 2 Goto the directory where the file smbridge exe is located By default smbridge exe is located at the OSA SMBridge installation directory 3 Enter the commands available in CLI mode to manage the remote server On Linux System 1 Start an OS shell 2 Goto the directory where the file smbridge is located By default smbridge is located at the directory usr sbin 3 Enter the commands available in CLI mode to manage the remote server Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 16 User s Manual for OSA System Management Bridge Syntactic Rules To ensure that readers understand more clearly the commands appearing in OSA SMBridge the following conventions are presented These conventions also apply to the syntax of commands in Server Mode Expression Explanation bold text type exactly as shown italic text replace with appropriate argument abc any or all arguments within are optional a b options delimited by cannot be used togethe
51. ur personal property taxes arising from this EULA or your use of the Product LIFE SUPPORT AND OTHER CRITICAL SYSTEMS The Software shall not be used in connection with any system where malfunction can reasonably be expected to result in personal injury death or damage to property environment or business Without limiting the foregoing the Software shall not be used in connection with any life support system You agree to hold OSA and its officers directors employees affiliates and licensors harmless from any claims or losses resulting from any of the foregoing uses of the Software EXPORT CONTROLS The Software and the underlying information and technology may not be downloaded or otherwise exported or reexported i into or to a national or resident of Cuba Iraq Libya Sudan North Korea Iran Syria or any other country to which the U S has embargoed goods or ii to anyone on the U S Treasury Department s list of Specially Designated Nationals Specially Designated Terrorists Specially Designated Narcotic Traffickers or the U S Commerce Department s Table of Deny Orders By downloading or using the Software you are agreeing to the foregoing and you represent and warrant that you are not located in under the control of or a national or resident of any such country or on any such list Without limiting the generality of the foregoing you agree that you will not export or re export directly Copyright 2004 OSA Technologies
52. ving error Session buffer limit Length exceeds the limit of telnet input exceeded A6h Syntax errors Command syntax Error Unable to parse command Unrecognized command Unrecognized Command Time format is incorrect Time is not correct Conflicting option Conflicting option last amp max Invalid parameter Invalid Parameter Parameter value Parameter out of range Parameter out of range OxC9 errors Parameter out of range 1 The value is out of range 1 255 255 Parameter out of range 1 The value is out of range 1 65535 65535 Invalid data field Invalid data field OxCC Invalid index value Index cannot be zero or negative First index larger than the The first index is larger than the last last First index larger than total The first index is larger than the total sel sel records records Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 43 User s Manual for OSA System Management Bridge A8h H W or Unsupported command Unsupported Operation 1 Sensor not present Request sensor data or record not present OxCB Sensor command error Command illegal for specified sensor or OxCD record type Firmware error Command response could not be provided OxCE Destination error Cannot deliver request to destination OxD3 Device error Device specific OEM errors 0x01 0 7 Unsupported command for
53. w connected server disable Allow user to disable SOL of now connected server Allow user to config baud rate and max priviledge parameter OPTIONS baud baudrate set baudrate of SOL priv priviledge set max priviledge of SOL SMBridge Connected 0 03 35 100 SCROLL CAPS Capture Print echo Copyright 2004 OSA Technologies an Avocent Company All Rights Reserved 31 User s Manual for OSA System Management Bridge Commands After the telnet connection with OSA SMBridge is successfully established a SMBridge prompt is displayed for further user commands The table below lists the OSA SMBridge commands available in Server mode with a brief description Command Description connect Connects to remote managed server identify Controls the identification LED on the front panel of the currently connected server sysinfo Retrieves and displays the system information of the currently connected server ower Controls power state of the managed server of the currently connected server sel Performs vital operations related to the system event log of the currently connected server sol Configures SOL BMC parameters of the currently connected server console Establishes the SOL session with the currently connected server reboot Combines power control with establishing a SOL session in one atomic operation Commands inherit

User`s Manual

Contents

Download Pdf Manuals

Related Search

Related Contents