Avocent AV Works Installation and maintenance instructions

590-257-001D
Installer/User Guide
For Technical Support:
Avocent Corporation
4991 Corporate Drive
Huntsville, Alabama 35805-6201 USA
Tel: [phone]
Fax: [phone]
Avocent International Ltd.
Avocent House, Shannon Free Zone
Shannon, County Clare, Ireland
Tel: [phone]
Fax: [phone]
Avocent Asia Pacific
Singapore Branch Office
100 Tras Street, #15-01
Amara Corporate Tower
Singapore 079027
Tel: [phone]
Fax: [phone]
Avocent Germany
Gottlieb-Daimler-Straße 2-4
D-33803 Steinhagen
Germany
Tel: [phone]
Fax: [phone]
Avocent Canada
20 Mural Street, Unit 5
Richmond Hill, Ontario
L4B 1K3 Canada
Tel: [phone]
Fax: [phone]
Email: [email protected]
www.avocent.com
AV Works®

INSTRUCTIONS
This symbol is intended to alert the user to the presence of important operating and
maintenance (servicing) instructions in the literature accompanying the appliance.
LIMITED WARRANTY
Avocent Corporation warrants to the original retail purchaser that this product is and will be free from defects
in materials and workmanship for a period of 24 months from the date of purchase.
Additionally, all Avocent products carry an unconditional thirty-day satisfaction guarantee. If, for any reason, you
are dissatisfied with the performance of this product, you may return it to the point of purchase for a refund of
the purchase price (excluding shipping charges). This guarantee does not apply to special order products, and
may not be available through all resellers. During the warranty period, purchaser must promptly call Avocent
for a RETURN MATERIALS AUTHORIZATION (RMA) number. Make sure that the RMA number appears on the
packing slip, proof of purchase, AND ON THE OUTSIDE OF EACH SHIPPING CARTON. Unauthorized returns
or collect shipments will be refused.
Ship prepaid to: Avocent Corporation
4991 Corporate Drive
Huntsville, AL 35805 U.S.A.
Telephone: [phone]
The above limited warranty is voided by occurrence of any of the following events, upon which the product is
provided as is, with all faults, and with all disclaimers of warranty identified below:
1. If defect or malfunction was caused by abuse, mishandling, unauthorized repair, or use other than intended.
2. If unauthorized modifications were made to product.
3. If unreported damages occurred in any shipment of the product.
4. If damages were due to or caused by equipment or software not provided by Avocent.
5. If the unit is used with non-grounded or incorrectly polarized AC power.
6. If the product is used in contradiction to any instruction provided by any User Guide or Instruction Sheet
provided to you or with the product.
7. If the product is damaged due to power surges, water exposure or act of God including lightning.
EXCEPT AS SPECIFICALLY PROVIDED ABOVE AND TO THE MAXIMUM EXTENT ALLOWED BY LAW,
AVOCENT CORPORATION DISCLAIMS ALL WARRANTIES AND CONDITIONS WHETHER EXPRESS,
IMPLIED, OR STATUTORY AS TO ANY MATTER WHATSOEVER INCLUDING, WITHOUT LIMITATION,
TITLE, NON-INFRINGEMENT, CONDITION, MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR OR
INTENDED PURPOSE.
EXCEPT AS EXPRESSLY PROVIDED ABOVE AND TO THE MAXIMUM EXTENT ALLOWED BY LAW, AVOCENT
CORPORATION SHALL NOT BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES
(INCLUDING WITHOUT LIMITATION, LOSS OF PROFIT, LOSS OF BUSINESS, LOSS OF INFORMATION,
FINANCIAL LOSS, PERSONAL INJURY, LOSS OF PRIVACY OR NEGLIGENCE) WHICH MAY BE CAUSED BY OR
RELATED TO, DIRECTLY OR INDIRECTLY, THE USE OF A PRODUCT OR SERVICE, THE INABILITY TO USE A
PRODUCT OR SERVICE, INADEQUACY OF A PRODUCT OR SERVICE FOR ANY PURPOSE OR USE THEREOF
OR BY ANY DEFECT OR DEFICIENCY THEREIN EVEN IF AVOCENT CORPORATION OR AN AUTHORIZED
AVOCENT DEALER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR LOSSES.
© 2004 Avocent Corporation. All rights reserved.

