Roamer KVM User Manual

Transcription

1 Roamer KVM User Manual Part Number: First Edition Rev. 02: October 2007 Website: Telephone: Copyright 2007

2 Copyright (c) Rackable Systems, Inc All rights reserved. Trademarks used in this manual: Rackable Systems, Rackable, Roamer KVM, and Roamer KVM Remote Management Solution are trademarks of Rackable Systems, Inc. disclaims any proprietary interest in trademarks and trade names other than its own. Rackable Systems may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Rackable Systems, Inc. the furnishing of this document does not release any license to these patents, trademarks, copyrights, or other intellectual property. Information in this document, including URLs and other Internet Website references, is subject to change without notice. Without limiting rights under copyright, no part of this document may be reproduced, stored in or transmitted in any form or by any means (electronic, mechanical, recording, photocopying, or otherwise), or for any purpose, without the express written permission of Rackable Systems, Inc. Copyright (c) 2003 Sun Microsystems, Inc. All Rights Reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistribution of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistribution in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of Sun Microsystems, Inc. or the names of contributors may be used to endorse or promote products derived from this software without specific prior written permission. This software is provided "AS IS," without a warranty of any kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You acknowledge that this software is not designed or intended for use in the design, construction, operation or maintenance of any nuclear facility.

3 Roamer KVM User Manual Rackable Rackable acknowledges the following trademarks: Intel is a registered trademark of Intel Corporation. Windows 98, Microsoft Windows, Windows NT, Windows 2000 and Windows XP are trademarks of Microsoft Corporation. IBM, AT, VGA, PS/2, and OS/2 are registered trademarks and XT and CGA are trademarks of International Business Machines Corporation. Raritan is a registered trademark of Raritan Incorporated. Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products. Rackable disclaims any proprietary interest in trademarks and trade names other than its own. The firmware of this product uses in part software under GPL license. See Appendix E for the license text. This product includes software developed by the University of California, Berkeley and its contributors. This software is based in part on the work of the Independent JPEG Group. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit ( Printed in the USA. Roamer KVM User Manual

4

5 Table of Contents Preface xi Roamer KVM xi This User Manual xi Limitations of Liability xi Technical Support xi 1 Quick Reference Guide About the Roamer KVM Initial Network Configuration Using the psetup Tool Installing the psetup Tool Running the psetup Tool Access Via Web Interface Remote Console Sync Mouse Option Introduction General Information Product Features When the Server is Running When the Server is Down Roamer KVM Installation Guide The Roamer KVM Connectors Ethernet Connection Connecting 10 Mbps Ethernet Connecting 100 Mbps Ethernet Roamer KVM Configuration Initial Configuration Initial Configuration using a DHCP Server Web Interface Resetting the System Administrator s Password Mouse and Keyboard Configuration Properties of Mice Remote Mouse Settings Auto Mouse Speed and Mouse Synchronization Double Mouse Mode Host Settings Limitations Special Mouse Driver Windows 2003 Server/XP Mouse Settings Active Desktop Single Mouse Mode Recommended Mouse Settings MS Windows 2000, 2003, XP (all versions) Sun Solaris Mac OS X Linux Video Modes Roamer KVM User Manual i

6 Table of Contents 5 Roamer KVM Usage Prerequisites HTTP/HTTPS TELNET SSH Java Web Browser Login and Logout to the Roamer KVM Logging into the Roamer KVM Navigation Logging out of the Roamer KVM The Remote Console General Description Main Window Remote Console Control Bar Remote Console Options Monitor Only Screenshot to Clipboard Chat Window Scaling Local Cursor Video Settings Refresh Video Soft Keyboard Local Keyboard Hotkeys Encoding Remote Console Status Line Optimizing the Video Picture Using the Roamer KVM with Low Bandwidth Web Interface Remote Control Roamer KVM Console Remote Console Preview Virtual Media Floppy Disk Upload a Floppy Image CD-ROM Image Drive Redirection System Health Chassis Control Monitor Sensors System Event Log LCD Carousel User Management Change Password Users And Groups User Management List of Available Options Permissions KVM Settings User Console Remote Console Settings for Users Transmission Encoding ii Table of Contents

7 Roamer KVM User Manual Automatic detection Pre-configured Manually Remote Console Type Java Virtual Machine (JVM) Sun Microsystems Java Browser Plug-in Miscellaneous Remote Console Settings Start in Monitor Mode Start in Exclusive Access Mode Mouse Hotkey Remote Console Button Keys Keyboard/Mouse Key Release Timeout USB Mouse Type Mouse Speed Device Settings Network Network Basic Settings IP auto configuration Preferred host name IP address Subnet Mask Gateway IP address Primary DNS Server IP Address Secondary DNS Server IP Address Network Miscellaneous Settings Remote Console and HTTPS port HTTP port TELNET port SSH port Bandwidth Limit Enable TELNET Enable SSH Disable Setup Protocol LAN Interface Settings LAN interface speed LAN interface duplex mode Serial IPMI Serial Over LAN (SOL) Configuration login Passthrough access Serial Port Settings Security HTTP Encryption Force HTTPS KVM Encryption IP Access Control Group Based System Access Control User Blocking Login Limitations Certificate Common name Organizational unit Organization Locality/City Roamer KVM User Manual iii

8 Table of Contents State/Province Country (ISO code) Challenge Password Confirm Challenge Password Key length Date And Time Authentication Event Log Event Log Targets List Logging Enabled NFS Logging Enabled SMTP Logging Enabled SNMP Logging Enabled Event Log Assignments SNMP Settings SNMP Overview Configuring SNMP Scratchpad Maintenance Device Information Event Log Update Firmware Updating the firmware Unit Reset Roamer KVM Command Line Interface (CLI) Starting the Command Line Interface Starting a Serial Session CLI Commands Clp DeleteScratchpadKey DumpScratchpadContents EnableDHCP FactoryReset GetCurrentIPInfo GetHostPowerOnState GetHostPowerState GetHostServerUptime GetLCDTextRotationInterval GetLCDTextSlot GetLEDColor GetLEDState GetPowerOnDelay GetRoamerKVMUptime GetScratchpadValue GetTemperatureData Help HostHardReset HostPowerOff HostPowerOn HostSoftShutdown Quit RebootRoamerKVM SetLCDTextRotationInterval iv Table of Contents

9 Roamer KVM User Manual SetLCDTextSlot SetLEDColor SetLEDState SetPowerOnDelay SetScratchpadValue SetStaticIPInfo StartLCDCarousel StopLCDCarousel Terminal Version IPMITool GetLCDTextSlot SetLCDTextSlot GetLCDTextRotationInterval SetLCDTextRotationInterval GetLEDState SetLEDState GetLEDColor SetLEDColor GetHostPowerOnState SetHostPowerOnState GetPowerOnDelay SetPowerOnDelay GetTemperatureData ResetRoamerKVM GetHostServerUptime GetRoamerKVMUptime StartLCDCarousel StopLCDCarousel IP Address Configuration A Frequently Asked Questions B Glossary C Specifications Environment Temperature Humidity Range D Warranty Information E GNU General Public License (GPL) Preamble F The OpenLDAP Public License G Key Codes H SNMP MIB I Creating Images Creating an Image Roamer KVM User Manual v

10 Table of Contents Floppy Images CD-ROM/ISO 9660 Images J Sharing Images Mounting an Image Windows 2000/XP UNIX and UNIX-like OS (UNIX, Solaris, Linux) K Redirecting Drives Drive Redirection Drive Redirection Options Configuration Drive Selection Write Support Using Device Redirection Navigation Buttons Connect/Disconnect Exit/Hide L Roamer KVM Pinout Index vi Table of Contents

11 Roamer KVM User Manual Figures 1 Roamer KVM psetup Initial Display IP Address Displayed Browser with IP address entered in address window Roamer KVM Initial Login Screen Rackable Roamer KVM Remote Console Roamer KVM Roamer KVM top view showing labeled connectors KVM Settings-Mouse Type-Other Operating Systems Remote Console Control Bar: Sync Button Internet Explorer Displaying Encryption Key Length Login screen Main Page Remote Console Remote Console Control Bar Remote Console Options Menu Chat Window Remote Console Options Menu: Scaling Remote Console Options Menu: Cursor Remote Console Options Menu: Video Settings Video Settings dialog Remote Console Options Menu: Refresh Video Soft Keyboard Mapping Soft Keyboard Remote Console Confirmation Dialog Remote Console Options: Encoding compression Remote Console Options: Predefined Encoding Compression Remote Console Options: Lossy Compression Remote Console Options: Color Depth Status line Status line transfer rate Roamer KVM Remote Console Virtual Floppy Area Select Image File CD-ROM Selection Drive Redirection Chassis Control Monitoring Remote Sensors Screen System Event Log Screen LCD Carousel Change password Set User Set Permissions User Console Settings (Part 1) User Console Settings (Part 2) Keyboard and Mouse Settings Network Settings Serial Device Security Certificate Settings Roamer KVM User Manual vii

12 Figures 51 SSL Certificate Upload Date and Time Event Log SNMP settings Scratchpad Device Information Connected Users Event Log List Update Firmware Unit Reset PuTTY Configuration Window Putty Username and Password Entry Screen PuTTY Help - Command Display PuTTY SSH Terminal Command SSH Mode - ESC sequence English (US) keyboard Layout, used for the key codes WinImage writing an image Start creation of ISO image file File selected and blank and writable CD is in the drive Recording progress CD-ROM Selection The image file on the share Explorer Context Menu Share configuration dialog Drive Redirection Main View Selecting the desired drive Selecting Write Support Device Authentication Tray Info viii Figures

13 Roamer KVM User Manual Tables 1 Initial Network Configuration Initial Login Settings Host system failures and how they are detected Roamer KVM Connectors Initial network configuration Initial Login Settings Initial Login Settings Top Row Buttons Description of GUI Symbols Initial Login Settings Ports for Internet Services Rackable s IPMI Vendor Extensions GetLCDTextSlot SetLCDTextSlot GetLCDTextRotationInterval SetLCDTextRotationInterval GetLEDState SetLEDState GetLEDColor GetLEDColor GetHostPowerOnState GetPowerOnDelay SetPowerOnDelay GetTemperatureData ResetRoamerKVM GetHostServerUptime GetRoamerKVMUptime StartLCDCarousel StopLCDCarousel Environmental Temperatures Environmental Humidity Range Key Names Roamer KVM Pinout Roamer KVM User Manual ix

14 Tables x Tables

15 Preface The Roamer KVM provides complete lights-out remote server management capabilities allowing you to manage and monitor components in your servers. For more information about Rackable Systems products, visit our website at Roamer KVM Features of the Rackable Roamer KVM include: Manages distributed servers from a remote location Boasts a rich array of command line and Web GUI features An LCD display provides instant server status and programmable messages Remote management capabilities include: KVM, virtual media, power and temperature control, server reset and more Executes an orderly power down for maintenance followed by a cold start when ready Diagnoses a failure and performs a server restart Configuration support for HTTP, SSH, TELNET, IPMI and SNMP services Does not consume valuable PCI slots Ships fully installed in a system for quick and easy deployment This User Manual This Roamer KVM User Manual shows you how to install the software required to run Roamer KVM and provides descriptions of features and interfaces to the tool. Limitations of Liability Rackable Systems shall in no event be held liable for any loss, expenses or damages of any kind whatsoever, whether direct, indirect, incidental, or consequential (whether arising from the design or use of this product or the support materials provided with the product). No action or proceeding against Rackable Systems may be commenced more than two years after the delivery of the product to the buyer. The licensee agrees to defend and indemnify Rackable Systems from any and all claims, suits, and liabilities (including attorney s fees) arising out of or resulting from any actual or alleged act or omission on the part of Licensee, its authorized third parties, employees, or agents, in connection with the distribution of Licensed Software to end-users, including, without limitation, claims, suits, and liability for bodily or other injuries to end-users resulting from use of Licensee s product not caused solely by faults in Licensed Software as provided by Rackable Systems to Licensee. Technical Support Please contact your Rackable Systems Technical Support representative if you need assistance configuring or using Roamer KVM. You may also contact us by at: support@rackable.com. Roamer KVM User Manual xi

16 Preface xii Roamer KVM User Manual

17 1 Quick Reference Guide About the Roamer KVM The Roamer KVM provides remote server management capabilities. You can use the Roamer KVM to manage and monitor components in your servers over the network. Roamer KVM offers a comprehensive hardware solution for server management. Figure 1 Roamer KVM A key feature of the Rackable KVM Module is an integrated BMC (Baseboard Management Controller). It allows you to collect the data from the motherboard sensors. The Roamer KVM can also take an active role in controlling the motherboard, fans, and monitoring motherboard-based sensors. Initial Network Configuration Initially, the Roamer KVM network interface is configured with the parameters shown in Table 1. Table 1 Initial Network Configuration Parameter Value IP address Assigned by DHCP Netmask Gateway none Roamer KVM User Manual 1

18 Quick Reference Guide If this initial configuration does not meet your local requirements, adjust the values to your needs. To retrieve the IP address of the Roamer KVM, perform the following steps: 1. Run the psetup tool (described below). 2. Click the Refresh Devices button (shown in Figure 2). 3. The dropdown list will contain the MAC addresses of all Roamer KVM devices on the network. 4. Select the appropriate MAC address and click Query Device. The IP address displays in the IP address field. Using the psetup Tool Warning: DHCP Failure If DHCP is unable to get an address over a period of time, the Roamer KVM will not have an IP address, and will not be available on the network. Restart the Roamer KVM to get it to retry getting an IP address. psetup is a tool that allows you to configure and set up the Roamer KVM. Installing the psetup Tool To install the psetup tool: 1. Download psetup.zip from ftp://ftp.rackable.com/public/roamer KVM. 2. Extract the file psetup.exe from the psetup.zip file. Running the psetup Tool To run the psetup tool: 1. Be sure the Roamer KVM server is powered on and is connected by an Ethernet cable to your network. 2. Double-click the psetup.exe file to run the psetup tool. 3. When you see the display shown in Figure 2, click Query Device to have it locate the Roamer KVM. Figure 2 psetup Initial Display 2 Roamer KVM User Manual

19 Quick Reference Guide 4. When the psetup software locates the Roamer KVM, the display changes to show the IP address in the grayed-out box, as shown in Figure 3. This is the IP address you will use in the browser, as discussed in the next section. Access Via Web Interface Figure 3 IP Address Displayed You can access the Roamer KVM using a standard Java enabled web browser. You may use the HTTP protocol or a secure encrypted connection through HTTPS. To access the module: 1. Open a browser window (Firefox used in the example shown in Figure 4). Figure 4 Browser with IP address entered in address window 2. Enter the address shown in the IP address of the Roamer KVM into your web browser and press Return. You will see the display shown in Figure 5. Figure 5 Roamer KVM Initial Login Screen Roamer KVM User Manual 3

20 Quick Reference Guide 3. The initial login settings for the web interface are shown in Table 2: Table 2 Initial Login Settings Parameter Value Login admin Password admin or rackable 1 1. Depending on which manufacturing run your Roamer KVM was built, the default administrator password is either admin or rackable. The Roamer KVM requires you to change the administrator password during the first login. Remote Console The Remote Console is the redirected screen, keyboard and mouse of the remote host system in which the Roamer KVM is installed. The web browser used for accessing the Rackable KVM must supply a Java Runtime Environment version 1.4 or higher. Older versions of JRE will work, but some features may not be available. The Remote Console behaves exactly the same way as if you were sitting directly in front of the screen of your remote system. This means that you can use both the keyboard and mouse in the usual way. You can open the console by choosing the appropriate link in the navigation frame of the HTML front end. Figure 6 shows the top portion of the Remote Console. Sync Mouse Option Figure 6 Rackable Roamer KVM Remote Console Mouse devices connected to systems running modern operating systems are usually connected to the USB port. Because of this, you do not need to worry about mouse synchronization and similar parameters. This applies to Windows operating systems including Windows 2000, 2003, and XP, as well as Mac OS X. These operating systems use Absolute Mouse Mode. Note: Sync Mouse Option This option is ONLY visible and available if you choose the option Other Operating Systems parameter for the mouse. In general, there is no need to change mouse settings on the host system. If you need to, choose the Sync Mouse option (shown in Figure 10) to synchronize the local mouse cursor with the remote mouse cursor. Synchronization is typically necessary when using accelerated mouse settings on the host system. Refer to Chapter 4 for more information on the Sync Mouse option. 4 Roamer KVM User Manual

21 2 Introduction General Information The Roamer KVM is a manufacturer-independent remote administration system. It works as an integrated solution on your server system. Based on an embedded operating system, the Roamer KVM provides both exceptional stability and permanent availability independent of the present state of the server s operating system. As a system administrator, you can use the Roamer KVM BMC to gain full control and location-independent remote access to respond to critical incidents and to undertake necessary maintenance. Figure 7 Roamer KVM Product Features The Roamer KVM defines a new class of remote access devices. It combines digital remote access via IP networks with IPMI-based comprehensive and integrated system management. The Roamer KVM offers convenient, remote KVM access and control via LAN or Internet. It captures, digitizes, and compresses video and transmits it with keyboard and mouse signals to and from a remote computer. Remote access and control software runs on its embedded processors only but not on mission critical servers, so that there is no interference with server operation or impact on network performance. The Roamer KVM also offers integrated remote power management using IPMI. Key features of the Roamer KVM are: Serial Access IPMI V2.0 KVM (keyboard, video, mouse) access over IP No impact on server or network performance Automatically senses video resolution for best possible screen capture High-performance mouse tracking and synchronization Local Mouse suppression (only when using Sun s Java Virtual Machine) Roamer KVM User Manual 5

22 Introduction When the Server is Running The Roamer KVM gives you full control over the remote server. The Management Console allows you to access the remote server s graphics, keyboard and mouse and to send special commands to the server. You can also perform periodic maintenance of the server. Using the Console Redirection Service, you are able to access a remote system by its serial console and to perform the following: Reboot the system (a graceful shutdown) Monitor the boot process Modify the BIOS When the Server is Down Note: ACPI Support ACPI support in the operating system is required for this feature. Obviously, fixing hardware defects is not possible using a remote management device. However, the Roamer KVM gives an administrator valuable information about the type of a hardware failure. Using the Roamer KVM, administrators can determine which kind of serious hardware failure has occurred. Refer to Table 3. Table 3 Host system failures and how they are detected Type of Failure Hard disk failure Power supply failure CPU, Controller, main board failure CPU fan failure Software RAM failure Detected By Console screen, CMOS set-up information, and SMART test. Server remains in power off state after power on command is given. Power supply is on, but there is no video output. By IPMI, server specific management, or BIOS setting. Boot-Sequence on boot console. 6 Roamer KVM User Manual

23 3 Roamer KVM Installation Guide The Roamer KVM Figure 8 shows the connectors on the Roamer KVM. This section discusses the module-to-server connection, as well as the two types of Ethernet connections between the server and your network. Figure 8 Roamer KVM top view showing labeled connectors Connectors The connectors on the top board of Roamer KVM and the connections are described in Table 4. Table 4 Roamer KVM Connectors Connector Via Cable Connects to LCD Connector [JP1301] xx-R LCD [ R] Front Panel Connector [JP1307] xx-R [J1A] Front Panel Switch Board [ R] [J3] 5VSTBY power connection [J2] Motherboard Connector [JP1300] xx-R [J1B] Power Sw connection [J10] on the motherboard Reset Sw connection [J4] on the motherboard USB connection [J7] on the motherboard Serial port connection [J6] on the motherboard for Remote serial redirection Roamer KVM User Manual 7

24 Roamer KVM Installation Guide Table 4 Roamer KVM Connectors Connector Via Cable Connects to VGA Connector [JP1302] xx-R [JP1302] Motherboard VGA output [RGB input] I2C Connector [JP1308] n/a Presently this connector is not used Second Serial Port Connector [J1300] n/a Presently this connector is not used Fan Tach Connector [JP1304] 1 n/a Presently this connector is not used Ethernet Connector [JP1305] xx-R [J10] Front Panel Switch Board [ R] via J3 1. It is the connector marked as "PWM/Tacho The pinout table for the Roamer KVM is available in Appendix L. Ethernet Connection The Roamer KVM needs a dedicated RJ45 Ethernet connector - this must be provided by the native system. The Roamer KVM uses the motherboard s Ethernet through a dedicated cable on the module. The Ethernet connector may be used either as a 100 Mbps 100Base-TX connection or as a 10 Mbps 10BASE-T connection. The adapter can sense the connection speed and automatically adjusts to it, or you can set the speed manually. Connecting 10 Mbps Ethernet For 10BASE-T Ethernet networks, the Fast Ethernet adapter uses category 3, 4, or 5 UTP cable. To establish a 10-Mbps connection, the cable must to be connected to a 10BASE-T hub and switches. 1. Make sure that the cable is wired appropriately for a standard 10BASE-T adapter. 2. Align the RJ45 plug with the notch on the adapter s connector and insert it into the adapter s connector. You should hear an audible click as the Ethernet plug latches. Connecting 100 Mbps Ethernet For 100BASE-TX Ethernet networks, the Roamer KVM supports Category 5 or higher UTP cabling. To establish a 100 Mbps connection, the cable has to be connected to a 100BASE-TX hub. 1. Make sure that the cable is wired appropriately for a standard 100BASE-TX adapter. 2. Align the RJ45 plug with the notch on the adapter s connector and insert it into the adapter s connector. You should hear an audible click as the Ethernet plug latches. Note: Cabling Similarity The UTP wire pairs and configuration for 100BASE-TX cable are identical to those for 10BASE-T cable when using category 5 UTP cable. 8 Roamer KVM User Manual

25 4 Roamer KVM Configuration Initial Configuration Table 5 The Roamer KVM s communication interfaces are based on TCP/IP. The module comes pre-configured with the IP configuration listed in Table 5. Initial network configuration Parameter IP address Value Assigned by DHCP Netmask Gateway none If this initial configuration does not meet your requirements, the following section describes the initial IP configuration that is necessary to access the Roamer KVM for the first time. Initial Configuration using a DHCP Server By default, the Roamer KVM will try to contact a DHCP server in the subnet to which it is physically connected. If a DHCP server is found, it may provide a valid IP address, gateway address, and subnet mask. Before you connect the device to your local subnet, complete the corresponding configuration of your DHCP server. We recommend you configure a fixed IP assignment to the MAC address of the Roamer KVM. You can find the MAC address on the outside of the shipping box and labeled on the bottom side. If this initial configuration does not meet your local requirements, use the setup tool psetup to adjust the values to your needs. The psetup tool can be found on the FTP site listed in Installing the psetup Tool, page 2. Install and run the psetup tool and follow the procedure described below. You can find a full description on how to use the psetup tool in Using the psetup Tool on page 2. Web Interface Table 6 Access the Roamer KVM using a standard Java enabled web browser (see Sun Microsystems Java Browser Plug-in on page 44 for information on obtaining and installing JVM). You may use the HTTP protocol or a secure encrypted connection through HTTPS. Enter the configured IP address of the Roamer KVM into your web browser. The initial login settings are shown in Table 6: Initial Login Settings Parameter Value Login admin Password admin or rackable 1 1. Depending on which manufacturing run your Roamer KVM was built, the default administrator password is either admin or rackable. The Roamer KVM requires you to change the administrator password during the first login. Roamer KVM User Manual 9

26 Roamer KVM Configuration Resetting the System Administrator s Password The administrator s password can be reset to its default value (see Table 6) by performing the following steps: 1. Power off the system. 2. Connect line J10 marked as SEN of cable xx-R in the system to the switched 5V pin of the USB header on the motherboard. Note that the USB header location is different on each motherboard. 3. Power the system on and then off. 4. Remove line J10 of cable xx-R from the pin. This cable end must be dressed so that it cannot accidentally short to any connectors in the chassis. 5. Turn on the system and log in. The administrator s password is now reset to its default. Mouse and Keyboard Configuration Properties of Mice The proper configuration of a remote mouse is easier to understand if you understand some underlying concepts. Mice transmit their movement using two methods: either absolute mode or relative mode. Absolute mode means that the mouse transmits absolute coordinates to the Roamer KVM. This is information such as: I am moving to screen co-ordinates X,Y. This mode is very easy to track, and most modern Windows versions (XP, 2000, 2003) as well as Mac OS X use this mode. This mode is also easiest for the Roamer KVM to track. The second mode is relative mode. In this case, the mouse transmits information like I am moving 97 pixels vertically and 88 pixels horizontally from my previous position. This is more difficult for the Roamer KVM to track for the following reasons: The Roamer KVM has to know the starting point of the movement. To make this happen, you need to press a special Synchronize Button, which allows the Roamer KVM to inquire the starting point of the mouse. Mouse acceleration can affect tracking because it can be different on the remote system and the system you are using to talk to the Roamer KVM. Because of this, the Roamer KVM has to do more conversion work to track the mouse than if it were using absolute mode. Relative mode is used by most Linux operating systems and older operating systems including Windows 95/98. If your PC uses this mode, you need to select Other Operating Systems as shown in Figure 9. Figure 9 KVM Settings-Mouse Type-Other Operating Systems 10 Roamer KVM User Manual

27 Roamer KVM Configuration Remote Mouse Settings A common problem with KVM devices is the synchronization between the local and remote mouse cursors. The Roamer KVM addresses this situation with an intelligent synchronization algorithm. Three mouse modes are available on the Roamer KVM: 1. Auto Mouse Speed The automatic mouse speed mode tries to detect the speed and acceleration settings of the host system automatically. See Auto Mouse Speed and Mouse Synchronization on page Fixed Mouse Speed This mode just translates the mouse movements from the web interface in a way that a one pixel move locally leads to an n pixel move on the remote system. This parameter n is adjustable with the scaling. Note that this works only when mouse acceleration is turned off on the remote system. 3. Single/Double Mouse Mode This mode is described in Single Mouse Mode on page 12. Auto Mouse Speed and Mouse Synchronization The automatic mouse speed mode performs the speed detection during mouse synchronization. Whenever the mouse does not move correctly, you can re-synchronize the local and remote mouse in either of two ways: 1. Fast Sync Fast synchronization is used to correct a temporary (but fixed) skew. Choose this option from the Remote Console Options menu (entry: Mouse Handling). If defined, you may also press the mouse synchronization hotkey sequence (see Remote Console Control Bar on page 20). 2. Intelligent Sync If the Fast Sync does not work, or the mouse settings have been changed on the host system, use Intelligent Synchronization instead. This method adjusts the parameters for the actual movement of the mouse pointer so that the mouse pointer is displayed at the correct position on the screen. This method takes more time than Fast Sync and you can access it with the appropriate item in the Remote Console Option menu (entry: Mouse Handling). The shape of the mouse pointer has a significant influence on the pointer detection. We recommend that you use a simple, but common pointer shape. In most cases, the detection and synchronization of animated pointer shapes is likely to fail. In general, pointer shapes that change during the pointer detection process are difficult to figure out in the transferred video picture. With the usage of a standard mouse pointer shape, detection is simple and the synchronization works well. Figure 10 Remote Console Control Bar: Sync Button The Sync Mouse button on top of the Remote Console can behave differently, depending on the current state of mouse synchronization. Usually clicking this button leads to a Fast Sync, except in situations where the KVM port or the video mode changed recently. See Remote Console Control Bar on page 20. Double Mouse Mode Host Settings Limitations One of the Roamer KVM s mouse modes is Double Mouse Mode where both the remote and the local mouse pointers are visible and need to be synchronized. Host operating systems have various settings for the mouse Roamer KVM User Manual 11

28 Roamer KVM Configuration driver that may negatively impact the mouse driver s use in a Roamer KVM environment, i.e., lead to desynchronized mouse pointers. While the Roamer KVM works with accelerated mice and is able to synchronize the local mouse pointer with the remote mouse pointer, the limitations described below in Special Mouse Driver, Windows 2003 Server/XP Mouse Settings, and Active Desktop may prevent this synchronization from working properly. Note, the following limitations do not apply when using a USB-connected mouse and the Mouse Type setting MS Windows 2000 and newer. Special Mouse Driver There are mouse drivers which influence the synchronization process and lead to desynchronized mouse pointers. If this happens, make sure you do not use a special vendor-specific mouse driver on your host system. Windows 2003 Server/XP Mouse Settings Windows XP has a mouse property in Control Panel > Mouse Properties > Pointer Options named Enhance pointer precision which, if used with the Roamer KVM s Other Operating Systems setting (see Figure 9), may make it difficult to synchronize the remote and local mouse pointers. In this event, the mouse property Enhance pointer precision must be deactivated. Active Desktop If the Active Desktop feature of Microsoft Windows is enabled, do not use a plain background. Instead, use some kind of wallpaper. As an alternative, you could also disable the Active Desktop completely. See Recommended Mouse Settings on page 12 for mouse mode recommendations. If the mouse requires resynchronization, perform the following procedure: 1. Move your mouse pointer into the upper left corner of the applet screen. 2. If resynchronization fails, reduce the speed of your mouse pointer (found at Control Panel > Mouse > Pointer Options > Motion) and repeat the procedure. Single Mouse Mode The Roamer KVM also features another mode, the Single Mouse Mode, where only the remote mouse pointer is visible. To use the Single Mouse Mode, perform the following steps: 1. Activate the single mouse mode in the Remote Console (see Remote Console Control Bar on page 20). 2. Click in the window area. The local mouse pointer is hidden and the remote one can be controlled directly. 3. To leave this mode, define a mouse hotkey in the Remote Console Settings Panel. Press this key to free the captured local mouse pointer. Recommended Mouse Settings For each different operating system, use the mouse settings described in the following sections. MS Windows 2000, 2003, XP (all versions) To set the Windows recommended mouse settings, perform the following as appropriate: For a PS/2 mouse, choose Auto Mouse Speed. For an XP mouse, disable the option enhance pointer precision in the Control Panel. Sun Solaris For Sun Solaris, use one of the following methods: Adjust the mouse settings either via xset m 1". Or, use the CDE Control Panel to set the mouse to 1:1, no acceleration. 12 Roamer KVM User Manual

29 Roamer KVM Configuration Or, use the Single Mouse Mode. Mac OS X Linux We recommend using the Single Mouse Mode. To set the Linux recommended mouse settings, perform the following: Choose the option Other Operating Systems from the Mouse Type selection box. Choose the option Auto Mouse Speed. This applies for both USB and PS/2 mice. Video Modes The Roamer KVM recognizes a limited number of common video modes. When running X11 on the host system, do not use any custom modelines with special video modes. If you do, the Roamer KVM may not be able to detect them. Instead, use any of the standard VESA video modes. Roamer KVM User Manual 13

30 Roamer KVM Configuration 14 Roamer KVM User Manual

31 5 Roamer KVM Usage Prerequisites The Roamer KVM features an embedded operating system and applications offering a variety of standardized interfaces. This chapter describes all of these interfaces and how to use them in a more detailed manner. The interfaces are accessed using the TCP/IP protocol family, thus they can be accessed using the built-in Ethernet adapter. The HTTP/HTTPS, TELNET, and SSH interfaces are supported and are described in the following sections. HTTP/HTTPS Full access is provided by the embedded web server. The Roamer KVM environment can be entirely managed using a standard web browser. You can access the Roamer KVM using the insecure HTTP protocol or using the encrypted HTTPS protocol. We recommend using HTTPS whenever possible. TELNET SSH You can access most of the Roamer KVM s functionality, including a text-mode console redirection, using a standard TELNET client. You can also use a Secure Shell (SSH) client to access the Roamer KVM, including a text-mode console redirection as mentioned above. The primary interface of the Roamer KVM is the HTTP interface, as described in this chapter. Other interfaces are addressed in subtopics. Java To use the Remote Console window of your managed host system, the browser must have a Java Runtime Environment Version 1.4 or higher. See Sun Microsystems Java Browser Plug-in on page 44 for information on obtaining and installing JVM. If the browser has no Java support (such as on a small handheld device), you can still maintain your remote host system using the administration forms displayed by the browser itself. Web Browser For an insecure connection to the Roamer KVM, we recommend the following web browsers: Windows 98, Windows ME, Windows 2000 and Windows XP: Microsoft Internet Explorer version 5.0 or higher, Netscape Navigator 7.0, Mozilla 1.6, and Mozilla Firefox Linux and other Unix-like operating systems: Netscape Navigator 7.0, Mozilla 1.6, and Mozilla Firefox Mac OS X: Firefox. To access the remote host system using a securely encrypted connection, you need a browser that supports the HTTPS protocol. Strong security is only assured by using a 128-bit key length. Some older browsers do not have a strong 128-bit encryption algorithm. Roamer KVM User Manual 15

32 Roamer KVM Usage Using the Internet Explorer, open the menu entry? and Info to read about the key length that is currently activated. The dialog box contains a link that leads you to information on how to upgrade your browser to a stateof-the-art encryption scheme. Figure 11 shows the dialog box displayed by Internet Explorer 6.0. Figure 11 Internet Explorer Displaying Encryption Key Length Newer web browsers support strong encryption by default. Login and Logout to the Roamer KVM This section describes how to log into and out of the Roamer KVM. Logging into the Roamer KVM 1. Open your web browser. 2. Type in the hostname or the IP address of the Roamer KVM configured during the installation process. When entering this information, enter for an unsecured HTTP connection or https: for a secure HTTP connection. For example: a. Type the following in the address line of your browser when establishing an unsecured connection: b. Type the following for a secure connection: This will take you to the Roamer KVM login page as shown in Figure 12. Figure 12 Login screen 16 Roamer KVM User Manual

33 Roamer KVM Usage The Roamer KVM has a built-in superuser that has all the permissions to administrate your Roamer KVM. See Table 7 for the default settings. Warning: Cookie Acceptance Your web browser must be set to accept cookies. Table 7 Initial Login Settings Parameter Navigation Value Login admin Password admin or rackable 1 1. Depending on which manufacturing run your Roamer KVM was built, the default administrator password is either admin or rackable. After the successful login to the Roamer KVM, the main page of the Roamer KVM appears as shown in Figure 13. This page consists of three parts, each of which contains specific information. Figure 13 Main Page Roamer KVM User Manual 17

34 Roamer KVM Usage Table 8 The buttons on the top row allow you to navigate within the front end (Table 8). The lower left frame contains a navigation bar and allows you to switch between the different sections of the Roamer KVM. Within the right frame, task-specific information is displayed depending on the section you have previously chosen. Top Row Buttons Button Function Return to the main page of the Roamer KVM. Open the Roamer KVM Remote Console. Exit from the Roamer KVM front end. Logging out of the Roamer KVM Selecting the Logout button logs out the current user and presents a new login screen. Please note that an automatic logout is performed if there is no activity for half an hour. 18 Roamer KVM User Manual

35 The Remote Console General Description Roamer KVM Usage The Remote Console is the redirected screen, keyboard and mouse of the remote host system that the Roamer KVM controls, as shown in Figure 14. Figure 14 Remote Console The Remote Console window is a Java Applet that tries to establish its own TCP connection to the Roamer KVM. The protocol run over this connection is neither HTTP nor HTTPS, but RFB (Remote Frame Buffer Protocol). Currently RFB tries to establish a connection to port 443. Your local network environment has to allow this connection to be made, i.e., your firewall and (in case you have a private internal network) your NAT (Network Address Translation) settings have to be configured accordingly. If the Roamer KVM is connected to your local network environment, and your connection to the Internet is available using a proxy server only without NAT being configured, the Remote Console is unlikely to be able to establish the connection. This is because today s web proxies are not capable of relaying the RFB protocol. In case of problems, consult your network administrator in order to provide an appropriate network environment. Roamer KVM User Manual 19

36 Roamer KVM Usage Main Window Starting the Remote Console opens an additional window. It displays the screen content of your host system. The Remote Console behaves in the same way as if you were sitting directly in front of the screen of your remote system. This means that the keyboard and mouse can be used in the usual way. The remote system will react to keyboard and mouse actions with a slight delay. The delay depends on the bandwidth and latency of the line which you use to connect to the Roamer KVM. With respect to the keyboard, the precise remote representation might lead to some confusion as your local keyboard changes its keyboard layout according to the remote host system. If you use a German administration system and your host system uses a US English keyboard layout, for instance, special keys on the German keyboard will not work as expected. Instead, the keys will result in their US English counterpart. You can circumvent such problems by adjusting the keyboard of your remote system to the same mapping as your local one. The Remote Console window always tries to show the remote screen with its optimal size. That means it will adapt its size to the size of the remote screen initially and after the screen resolution of the remote screen changes. However, you can always resize the Remote Console window in your local window system as usual. Remote Console Control Bar The upper part of the Remote Console window contains a control bar as shown in Figure 15. Using its elements you can see the status of the Remote Console and influence the local Remote Console settings. A description for each control is shown in Table 9. Warning: Remote Console The Remote Console window on your local window system is just one window among others. In order to make the remote keyboard and mouse work, your Remote Console window must have the local input focus. Warning: Option Availability Some of these options are only visible and usable when you have selected the operating system type Other Operating Systems. Figure 15 Remote Console Control Bar 20 Roamer KVM User Manual

37 Roamer KVM Usage Table 9 Description of GUI Symbols GUI Symbol Function Ctrl+Alt+Delete Virtual Media Drive Redirection Special button key to send the Control Alt Delete key combination to the remote system (see KVM Settings on page 43. Opens the virtual media Drive Redirection menu for the Remote Console (Refer to Figure 16.) Auto Adjust Video Automatically synchronizes the video settings to look best on the local display screen. Sync Mouse Single/Double Mouse Mode Options Choose this option in order to synchronize the local with the remote mouse cursor. This is especially necessary when using accelerated mouse settings on the host system. In general, there is no need to change mouse settings there. Switches between the Single Mouse Mode (where only the remote mouse pointer is visible) and the Double Mouse Mode (where remote and local mouse pointers are visible and need to be synchronized). Single Mouse Mode is only available if using SUN JVM 1.4 or higher. To open the Options menu, click on the button Options. See Remote Console Options on page 22 for a detailed description of the available options for the Roamer KVM. Roamer KVM User Manual 21

38 Roamer KVM Usage Remote Console Options To open the Options menu, click Options in the remote console bar shown in Figure 15. The following screen displays: Figure 16 Remote Console Options Menu Monitor Only Monitor Only toggles the Monitor Only filter on or off. If the filter is switched on, no remote console interaction is possible. The remote screen can only be viewed. Screenshot to Clipboard Screenshot to Clipboard allows you to capture a screenshot: the Roamer KVM will automatically place it onto the clipboard. This allows you to easily import the screenshot into your documents or other programs. Chat Window Chat Window opens a chat window, shown in, allowing you to interactively chat with other users logged into the Roamer KVM. Figure 17 Chat Window 22 Roamer KVM User Manual

39 Scaling Roamer KVM Usage Scaling allows you to scale down the Remote Console. You can still use both mouse and keyboard, however the scaling algorithm will not preserve all display details. Refer to Figure 18 to see scaling options. Figure 18 Remote Console Options Menu: Scaling Local Cursor Local Cursor offers a list of different cursor shapes to choose from for the local mouse pointer. The selected shape is saved for the current user and activated the next time this user opens the Remote Console. The number of available shapes depends on the Java Virtual Machine used; where a version of 1.4 or higher supports the full list of shapes. Figure 19 Remote Console Options Menu: Cursor Roamer KVM User Manual 23

40 Roamer KVM Usage Video Settings Video Settings allows you to adjust color settings, and vertical and horizontal offsets of the monitor. See Figure 20 and Figure 21. Figure 20 Remote Console Options Menu: Video Settings Figure 21 Video Settings dialog 24 Roamer KVM User Manual

41 Refresh Video Roamer KVM Usage Refresh Video causes the Roamer KVM to resync what it is displaying in the applet with what is really on the screen. In some instances, the window may not repaint properly. Selecting Refresh Video will clean things up, as shown in Figure 22. Figure 22 Remote Console Options Menu: Refresh Video Roamer KVM User Manual 25

42 Roamer KVM Usage Soft Keyboard Soft Keyboard simulates an entire keyboard that is connected to the remote system. Refer to Figure 23. Figure 23 Soft Keyboard Mapping Submenus of the Soft Keyboard choice are: Show - Displays the Soft Keyboard. Refer to Figure 23. Mapping - Used for choosing the according language and country mapping of the Soft Keyboard. Refer to Figure 23. Features of the Soft Keyboard are necessary if your remote system runs with a completely different language and country mapping to your administration machine. By selecting the appropriate button(s) you can send key codes and also key sequences to the remote system and act as if you would work with a keyboard directly connected to the remote system. To open the Soft Keyboard, select the entry Soft Keyboard from the Options menu, as shown in Figure 23. You can send single key strokes such as F as well as combinations of keys such as Ctrl+C or Alt+Shift+F4. For a single key stroke, you can click the button with the desired character. Single keys such as regular characters and numbers are sent immediately. Special keys like Ctrl, Shift as well as the function keys F1 to F12 must be selected twice. The first press sends the signal key is pressed, and the second press indicated the signal key is released to the remote system. After the first press, the button changes color to signal that the according key is currently pressed. After the second press, the button appears as usual and signals that the key was sent. To send the key combination Ctrl+C, select the button Ctrl first. The button changes color. Then press the C key. The following key (C in our example) is combined with the previously selected key. Both the buttons Ctrl and C 26 Roamer KVM User Manual

43 Roamer KVM Usage are released and the key combination is sent to the remote system. The button Ctrl appears normal (color change). Figure 24 Soft Keyboard To send the key combination Ctrl+F5 requires three steps: 1. Press Ctrl once. 2. Press F5 twice. 3. The last press releases both buttons and sends the key combination to the remote system. To send the key combination Alt+Shift+F4 requires three steps: 1. Press Alt once. 2. Press Shift. 3. Press F4 twice. 4. The last press releases all the buttons and sends the key combination to the remote system. Local Keyboard Local Keyboard is used to change the language mapping of your browser machine running the Remote Console Applet. Normally, the applet determines the correct value automatically. However, depending on your particular JVM and your browser settings this is not always possible. A typical example is a German localized system that uses a US-English keyboard mapping. In this case you have to change the Local Keyboard setting to the right language manually. Hotkeys Hotkeys opens a list of hotkeys defined before. In order to send a registered command to the host system choose the according entry. A confirmation dialog can be added that is displayed before sending the selected command to the remote host. Choose OK to perform the command on the remote host. For a detailed description see Remote Console Button Keys on page 45. Figure 25 Remote Console Confirmation Dialog Roamer KVM User Manual 27

44 Roamer KVM Usage Encoding Encoding is used to adjust the encoding level in terms of compression and color depth. They are only available unless Transmission Encoding is determined automatically (see Transmission Encoding on page 43). Compression Level: you may select a value between 1 and 9 for the desired compression level with level 1 enabling the fastest compression and level 9 the best compression. The most suitable compression level should always be seen as a compromise between the network bandwidth that is available, on your video picture to be transferred, and on the number of changes between two single video pictures. We recommend that you use a higher compression level if the network bandwidth is low. The higher the compression level the more time is necessary to both pack or unpack the video data on either side of the connection. The compression quality depends on the video picture itself, e.g., the number of the colors or the diversity of pixels. The lower the compression quality, the more data have to be sent and the longer it may take to transfer the whole video picture. If level 0 is chosen, the video compression is completely disabled. The Video Optimized option is useful if transferring high-quality motion pictures. In this case, the video compression is disabled, completely and all video data is transferred through the network as full-quality video snippets. Therefore, a high amount of bandwidth is required to ensure the quality of the video picture. Figure 26 Remote Console Options: Encoding compression The next two options allow you to set the compression level to a predefined level (Figure 27) or to set a level for loss compression (Figure 28). This compresses well, but leads to a degradation in image quality. 28 Roamer KVM User Manual

45 Roamer KVM Usage Figure 27 Remote Console Options: Predefined Encoding Compression Figure 28 Remote Console Options: Lossy Compression Roamer KVM User Manual 29

46 Roamer KVM Usage Color Depth: Sets the desired color depth. You may select between 8 or 16 bits for Video Optimized/compression level 0, or between 1 and 8 bits for compression level 1 to 9. The higher the color depth, the more video information that has to be captured and transferred. Figure 29 Remote Console Options: Color Depth Note: Video Handling If displaying motion pictures on a connection with low speed you may achieve an improvement regarding the video transfer rate by lowering the color depth and disabling the option Video Optimized. As a general result, the data rate is reduced (less bits per color). Furthermore, the Roamer KVM will not have to do any video compression. In total, this will lead to less transfer time of the motion picture. 30 Roamer KVM User Manual

47 Remote Console Status Line Roamer KVM Usage The status line shows both the console and the connection. Figure 30 was taken from a Remote Console with a resolution of 800x600 pixels. The value in brackets describes the connection to the Remote Console. Norm means a standard connection without encryption, SSL indicates a secure connection using Secure Socket Layer (SSL). Figure 30 Status line The status line displays the number of frame buffer updates per second ( Fps ) as well as the incoming ( In: ) and the outgoing ( Out: ) network traffic in KB per second. A low value of the network traffic is recommended and can be achieved as described in Optimizing the Video Picture on page 31. If compressed encoding is enabled, a value in brackets displays the compressed transfer rate. For more information about Monitor Only and Exclusive Access settings see Remote Console Control Bar on page 20. Optimizing the Video Picture Figure 31 Status line transfer rate The Roamer KVM detects the video mode with 8 bits (256 colors) automatically. To improve the picture quality you may select 16-bit (True Color) from the Options Menu of the Remote Console, sub menu Encoding, entry Color Depth (see Transmission Encoding on page 43. Currently, the video picture with the best quality can be achieved with the settings 16-bit (High Color) in the Remote Console or LAN (High Color) in the web front end. This option can also be preset in the Section called User Console on page 43. The sub menu Compression from the Options menu has no influence on the picture quality, but on the data rate of the picture that is transferred to the Remote Console. Using the Roamer KVM with Low Bandwidth The network connection of the Roamer KVM has an important influence on the time between two single video pictures. On a connection with low bandwidth it takes longer to transfer the video data from the Roamer KVM to the Remote Console on the local host. If the remote screen has changed, a new picture is sent. In terms of transfer time, there is no difference between text screens and screens in graphics mode. The video picture is taken as graphics data no matter what the screen looks like and which video mode is chosen. In terms of transferred data, there can be an improvement. The compression plays an important role here. You can choose a compression level from the sub menu Compression in the Options menu of the Remote Console. Please note that the video is compressed on the Roamer KVM, transferred to the Remote Console, and unpacked in a Java environment. Depending on the Roamer KVM and on the local machine, this procedure may take some time and may result in an slowly updated picture in the Remote Console. To improve the speed, you may also set the picture quality in the Remote Console to either 8 bit or even to grayscale. Due to less video data to be processed, this is likely to be more effective than the highest compression level. Roamer KVM User Manual 31

48 Roamer KVM Usage 32 Roamer KVM User Manual

49 6 Web Interface Remote Control The remote console is used to control many system options. Roamer KVM Console Remote Console Preview Figure 32 Roamer KVM Remote Console To open the KVM console, either click the Remote Console menu entry on the left side of the screen or click the console picture on the right. To refresh the screen, click Refresh. Roamer KVM User Manual 33

50 Web Interface Virtual Media Floppy Disk Figure 33 Virtual Floppy Area Upload a Floppy Image You can upload a floppy image with the following two steps: 1. Specify the path of the images. You can specify up to two images. Do this by typing the image name or by using the file selection dialog of your web browser. To open the file selection dialog, click Browse and select the desired image file. Figure 34 Select Image File The maximum image size is limited to 1.44MB. To use a larger image, mount this image through a Windows share (or SAMBA). See CD-ROM Image on page Roamer KVM User Manual

51 Web Interface 2. Click Upload to initiate the transfer of the chosen image file into the Roamer KVM s on-board memory. This image file is kept in the on-board memory of the Roamer KVM until the end of the current session, until you log out, or until you initiate a reboot of the Roamer KVM. Appendix I describes how to create both floppy and CD-ROM/ISO 9660 images. CD-ROM Image This option is used to share a CD-ROM or DVD ISO image over a Windows or Unix share using Samba. To include an image from a network share, select Virtual Media > CD-ROM Image. See Figure 35 below. Appendix J describes how to set up network shares for both Windows and Unix systems. Figure 35 CD-ROM Selection Roamer KVM User Manual 35

52 Web Interface Drive Redirection Drive Redirection is another way to use a virtual disk drive on the remote computer. With Drive Redirection you do not have to use an image file, but instead may work with a drive from your local computer on the remote machine. The drive is then shared over a TCP network connection. Devices such as floppy drives, hard disks, CD-ROMs, and other removable devices like USB sticks can be redirected. It is even possible to enable write support so that the remote system can write to your local disk. Figure 36 Drive Redirection Note that Drive Redirection works on a level which is far below the operating system. This means that neither the local nor the remote operating system is aware that the drive is currently redirected. This can lead to inconsistent data as soon as one of the operating systems (either from the local machine, or from the remote host) is writing data on the device. If write support is enabled, the remote computer may damage the data and the file system on the redirected device. On the other hand, if the local operating system writes data to the redirected device, the drive cache of the operating system of the remote host might contain older data. This may confuse the remote host s operating system. Redirecting a local drive requires an application to be running on the client system. This drive redirection software is integrated in the Java Remote Console applet and is currently available for Windows only. Users of other operating systems currently are limited to uploading floppy images or selecting CD-ROM images located on a Windows share. Both of these functions can be activated in the web front-end and are entirely independent of the client operating system. Appendix K describes how to configure redirected drives. System Health Warning: Drive Redirection Use Drive Redirection with care, especially when using write support. The IPMI support on the Roamer KVM allows you to power cycle the remote host system or to perform a hard reset. Additionally, you can see the remote event log and interrogate the state of some system sensors including temperature. 36 Roamer KVM User Manual

53 Web Interface Chassis Control The Chassis Control screen is shown in Figure 37. Figure 37 Chassis Control Using Chassis Control you can: Obtain information about the selected chassis Switch the remote power on and off (power cycle) Locate the remote host chassis Perform a Soft Shutdown and Reset Roamer KVM User Manual 37

54 Web Interface Monitor Sensors On the Monitoring Sensors screen (Figure 38) you can see remote hosts sensors and their values or state. Figure 38 Monitoring Remote Sensors Screen System Event Log You can browse the System Event Logs here. Note, these logs are for IPMI events. These are different from the Roamer KVM s own system logs. Figure 39 System Event Log Screen 1 38 Roamer KVM User Manual

55 LCD Carousel Web Interface Using the Chassis Control screen, as seen in Figure 40, you can input a list of standardized LCD names. Figure 40 LCD Carousel The LCD Carousel is a queue of ten sets of 2x20 character messages to be displayed on the LCD panel of the Roamer KVM. The Roamer KVM can either display a fixed message at all times or rotate between the ten messages. The pause between messages is configurable by the user. Roamer KVM User Manual 39

56 Web Interface User Management Change Password To change your password 1. Enter the old password in the top entry field. 2. Enter the new password in the middle entry field. 3. Retype the password in the lower entry field. 4. Click Apply to submit your changes. Figure 41 Change password 40 Roamer KVM User Manual

57 Web Interface Users And Groups The User Management screen shown in Figure 42 allows you to manage passwords and users Figure 42 Set User User Management The Roamer KVM comes with a pre-configured user account admin that has a fixed set of permissions. This user has all possible rights needed to configure the device and to access all of the functions of the Roamer KVM. The Roamer KVM will require you to change the password for "admin" when you first login. Table 10 Initial Login Settings Parameter Value Login admin Password admin or rackable 1 1. Depending on which manufacturing run your Roamer KVM was built, the default administrator password is either admin or rackable. Rackable Features The Roamer KVM has three pre-defined user groups: ADMIN - User group for the administrative users. NONE - For users that are authenticated externally (via LDAP or RADIUS) but have no group assigned to them. UNKNOWN - For users that are authenticated externally (via LDAP or RADIUS) but have a group assigned to them that is unknown to the Roamer KVM. Roamer KVM User Manual 41

58 Web Interface The Roamer KVM also maps some user groups specified in the manual slightly differently. For example, the groups for port permissions: none - maps to none. read only - maps to view. read write - maps to control. List of Available Options A full list of available options follows. This list can only be seen by the users in the ADMIN group. Existing users - Select an existing user for modification. Once a user is selected, click the Lookup button to see the user information. New username - The new username for the selected account. Password - The password for the login name. It must be at least four characters long. Confirm password - Confirmation of the password above. address - This is optional. Mobile number - This information may be optionally provided. Role - Each user can be a member of a group (named a role) - either an administrator, or a regular user. Choose the desired role from the selection box. To create a user, press the Create button. The Modify button changes the displayed user settings. To delete a user, click Delete. Permissions Note: Deleting Groups Even if you are a user in the ADMIN group you cannot delete any of the pre-defined groups. You may create and delete other groups as you wish. The Permissions page shown in Figure 43 allows you to set the permissions for each user or group. Figure 43 Set Permissions 42 Roamer KVM User Manual

59 Web Interface Select the item (user and/or group) from the drop-down menu. All changes you make affect the permission set of the selected entity. The user can only access and use the selected function if the permissions field is set to yes. Most entries are fairly self-explanatory. The fields labeled RC Settings pertain to the settings of the Remote Console. A kind of special case is the field IPMI may use SOL payload. This field becomes set if the user/group is allowed to use administrative sessions over the serial line. KVM Settings User Console The following User Console settings shown in Figure 44 are user-specific. Each user can change settings for himself/herself. User admin can customize these settings for every user. Changing the settings for one user does not affect the settings of other users. Figure 44 User Console Settings (Part 1) Remote Console Settings for Users This selection box displays the user ID for which the values are shown and for which the changes will take effect. 1. Select the desired user from the selection box and click Update. 2. This results in displaying the according user settings below. Transmission Encoding The Transmission Encoding setting allows changing the image-encoding algorithm that is used to transmit the video data to the Remote Console window. It is possible to optimize the speed of the remote screen depending on the number of users working at the same time and the bandwidth of the connection line (Modem, ISDN, DSL, LAN, etc.). Automatic detection Note: Access Rights You are allowed to change the settings of other users only if you have the necessary access rights for this task. For a regular user without the correct permissions it is not possible to change the settings for any other user. The encoding and the compression level is determined automatically from the available bandwidth and the current content of the video image. Roamer KVM User Manual 43

60 Web Interface Pre-configured The pre-configured settings deliver the best result because of optimized adjustment of compression and color depth for the indicated network speed. Manually This allows you to adjust both compression rate and the color depth individually. Depending on the selected compression rate, the data stream between the Roamer KVM and the Remote Console is compressed in order to save bandwidth. Since high compression rates are very time consuming, they should not be used while several users are accessing the Roamer KVM simultaneously. The standard color depth is 16 bits (65536 colors). The other color depths are intended for slower network connections in order to allow a faster transmission of data. Therefore compression level 0 (no compression) uses only 16-bit color depth. At lower bandwidths only 4 bits (16 colors) and 2 bits (4 gray scales) are recommended for typical desktop interfaces. Photo-like pictures have best results with 4 bits (16 gray scales). You should use 1-bit color depth (black/white) only for extremely slow network connections. Remote Console Type Specifies which Remote Console Viewer to use. Refer to Figure 45. Java Virtual Machine (JVM) This is the Sun JVM for Internet Explorer. Sun Microsystems Java Browser Plug-in Figure 45 User Console Settings (Part 2) This plugin instructs the web browser of your administration system to use the Sun Microsystems JVM. The JVM in the browser is used to run the code for the Remote Console window which is actually a Java Applet. If you check this box for the first time on your administration system, and the appropriate Java plug-in is not yet installed, it may be downloaded and installed automatically. However, in order to complete the installation, you have to answer Yes to the installation dialogs. The download size is approximately 11 Mbytes. The advantage of 44 Roamer KVM User Manual

61 Web Interface downloading Sun s JVM is the usage of a stable and identical JVM across different platforms. The Remote Console software is optimized for this JVM version and offers a wider range of functionality when run in SUN s JVM. Roamer KVM requires JVM (JRE) v1.4 or higher. Download Sun s Java Runtime Environment (JRE), which contains the JVM, at Miscellaneous Remote Console Settings Start in Monitor Mode Refer to Figure 45. This sets the initial value for the monitor mode. By default the monitor mode is disabled. If you switch it on, the Remote Console window is started in read-only mode. Start in Exclusive Access Mode Enables the exclusive access mode immediately at Remote Console startup. This forces the Remote Consoles of all other users to close. No one else can open the Remote Console at the same time until you disable this feature or log off. Mouse Hotkey Allows you to specify a hotkey combination which starts either the mouse synchronization process, if pressed in the Remote Console or is used to leave the single mouse mode. This function is only available if you have selected the Mouse Mode Other Operating System. Remote Console Button Keys Refer to Figure 45. Button Keys allow simulating keystrokes on the remote system that cannot be generated locally. The reason for this might be a missing key or just the fact that the local operating system of the Remote Console is unconditionally catching this keystroke already. Typical examples are Ctrl+Alt+Delete on Windows and DOS, that is always caught, or the key sequence Ctrl+Backspace on Linux that can be used for terminating the X-Server. In order to define a new Button Key or to adjust an existing one have a look at the rules that describe the setting for a key. In general, the syntax for a key is as follows: [confirm] <keycode>[+ - >[*]<keycode>]* A term in brackets is optional. The star at the end means that you add further keys as often as required for your case. The term confirm adds an confirmation dialogue that is displayed before the key strokes are sent to the remote host. The keycode is the key to be sent. Multiple key codes can be concatenated with either a plus, a minus, or an > sign. The plus sign builds key combinations - all the keys are pressed until a minus sign or the end of the combination is encountered. In this case all pressed keys are released in the reverse order. So, the minus sign builds single, separate key presses and key releases. The > sign only releases the last key. The star inserts a pause with a duration of 100 milliseconds. For example, the key combination of Ctrl, Alt and F2 is represented by the sequence Ctrl+Alt+F2 For a full list of key codes and aliases, refer to Appendix G. Note: Additional Keys If you need more button keys than shown use the button More entries. This will open a list of additional entry fields. Roamer KVM User Manual 45

62 Web Interface Keyboard/Mouse This screen, shown in Figure 46 allows you to manage keyboard and mouse settings. Figure 46 Keyboard and Mouse Settings Key Release Timeout This is a useful option if you are accessing the Roamer KVM over a slow or congested network. In such a situation, you transmit a network packet containing the key PRESS to the Roamer KVM. When you release the key, then the Roamer KVM will receive a corresponding RELEASE packet. When the network is slow, it takes too long for the RELEASE packet to arrive. This might mislead the Roamer KVM to replicate the key press. This is equivalent to holding down a key. The Key Release Timeout (in milliseconds) tells the Roamer KVM to consider the key released, even if no RELEASE packet has arrived. This avoids keys being repeated in an undesired fashion. USB Mouse Type Enables the USB mouse type. Choose an appropriate option from the selection box shown in Figure 46. Choose between MS Windows 2000 or newer for MS Windows 2000, 2003 Server, XP, or Other Operating Systems such as MS Windows NT, Linux, or OS X. In MS Windows 2000 or newer mode, the remote mouse is always synchronized with the local mouse. For a detailed description about the mouse type and recommended options for the different operating systems, see Recommended Mouse Settings on page 12. Mouse Speed Auto mouse speed - Use this option if the mouse settings on the host use an additional acceleration setting. The Roamer KVM tries to detect the acceleration and speed of the mouse during the mouse sync process. Fixed mouse speed - Use a direct translation of mouse movements between the local and the remote pointer. You may also set a fixed scaling which determines the amount the remote mouse pointer is moved when the local mouse pointer is moved by one pixel. This option only works when the mouse settings on the host are linear. This means that there is no mouse acceleration involved. To set the options, click Apply. 46 Roamer KVM User Manual

63 Device Settings Network Web Interface The Network Settings panel shown in Figure 47 allows you to change network related parameters. Each parameter is explained below. Once applied, the new network settings come into effect immediately. Figure 47 Network Settings Network Basic Settings IP auto configuration With this option you can define if the Roamer KVM should fetch its network settings from a DHCP or BOOTP server. For DHCP select DHCP and for BOOTP select BOOTP accordingly. If you choose NONE then IP auto configuration is disabled. Warning: IP Configuration The initial IP configuration is usually done directly at the host system using the procedure described in Initial Configuration using a DHCP Server on page 9. Roamer KVM User Manual 47

64 Web Interface Preferred host name Preferred host name to request from DHCP server. Whether the DHCP server takes the Roamer KVM s suggestion into account or not depends on the server configuration. IP address IP address in the usual dot notation. Subnet Mask The subnet mask of the local network. Gateway IP address In case the Roamer KVM should be accessible from networks other than the local one, this IP address must be set to the local network router s IP address. Primary DNS Server IP Address IP address of the primary Domain Name Server in dot notation. This option may be left empty, as the Roamer KVM is not be able to perform name resolution. Secondary DNS Server IP Address IP address of the secondary Domain Name Server in dot notation form. The Secondary DNS Server is used in the event that the Primary DNS Server cannot be contacted. Network Miscellaneous Settings Table 11 lists the ports used by Roamer KVM. Warning: Network Settings Changing the network settings of the Roamer KVM might result in losing connection to it. In case you change the settings remotely make sure that all the values are correct and you still have an option to access the Roamer KVM. Table 11 Ports for Internet Services Service TCP UDP Notes SSH Secure Shell TELNET Allows remote logins to other machines. HTTP HyperText Transfer Protocol, e.g., for web browsing. NTP Network Time Protocol SNMP The system used on the Internet to manage all the equipment that makes up the Internet. LDAP Lightweight Directory Access Protocol serves as an Internet phone book. SSL The default port for HTTPS/SSL HTTPS HTTP protocol over TLS/SSL LDAPs Secure LDAP (LDAP protocol over TLS/SSL) Remote Console and HTTPS port Port number at which the Roamer KVM s Remote Console server and HTTPS server are listening. If left empty, the default value (port 443) is used. HTTP port Port number at which the Roamer KVM s HTTP server is listening. If left empty, the default value (port 80) is used. 48 Roamer KVM User Manual

65 TELNET port Web Interface Port number at which the Roamer KVM s TELNET server is listening. If left empty, the default value (port 23) is used. SSH port Port number at which the Roamer KVM s SSH (Secure SHell) server is listening. If left empty, the default value (port 22) is used. Bandwidth Limit The maximum network traffic generated through the Roamer KVM Ethernet device. Value in Kbit/s. Enable TELNET This enables the TELNET client mode. Enable SSH This enables the SSH (Secure SHell) client mode. Disable Setup Protocol Enable this option to exclude the Roamer KVM from the setup protocol. LAN Interface Settings This entry field displays the current settings for the Ethernet/LAN interface of the Roamer KVM. You may choose between auto negotiation and a fixed setting for the Ethernet transceiver settings interface speed and duplex mode in case auto negotiation does not work correctly. LAN interface speed Depending on your network connection, you may select the appropriate speed value for this interface. To adjust the interface automatically, choose autodetect (default value). If this selection results in misbehavior of the interface, choose one of other speed options to work with. The interface will transmit and receive data with that fixed speed. LAN interface duplex mode If necessary, you may also select a specific duplex mode. The default value is set to autodetect which leads to an automatic setting of the duplex mode depending on your network (recommended). As an alternative, you may explicitly set the interface to either half duplex or full duplex mode. Roamer KVM User Manual 49

66 Web Interface Serial The Serial Port Settings, shown in Figure 48, allow you to change parameters relating to the serial port. Each parameter is explained below. Once applied, the new settings take effect immediately. Figure 48 Serial IPMI Serial Over LAN (SOL) The IPMI protocol as implemented by the Roamer KVM supports Serial Over LAN (SOL) as an extension. When this selection is enabled, the serial port can only be accessed via an IPMI session. Configuration login The configuration login is used by Rackable Support to reconfigure the Roamer KVM. This setting is only to be used when requested by Rackable Support. Passthrough access When this selection is enabled, the serial port can be accessed via either a TELNET session or an SSH session using the terminal CLI command (see Terminal on page 75). 50 Roamer KVM User Manual

67 Web Interface Serial Port Settings This section of the window allows for modification to the serial port configuration. The default settings have been chosen to work with the vast majority of servers and should not be changed without consulting Rackable Support for the correct configuration. Security The security page allows you to manage system security, as shown in Figure 49. Figure 49 Device Security Roamer KVM User Manual 51

68 Web Interface HTTP Encryption Force HTTPS If this option is enabled, access to the web front-end is only possible using a HTTPS connection. The Roamer KVM will not listen on the HTTP port for incoming connections. If you want to create your own SSL certificate that is used to identify the Roamer KVM, refer to Certificate on page 53. KVM Encryption This option controls the encryption of the RFB protocol. RFB is used by the Remote Console to transmit both the screen data to the administrator machine and keyboard and mouse data back to the host. If set to Off, no encryption is used. If set to Try, the applet tries to make an encrypted connection. In case the connection cannot be established, an unencrypted connection is used instead. If set to Force, the applet tries to make an encrypted connection. An error is reported in the event the connection establishment fails. IP Access Control This allows you to set an IP address policy in order to specify which networks are allowed to access the Roamer KVM. Be sure to click Apply to save and enable your changes. Group Based System Access Control This is similar to the option above, except that you can specify a group of IP addresses and not a network with a network mask. User Blocking When someone attempts to login to the Roamer KVM and fails, you can specify how many failed login attempts the Roamer KVM should tolerate before waiting for the specified number of Block Time minutes before it allows further logins. This is useful for blocking automated hacking and cracking attempts. Login Limitations You can specify that only a single user is allowed to login to the Roamer KVM at a time. Note, if you do so, this greatly reduces the usefulness of, for example, the chat window, because you can then only talk to yourself. Also, if another administrator is logged in from a different location, then you are blocked from accessing the Roamer KVM. Password aging is the time interval at which users are required to change the password. Some systems refer to this as Password Expiry. 52 Roamer KVM User Manual

69 Web Interface Certificate Figure 50 Certificate Settings The Roamer KVM uses the Secure Socket Layer (SSL) protocol for any encrypted network traffic between itself and a connected client. During connection establishment, the Roamer KVM has to expose its identity to a client using a cryptographic certificate. Upon delivery, this certificate and the underlying secret key is the same for all Roamer KVMs ever produced and certainly won t match the network configuration that was applied to the Roamer KVM cards by its user. The certificate s underlying secret key is also used for securing the SSL handshake. Hence, this is a security risk (but far better than no encryption at all). However, it is possible to generate and install a new Base64 x.509 certificate that is unique for a particular Roamer KVM. In order to do that, the Roamer KVM is able to generate a new cryptographic key and the associated Certificate Signing Request (CSR) that needs to be certified by a certification authority (CA). A certification authority verifies that you are the person who you claim you are and signs and issues a SSL certificate to you. To create and install a SSL certificate for the Roamer KVM the following steps are necessary: 1. Create a SSL Certificate Signing Request using the panel shown in Figure 50. You need to fill out a number of fields that are explained below. 2. Click on the button Create which will initiate the Certificate Signing Request generation. The CSR can be downloaded to your administration machine with the Download CSR button (see Figure 51). 3. Send the saved CSR to a CA for certification. You will get the new certificate from the CA after a more or less complicated traditional authentication process (depending on the CA). 4. Upload the certificate to the Roamer KVM using the Upload button as shown in Figure Roamer KVM User Manual 53

70 Web Interface Figure 51 SSL Certificate Upload After completing these three steps the Roamer KVM has its own certificate that is used for identifying the module to its clients. Common name This is the network name of the Roamer KVM once it is installed in the user s network (usually the fully qualified domain name). It is identical to the name that is used to access the Roamer KVM with a web browser but without the prefix In case the name given here and the actual network name differ, the browser displays a security warning when the Roamer KVM is accessed using HTTPS. Organizational unit This field is used for specifying to which department within an organization the Roamer KVM belongs. Organization The name of the organization to which the Roamer KVM belongs. Locality/City The city where the organization is located. State/Province The state or province where the organization is located. Country (ISO code) The country where the organization is located. This is the two-letter ISO code, e.g., DE for Germany or US for the United States. 54 Roamer KVM User Manual

71 Web Interface The address of a contact person that is responsible for the Roamer KVM and its security. Challenge Password Some certification authorities require a challenge password to authorize later changes on the certificate (e.g., revocation of the certificate). The minimal length of this password is four characters. Confirm Challenge Password Confirmation of the Challenge Password. Key length This is the length of the generated key in bits. In most cases, 1024 bits are sufficient. Longer keys may result in a slower response time of the Roamer KVM during connection establishment. Date And Time This is the page where you can configure the internal real-time clock of the Roamer KVM (see Figure 52). Figure 52 Date and Time Roamer KVM User Manual 55

72 Web Interface You can adjust the clock manually or use an NTP time server. Without a time server, your time setting will not be persistent, so you have to adjust it again after the Roamer KVM loses power for more than a few minutes. To avoid this, you can use a NTP time server which sets up the internal clock automatically to the current UTC time. Because NTP server time is always UTC, there is a setting that allows you to set up a static offset to get your local time. Authentication Warning: UTC Offset There is currently no way to adjust the daylight saving time automatically. So you have to set up the UTC offset twice a year properly to the local rules of your country. You can specify where the Roamer KVM will look in order to authenticate the users. You can either use Local Authentication, this means you need to have created the user account on the Roamer KVM and the user/group information residing on the Roamer KVM is used for authentication. The other options allow you to specify an LDAP or a RADIUS Server to use for the login authentication. These methods are very useful when you want to map users into specific groups which have certain privileges. It is typically easier and simpler to refer to already existing groups, rather than having to re-enter everything into the Roamer KVM. Note: Superuser Access Whatever you configure, you can always login over the network as the user admin. The admin user is always authenticated and authorized locally, so you always have a back door into the Roamer KVM. 56 Roamer KVM User Manual

73 Event Log Web Interface Important events like a login failure or a firmware update are logged to a selection of logging destinations (see Figure 53). Figure 53 Event Log Each of those events belong to an event group which can be activated separately. For a detailed specification of the existing event groups and the log events belonging to them, use the help link in the HTML front-end. The common way to log events is to use the internal log list of the Roamer KVM. To show the log, list click Event Log from the Maintenance section. In Event Log Settings you can choose how many log entries are shown on each page. You can also clear the log file here. Roamer KVM User Manual 57

74 Web Interface Event Log Targets List Logging Enabled You may use the Roamer KVM internal log module to log events. To show the log list, click Event Log on the Maintenance page. Since the Roamer KVM s system memory is used to save all the information, the maximum number of possible log list entries is restricted to 1,000 events. Every entry that exceeds this limit overrides the oldest one automatically NFS Logging Enabled Define a NFS server where a directory or a static link has to be exported to, in order to write all logging data to a file that is located there. To write logging data from more than one Roamer KVM devices to only one NFS share, you have to define a file name that is unique for each device. When you change the NFS settings and click Apply, the NFS share is mounted immediately. That means the NFS share and the NFS server must be filled with valid sources or you will get an error message. SMTP Logging Enabled With this option the Roamer KVM is able to send s to an address given by the address text field in the Event Log Settings. These s contain the same description strings as the internal log file and the mail subject contains the event group of the occurred log event. In order to use this log destination, you have to specify a SMTP server that must be reachable from the Roamer KVM device and that needs no authentication (<serverip>:<port>). SNMP Logging Enabled If this is activated, the Roamer KVM sends an SNMP trap to a specified destination IP address every time a log event occurs. If the receiver requires a community string, you can set it in the appropriate text field. Most of the event traps only contain one descriptive string with all information about the log event. Only authentication and host power events have their own trap class containing detailed information about the occurred event. Event Log Assignments Warning: Reset Button If the reset button on the HTML front-end is used to restart the Roamer KVM, all logging information is saved permanently and is available after the Roamer KVM is started. If the Roamer KVM loses power or a hard reset is performed, all logging data is lost. To avoid this use one of the log methods described below. Warning: NFS Log File Size In contrast to the internal log file on the Roamer KVM, the size of the NFS log file is not limited. Every log event is appended to the end of the file so it grows continuously and you may have to delete it or move it away from time to time. Choose which actions of the Roamer KVM you want to save in the log file. Check the desired boxes and click Apply to confirm your selection. 58 Roamer KVM User Manual

75 Web Interface SNMP Settings The SNMP screen is shown in Figure 54. SNMP Overview Figure 54 SNMP settings SNMP is used over the network to monitor and manage the Roamer KVM. The SNMP agent running on the Roamer KVM exposes management data on the module as variables (such as serial number, firmware version, MAC address/ip address/netmask/ gateway of LAN interface). The managing system can retrieve the information using SNMP commands such as GET, GETNEXT, and GETBULK. Roamer KVM only supports SNMP v1. The management system can also send configuration updates or control requests through the SET protocol operation to actively manage the Roamer KVM.Actions that can be initiated via SNMP include: Reset server Power on/off server Reset the Roamer KVM In addition, SNMP provides a means of informing the management system about the results of management requests. For example, events reported by the Roamer KVM via SNMP to the management system include: Login trial at the Roamer KVM failed Login trial at the Roamer KVM succeeded Denying access to a particular action Server was reset Server was powered on/off. The Roamer KVM s management data is described in its SNMP MIB (management information bases). Refer to the SNMP MIB shown in Appendix H for more complete descriptions of SNMP s capabilities. Roamer KVM User Manual 59

76 Web Interface Configuring SNMP The SNMP settings fields are shown in Figure 54 and described below. You use these setting to change SNMP-related parameters. Also, the SNMP Settings screen provides a control (pointed to by an arrow in Figure 54) that you can use to view the SNMP MIB. Enable SNMP Agent If this option is checked, the Roamer KVM will reply to SNMP requests. Read Community This is the SNMP community, which allows you to retrieve information through SNMP. Write Community This community allows you to set options and to reset the Roamer KVM or the host via SNMP, for example, all that affects the host or the Roamer KVM. System Location Note: Write Community If a community is left blank, you cannot perform the according request. For example, if you want to disable the possibility to reset the Roamer KVM through SNMP, then do not set a write community. Enter a description of the physical location of the host. The description is used in reply to the SNMP request syslocation.0. System Contact Enter a contact person for the host. The value is used in reply to the SNMP request syscontact Roamer KVM User Manual

77 Web Interface Scratchpad The Scratchpad screen is shown in Figure 55. Figure 55 Scratchpad The Scratchpad displays your system information including network settings and LCD text strings. In addition, the Scratchpad can be used to document user-specified information in the form of keys and their related values. Key names and their values are limited to no more than 32 characters in length. Roamer KVM User Manual 61

78 Web Interface Maintenance Device Information This section contains a summary of this Roamer KVM and its current firmware, and allows you to reset the card. Refer to Figure 56. Figure 56 Device Information The data file for support allows you to download the Roamer KVM data file with specific support information. This is an XML file with certain customized support information such as the serial number. Send us this information by , together with a support request. This information helps us locate and solve your reported problem. Figure 57 displays the Roamer KVM activity. Figure 57 Connected Users From left to right, Figure 57 displays the connected user(s), its IP address (from which host the user comes from) and its activity status. The display item RC indicates that the Web Interface is open. If the Web Interface is opened in exclusive mode, the term exclusive is added. For more information about this option, see Remote Console Control Bar on page 20. The last column displays user activity. It contains either active for an active user, or the according idle time for an inactive user. 62 Roamer KVM User Manual

79 Web Interface Event Log Figure 58 displays the Event Log list. Figure 58 Event Log List The event log list includes the events kept by the Roamer KVM extended by the event date, a short event description, and an IP address from which the request originated. Use the text buttons Prev and Next to browse within the data. The Prev button displays the previous page with newer log information; the Next button switches to the following page with older log information. Roamer KVM User Manual 63

80 Web Interface Update Firmware You can update the firmware of the Roamer KVM remotely to install new functionality or special features, as shown in Figure 59. Figure 59 Update Firmware A new firmware update is a binary file which is sent to you by , or you can download it from the Rackable web site. If the firmware file is a compressed file with suffix.zip, you have to unzip it before you can proceed. To extract the archive, you may use WinZip from (for Windows OS) or a tool named unzip or gzip that may already be provided in your OS (UNIX, Linux, OS X). Before you can start updating the firmware of your Roamer KVM, the new and uncompressed firmware file must accessible on the system that you use for connecting to the Roamer KVM. Updating the firmware 1. First, the new firmware file is uploaded onto the Roamer KVM. a. Select the file on your local system using the button Browse of the Upload Firmware panel (see Figure 59). b. Click Upload to transfer the previously selected file from your local file system onto the Roamer KVM. c. Once the firmware file is uploaded, it is checked to be sure it is a valid firmware file and whether there were any transmission errors. In case of an error, the Upload Firmware function is aborted and the current firmware is kept as is. Warning: Firmware Updates This process is not reversible and might take several minutes. Make sure that the firmware update is not interrupted, for example, by turning off the power, during the update process, because doing so will render the Roamer KVM inoperable. 64 Roamer KVM User Manual

81 Web Interface 2. The Update Firmware screen displays. This screen shows you the version number of the currently running firmware and the version number of the uploaded firmware. Clicking Update stores the new version and replaces the old version. 3. After the firmware is saved locally, the Roamer KVM resets automatically. After about one minute, the system redirects you to the Login page and requests that you log in once again. Warning: Firmware Updates The three-stage firmware update process and complete consistency check are making a mistake in updating the firmware almost impossible. However, only experienced staff members or administrators should perform a firmware update. Make sure the Roamer KVM s power supply will not be interrupted! Unit Reset The screen shown in Figure 60 allows you to reset specific parts of the device. Figure 60 Unit Reset Unit Reset involves the both keyboard and mouse, the video engine and the Roamer KVM itself. Resetting the card itself is mainly needed to activate a newly updated firmware. It closes all current connections to the administration console and to the Remote Console. The whole process takes about 30 seconds. Resetting subdevices (for example, the video engine) takes only seconds and does not result in closing connections. To reset a certain Roamer KVM functionality, click Reset as displayed in Figure 60. Note: Resetting Roamer KVM Anyone in the admin group is allowed to reset the Roamer KVM. Roamer KVM User Manual 65

82 Web Interface 66 Roamer KVM User Manual

83 7 Roamer KVM Command Line Interface (CLI) Starting the Command Line Interface You can access the Roamer KVM through a command line interface, using the SSH or TELNET protocol. To access the CLI, follow these steps: 1. Download a tool such as PuTTY from the World Wide Note: PuTTY-based Example Web. The examples shown in this chapter use 2. Run the Putty executable. the PuTTY tool. You may use other tools if 3. Be sure that SSH or TELNET is enabled on the Roamer you prefer. KVM. Refer to Figure 47 on page 47 to see that SSH access is enabled by the radio button being checked. 4. Enter the IP address of Rackable box in the box highlighted in Figure 61. Click Open. Figure 61 PuTTY Configuration Window 5. A terminal window opens, as shown in Figure 62 on page Roamer KVM User Manual 67

84 Roamer KVM Command Line Interface (CLI) 6. Enter your the Roamer KVM administrator username and password. Figure 62 Putty Username and Password Entry Screen 7. The esh prompt displays. 8. Type Help to see the command choices. The system displays the screen shown in Figure 63 on page 69. The command choices are: power [on off soft reset status] - cycles power or shows power status per the commands shown. quit - exits the command terminal. identify [duration] [color] [blink color] - changes color of the LED on the Roamer KVM panel. [duration] - how long the led should be on. Valid options are on, off, 15, 60. Option on means to stay on until told to turn off. 15 and 60 are the number of seconds the LED should stay on. [color] and [blink color] both accept any of the following colors: red, green, yellow, blue, violet, light blue, white. [blink color] also accepts the options: noblink steady and blink. If no arguments are specified for [color] and [blink color], the defaults are red and blink respectively. version - displays the firmware version, firmware build number, and the firmware description. lcd - lcd [display] message - sets the LCD display message. terminal [<nr>] - opens a connection to the serial port. <nr> specifies the serial port number (1 or 2), the default is 1. You may leave this mode by entering the following key sequence: ESC exit. clp - starts a clp session, returning a clp:/-> prompt. 68 Roamer KVM User Manual

85 Roamer KVM Command Line Interface (CLI) Figure 63 PuTTY Help - Command Display Starting a Serial Session To start a serial session, type terminal at the esh prompt, as shown in Figure 64. A serial session starts, as shown in Figure 65. Figure 64 PuTTY SSH Terminal Command To exit the terminal mode: 1. Press the Esc key. 2. Type the word exit on the keyboard. The serial session quits, as shown in Figure Roamer KVM User Manual 69

86 Roamer KVM Command Line Interface (CLI) CLI Commands Clp This section lists the CLI commands. Syntax: clp Description: Starts a clp session, returning a clp:/-> prompt. DeleteScratchpadKey Figure 65 SSH Mode - ESC sequence Syntax: DeleteScratchpadKey <key> Description: Deletes a key from the scratchpad. If the specified key is present in the scratchpad, then you are prompted to press "Y" prior to deleting the key. If any other key is pressed, then the call is aborted. DumpScratchpadContents Note: System Scratchpad Values This command will not allow you to delete any of the system Scratchpad values. Syntax: DumpScratchpadContents Description: Prints all the scratchpad values on the system. If any of the user s defined keys contain unprintable characters, it is undefined what the behavior will be. EnableDHCP Syntax: EnableDHCP Description:Enables the DHCP client on the Roamer KVM. If no DHCP server is present, this could result in an unreachable Roamer KVM. Prior to seeing the values, the Roamer KVM will prompt you to press "Y" prior to committing the change. FactoryReset Syntax: FactoryReset Description:Resets the Roamer KVM to its factory defaults. Prior to triggering the reset of the Roamer KVM card, you are prompted to press "Y". If any other key is pressed the command is aborted. 70 Roamer KVM User Manual

87 Roamer KVM Command Line Interface (CLI) GetCurrentIPInfo Syntax: GetCurrentIPInfo Description:Prints the current static or DHCP assigned IP information to the console in the form: RoamerKVM IP Configuration Information IP Address = Subnet Mask = Default Gateway = Primary DNS = Secondary DNS = GetHostPowerOnState Syntax: GetHostPowerOnState Description:This command prints to the console the current power status of the server, where: 0 == "off" 1 == "on" 2 == "in power on delay" GetHostPowerState Syntax: GetHostPowerState Description:Prints to the console the last known power state of the host server. GetHostServerUptime Syntax: GetHostServerUptime Description:Prints the amount of time the Host Server has run to the console. GetLCDTextRotationInterval Syntax: GetLCDTextRotationInterval Description:This command will print to the console the current delay between text on the LCD changing in seconds. GetLCDTextSlot Syntax: GetLCDTextSlot <slot number 0 to 10> Description:The user-specified slot number 1 to 10 will return the appropriate LCD text stored in the scratchpad. If slot 0 is requested, the current, on LCD text, is printed out. Any slot that is blank will return a "no text set in LCD slot message." Any other slot number, besides 0-10, results in an error being printed to the end user. Roamer KVM User Manual 71

88 Roamer KVM Command Line Interface (CLI) GetLEDColor Syntax: GetLEDColor Description:This command will print to the console the current color of the LED, where: 0 == "green" (default) 1 == "blue" 2 == "red 3 == "yellow" 4 == "purple" 5 == "cyan" 6 == "white GetLEDState Syntax: GetLEDState Description:The command will print to the console the current state of the LCD. 0=="off" (default setting) 1=="blinking" 2=="on" GetPowerOnDelay Syntax: GetPowerOnDelay Description:This command prints to the console the delay that will occur before the Roamer KVM powers on the server. GetRoamerKVMUptime Syntax: GetRoamerKVMUptime Description:Prints the amount of time the Roamer KVM has run to the console. GetScratchpadValue Syntax: GetScratchpadValue <key> Description: If the specified key is present in the scratchpad, the contents are printed to the console. If the contents contain unprintable characters, the behavior is left undefined. If no key name is specified or the key does not exist, an error is printed to the console. GetTemperatureData Help Syntax: GetTemperatureData Description:Prints out the current temperature measured by the Roamer KVM's temperature probe. Syntax: Help [<command name>] Description:If <command name is not specified>, the grammar for all available commands is printed to the console. If <command name> is specified, then the grammar for just that command is presented. 72 Roamer KVM User Manual

89 Roamer KVM Command Line Interface (CLI) HostHardReset Syntax: HostHardReset Description:You are presented with a prompt to enter "Y" if you want to hard reset the host server. If "Y" is entered, then the hard reset of the host is triggered by the shell. Pressing any other key will abort the request. HostPowerOff Syntax: HostPowerOff Description:You are presented with a prompt to enter "Y"if you want to power off the host server. If "Y" is entered, then the IPMI HostPowerOff command is triggered by the shell. Pressing any other key will abort the request. HostPowerOn Syntax: HostPowerOn Description:You are presented with a prompt to enter "Y" if you want to power on the host server. If "Y" is entered then the IPMI HostPowerOn command is triggered by the shell. Pressing any other key will abort the request. HostSoftShutdown Quit Syntax: HostSoftShutdown Description:You are presented with a prompt to enter "Y" if you want to soft shutdown the host server. The text should also include the warning that this functionality requires host OS support and may not work on all servers. If "Y" is entered, then the IPMI HostSoftShutdown command is triggered by the shell. Pressing any other key will abort the request. Syntax: Quit Description:Exits the command terminal. RebootRoamerKVM Syntax: RebootRoamerKVM Description: Prior to triggering the reboot of the Roamer KVM card, are be prompted to press "Y". If any other key is pressed, the command is aborted. Unlike a reset, a reboot is strictly restarts the Roamer KVM card without any settings being set to their defaults. SetLCDTextRotationInterval Syntax: SetLCDTextRotationInterval <interval 1 to 99> Description:This command will set the delay between text on the LCD changing. Valid values are 1 to 99 seconds. Any other values will result in an error being returned to you. SetLCDTextSlot Syntax: SetLCDTextSlot <slot number 1 to 10> <text> Description:If the slot already contains text, you are prompted to press "Y" prior to being overwritten. If the slot is blank, then the text will just be automatically overwritten. If you try to enter more than 40 characters of text, the text is silently truncated by the system. If any other slot number is specified, then an error is displayed. Roamer KVM User Manual 73

90 Roamer KVM Command Line Interface (CLI) SetLEDColor Syntax: SetLEDColor <red green blue yellow purple cyan white> Description:This command will set the current color of the LED, where: 0 == "green" (default) 1 == "blue" 2 == "red 3 == "yellow" 4 == "purple" 5 == "cyan" 6 == "white SetLEDState Syntax: SetLEDState <off on blinking> Description:This command will set the state of the LED. Valid states are: 0=="off" (default setting) 1=="blinking" 2=="on" SetPowerOnDelay Syntax: SetPowerOnDelay <delay 0-99> Description:This command sets the delay in seconds that will occur before the Roamer KVM powers on the host server. Valid values are 0 to 99 seconds. Any other values will result in an error being returned to you. SetScratchpadValue Syntax: SetScratchpadValue <key> <value> Description:Set a key/value pair in the scratchpad. If the specified key is present in the scratchpad, then you are prompted to press "Y" prior to overwriting the value. If any other key is pressed, then the call is aborted. SetStaticIPInfo Note: System Scratchpad Values This command will not allow you to modify any of the System scratchpad values. Syntax: SetStaticIPInfo <ipaddress> <default gateway> <subnetmask> [<primary DNS>] [<secondary DNS>] Description:It is required that you provide the IP address, subnet mask, and default gateway in order for this command to operate. If you specify incorrect information, the Roamer KVM is put in an unreachable state. Prior to setting the IP information, the command will print out the values entered by you and prompt you to confirm by pressing "Y" that you want to apply these settings. StartLCDCarousel Syntax: StartLCDCarousel <slot number 1 to 10> Description: Starts the LCD carousel rotating at the specified LCD slot. StopLCDCarousel Syntax: StopLCDCarousel <slot number 1 to 10> 74 Roamer KVM User Manual

91 Roamer KVM Command Line Interface (CLI) Description: If the carousel is running, you are prompted to press "Y" to confirm the action. If the carousel is stopped, the LCD will just be updated with the requested slot numbers text value. Terminal Syntax: terminal [<nr>] Description:Opens a connection to the serial port. <nr> specifies the serial port number (1 or 2), the default is 1. You may leave this mode by entering the following key sequence: ESC e x i t. Version Syntax: version Description:Displays the firmware version, firmware build number, and the firmware description. Roamer KVM User Manual 75

92 Roamer KVM Command Line Interface (CLI) 76 Roamer KVM User Manual

93 8 IPMITool IPMITool is an open standard tool for interfacing with devices managed via the IPMI 2.0 standard. IPMITool supports all major operating systems and can be downloaded from Each command description below shows how to call the command with IPMITool, but the general syntax is: ipmitool -U <username> -P <password> -H <RoamerKVM IP Address> raw <netfn> <command> <data> The Rackable OEM netfn is 0x3A. The netfn is used when sending an IPMI command to the Roamer KVM to uniquely identify it as a Rackable vendor extension to the IPMI standard. The following table lists each of the command identifiers for Rackable's IPMI Vendor Extensions: Table 12 Rackable s IPMI Vendor Extensions Command Name GetLCDTextSlot SetLCDTextSlot GetLCDTextRotationInterval SetLCDTextRotationInterval GetLEDState SetLEDState GetLEDColor SetLEDColor GetHostPowerOnState SetHostPowerOnState GetPowerOnDelay SetPowerOnDelay GetTemperatureData ResetRoamerKVM GetHostServerUptime GetRoamerKVMUptime StartLCDCarousel StopLCDCarousel ID 0x10 0x11 0x12 0x13 0x14 0x15 0x16 0x17 0x18 0x19 0x1a 0x1b 0x1c 0x22 0x23 0x24 0x25 0x26 Roamer KVM User Manual 77

94 IPMITool GetLCDTextSlot Retrieves a specific LCD slot in the LCD carousel. The API will take as arguments a slot number from 1-10 and will return a 40 character buffer of text. If a value of 0 is requested, the current text on the LCD is returned. Table 13 GetLCDTextSlot IPMI Table Byte Description Request Data 1 Slot number between 0 and 10 Response Data 1 2 Completion code 40 characters of text present in the requested slot Example The following retrieves the text in slot one of the LCD Carousel: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x10 0x01 Returns: f 61 6d b 56 4d SetLCDTextSlot Sets a specific LCD slot in the LCD carousel. The API will take as arguments a slot number from 1-10 and a 40 character buffer of the text to be populated in the slot. Table 14 SetLCDTextSlot IPMI Table Byte Description Request Data 1 2 Slot number between 0 and characters of text present in the requested slot Response Data 1 Completion code Example The following sets the LCD text to " RoamerKVM": ipmitool.exe -U admin -P rackable -H raw 0x3a 0x11 0x03 0x20 0x20 0x20 0x20 0x20 0x52 0x6f 0x61 0x6d 0x65 0x72 0x20 0x4b 0x56 0x4d 78 Roamer KVM User Manual

95 IPMITool GetLCDTextRotationInterval Retrieves the time in seconds that are paused before changing the text on the LCD. Valid values are 1 to 99 seconds. Table 15 GetLCDTextRotationInterval IPMI Table Byte Description Request Data - - Response Data 1 2 Completion code Rotation interval in seconds Example The following gets the rotation interval: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x12 Returns: 02 SetLCDTextRotationInterval Sets the time in seconds that are paused before changing the text on the LCD. Valid values are 1 to 99 seconds. Table 16 SetLCDTextRotationInterval IPMI Table Byte Description Request Data 1 Rotation interval in seconds (1 to 99 seconds) Response Data 1 Completion code Example The following sets the rotation interval to 5 seconds: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x13 0x05 Roamer KVM User Manual 79

96 IPMITool GetLEDState Retrieves the state of the tri-color LED. Valid states that can be returned are: 0=="off" 1=="blinking" 2=="solid on" Table 17 GetLEDState IPMI Table Byte Description Request Data - - Response Data 1 2 Completion code State: 0=="off" (default setting) 1=="blinking" 2=="on" Example The following gets the current color of the LED: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x16 Returns: 02 (means the LED is currently red) SetLEDState Sets the state of the tri-color LED. Valid states to be set are: 0=="off" 1=="blinking" 2=="solid on" Table 18 SetLEDState IPMI Table Byte Description Request Data 1 State: 0=="off" (default setting) 1=="blinking" 2=="on" Response Data 1 Completion code Example The following sets the current state of the LED to blinking: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x15 0x01 80 Roamer KVM User Manual

97 IPMITool GetLEDColor Retrieves the state of the tri-color LED. Valid colors if the states are: 0 == "green" (default) 1 == "blue" 2 == "red" 3 == "yellow" 4 == "purple" 5 == "cyan" 6 == "white" Table 19 GetLEDColor IPMI Table Byte Description Request Data - - Response Data 1 2 Completion code State: 0 == "green" (default) 1 == "blue" 2 == "red 3 == "yellow" 4 == "purple" 5 == "cyan" 6 == "white" Example The following gets the current color of the LED: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x16 Returns: 02 (means the LED is currently red) SetLEDColor Sets the color of the tri-color LED. Valid colors are: 0 == "green" (default) 1 == "blue" 2 == "red 3 == "yellow" 4 == "purple" 5 == "cyan" 6 == "white Roamer KVM User Manual 81

98 IPMITool Table 20 GetLEDColor IPMI Table Byte Description Request Data 1 State: 0 == "green" (default) 1 == "blue" 2 == "red 3 == "yellow" 4 == "purple" 5 == "cyan" 6 == "white Response Data 1 Completion code Example The following sets the current color of the LED to yellow: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x17 0x03 GetHostPowerOnState Sets the host server's power state on a power restore event. Valid states that can be set are: 0 == "do nothing" 1 == "always on" 2 == "restore last known power state" Table 21 GetHostPowerOnState IPMI Table Byte Description Request Data - - Response Data 1 2 Completion code State: 0 == off 1 == on 2 == in power on delay Example The following gets the power on state of the host: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x18 SetHostPowerOnState Sets the host server's power state on a power restore event. Valid values are: 0 == "no nothing" 1 == "always on" 2 == "restore last known power state" 82 Roamer KVM User Manual

99 IPMITool GetPowerOnDelay Retrieves the amount of time in seconds to delay prior to powering on the host server by the Roamer KVM when power is restored to the Roamer KVM hardware following a full outage. This ensures that all servers in a rack do not power on at the same time and cause a current spike. Valid settings are 0 to 99 seconds with the default delay being 0 seconds. Table 22 GetPowerOnDelay IPMI Table Byte Description Request Data - - Response Data 1 2 Example Completion code Delay in seconds ipmitool.exe -U admin -P rackable -H raw 0x3a 0x1a Returns: 05 SetPowerOnDelay Sets the amount of time in seconds to delay prior to powering on the host server by the Roamer KVM when power is restored to the Roamer KVM hardware following a full outage. This is to ensure that all servers in a rack do not power on at the same time and result in a current spike in a rack. Valid settings are 0 to 99 seconds with the default delay being 0 seconds. Note: PowerOnDelay Value In the case where a server has a non-zero power on delay and is switched from "always on" to "always off" and back to "always on again for its Power on state, the power on delay value will persist in the configuration database. It is ignored in the cases where the power state is "Always off" or last known state was "off." Table 23 SetPowerOnDelay IPMI Table Byte Description Request Data 1 Delay in seconds (0 to 99 seconds are legal) Response Data 1 Completion code Example Sets the power on delay to 5 seconds ipmitool.exe -U admin -P rackable -H raw 0x3a 0x1b 0x05 Roamer KVM User Manual 83

100 IPMITool GetTemperatureData Returns the current value of the temperature sensor on the Roamer KVM in degrees Celsius. Table 24 GetTemperatureData IPMI Table Byte Description Request Data - - Response Data 1 2 Completion code Temperature in degrees Celsius Example The following retrieves the current temperature being measured by the Roamer KVM in degrees Celsius: ipmitool.exe -U admin -P rackable -H raw 0x3a 0x1c Returns: 29 ResetRoamerKVM This API will force a reboot of the Roamer KVM board. Prior to the reboot occurring, the HOST_SERVER_LAST_KNOWN_POWER_STATE scratchpad variable is updated to ensure consistency following the reboot. Table 25 ResetRoamerKVM IPMI Table Byte Description Request Data - - Response Data 1 Completion code Example The following resets the Roamer KVM to factory defaults (be careful because all settings are lost by doing this): ipmitool.exe -U admin -P rackable -H raw 0x3a 0x22 84 Roamer KVM User Manual

101 IPMITool GetHostServerUptime Retrieves the number of seconds since the last host server reboot. If this is a non-zero value, then it is compared with the current time as retrieved from the Roamer KVM OS and a value in seconds for the host servers up time is returned to the caller. Note: Translate seconds The UI must translate this into days/hours/minutes/seconds. Table 26 GetHostServerUptime IPMI Table Byte Description Request Data - - Response Data 1 2 Completion code Server uptime in seconds Example Get the amount of time in seconds since the last host server reboot ipmitool.exe -U admin -P rackable -H raw 0x3a 0x23 Returns: GetRoamerKVMUptime Returns the number of seconds since the last Roamer KVM reboot. Note: Translate seconds The UI must translate this into days/hours/minutes/seconds. Table 27 GetRoamerKVMUptime IPMI Table Byte Description Request Data - - Response Data 1 2 Completion code Roamer KVM uptime in seconds Example Get the amount of time in seconds since the last Roamer KVM reboot ipmitool.exe -U admin -P rackable -H raw 0x3a 0x24 Returns: 3c f Roamer KVM User Manual 85

102 IPMITool StartLCDCarousel Starts the LCD carousel application in Roamer KVM. If the carousel is already running, it is a noop. The API will take an integer argument from 1 to 10 which represents the slot number to start the carousel from. Table 28 StartLCDCarousel IPMI Table Byte Description Request Data 1 Slot number to put on the LCD Response Data 1 Completion code Example Starts the LCD at slot 2 ipmitool.exe -U admin -P rackable -H raw 0x3a 0x25 0x02 StopLCDCarousel Stops the LCD carousel application in Roamer KVM. The API will take an integer argument from 1 to 10 which represents the slot number of the LCD text that the carousel should display until started again. If the carousel is already stopped it will update the LCD to the newly specified slot number. Table 29 StopLCDCarousel IPMI Table Byte Description Request Data - - Response Data 1 Completion code Example Stops the LCD at slot 1 ipmitool.exe -U admin -P rackable -H raw 0x3a 0x26 0x01 IP Address Configuration IP Address configuration on the Roamer KVM is accomplished using the standard IPMI set facility, i.e., set <channel> <parameter> Sets the given parameter on the given channel. Valid parameters are: ipaddr <x.x.x.x> Sets the IP address for this channel. netmask <x.x.x.x> Sets the netmask for this channel. macaddr <xx:xx:xx:xx:xx:xx> Sets the MAC address for this channel. defgw ipaddr <x.x.x.x> Sets the default gateway IP address. defgw macaddr <xx:xx:xx:xx:xx:xx> Sets the default gateway MAC address. bakgw ipaddr <x.x.x.x> Sets the backup gateway IP address. bakgw macaddr <xx:xx:xx:xx:xx:xx> Sets the backup gateway MAC address. password <pass> Sets the null user password. snmp <community string> Sets the SNMP community string. ipsrc Sets the IP address source: none unspecified 86 Roamer KVM User Manual

103 IPMITool static manually configured static IP address dhcp address obtained by DHCP Roamer KVM User Manual 87

104 IPMITool 88 Roamer KVM User Manual

105 A Frequently Asked Questions 1. The mouse does not react correctly in the applet screen. The mouse is not in sync with the mouse of the host. Navigate your mouse pointer into the upper left corner of the applet screen and move it slightly forth and back. Thus the mouse is resynchronized. If resynchronizing fails, disable the mouse acceleration and repeat the procedure. 2. The mouse is behaving erratically. Verify your mouse settings. Disable the mouse acceleration. In Windows 2000, do this in Settings > System control > Mouse. Be sure your mouse settings match your mouse model, i.e., PS/2 or wheel mouse. 3. Login to the Roamer KVM fails. Verify both your user login and your password. Your web browser has to be configured to accept cookies. By default, the user admin has the password admin or rackable. 4. The Remote Console window of the Roamer KVM does not open. A firewall may prevent the access to the Remote Console. The TCP ports 80 (for HTTP) and 443 (for both HTTPS and RFB) have to be open (the server providing the firewall has to accept incoming TCP connections on these ports). 5. Remote console is unable to connect and displays a timeout error. Please check your network configuration. If there is a proxy server between the Roamer KVM and your host, then you may not be able to transfer the video data using RFB. Establish a direct connection between the Roamer KVM and the client. Furthermore, check the settings of the Roamer KVM and choose a different server port used for RFB transfer. If you use a firewall then check the according port for accepting connections. You may restrict these connections for the IP addresses used by the Roamer KVM and your client. 6. No connection can be established to the Roamer KVM. Review hardware connections. Is the Roamer KVM attached to a power supply? Verify your network configuration (IP address, router). You may send a ping request to the Roamer KVM to find out whether the Roamer KVM is reachable via network. 7. Special key combinations, e.g., Alt+F2, Alt+F3 are intercepted by the console system and not transmitted to the host. You must define a Button Key. This can be done in the Remote Console settings (Chapter 5). Alternatively, you can use the soft keyboard feature. Roamer KVM User Manual 89

106 Frequently Asked Questions 8. The Roamer KVM web pages do not display correctly. Check your browser s cache settings. Make sure the cache settings are not set never check for newer pages. Otherwise the Roamer KVM pages may be loaded from your browser cache and not from the card. 9. Windows XP does not awaken from standby mode. This may be a Windows XP problem. Try not to move the mouse pointer while XP switches into standby mode. 10. With SUN computers, a USB keyboard does not work. The Roamer KVM emulates a USB keyboard. If you attach a USB keyboard to your host, two keyboards are detected. We cannot predict which one of these connects first and which one you are able to work with. SUN supports only one USB keyboard. 11. Cannot upload the signed certificate in Mac OS X. If an internal error occurs while uploading the signed certificate either change the extension of the file to.txt or add a file helper using the Internet Explorer preferences for this type of file. Make sure that the encoding is set to plain text and the check box use for outgoing is set. As an alternative, you may also use a Mozilla-based browser (Mozilla, FireFox). 12. Every time I open a dialog box with some buttons, the mouse pointers are not synchronous anymore. Disable the setting Automatically move mouse pointer to the default button of dialog boxes in the mouse settings of your operating system. 13. The Remote Console does not open with Opera in Linux. Some versions of Opera do not grant enough permissions if the signature of the applet cannot be verified. To solve the problem, add the lines: grant codebase nn.pp.rc.remoteconsoleapplet { permission java.lang.runtimepermission accessclassinpackage.sun.* ; to the java policy file of opera (e.g., /usr/share/opera/java/opera.policy). 14. The video data on the local monitor is surrounded by a black border. This is not a failure. The local monitor is programmed to a fixed video mode that can be selected in the video settings of the Roamer KVM. Refer to Chapter 5 for more details. 15. The local monitor displays video data, but the remote screen remains blank. If the Remote Console is connected (look at the status line of the Remote Console) you should verify that the flat panel interface is not switched off by the video driver of your operating system. 16. I forgot my password. How can I reset the Roamer KVM to factory defaults? You may use the serial interface. For a detailed description, see Chapter Roamer KVM User Manual

107 Frequently Asked Questions 17. Does it matter which USB version is used? The Roamer KVM works only with USB v1.1. If present, USB v2.0 must be disabled either in the BIOS or by using jumpers on the motherboard. Roamer KVM User Manual 91

108 Frequently Asked Questions 92 Roamer KVM User Manual

109 B Glossary ACPI - Advanced Configuration and Power Interface - A specification that enables the operating system to implement power management and system configuration. ATX - Advanced Technology Extended - A particular specification that covers the style of motherboards and enclosure introduced by Intel in BMC - A baseboard management controller (BMC) is a specialized microcontroller embedded on the motherboard of many computers, especially servers. The BMC is the intelligence in the Intelligent Platform Management Interface (IPMI) architecture. The BMC manages the interface between system management software and platform hardware. DHCP - Dynamic Host Configuration Protocol - A protocol for dynamically assigning IP configurations to host names, especially used in a local network. DNS - Domain Name System - A protocol used to locate computers on the Internet by their name. FAQ - Frequently Asked Questions HTTP - Hypertext Transfer Protocol - One of the protocols used for communication between single computers, especially between web browsers and web servers. HTTPS - Hypertext Transfer Protocol Secure - The secure version of HTTP. IPMI - Intelligent Platform Management Interface - A specification defining a set of common interfaces for operating system independent platform management and health monitoring. LED - Light Emitting Diode - A semiconductor device that emits incoherent monochromatic light when electrically biased in the forward direction. PS/2 - Personal System/2 - IBM s second generation of personal computers, which was released to the public in Today, PS/2 is known as a device interface for mouse and keyboard. SNMP - Simple Network Management Protocol - A widely used network monitoring and control protocol. SSH - Secure Shell - An encrypted network protocol providing a secure replacement for TELNET. SSL - Secure Socket Layer - An encryption technology for the Internet used to provide secured data transmissions. Roamer KVM User Manual 93

110 Glossary SVGA - Super Video Graphics Array - A refinement of the Video Graphics Array (VGA) that provides increased pitch and resolution performance. UTP - Unshielded Twisted Pair - A cable with two conductors twisted as a pair and bundled within the same outer PVC covering. 94 Roamer KVM User Manual

111 C Specifications Environment Temperature Table 30 Environmental Temperatures Attribute Operating Temperature Range Storage Temperature Range Value 0ºC to 55ºC (32ºF to 131ºF) -18ºC to 70ºC (-0.4ºF to 158ºF) Humidity Range Table 31 Environmental Humidity Range Attribute Operating Range Storage Range Value 10% to 90% (non-condensing) 5% to 95% (non-condensing) Roamer KVM User Manual 95

112 Specifications 96 Roamer KVM User Manual

113 D Warranty Information Roamer KVM User Manual 97

114 Warranty Information 98 Roamer KVM User Manual

115 E GNU General Public License (GPL) Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation s software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author s protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone s free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The Program, below, refers to any such program or work, and a work based on the Program means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term modification.) Each licensee is addressed as you. Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its Roamer KVM User Manual 99

116 GNU General Public License (GPL) contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Program s source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a. You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b. You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c. If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a. Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b. Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c. Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. 100 Roamer KVM User Manual

117 GNU General Public License (GPL) If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and any later version, you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY Roamer KVM User Manual 101

118 GNU General Public License (GPL) 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type "show w". This is free software, and you are welcome to redistribute it under certain conditions; type "show c" for details. 102 Roamer KVM User Manual

119 GNU General Public License (GPL) The hypothetical commands "show w" and "show c" should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than "show w" and "show c"; they could even be mouse-clicks or menu items-- whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program "Gnomovision" (which makes passes at compilers) written by James Hacker. This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License. Roamer KVM User Manual 103

120 GNU General Public License (GPL) 104 Roamer KVM User Manual

121 F The OpenLDAP Public License Version 2.8, 17 August 2003 Redistribution and use of this software and associated documentation ("Software"), with or without modification, are permitted provided that the following conditions are met: 1. Redistributions in source form must retain copyright statements and notices, 2. Redistributions in binary form must reproduce applicable copyright statements and notices, this list of conditions, and the following disclaimer in the documentation and/or other materials provided with the distribution, and 3. Redistributions must contain a verbatim copy of this document. The OpenLDAP Foundation may revise this license from time to time. Each revision is distinguished by a version number. You may use this Software under terms of this license revision or under the terms of any subsequent revision of the license. THIS SOFTWARE IS PROVIDED BY THE OPENLDAP FOUNDATION AND ITS CONTRIBUTORS "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OPENLDAP FOUNDATION, ITS CONTRIBUTORS, OR THE AUTHOR(S) OR OWNER(S) OF THE SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. The names of the authors and copyright holders must not be used in advertising or otherwise to promote the sale, use or other dealing in this Software without specific, written prior permission. Title to copyright in this Software shall at all times remain with copyright holders. OpenLDAP is a registered trademark of the OpenLDAP Foundation. Copyright The OpenLDAP Foundation, Redwood City, California, USA. All Rights Reserved. Permission to copy and distribute verbatim copies of this document is granted. Roamer KVM User Manual 105

122 The OpenLDAP Public License 106 Roamer KVM User Manual

123 G Key Codes Table 32 shows the key codes used to define the key strokes or hot keys for several functions. Please note that these key codes do not necessarily represent the key characters that are used on international keyboards. A key on a standard 104 key PC keyboard with a US English language mapping is named. The layout for this keyboard is shown in Figure 66. However, most modifier keys and other alphanumeric keys used for hot key purposes in application programs are on a similar position, no matter what language mapping you are using. Some of the keys also have aliases. This means that a key can be named by two different key codes. Figure 66 English (US) keyboard Layout, used for the key codes Table 32 Key Names Key Alias Key(s) 0-9 A-Z ~ Tilde - Minus = Equals ; < Less,. / Slash Backspace Roamer KVM User Manual 107

124 Key Codes Table 32 Key Names Key Alias Key(s) Tab [ ] Enter Caps Lock \ Backslash LSHIFT Shift RCTRL CTRL, STRG RSHIFT Shift LCTRL CTRL, STRG LALT ALT Space ALT GR Escape ESC F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 Print Screen Scroll Lock 108 Roamer KVM User Manual

125 Key Codes Table 32 Key Names Key Alias Key(s) Break Insert Home POS 1 Page_up Page_down Delete Del End Up Left Down Right Num_lock Numpad0 Numpad1 Numpad2 Numpad3 Numpad4 Numpad5 Numpad6 Numpad7 Numpad8 Numpad9 Numpadplus Numpad_plus. + Numpad / / Numpadminus Numpad_minus. - Numpadenter Windows Menu Roamer KVM User Manual 109

126 Key Codes 110 Roamer KVM User Manual

127 H SNMP MIB A link to the latest SNMP MIB is contained in the SNMP screen found at Device Settings > SNMP Settings > Click here to view the SNMP MIB. In addition, the SNMP MIB listing is shown here. roamerkvm-mib DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, enterprises, Integer32, TimeTicks, IpAddress FROM SNMPv2-SMI OBJECT-GROUP FROM SNMPv2-CONF TEXTUAL-CONVENTION, TruthValue, DisplayString FROM SNMPv2-TC; roamerkvm MODULE-IDENTITY LAST-UPDATED " Z" ORGANIZATION "Rackable, Inc." CONTACT-INFO "Contact: Matthew Gambardella Postal: Rackable Systems Landing Parkway Fremont, CA Tel: Fax: support@rackable.com" DESCRIPTION "" REVISION " Z" DESCRIPTION "Initial Draft" ::= { rackable 1 } rackable OBJECT IDENTIFIER ::= { enterprises } chassis OBJECT IDENTIFIER ::= { roamerkvm 1 } hostserveruptime OBJECT-TYPE Roamer KVM User Manual 111

128 SNMP MIB SYNTAX MAX-ACCESS STATUS DESCRIPTION ::= { chassis 2 } TimeTicks read-only current "The time in ticks since the host server has been powered on" powercontrol OBJECT-TYPE SYNTAX Integer32 UNITS "1..3" MAX-ACCESS read-write STATUS current DESCRIPTION "1 will cause the server to power on, 2 will cause the server to power off, 3 will cause the server to perform a soft shutdown" ::= { chassis 5 } powerondelay OBJECT-TYPE SYNTAX Integer32 UNITS "0..99" MAX-ACCESS read-write STATUS current DESCRIPTION "Sets the delay prior to a server booting up to be between 0 to 99 seconds. This delay only is used during a power restoration event on the server." ::= { chassis 6 } powerstate OBJECT-TYPE SYNTAX Integer32 UNITS "0..2" MAX-ACCESS read-only STATUS current DESCRIPTION "Retrieves the current power setting of the server. off(0), on(1),in power on delay(2)." ::= { chassis 7 } reboothost OBJECT-TYPE SYNTAX Integer32 UNITS "1" 112 Roamer KVM User Manual

129 SNMP MIB MAX-ACCESS STATUS DESCRIPTION ::= { chassis 8 } read-write current "Setting to a value of 1 will trigger an immediate hard reset of the server." card OBJECT IDENTIFIER ::= { roamerkvm 2 } rebootroamerkvm OBJECT-TYPE SYNTAX Integer32 UNITS "1" MAX-ACCESS read-write STATUS current DESCRIPTION "When set to 1 this triggers a hard reboot of the RoamerKVM." ::= { card 1 } roamerkvmuptime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time in ticks since the RoamerKVM has been powered on" ::= { card 3 } roamerkvmcurrentipaddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address of the RoamerKVM board." ::= { card 4 } roamerkvmcurrentsubnetmask OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The subnet mask of the RoamerKVM board." ::= { card 5 } Roamer KVM User Manual 113

130 SNMP MIB roamerkvmcurrentdefaultgateway OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The default gateway of the RoamerKVM board." ::= { card 6 } roamerkvmcurrentprimarydns OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The primary DNS of the RoamerKVM board if it is set." ::= { card 7 } roamerkvmcurrentsecondarydns OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The secondary DNS of the RoamerKVM board if it is set." ::= { card 8 } setstaticipaddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-write STATUS current DESCRIPTION "Queues up the static IP address that will be set on the RoamerKVM when the call to EnableStaticIP address is set." ::= { card 10 } setstaticsubnetmask OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-write STATUS current DESCRIPTION "Queues up the subnet mask for the new static IP settings that will be set on the RoamerKVM when the call to EnableStaticIP address is set." 114 Roamer KVM User Manual

131 SNMP MIB ::= { card 11 } setstaticdefaultgateway OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-write STATUS current DESCRIPTION "Queues up the sdefault gateway for the new static IP settings that will be set on the RoamerKVM when the call to EnableStaticIP address is set." ::= { card 12 } setstaticprimarydns OBJECT-TYPE SYNTAX IpAddress UNITS "1..2" MAX-ACCESS read-write STATUS current DESCRIPTION "Queues up the primary DNS server for the new static IP settings that will be set on the RoamerKVM when the call to EnableStaticIP address is set." ::= { card 13 } setstaticsecondarydns OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-write STATUS current DESCRIPTION "Queues up the secondary DNS for the new static IP settings that will be set on the RoamerKVM when the call to EnableStaticIP address is set." ::= { card 14 } enabledhcp OBJECT-TYPE SYNTAX Integer32 UNITS "1" MAX-ACCESS read-write STATUS current DESCRIPTION "Switches the RoamerKVM to use DHCP for IP Address information. If already running with DHCP the new call will result in a renewal of the DHCP IP address." Roamer KVM User Manual 115

132 SNMP MIB ::= { card 15 } enablestaticipsettings OBJECT-TYPE SYNTAX Integer32 UNITS "1" MAX-ACCESS read-write STATUS current DESCRIPTION "Persists the IP information that was specified in the properties setstaticipaddress, setstaticsubnetmask, setstaticdefualtgateway, setstaticprimarydns,setstaticsecondarydns. If the IP information set in those keys is incorrect the RoamerKVM will be unreachable." ::= { card 16 } lcdtextrotationinterval OBJECT-TYPE SYNTAX Integer32 UNITS "1..99" MAX-ACCESS read-write STATUS current DESCRIPTION "A value from 1 to 99 which is the delay between messages being cycled on the LCD." ::= { card 24 } controlled OBJECT-TYPE SYNTAX Integer32 UNITS "0..9" MAX-ACCESS read-write STATUS current DESCRIPTION "Sets the state of the alert LED to the specified value. If the param is not 0..9 a failure will occur. Valid values are: off(0), solidred(1), solidblue(2), solidgreen(3), blinkred(4), blinkblue(5), blinkgreen(6), blinkredgreen(7),blinkredblue(8), blinkbluegreen(9)" ::= { card 25 } startlcdcarousel OBJECT-TYPE SYNTAX Integer Roamer KVM User Manual

133 SNMP MIB UNITS "1..10" MAX-ACCESS read-write STATUS current DESCRIPTION "If the carousel is already running this is a no-op. Valid values are 1 to 10 (representing the slot number) which is the starting point from which the LCD carousel begins rotation." ::= { card 26 } stoplcdcarousel OBJECT-TYPE SYNTAX Integer32 UNITS "1..10" MAX-ACCESS read-write STATUS current DESCRIPTION "Stops the carousel from rotating and sets the specified slot numbers LCD text as the permanent display. If the carousel is already stopped then the LCD will be updated to the specified slot text. Valid values are from 1 to 10." ::= { card 27 } temperature OBJECT-TYPE SYNTAX MAX-ACCESS STATUS DESCRIPTION ::= { card 29 } Integer32 read-only current "Temperature is returned in degrees Celsius." EntryStatus ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The status of a table entry. Setting this object to the value invalid(4) has the effect of invalidating the corresponding entry. That is, it effectively disassociates the mapping identified with said entry. It is an implementation-specific matter as to whether Roamer KVM User Manual 117

134 SNMP MIB the agent removes an invalidated entry from the table. Accordingly, management stations must be prepared to receive tabular information from agents that corresponds to entries currently not in use. Proper interpretation of such entries requires examination of the relevant EntryStatus object. An existing instance of this object cannot be set to createrequest(2). This object may only be set to createrequest(2) when this instance is created. When this object is created, the agent may wish to create supplemental object instances with default values to complete a conceptual row in this table. Because the creation of these default objects is entirely at the option of the agent, the manager must not assume that any will be created, but may make use of any that are created. Immediately after completing the create operation, the agent must set this object to undercreation(3). When in the undercreation(3) state, an entry is allowed to exist in a possibly incomplete, possibly inconsistent state, usually to allow it to be modified in multiple PDUs. When in this state, an entry is not fully active. Entries shall exist in the undercreation(3) state until the management station is finished configuring the entry and sets this object to valid(1) or aborts, setting this object to invalid(4). If the agent determines that an entry has been in the undercreation(3) state for an abnormally long time, it may decide that the management station has crashed. If the agent makes this decision, it may set this object to invalid(4) to reclaim the entry. A prudent agent will understand that the management station may need to wait for human input and will allow for that possibility in its determination of this abnormally long period. An entry in the valid(1) state is fully configured and consistent and fully represents the configuration or 118 Roamer KVM User Manual

135 SNMP MIB operation such a row is intended to represent. For example, it could be a statistical function that is configured and active, or a filter that is available in the list of filters processed by the packet capture process. A manager is restricted to changing the state of an entry in the following ways: To: valid createrequest undercreation invalid From: valid OK NO OK OK createrequest N/A N/A N/A N/A undercreation OK NO OK OK invalid NO NO NO OK nonexistent NO OK NO OK In the table above, it is not applicable to move the state from the createrequest state to any other state because the manager will never find the variable in that state. The nonexistent state is not a value of the enumeration, rather it means that the entrystatus variable does not exist at all. An agent may allow an entrystatus variable to change state in additional ways, so long as the semantics of the states are followed. This allowance is made to ease the implementation of the agent and is made despite the fact that managers should never exercise these additional state transitions." SYNTAX INTEGER { valid(1), createrequest(2), undercreation(3), invalid(4) } userscratchpadtable OBJECT-TYPE SYNTAX SEQUENCE OF UserScratchpadEntry MAX-ACCESS not-accessible STATUS current Roamer KVM User Manual 119

136 SNMP MIB DESCRIPTION ::= { card 30 } "The user editable scratchpad" userscratchpadentry OBJECT-TYPE SYNTAX UserScratchpadEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Please replace this text with your description." INDEX { uscrindex } ::= { userscratchpadtable 1 } UserScratchpadEntry ::= SEQUENCE { uscrindex INTEGER, uscruserkey DisplayString, uscruservalue DisplayString, uscrentrystatus EntryStatus } uscrindex OBJECT-TYPE SYNTAX Integer32 ( ) MAX-ACCESS read-create STATUS current DESCRIPTION "A unique value for each entry. Its value ranges between 1 and the total number of entries." ::= { userscratchpadentry 1 } uscruserkey OBJECT-TYPE SYNTAX MAX-ACCESS STATUS DESCRIPTION DisplayString read-create current "The key for the user scratchpad entry" 120 Roamer KVM User Manual

137 SNMP MIB ::= { userscratchpadentry 2 } uscruservalue OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-create STATUS current DESCRIPTION "The value for the user scratchpad entry" ::= { userscratchpadentry 3 } uscrentrystatus OBJECT-TYPE SYNTAX EntryStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this userscratchpad entry." ::= { userscratchpadentry 4 } systemscratchpadtable OBJECT-TYPE SYNTAX SEQUENCE OF SystemScratchpadEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table of system scratchpad key/value pairs." ::= { card 31 } systemscratchpadentry OBJECT-TYPE SYNTAX SystemScratchpadEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Please replace this text with your description." INDEX { scrindex } ::= { systemscratchpadtable 1 } SystemScratchpadEntry ::= SEQUENCE { scrindex INTEGER, scrsystemkey DisplayString, Roamer KVM User Manual 121

138 SNMP MIB } scrsystemvalue DisplayString scrindex OBJECT-TYPE SYNTAX Integer32 ( ) MAX-ACCESS read-only STATUS current DESCRIPTION "A unique value for each entry. Its value ranges between 1 and the total number of entries." ::= { systemscratchpadentry 1 } scrsystemkey OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The key for the system scratchpad entry" ::= { systemscratchpadentry 2 } scrsystemvalue OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The value for the system scratchpad entry" ::= { systemscratchpadentry 3 } lcdslotstable OBJECT-TYPE SYNTAX SEQUENCE OF LcdSlotsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "the text stored in the LCD" ::= { card 32 } lcdslotsentry OBJECT-TYPE SYNTAX LcdSlotsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "and LCD text slot entry" INDEX { 122 Roamer KVM User Manual

139 SNMP MIB } ::= { lcdslotstable 1 } lcdindex LcdSlotsEntry ::= SEQUENCE { lcdindex Integer32, lcd DisplayString } lcdindex OBJECT-TYPE SYNTAX Integer32 (1..10) MAX-ACCESS read-only STATUS current DESCRIPTION "Please replace this text with your description." ::= { lcdslotsentry 1 } lcd OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-write STATUS current DESCRIPTION "40 characters to be displayed on the LCD" ::= { lcdslotsentry 2 } info OBJECT IDENTIFIER ::= { roamerkvm 3 } userloginname OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The login of a user." ::= { info 10 } remotehost OBJECT-TYPE SYNTAX MAX-ACCESS STATUS IpAddress read-only current Roamer KVM User Manual 123

140 SNMP MIB in." DESCRIPTION ::= { info 11 } "The IP of the remote host from which a user is logged eventtype OBJECT-TYPE SYNTAX MAX-ACCESS STATUS DESCRIPTION ::= { info 8 } DisplayString read-only current "The name of a generic log event" eventdesc OBJECT-TYPE SYNTAX MAX-ACCESS STATUS DESCRIPTION ::= { info 9 } DisplayString read-only current "The description text of a generic log event" traps OBJECT IDENTIFIER ::= { roamerkvm 4 } loginfailed NOTIFICATION-TYPE OBJECTS { userloginname, remotehost } STATUS current DESCRIPTION "Failed login try." ::= { traps 2 } loginsuccess NOTIFICATION-TYPE OBJECTS { userloginname, remotehost } STATUS current DESCRIPTION "Success login." ::= { traps 3 } securityviolation NOTIFICATION-TYPE OBJECTS { userloginname, remotehost } STATUS current DESCRIPTION "Security violation." ::= { traps 4 } generic NOTIFICATION-TYPE 124 Roamer KVM User Manual

141 SNMP MIB OBJECTS { eventtype, eventdesc } STATUS current DESCRIPTION "This trap is used for any other notification message." ::= { traps 5 } roamerkvmgroups OBJECT IDENTIFIER ::= { roamerkvm 5 } rackableroamermiballobjects OBJECT-GROUP OBJECTS{ controlled, hostserveruptime, powercontrol, powerondelay, powerstate, reboothost, rebootroamerkvm, roamerkvmuptime, roamerkvmcurrentipaddress, roamerkvmcurrentsubnetmask, roamerkvmcurrentdefaultgateway, roamerkvmcurrentprimarydns, roamerkvmcurrentsecondarydns, setstaticipaddress, setstaticsubnetmask, setstaticdefaultgateway, setstaticprimarydns, setstaticsecondarydns, enabledhcp, enablestaticipsettings, startlcdcarousel, stoplcdcarousel, lcdtextrotationinterval, temperature, lcdindex, lcd, scrindex, scrsystemkey, scrsystemvalue, uscrindex, Roamer KVM User Manual 125

142 SNMP MIB uscruserkey, uscruservalue, uscrentrystatus } STATUS current DESCRIPTION "This automatically created object group contains all those objects that do not belong to any other OBJECT-GROUP" ::= { roamerkvmgroups 1 } END 126 Roamer KVM User Manual

143 I Creating Images Creating an Image This appendix describes how to create floppy and CD images for Unix and Windows systems. Floppy Images UNIX and UNIX-like OSes To create an image file make use of dd. This is one of the original UNIX utilities and is included in every UNIX-like OS (UNIX, Sun Solaris, Linux). To create a floppy image file copy the floppy raw device to a file using the following command: dd [if=/dev/fd0] [of=/tmp/floppy.img] dd reads the entire disc from the device /dev/fd0 and saves the output in the specified output file /tmp/floppy.img. Adjust both parameters exactly to your needs (input device etc.) MS Windows You can use the tool WinImage, as shown in Figure 67. Figure 67 WinImage writing an image 1. Select File > Open. Using the Open dialog window, navigate to the image file. Click Open. 2. Select Disk > Use floppy A:. 3. Select Disk > Write disk or Disk > Format and write disk if the drive needs formatting. Roamer KVM User Manual 127

144 Creating Images CD-ROM/ISO 9660 Images UNIX and UNIX-like OSs To create an image file, use dd. This is one of the original UNIX utilities and is included in every UNIX-like OS (UNIX, Sun Solaris, Linux). To create a CD-ROM image file you have to copy the contents of the CD-ROM to a file. Use the following command: dd [if=/dev/cdrom] [of=/tmp/cdrom.img] dd reads the entire disc from the device /dev/cdrom and saves the output in the specified output file /tmp/cdrom.img. Adjust both parameters to suit your needs (input device etc.). MS Windows To create the image file, use your favorite CD imaging tool (ISO Recorder is shown in Figure 68) to copy the whole contents of the disc into one single ISO image file on your hard disk. Note: CDs Supported Only virtual CDs are supported, not DVDs. 1. For example, with ISO Recorder, right-click on a CD drive that contains a CD to create an ISO image file from. Click Create image from CD. See Figure 68. Figure 68 Start creation of ISO image file 128 Roamer KVM User Manual

145 Creating Images 2. The following window displays. Navigate to the directory where the.iso file will reside and specify its filename as shown in Figure 69. Figure 69 File selected and blank and writable CD is in the drive 3. Click Next to start the copying process as shown in Figure 70. Figure 70 Recording progress Once copying completes, click Finish to exit ISO Recorder. Roamer KVM User Manual 129

146 Creating Images 130 Roamer KVM User Manual

147 J Sharing Images Mounting an Image To include an image from a Windows share, select Virtual Media > CD-ROM Image. See Figure 71. Figure 71 CD-ROM Selection The following information is required to mount the selected image properly: Share host - The server name or its IP address. On Windows 95, 98, and Windows ME, do not specify the IP address but the server name ( NetBIOS Name ). Share name - The name of the share to be used. Path to image - The path of the image file on the share. User (optional) - If necessary, specify the username for the share named before. If unspecified and a guest account is activated, this guest account information is used as your login. Password (optional) - If necessary, specify the password for the given username. For example, referring to the previous image, the Roamer KVM will look for a server named mysql.acme.com. Then, the entered share name is selected (in our example we use the share storage) and the image file \cdrom_image.iso opens. If this file can only be accessed with both a username and password, enter the values in the input fields for username and password. In our example, the file is owned by the user johndoe and protected by an user-specific passphrase (displayed as a number of bullets). To register the specified file image and its location, click Set. The specified image file should be accessible from the Roamer KVM. The information above has to be given from the point of view of the Roamer KVM. Be sure to specify correct IP addresses or device names. Otherwise, the Roamer KVM User Manual 131

148 Sharing Images Roamer KVM may not be able to access the referenced image file properly, in which case, it will leave the given file unmounted and display an error message. If this occurs, use the correct values and repeat this step if necessary. Figure 72 The image file on the share The specified share has to be configured correctly. Therefore, administrative permissions are required. As a regular user you may not have these permissions. Either log in as a system administrator (or as root on UNIX systems) or ask your system administrator to complete this task. 132 Roamer KVM User Manual

149 Windows 2000/XP Sharing Images Open the Windows file explorer, navigate to the directory (or share) and click the right mouse button to open the context menu. Select Sharing to open the configuration dialog (Figure 73). Figure 73 Explorer Context Menu Roamer KVM User Manual 133

150 Sharing Images Adjust the settings for the selected directory, as shown in Figure 74. Figure 74 Share configuration dialog Activate the selected directory as a share. Select Share this folder. Choose an appropriate name for the share. You may also add a short description for this folder (input field Comment). If necessary, adjust the permissions (button Permissions). Click OK to set the options for this share. UNIX and UNIX-like OS (UNIX, Solaris, Linux) If you like to access the share via Samba, Samba has to be set up properly. You may either edit the Samba configuration file /etc/samba/smb.conf or use the Samba Web Administration Tool (SWAT) or WebMin to set the correct parameters. For more information, review the manual entry (man-entry) of smb.conf. 134 Roamer KVM User Manual

151 K Redirecting Drives Drive Redirection This appendix describes how to configure Drive Direction. Start by selecting Virtual Media > Drive Redirection. See Figure 75. Figure 75 Drive Redirection Drive Redirection Options As shown in Figure 75, you may enable the following options: Disable Drive Redirection - If enabled, Drive Redirection is switched off. Force read-only connections - If enabled, write support for Drive Redirection is switched off and it is not possible to write on a redirected device. Roamer KVM User Manual 135

152 Redirecting Drives Configuration Specify the parameters of the network connection (see Figure 76). Figure 76 Main View Device - This is the address (either the DNS name or the IP address) of the Roamer KVM to connect to. Port - This is the network port. By default, Roamer KVM uses the remote console port (443). You should change this value if you have changed the remote console port in your Roamer KVM s network settings. Secure Connection - Select this box to establish a secure connection via SSL. This maximizes security, but may reduce the connection speed. 136 Roamer KVM User Manual

153 Redirecting Drives Drive Selection Select the drive you would like to redirect. Refer to Figure 77. Figure 77 Selecting the desired drive All available devices (drive letters) are shown here. Note that the whole drive is shared with the remote computer, not only one partition. If you have a hard disk with more than one partition, all drive letters that belong to this disk are redirected. The Refresh button may be used to regenerate the list of drive letters, especially for an USB stick. Roamer KVM User Manual 137

154 Redirecting Drives Write Support You can enable write support on this screen, as shown in Figure 78. Figure 78 Selecting Write Support Write support means that the remote computer is allowed to write on your local drive. This can be very dangerous. If both the remote and the local system try to write data on the same device, this will certainly destroy the file system on the drive. Use this only if you know what you are doing and are aware of the risk involved. Warning: Write Support Use write support with extreme care. 138 Roamer KVM User Manual

155 Redirecting Drives Using Device Redirection To use the Drive Redirection, as shown in Figure 79, you must authenticate on the Roamer KVM using a valid username and password. You need permission to change the virtual disk configuration. Figure 79 Device Authentication Navigation Buttons Connect/Disconnect To establish the drive redirection, click the Connect button once. If all the settings are correct, the status bar displays that the connection is established, the Connect button is disabled, and the Disconnect button is enabled. On an error, the status line shows the error message. The drive redirection software tries to lock the local drive before it is redirected. That means that it tries to prevent the local operating system from accessing the drive as long as it is redirected. This may also fail, especially if a file on the drive is currently open. In the case of a locking failure, you are prompted to see if you want to establish the connection. This should not be a serious problem if the note above is respected. If write support is enabled, a drive which is not locked might be damaged by Drive Redirection. Click the Disconnect button to stop a Drive Redirection connection. Exit/Hide If the Exit button is pressed, the Drive Redirection software is closed. If a Drive Redirection connection is active, the connection is closed before the application terminates. Clicking the Hide to Tray button, hides the application, but does not terminate it. This means that an active connection is kept active until it is closed explicitly. You can access the software by its tray icon. The tray icon also shows whether a connection is established or not. Double-clicking the icon shows the application window, or right-clicking displays a shortcut menu (see Figure 80). Roamer KVM User Manual 139