For Technical Support: www.avocent.
FCC Warning Statement The Cyclades ACS advanced console server has been tested and found to comply with the limits for Class A digital devices, pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment.
Cyclades® ACS 6000 Advanced Console Server Command Reference Guide Avocent, the Avocent logo, The Power of Being There, DSView and Cyclades are registered trademarks of Avocent Corporation or its affiliates in the US and other countries. All other marks are the property of their respective owners. © 2008 Avocent Corporation.
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. Dangerous Voltage This symbol is intended to alert the user to the presence of uninsulated dangerous voltage within the product’s enclosure that may be of sufficient magnitude to constitute a risk of electric shock to persons. Power On This symbol indicates the principal on/off switch is in the on position.
iii T A B L E O F C ON T E N T S Table of Contents List of Tables .................................................................................................................. vii Chapter 1: Introduction, Navigation and Commands ................................................... 1 Access Options and How to Log Into the CLI ................................................................................... 3 Configuration Tasks Performed With the CLI ..................................................
iv Cyclades ACS 6000 Advanced Console Server Command Reference Guide killuser ...................................................................................................................................... 14 sendmsg..................................................................................................................................... 14 inspectdbuf................................................................................................................................
Table of Contents v Overview Options ............................................................................................................................ 49 Information Options......................................................................................................................... 50 Active Sessions Information............................................................................................................. 53 Power Management Options ....................................
vi Cyclades ACS 6000 Advanced Console Server Command Reference Guide
vii LIST OF TABLES List of Tables Table 1.1: ACS 6000 Advanced Console Server Port Descriptions .................................................. 2 Table 2.1: Port Access and Configuration Tasks ............................................................................ 19 Table 2.2: Topology Parameters ..................................................................................................... 20 Table 3.1: Global Settings Options................................................................
viii Cyclades ACS 6000 Advanced Console Server Command Reference Guide
1 CHAPTER 1 Introduction, Navigation and Commands The Cyclades ACS 6000 advanced console server is a 1U appliance that serves as a single point for access and administration of connected devices, such as target device consoles, modems and power devices. ACS 6000 console servers support secure remote data center management and out-of-band management of IT assets from any location worldwide.
2 Cyclades ACS 6000 Advanced Console Server Command Reference Guide 1 2 4 3 5 Figure 1.1: ACS 6000 Advanced Console Server Ports Table 1.1: ACS 6000 Advanced Console Server Port Descriptions Number Description 1 Serial Port 1 NOTE: Serial ports are also referred to with tty device names, such as ttSy1, ttyS2 and so forth.
Chapter 1: Introduction, Navigation and Commands 3 Access Options and How to Log Into the CLI The CLI utility can be accessed in the following ways: • Through a local terminal or a computer that has a terminal emulation program connected to the console port of the console server with session settings of 9600, 8, N and 1, with no flow control.
4 Cyclades ACS 6000 Advanced Console Server Command Reference Guide For example, in the Web Manager, user configuration is done when an administrator selects Appliance Settings - Users - Local Accounts - User Names to get to the User Names screen. To navigate to the equivalent configuration level in the CLI, an administrator would navigate in the CLI with the cd command followed by the path: cd appliance_settings/users/local_accounts/ user_names.
Chapter 1: Introduction, Navigation and Commands 5 A prompt like the following appears at each level: --:- appliance_settings cli-> NOTE: CLI commands are case sensitive. At any level, you can press Tab Tab at the prompt to see the commands that can be entered at the current level.
6 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Parameters Some CLI commands take parameters. If you press Tab Tab after a command that requires a parameter, you are prompted to enter the parameter. Command Line Syntax NOTE: Square brackets ([ ]) denote an optional element. Each element is separated by a space. There are no spaces between sub-elements.
Chapter 1: Introduction, Navigation and Commands | : or () : group CLI Command Set NOTE: Most of the commands work from any location when the path to the command parameter is included. NOTE: The word “node” refers to an entity such as a route, host or user, which can be added, configured or deleted. help Generate a help message about how to navigate the CLI.
8 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Syntax: --:- units cli-> add Example: --:- units cli-> add appliance_settings/network/hosts --:#- [hosts] cli-> delete Delete a node. Syntax: --:- units cli-> delete cd Change directory (level). Syntax: --:- units cli-> cd Example: --:- units cli-> cd topology Displays the following: --:- topology cli-> Example: --:- topology cli-> cd .. -or--:- topology cli-> cd ..
Chapter 1: Introduction, Navigation and Commands 9 --:- overview cli-> pwd Display the path to the current level (print working directory). Syntax: --:- units cli-> pwd connect Connect to a serial or auxiliary port.
10 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Password: -orType the hotkey to suspend the connection: Ctrl + z share Connect to a serial or auxiliary port as an additional, read/write user.
Chapter 1: Introduction, Navigation and Commands 11 NOTE: You must log into the CLI as root to have full control over the local directory path. All normal FTP commands apply. scp Perform a secure shell copy. Syntax: --:- units cli-> scp [[user@]host1:]file1 [...] [[user@]host2:]file2 set Set a parameter. Syntax: --:- units cli-> set = After a parameter has been changed using the set command, a pair of asterisks appear at the beginning of the CLI prompt.
12 Cyclades ACS 6000 Advanced Console Server Command Reference Guide show/ls Show the available directories, commands or parameters at the current location.
Chapter 1: Introduction, Navigation and Commands 13 --:- units cli-> cd power_management/management//outlet_table --:- outlet_table cli-> [cycle|on|off|lock|unlock]
14 Cyclades ACS 6000 Advanced Console Server Command Reference Guide FOOD HUGH SKI ALMA LURK BRAD Special Multi-session Commands The following commands require navigation to an enabled and configured port to which one or more users are simultaneously connected. To get to the port, enter the following command. --:- units cli-> cd topology/ listuser List the users connected to the shared serial port.
Chapter 1: Introduction, Navigation and Commands 15 --:- units cli -> inspectdbuf overview/appliance_data_logging The following commands are available for inspectdbuf: • Return - Scroll forward one line. • Ctrl + F - Scroll forward one window. • Ctrl + B - Scroll backward one window. • /pattern - Search foward in the file for the first line containing the pattern. • ?pattern - Search backward in the file for the first line containing the pattern. • n - Repeat the search. • q - Quit.
16 Cyclades ACS 6000 Advanced Console Server Command Reference Guide CLI Equivalent Actions to Web Manager Checkbox Selection NOTE: The following example procedure, which configures IPv6, illustrates the actions to use in the CLI to enable or disable an option when a checkbox would be selected or deselected in the Web Manager. To configure IPv6 (example of how to perform the equivalent of Web Manager checkbox selection/deselection): 1. Log into the CLI and enter cd appliance_settings/network/ip.
Chapter 1: Introduction, Navigation and Commands [X] get_domain_from_dhcpv6 8. Enter commit.
18 Cyclades ACS 6000 Advanced Console Server Command Reference Guide
19 CHAPTER 2 Port Access and Configuration Examples By default, all serial ports and the AUX/Modem port are disabled. The administrator must enable and configure the ports before anyone can use them. Configuration of ports differs based on the type of connected device, which can be either a device console, a PDU or modem. By default, all users can access all enabled and configured ports.
20 Cyclades ACS 6000 Advanced Console Server Command Reference Guide View Information About the Console Server and Connected Devices When a regular user or an administrator enters show at the Topology level, information about the following appears in the format shown in Table 2.2: • The console server • The AUX/Modem port (if it is enabled and configured with the Dial-In Profile) • The serial ports that user is authorized to access (if they are configured with the CAS or Power Profile) Table 2.
Chapter 2: Port Access and Configuration Examples 21 Table 2.2: Topology Parameters (Continued) Field Description For Outlets NOTE: Enter cd /outlets and enter show to see list of outlets and the actions that can be taken (commands that can be executed) for each outlet as shown below.
22 Cyclades ACS 6000 Advanced Console Server Command Reference Guide name: myPDU port: 3/1 type: PM20i|30A status: 3|20 action: 77-77-70-p-1/ 77-77-70-p-2/ myPDU/ --:- topology cli-> Connect to a Device Console Connected to a Serial Port The following procedure is an example of how an administrator or an authorized user can connect to a device console when the device is connected to a port that is enabled and configured with the CAS Profile.
Chapter 2: Port Access and Configuration Examples 23 Last login: Tue Oct 2 13:09:04 2007 on :0 Linux fremont-techpubs 2.6.15-28-386 #1 PREEMPT Wed Jul 18 22:50:32 UTC 2007 i68 6 GNU/Linux # Manage Power for a Device Connected to an Outlet on a PDU See power_cycle, power_off and power_on on page 12 for how an administrator or any authorized user can manage power on PDU outlets when the PDU is connected to a port that is enabled and configured with the Power Profile.
24 Cyclades ACS 6000 Advanced Console Server Command Reference Guide 8. Enter set port_settings/serial_profile=cas then enter commit as shown to assign the CAS profile and save the settings. --:- port_settings cli-> set port_settings/ serial_profile=cas **:- port_settings cli-> commit --:- port_settings cli-> 9. Enter set port_settings/status=enabled, then enter commit and show as shown to enable the configured port, save the settings and verify the configuration.
Chapter 2: Port Access and Configuration Examples 6. 25 Type set port_settings/ then press Tab to view the options for the Port_Settings parameter. --:- port_settings cli-> set port_settings/ rj45_pin-out status serial_profile 7. Enter set port_settings/ status=enabled serial_profile=power then enter commit to set the Serial_Profile to Power, enable the port and commit the changes. --:- port_settings cli-> set port_settings/ status=enabled serial_profile=power **:- port_settings cli-> commit 8.
26 Cyclades ACS 6000 Advanced Console Server Command Reference Guide
27 CHAPTER 3 CLI Appliance Settings Options This chapter describes the Appliance Settings options. Only administrators and authorized users can access the appliance_settings level. These procedures assume you have logged into the CLI as an administrator and are at the --:- units cli-> prompt. NOTE: In the tables that show output from the show command, when an option that is followed by an equal sign (=) is left blank, that option is not assigned a value by default.
28 Cyclades ACS 6000 Advanced Console Server Command Reference Guide See Table 3.1 through Table 3.13 for options available at each level and their default settings, where applicable. Parameters with an X beside them were selected, either as the default or from the previous configuration. Appliance_Settings/Global_Settings 1. Enter cd appliance_settings/global_settings to navigate to the Global Settings level. --:- units cli-> cd appliance_settings/global_settings 2.
Chapter 3: CLI Appliance Settings Options Table 3.
30 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Table 3.2: Network Options (Continued) Network Navigation Tree [X] enable_ipv6 (enabled by default) [ ] get_dns_from_dhcpv6 [ ] get_domain_from_dhcpv6 devices eth0 settings status=enabled/disabled (*) ipv4_method (*) dhcp ( )static address: nnn.nnn.nnn.nnn mask: nnn.nnn.nnn.
Chapter 3: CLI Appliance Settings Options Table 3.2: Network Options (Continued) Network Navigation Tree mask: nnn.nnn.nnn.
32 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Table 3.2: Network Options (Continued) Network Navigation Tree domain = corp.avocent.com (default) hostname = ACS60xx-1357908642 (default) hosts 127.0.0.1 ip = 127.0.0.1 hostname = localhost alias = (null) IPv6 IPv4 addresses are always enabled. An administrator can also enable IPv6 addresses at the appliance_settings/network/ipv6 level.
Chapter 3: CLI Appliance Settings Options --:- settings cli-> show Hosts The following procedure describes how to add a host to the hosts table. To add a host to the host table: 1. Enter cd appliance_settings/network/hosts to navigate to the Hosts level. --:- units cli-> cd appliance_settings/network/hosts 2. Enter show to view the current host settings. --:- hosts cli-> show 127.0.0.1 ip: 127.0.0.1 hostname: localhost alias: 127.0.0.1/ 3. Type add then press Return.
34 Cyclades ACS 6000 Advanced Console Server Command Reference Guide alias: 127.0.0.1/add 172.26.31.164/ 7. Enter cd /settings to navigate to the level where you can perform additional configuration of the host entry. --:- hosts cli-> cd 172.26.31.164/settings 8. Enter show to view the additions to the host table and the Settings option. --:- 172.26.31.164 cli-> show ip: 172.26.31.
Chapter 3: CLI Appliance Settings Options ( ) static address = prefix_length = gateway = (*) ipv6_address_unconfigured mac address: 00:e0:86:0c:49:7a dns: primary = 172.26.29.4 dns: primary = 172.26.29.4 secondary = domain = corp.avocent.
36 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Appliance_Settings/Ports Enter cd appliance_settings/ports to navigate to the Ports level. --:- units cli-> cd appliance_settings/ports Table 3.
Chapter 3: CLI Appliance Settings Options 37 Table 3.3: Ports Options (Continued) Ports Navigation Tree ppp_connection = ppp|pap_authentication = devices secure_dial-in callback_users ppp_otp_users power_profile login devices outlet_group To enable and assign the Serial profile to a serial port: 1. Enter cd appliance_settings/ports/physical_ports/serial_ports//port_settings to navigate to the ports_settings level. Port 3 is used in the example.
38 Cyclades ACS 6000 Advanced Console Server Command Reference Guide --:- port_settings cli-> set port_settings/ status=enabled serial_profile=cas **:- port_settings cli-> commit --:- port_settings cli-> To enable and configure the AUX/Modem port: 1. Enter cd appliance_settings/ports/physical_ports/auxiliary_ports/ttym1/ aux_port_settings to navigate to the aux_port_settings level.
Chapter 3: CLI Appliance Settings Options --:- units cli-> cd appliance_settings/ports/dial-in_profile -or--:- units cli-> cd appliance_settings/ports/power_profile Appliance_Settings/Pluggable Devices Enter cd appliance_settings/pluggable_devices to navigate to the pluggable_devices level. --:- units cli-> cd appliance_settings/pluggable_devices Table 3.
40 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Table 3.
Chapter 3: CLI Appliance Settings Options 41 Table 3.6: Authentication Options (Continued) Authentication Navigation Tree tacacs+ ldap(s)/ad kerberos nis dsview Appliance_Settings/Users Enter cd appliance_settings/users to navigate to the users level. --:- Units cli-> cd appliance_settings/users Table 3.
42 Cyclades ACS 6000 Advanced Console Server Command Reference Guide --:- user_names cli-> add --:#- [user_name] cli-> set user_information/ user_name=fred password=smith123abc confirm_password=smith123abc --:#- [user_names] cli-> 3. Enter save. --:#- [user_names] cli-> save 4. Enter show to verify that the new user has been added. --:#- [user_names] cli-> show Appliance_Settings/Syslog Enter cd appliance_settings/syslog to navigate to the syslog level.
Chapter 3: CLI Appliance Settings Options NOTE: To set a rule, you must enable the interface, set the rule for the interface and physically connect the interface to the network. Table 3.9: Firewall Options Firewall Navigation Tree ipv4_filter_table input forward output ipv6_filter_table input forward output Appliance_Settings/IPSec(VPN) Enter cd appliance_settings/ipsec(vpn) to navigate to the ipsec(vpn) level. --:- units cli-> cd appliance_settings/ipsec(vpn) Table 3.
44 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Table 3.10: IPSec(VPN) Options (Continued) IPSec(VPN) Navigation Tree ip_address = next_hop = subnet = ipsec(vpn)_authentication authentication_method ( ) rsa_key remote_side_rsa = local_side_rsa = ( ) secret pre-shared_secret = Appliance_Settings/SNMP Enter cd appliance_settings/snmp to navigate to the snmp level. --:- units cli-> cd appliance_settings/snmp Table 3.
Chapter 3: CLI Appliance Settings Options Table 3.11: SNMP Options (Continued) SNMP Navigation Tree ( ) version v1/v2 ipv6 source ( ) version v3 authentication_type md5 sha authentication_pass_phrase des_pass_phrase minimum_authentication_level no_auth suth priv Appliance_Settings/Date and Time Enter cd appliance_settings/date_and_time to navigate to the date_and_time level. --:- units cli-> cd appliance_settings/date_and_time Table 3.
46 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Table 3.
Chapter 3: CLI Appliance Settings Options Table 3.13: Boot Configuration Options Boot_Configuration Navigation Tree boot_configuration (*) flash (*) image_1 ( ) image_2 ( ) network appliance_ip_address= tftp_server_ip= filename= watchdog_timer eth0_mode= eth1_mode= console_speed= Appliance_Settings/Online Help Enter cd appliance_settings/online_help to navigate to the online_help level.
48 Cyclades ACS 6000 Advanced Console Server Command Reference Guide
49 CHAPTER CLI Overview, Information, Active Sessions and Power Management Options 4 This section provides procedures for some tasks that the administrator can perform at the following levels of the CLI. Table 4.1: Ports Menu Options Level Use this option to: Overview Reboot, save and restore configuration files. Information View information about the console server configuration. Active Sessions View information about active sessions.
50 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Table 4.2: Overview Commands (Continued) Command Description or Field save configuration Save configuration according to the following parameters. ftp site FTP site parameters listed below. ip address IP address of the FTP site. username Username on the FTP site. password User password on the FTP site. path and filename Path to the storage directory and the filename of the configuration file.
Chapter 4: CLI Overview, Information, Active Sessions and Power Management Options 3. Enter cd to view any of the options. 4. Enter show to view the list of available parameters. 51 This procedure continues down the hierarchical levels. See Table 4.3 for the options and and their default settings. Table 4.
52 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Table 4.
Chapter 4: CLI Overview, Information, Active Sessions and Power Management Options Active Sessions Information The Active Session information fields are described in Table 4.4. An authorized user can kill an active session with the Kill command. Table 4.
54 Cyclades ACS 6000 Advanced Console Server Command Reference Guide --:- active_sessions cli-> kill 37 Power Management Options The Power Management Options are described in Table 4.5. Table 4.5: Power Management Options Descriptions Option Description settings Allows an authorized user to reboot, restore factory default settings or to rename PDU(s).
55 APP ENDICE S Appendices Appendix A: Enabling Firmware Upgrades When the Boot Image is not in Flash To enable firmware upgrades when the boot image is not in Flash: 1. Connect to the console of the console server as root. CLI 2.0 (2007-10-04T08:11-0700) --:- units cli-> 2. Enter shell. A warning appears followed by the root prompt. --:- units cli-> shell WARNING: Improper use of shell commands could lead to data loss, the deletion of important system files or other unexpected result.
56 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Appendix B: Technical Support Our Technical Support staff is ready to assist you with any installation or operating issues you encounter with your Avocent product. If an issue should develop, follow the steps below for the fastest possible service. To resolve an issue: 1. Check the pertinent section of this manual to see if the issue can be resolved by following the procedures outlined. 2. Visit www.avocent.
57 INDE X Index A E access options (CLI) 3 enable ports 37 add command 7 exit command 10 Appliance Settings options 27 autocompletion 5 AUX/Modem port configure 19 enable 38 C F ftp command 10 H help command 7 I CAS Profile 20, 22 cd command 8 cleandbuf command 15 CLI utility access options 3 introduction 1 Information options 50 inspectdbuf command 14 K killuser command 14 log in 3 L navigation 4 listuser command 14 command line syntax 6 lock command 12 command set 7 ls command 12 c
58 Cyclades ACS 6000 Advanced Console Server Command Reference Guide on command 12 power_off command 12 opiepasswd command 13 power_on command 12 outlet groups 54 pwd command 9 Overview options 49 P Q quit command 10 parameters 6 passwd command 13 R PC cards, configure 39 revert command 11 PDUs S AUX/Modem port connection 2 manage power on outlets 19 manage power, procedure 24 ports for 1 scp command 11 sendmsg command 14 serial ports configuration 19 power management and configuration op
FCC Warning Statement The Cyclades ACS advanced console server has been tested and found to comply with the limits for Class A digital devices, pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment.
For Technical Support: www.avocent.