AVWorks®
Installer/User Guide
Avocent, the Avocent logo, The Power of Being There, AVWorks,
OSCAR, OutLook and AutoView are registered trademarks of Avocent
Corporation or its affiliates. All other marks are the property of their
respective owners.
© 2004 Avocent Corporation. All rights reserved.

iii
Table of Contents
List of Figures ................................................................................................................ vii
List of Tables ................................................................................................................... ix
Chapter 1: Product Overview.......................................................................................... 1
About AVWorks Software................................................................................................................... 1
Features and Benefits ........................................................................................................................ 1
System Components ........................................................................................................................... 2
Glossary ............................................................................................................................................. 3
Operating Features............................................................................................................................ 3
Keyboard navigation .................................................................................................................. 3
Device naming ............................................................................................................................ 3
Managing multiple connections.................................................................................................. 4
Chapter 2: Installation and Startup ................................................................................ 7
Getting Started................................................................................................................................... 7
Installing AVWorks Software............................................................................................................. 8
Updating AVWorks Software ............................................................................................................. 9
Uninstalling AVWorks Software ...................................................................................................... 10
Launching AVWorks Software ......................................................................................................... 10
Quick Setup ...................................................................................................................................... 11
Chapter 3: AVWorks Explorer....................................................................................... 13
About the AVWorks Explorer........................................................................................................... 13
Window Features ............................................................................................................................. 13
Customizing the window appearance ....................................................................................... 15
Adding an Appliance........................................................................................................................ 15
Managing Cached Credentials ........................................................................................................ 17
Accessing Appliances....................................................................................................................... 20
Accessing Devices............................................................................................................................ 20
Customizing Properties.................................................................................................................... 23
Viewing and changing general properties................................................................................ 23
Viewing and changing network properties ............................................................................... 24
Viewing and changing information properties......................................................................... 25
TABLE OF CONTENTS

iv AVWorks Installer/User Guide
Viewing connections properties................................................................................................26
Viewing and changing Telnet properties.................................................................................. 26
Customizing Options........................................................................................................................ 27
Viewing and changing general options .................................................................................... 27
Viewing and changing Telnet options ...................................................................................... 30
Managing Folders............................................................................................................................ 31
Assigning Units ................................................................................................................................ 31
Deleting............................................................................................................................................ 32
Renaming ......................................................................................................................................... 33
Managing Product Licenses ............................................................................................................ 34
Managing the AVWorks Software Database ................................................................................... 34
Saving and loading a database................................................................................................. 35
Exporting a database................................................................................................................ 35
Chapter 4: Video Viewer ................................................................................................ 37
About the Video Viewer ................................................................................................................... 37
Window Features ............................................................................................................................. 38
Adjusting the View ........................................................................................................................... 39
Additional video adjustment .....................................................................................................40
Specifying the Connection Speed..................................................................................................... 41
Adjusting Mouse Options................................................................................................................. 42
Cursor type ............................................................................................................................... 42
Scaling ...................................................................................................................................... 42
Alignment.................................................................................................................................. 43
Using Scan Mode ............................................................................................................................. 43
Using Macros................................................................................................................................... 45
Chapter 5: Serial Console Viewer................................................................................. 49
About the Serial Console Viewer ..................................................................................................... 49
Window Features ............................................................................................................................. 50
About Options .................................................................................................................................. 51
Customizing Preferences ................................................................................................................. 51
Customizing Session Properties....................................................................................................... 52
Using Login Scripts ......................................................................................................................... 54
Using Macros................................................................................................................................... 57

Table of Contents v
Using Logging.................................................................................................................................. 59
Moving Session Data ....................................................................................................................... 61
Using History Mode......................................................................................................................... 63
Chapter 6: AVR AMP...................................................................................................... 65
About the AVR AMP ........................................................................................................................ 65
Viewing Global General Settings .................................................................................................... 66
Viewing and Changing Global Network Settings ............................................................................ 66
Viewing and Changing Global Session Settings.............................................................................. 67
Managing User Accounts................................................................................................................. 67
Access levels ............................................................................................................................. 67
Locking and unlocking user accounts....................................................................................... 69
Managing User Sessions.................................................................................................................. 70
Viewing AVRIQ Module Information .............................................................................................. 71
Using SNMP .................................................................................................................................... 71
Managing SNMP traps .............................................................................................................73
Viewing Device Connection Information......................................................................................... 73
Resynchronizing the device list.................................................................................................74
Configuring Cascade Switch Connections ...................................................................................... 74
Viewing Switch and Module Version Information........................................................................... 75
Upgrading Firmware....................................................................................................................... 75
Upgrading AVR switch firmware .............................................................................................75
Upgrading AVRIQ module firmware........................................................................................ 76
Rebooting the Switch ....................................................................................................................... 77
Managing the Appliance Configuration Database .......................................................................... 77
Saving an appliance configuration database ........................................................................... 77
Restoring an appliance configuration database....................................................................... 78
Managing the Appliance User Database......................................................................................... 78
Saving an appliance user database .......................................................................................... 78
Restoring an appliance user database...................................................................................... 79
Chapter 7: CCM AMP ..................................................................................................... 81
About the CCM AMP ....................................................................................................................... 81
Viewing Global General Settings .................................................................................................... 82
Viewing and Changing Global Network Settings ............................................................................ 82
Viewing and Changing Global CLI Settings.................................................................................... 83

vi AVWorks Installer/User Guide
Configuring Global Authentication Settings.................................................................................... 84
Configuring Global Session Settings ............................................................................................... 85
Viewing and configuring SSH information............................................................................... 86
Managing User Accounts................................................................................................................. 87
Locking and unlocking user accounts....................................................................................... 90
Managing User Sessions.................................................................................................................. 91
Viewing and Changing Serial Port Parameters .............................................................................. 91
Configuring Port Alert Strings ........................................................................................................ 92
Viewing Port Statistics..................................................................................................................... 93
Using SNMP .................................................................................................................................... 94
Managing SNMP traps .............................................................................................................96
Viewing Device Connection Information......................................................................................... 96
Resynchronizing the device list.................................................................................................96
Viewing Firmware Revisions ........................................................................................................... 97
Upgrading Firmware....................................................................................................................... 97
Rebooting the Appliance .................................................................................................................. 98
Managing an Appliance Configuration Database........................................................................... 98
Saving an appliance configuration database ........................................................................... 98
Restoring an appliance configuration database....................................................................... 99
Managing an Appliance User Database.......................................................................................... 99
Saving an appliance user database ........................................................................................ 100
Restoring an appliance user database.................................................................................... 100
Appendices................................................................................................................... 101
Appendix A: Keyboard and Mouse Shortcuts ................................................................................ 101
Appendix B: Sun Advanced Key Emulation ................................................................................... 103
Appendix C: Serial Console Viewer Terminal Emulation ............................................................. 105
Appendix D: Ports Used by AVWorks Software ............................................................................ 120
Appendix E: Technical Support ..................................................................................................... 121
Index.............................................................................................................................. 123

vii
List of Figures
Figure 3.1: Explorer Window Areas................................................................................................ 14
Figure 3.2: Credential Caching Levels and Default Settings.......................................................... 18
Figure 4.1: Video Viewer Window .................................................................................................. 38
Figure 4.2: Manual Video Adjust Dialog Box ................................................................................. 41
Figure 5.1: Serial Console Viewer Window .................................................................................... 50
LIST OF FIGURES

viii AVWorks Installer/User Guide

ix
List of Tables
Table 3.1: Explorer Window Areas ................................................................................................. 14
Table 4.1: Video Viewer Window Areas.......................................................................................... 39
Table 4.2: Manual Video Adjust Dialog Box Areas ........................................................................ 41
Table 5.1: Serial Console Viewer Window Areas............................................................................ 51
Table 5.2: CCM Appliance Default Values ..................................................................................... 56
Table 6.1: AVR Switch Access Levels.............................................................................................. 68
Table 7.1: CCM Appliance Access Levels ....................................................................................... 87
Table A.1: Divider Pane Keyboard and Mouse Shortcuts............................................................. 101
Table A.2: Tree View Control Keyboard and Mouse Shortcuts .................................................... 101
Table A.3: Unit List Keyboard and Mouse Operations ................................................................. 102
Table B.1: Sun Key Emulation....................................................................................................... 103
Table C.1: VT100+ Function Key Support.................................................................................... 105
Table C.2: VT102 Receive Codes ..................................................................................................106
Table C.3: VT100 Special Keys and Control Keys ........................................................................ 106
Table C.4: VT100 ANSI Set and Reset Mode Cursor Keys ........................................................... 108
Table C.5: VT100 PF1 through PF4 Key Definitions ................................................................... 108
Table C.6: VT100 ANSI Mode Control Sequences ........................................................................ 108
Table C.7: VT220 Encoding .......................................................................................................... 112
Table C.8: VT220 Decoding .......................................................................................................... 113
Table C.9: VT52 Encoding ............................................................................................................ 115
Table C.10: VT52 Decoding .......................................................................................................... 115
Table C.11: VT320 Encoding ........................................................................................................ 116
Table C.12: VT320 Decoding ........................................................................................................ 117
Table D.1: Ports Used by AVWorks Software ............................................................................... 120
LIST OF TABLES

xAVWorks Installer/User Guide

1
CHAPTER
1Product Overview
About AVWorks Software
The AVWorks cross-platform management application allows you to view and control network
appliances and attached devices. The cross-platform design ensures compatibility with most
popular operating systems and hardware platforms. Each appliance handles authentication and
access control individually, placing system control at the point of need.
AVWorks software utilizes browser-like navigation with an intuitive split-screen interface,
providing you with a single point of access for all your appliances. Use AVWorks software to
manage your existing appliances, install a new device or launch a session to a device. Built-in
groupings such as Devices, Sites and Folders provide an easy way to select the units to view.
Powerful search and sort capabilities allow you to quickly find any unit.
Features and Benefits
Easy to install and configure
AVWorks software is designed for easy installation and operation. Auto-discovery of appliances
lets you deploy new equipment in minutes. Wizard-based installation and online help simplify
initial system configuration. The intuitive graphical interface makes managing and updating simple
and straightforward.
Powerful customization capabilities
Tailor AVWorks software to fit your specific system needs. Take advantage of built-in groups or
create your own. Customize unit and field names, icons and macros for maximum flexibility and
convenience. Using names that are meaningful to you makes it easy to quickly find any device.
Extensive appliance management
AVWorks software allows you to add and manage multiple appliances in one system. Once a new
appliance is added, you may configure operating parameters, control and preempt user sessions to
devices and execute numerous control functions, such as rebooting and upgrading your appliance.
From the intuitive Appliance Management Panel (AMP), you may enable Simple Network
Management Protocol (SNMP) traps, configure target devices and manage user databases.

2AVWorks Installer/User Guide
Appliance-based authentication
User authentication and access control are appliance-based. After users successfully log in to an
appliance, you may configure the AVWorks software to cache their credentials for the duration of
the AVWorks software session.
System Components
AVWorks software contains the following major components.
AVWorks Explorer
The AVWorks Explorer is the primary point of control for accessing AVWorks software features
and functionality. It is the main Graphic User Interface (GUI) that appears when AVWorks
software is launched. From the Explorer, you may easily view the appliances and devices defined
in the local database. Built-in groupings such as Appliances and Devices provide an easy way to
list units. You may create custom groups of units by adding custom folders. Other groupings are
also available, based on custom fields that may be assigned to units.
From AVWorks Explorer, you may select a device from a Unit list, then click an icon to launch a
session to it. You may also select an appliance, then click an icon to launch management and
control functions.
Video Viewer
The Video Viewer allows you to control the keyboard, monitor and mouse functions of individual
devices. You may use predefined macros and create new macros for the device. The Video Viewer
may be launched to devices on the following switches:
• AutoView®1000R/2000R switches
Serial Console Viewer
The Serial Console Viewer allows you to establish serial sessions with individual devices that support
Telnet. You may tailor user preferences for all sessions, as well as session properties for each device.
The Serial Console Viewer offers a separate history mode to review session data, a scripting function
for automatic device login and a logging function for saving session data to a file. Appliance settings
indicate whether Secure Shell (SSH) or plain text (non-encrypted) sessions (or both) are allowed. The
Serial Console Viewer may be launched to devices on the following appliances:
• Equinox CCM console management appliances
• Generic appliances
Appliance Management Panels (AMPs)
Each AMP is implemented as a Network Management Module (NMM) that supports an appliance
type. An AMP contains a tabbed pane; each tab represents a top-level function category for the
appliance. For example, the AMP tabs may be Settings, Status and Tools. The number and content
of tabbed panes differs for each appliance/switch.

Chapter 1: Product Overview 3
AVWorks software contains the following AMPs:
• AVR - supports AutoView 1000R/2000R switches
• CCM - supports Equinox CCM console management appliances
Generic Appliance NMM
AVWorks software supplies a Generic Appliance NMM. This module provides support for browser
and Telnet sessions to generic devices such as a Cisco router. If the appliance supports SNMP,
AVWorks software can discover it; otherwise, it may be added manually. Depending on the
support offered, an appliance may be accessed using the Serial Console Viewer, a browser or a
third party Telnet client.
Glossary
The following words are used throughout this documentation:
• Appliance - Equipment that provides KVM or serial over IP connectivity to attached devices
• Device - Data center equipment such as a server, router or power management device, which is
attached to an appliance
• Unit - Includes appliances and devices; this term is used when a discussion applies to either or both
• Explorer - Indicates the AVWorks Explorer.
Operating Features
Keyboard navigation
Keyboard and Mouse Shortcuts on page 101 lists the Explorer navigation shortcuts. Other AVWorks
software components also support full keyboard navigation in addition to mouse operations.
Device naming
AVWorks software requires that each appliance and device have a unique name. To minimize the
need for operator intervention, AVWorks software uses the following procedure to generate a
unique name for a device whose current name conflicts with another name in the database.
During background operations (such as an automated operation that adds or modifies a name or
connection), if a name conflict occurs, the conflicting name will automatically be made unique.
This will be done by appending a tilde (~) followed by an optional set of digits. The digits are
added in cases where adding the tilde alone does not make the name unique. The digits start with a
value of one and are incremented until a unique name is created.
During user operations, if a user specifies a non-unique name, a message will inform the user that a
unique name is required.
Device name displays
When an appliance is added, the device names retrieved from the appliance are stored in the
AVWorks software database. The operator may then rename a device in the Explorer, and the new

4AVWorks Installer/User Guide
name will be stored in the database and used in various AVWorks component screens. This new
device name will not be communicated to the appliance.
Since AVWorks software is a decentralized management system, the name assigned to a device on
the appliance may be changed at any time without updating the AVWorks software database. This
feature allows each operator to customize a particular AVWorks software view of the list of
devices being managed.
Since there may be more than one name associated with a single device - one on the appliance and
one in AVWorks software - AVWorks software uses the following rules to determine which name
is displayed:
• The Explorer will only show the devices listed in its database, with the name specified in the
database. In other words, the Explorer will not talk to the appliance to obtain device information.
• The AMP will display information retrieved from the appliance, except where noted.
• The Resync Wizard (which is used to resynchronize device lists in the AMP) will overwrite
locally-defined device names only if the appliance device name has been changed from the
default value. Non-default device names that are read from the appliance during a resynchroni-
zation are allowed to override the locally-defined names.
Sorting
In certain displays, an AVWorks software component will display a list of items with columns of
information about each item. If a column header contains an arrow, you may sort the display by that
column in ascending or descending order.
To sort a display by a column header:
Click the arrow in a column header. The items in the list will be sorted according to that column.
An upward-pointing arrow indicates the list is sorted by that column header in ascending order. A
downward-pointing arrow indicates the list is sorted by that column header in descending order.
Managing multiple connections
A device that has connections to more than one appliance managed by AVWorks software will
usually appear as two different devices in the AVWorks Explorer when appliances are initially
discovered. For example, a server may have a serial console port connected to a CCM appliance,
which is used during the boot process. The same server may also have a KVM connection to an
AVR switch that is accessible after the server is up and running.
You may configure such a device to appear only once, and the Explorer will then provide the valid
connection methods for accessing the device (for example, the Connect Video and Connect Serial
task buttons).
To rename the device locally:
1. Using the CCM appliance serial CLI , issue a Port Set command with the Name parameter.
-or-
Using the AVR OSCAR®interface, configure the device name with the Names dialog box.

Chapter 1: Product Overview 5
For example, if you want the server connection to the CCM appliance to have the same name
as its AVR switch connection, change the name using the CCM appliance serial CLI.
2. Resynchronize the device list in the appropriate AMP. For more information, see Resynchro-
nizing the device list on page 74 for the AVR AMP and Resynchronizing the device list on
page 96 for the CCM AMP.
For example, if you changed the server name on the CCM appliance, resynchronize the device
list in the CCM AMP.
See the respective installer/user guides for complete command information.

6AVWorks Installer/User Guide

7
CHAPTER
2Installation and Startup
Getting Started
Before installing AVWorks software, refer to the following lists to ensure that you have all the
items necessary for proper installation.
Supplied with AVWorks software
• AVWorks software CD
• AVWorks Installer/User Guide
• Download instructions
Supported operating systems
• Microsoft®Windows®2000 Server and Workstation
• Microsoft Windows NT®4.0 Server and Workstation
• Microsoft Windows XP (Home and Professional)
• Red Hat Linux®7.3, 8.0 and 9.0
•Sun
®Solaris™ 8.0 and 9.0
Hardware configuration requirements
AVWorks software is supported on the following minimum PC hardware configurations:
• 500 MHz Pentium III
• 256 MB RAM
• 10 or 100 BaseT NIC
• XGA video with graphics accelerator
• Desktop size must be a minimum of 800 x 600
• Color palette must be a minimum of 65,536 (16-bit) colors
AVWorks software is supported on the following minimum Sun hardware configurations:
• 333 MHz Pentium Ultra SPARC-IIi
• 256 MB RAM

8AVWorks Installer/User Guide
• 10BaseT or 100BaseT NIC
• Video card with graphics accelerator
• Desktop size must be a minimum of 800 x 600
• Color palette must be a minimum of 65,536 (16-bit) colors
Browser requirements
Internet Explorer 5.0 or higher (Windows only)
-or-
Netscape 6.0 or higher
-or-
Mozilla™ 1.4 or higher
Installing AVWorks Software
To install on Microsoft Windows operating systems:
1. Insert the AVWorks software CD-ROM into your CD-ROM drive. If AutoPlay is supported
and enabled, the setup program will start automatically.
-or-
If your system does not support AutoPlay, set the default drive to your CD-ROM drive letter
and execute the following command to start the install program (replace drive with your CD-
ROM drive letter):
drive:\AVWorks\win32\setup.exe
2. Follow the on-screen instructions.
To install on Red Hat Linux operating systems:
1. Insert the AVWorks software CD-ROM into your CD-ROM drive. If AutoMount is supported
and enabled, open a command window and continue with step 2.
-or-
If your system does not support AutoMount, issue the following command to mount the CD-
ROM volume:
mount -t iso9660 -ro mode=0555 <unit> <mount point>
Replace <unit> with the name of the CD-ROM on your machine and <mount point> with the
name of the desired mount point. For example, to mount a CD-ROM which is the second IDE
unit on /mnt/cdrom, execute the command:
mount -t iso9660 -ro mode=0555 /dev/cdrom /mnt/cdrom
2. Change to the root directory on the CD. For example:
cd /mnt/cdrom
3. Enter the following command to start the install program:
sh ./AVWorks/linux/setup.bin
4. Follow the on-screen instructions.