CYCLADES™ ACS 6000 Command Reference Guide
FCC Warning Statement The Cyclades™ ACS 6000 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 Command Reference Guide Avocent, the Avocent logo, The Power of Being There, Cyclades and DSView are trademarks or registered trademarks of Avocent Corporation or its affiliates in the U.S. and other countries. All other marks are the property of their respective owners. © 2011 Avocent Corporation.
Symbols Used NOTE: The following symbols may appear within the documentation or on the appliance. 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.
ii TA B LE OF C ON TE N TS Introduction, Navigation and Commands Access Options and How to Log Into the CLI 1 2 Configuration Tasks Performed With the CLI 3 CLI Navigation 4 Autocompletion 5 Parameters 6 Command Line Syntax 6 CLI Command Set Commands Used for the CLI 9 9 help 9 add 10 delete 10 cd 10 pwd 11 connect 11 sniff 11 share 12 disconnect 12 exit/quit 12 ftp 12 scp 13 set 13 commit 13 revert 13 ls 14 show 14 list_configuration 14 cycle, on, off, lo
iii Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide wiz Special Multi-session Commands 17 17 list_shared_session 17 kill_shared_session 17 sendmsg 17 show_databuf and show_appliance_databuf 18 cleandbuf and clean_appliance_databuf 18 CLI Equivalent Actions to Web Manager Checkbox Selection Port Access and Configuration Examples View Information About the Console Server and Connected Devices 19 21 22 Connect to a Device Console Connected to a Serial Port 24 Accessing Seri
Table of Contents Network/SNMP Wiz command Ports iv 39 39 40 Auxiliary ports 43 Pluggable Devices 44 Authentication 45 Users 45 Syslog 46 Events_and_Logs 47 Power Management 48 Active Sessions Information 49 Appendix A: Enabling Firmware Upgrades When the Boot Image is not in Flash 51 Appendix B: Migration CLI 53 Appendix C: Su and Sudo Commands 59 Appendix D: Technical Support 63
v Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide
1 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. Console servers support secure remote data center management and out-ofband management of IT assets from any location worldwide.
2 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Figure 1.1: Console Server Ports Table 1.1: Console Server Port Descriptions Number Description Serial Port 1 1 NOTE: Serial ports are also referred to with tty device names, such as ttSy1, ttyS2 and so forth. 2 Eth1 (eth1) 3 Eth0 (eth0) AUX/Modem Port (ttyM1 or ttyA1) 4 5 NOTE: If an internal modem is ordered and factory installed, this port is configured internally as a modem port.
Chapter 1: Introduction, Navigation and Commands 3 • 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 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 use the cd command followed by the path: cd /users/local_accounts/user_names.
Chapter 1: Introduction, Navigation and Commands 5 --:- / cli-> cd system_tools A prompt like the following appears at each level: --:- system_tools 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 --:- / cli-> cd access If you then press Enter, you are changed to the access level, and the access level prompt appears. --:- access cli-> The following example illustrates a case when more than one command matches the letters typed. --:- / cli-> sh shell show 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.
Chapter 1: Introduction, Navigation and Commands Section_Label Param_Label Value_text := labels or data from the UIC.
8 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide
9 CLI Command Set 2 Commands Used for the CLI This chapter describes the general commands used when accessing the console server with the command line interface. 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.
10 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide characters when assigning values to parameters. add Add a node. Syntax: --:- / cli-> add Example: --:- / cli-> add network/hosts --:#- [hosts] cli-> delete Delete a node. Syntax: --:- / cli-> delete cd Change directory (level). Syntax: --:- / cli-> cd Example: --:- / cli-> cd access Displays the following: --:- access cli-> Example: --:- access cli-> cd .. -or--:- access cli-> cd ..
Chapter 2: CLI Command Set --:- access cli-> cd /information Displays the following: --:- information cli-> pwd Display the path to the current level (print working directory). Syntax: --:- / cli-> pwd connect Connect to a serial port.
12 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Displays the following: Password: -orType the hotkey to suspend the connection: Ctrl + z share Connect to a serial port as an additional, read/write user. Syntax: --:- access cli-> share Example: --:- access cli-> share 77-77-70-p-2 Displays the following: Password: -orType the hotkey to suspend the connection: Ctrl + z disconnect Use the text session hot key to suspend the target session and return to the CLI.
Chapter 2: CLI Command Set 13 --:- / cli-> ftp [|] 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: --:- / cli-> scp [[user@]host1:]file1 [...] [[user@]host2:]file2 set Set a parameter. Syntax: --:- / cli-> set = After a parameter has been changed using the set command, a pair of asterisks appear at the beginning of the CLI prompt.
14 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide ls Show the available directories or subnodes at the current location. Syntax: --:- / cli-> ls Example: --:- / cli-> ls authentication appliance_authentication/ authentication_servers/ --:- / cli-> show Show the content of the current location (shows tables and parameters with current values).
Chapter 2: CLI Command Set 15 set ipv4_method=dhcp #set ipv4_method=static #ipv4_address=192.168.160.10 #ipv4_ mask=255.255.255.
16 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide --:- cli-> [cycle|on|off], To power control (on, off, cycle, lock, unlock) outlets of one specific PDU under the power management level: 1. Go to the outlet level for the specific PDU. --:- / cli-> cd power_management/pdus//outlets 2.
Chapter 2: CLI Command Set 17 wiz Configures the IP parameters for the Eth0 interface.
18 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide --:- cli-> sendmsg admin@139 You are being terminated. show_databuf and show_appliance_databuf View the data buffer files for the port. Data buffering must be enabled in the CAS Profile for the port and the user must be authorized for data buffer management. Syntax: --:- cli-> show_databuf View the data logging for the appliance.
Chapter 2: CLI Command Set 19 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. The sub-parameters will be available after the option is enabled. To configure IPv6 (example of how to perform the equivalent of web manager checkbox selection/deselection): 1.
20 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide domain = corp.tst.com enable_ipv6 = yes get_dns_from_dhcpv6 = no get_domain_from_dhcpv6 = no enable_bonding = no 7. Enter commit.
21 3 Port Access and Configuration Examples By default, all serial ports and the AUX/Modem port are disabled. An 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. The administrator must decide whether to restrict user access to ports by the assignment of authorizations to user groups.
22 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 Access level, information about the following appears in the format shown in : • The console server • The AUX/Modem port (if it is enabled and configured with the Power Profile) • The serial ports that user is authorized to access (if they are configured with the CAS or Power Profile) Table 3.
Chapter 3: Port Access and Configuration Examples Field Description For Outlets 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. Name Either the default XX-XX-XXPXX_n_n or an administrator-assigned name Port PDU outlet number Type Outlet Status ON / OFF Action None To view information about the console server and connected devices: 1.
24 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide 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. To connect to a device console connected to a serial port: NOTE: The serial port must already be configured and enabled prior to this procedure.
Chapter 3: Port Access and Configuration Examples 25 ts_menu options -u [-l] [-ro] Table 3.3: ts_menu Parameters Parameter Description -u Invokes ts_menu as the user named by . This requires a password to be entered. The user only has access to authorized serial ports. -l Generates a list of ports the user can access. Port aliases are shown if defined. -ro Invokes ts_menu in read-only mode. You may connect in read-only mode to any port you have access to.
26 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide To set up a console access service (CAS) port: 1. Log onto the CLI as an administrator. --:- / cli-> 2. Enter set_cas ports/serial_ports/ followed by a space and the number of the port you want to configure (port 1 is used as an example). --:- / cli-> set_cas ports/serial_ports/ 1 3. Enter show to view the status of port 1.
Chapter 3: Port Access and Configuration Examples 2. Enter show to view the configuration of port 3. --:- serial_ports/physical cli-> show Selected items: 3 Port: 3 enable_cisco_rj45_pin-out = no status = enabled speed = 9600 parity = none data_bits = 8 stop_bits = 1 flow_control = none Type ls to see available sub-nodes --:- serial_ports/physical cli-> 3. Enter set status=enabled then enter save to set the Serial_Profile to Power, enable the port and commit the changes. 4.
28 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Type ls to see available sub-nodes
29 4 CLI Overview for Administrators This chapter describes using the Command Line Interface (CLI) for administrators. Only administrators and authorized users can access the commands listed in this chapter. These procedures assume you have logged into the CLI as an administrator and are at the --:- / 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. System 1.
30 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide System/Security Enter cd security to navigate to the security level. --:- / cli-> cd system/security Table 4.
Chapter 4: CLI Overview for Administrators System Navigation Tree http_port= enable_https_session https_ssl_version= https_port= https_minimum_cipher_suite_level= redirect_http|https= dsview all_appliance_to_be_managed_by_dsview= fips_140 enable_fips_140-2_module= System/Date and Time Enter cd system/date_and_time to navigate to the date_and_time level. --:- / cli-> cd system/date_and_time Table 4.
32 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Date and Time Navigation Tree year= time_zone predefined zone=set System/Help and Language Enter cd system/help_and_language to navigate to the online_help level. --:- / cli-> cd system/help_and_language To set the online help URL: Perform this procedure if you have downloaded the online help files to a web server that is accessible to the console server. 1. Enter the following command. --:- / cli> cd system/help_and_language/ 2.
Chapter 4: CLI Overview for Administrators --:- / cli> cd system/general/ 2. Enter the following command. --:- general cli-> set enable_login_banner=yes **:- general cli> set login_banner= A line similar to the following appears. **:- general cli> 3. Save your settings. **:- general cli> commit. System/Boot Configuration Enter cd system/boot_configuration to navigate to the boot_configuration level. --:- / cli-> cd system/boot_configuration Table 4.
34 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Table 4.5: System/Usage Options Usage Navigation Tree flash usage memory Network 1. Enter cd network to navigate to the Network level --:- / cli-> cd network/ 2. Enter ls to view the list of available options. settings/ devices/ ipv4_static_routes/ ipv6_static_routes/ hosts/ firewall/ ipsec(vpn)/ snmp/ Network/Settings 1. Enter cd network/settings to navigate to the Network settings level. --:- / cli-> cd network/settings/ 2.
Chapter 4: CLI Overview for Administrators 35 Network Navigation Tree primary_dns= secondary_dns= enable_ipv6= get_dns_from_dhcpv6= get_domain_from_dhcpv6= enable_ipv4_multiple_routing_tables= Network/IPv4 and IPv6 IPv4 addresses are always enabled. An administrator can also enable IPv6 addresses at the appliance_settings/network/ipv6 level. A procedure to enable IPv6 is used as an example in CLI Equivalent Actions to Web Manager Checkbox Selection on page 19. Table 4.
36 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide 1. Enter cd network/devices/ /settings to navigate to the Settings level for the desired interface. --:- / cli-> cd network/devices/eth0/ 2. Enter set ipv< 4|6> _method=static to set the method to static for IPv4 or IPv6. **:- eth0 cli-> set ipv4_method=static 3. Enter set ipv< 4|6> _address= ipv< 4|6> _mask= to set the IP address and subnet mask, then enter commit to save the change.
Chapter 4: CLI Overview for Administrators 37 127.0.0.1 ip: 127.0.0.1 hostname: localhost alias: 127.0.0.1/ 3. Type add then press Return. --:- hosts cli-> add --:#- [hosts] cli-> ls ip = hostname = alias = --:#- [hosts] cli-> 4. Enter set hostname= ip= to add the name of a host and the IP address for the host. NOTE: Each parameter that follows the add command is separated by a space. --:#- [hosts] cli-> set hostname=sharedacs6000 ip=172.26.31.164 5. Enter commit.
38 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide --:- 172.26.31.164 cli-> show ip: 172.26.31.164 hostname = sharedacs6000 alias = Table 4.9: Network/Hosts Options Hosts Navigation Tree hosts 127.0.0.1 alias= hostname= Network/Firewall Enter cd network/firewall to navigate to the firewall level. --:- / cli-> cd network/firewall 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 4.
Chapter 4: CLI Overview for Administrators 39 --:- / cli-> cd network/ipsec(vpn) Table 4.11: Network/IPSec(VPN) Options IPSec(VPN) Navigation Tree ipsec(vpn) Network/SNMP Enter cd network/snmp to navigate to the snmp level. --:- / cli-> cd network/snmp Table 4.12: Network/SNMP Options SNMP Navigation Tree snmp public_v1|v2/ oid= permission= source= Wiz command The wiz command allows administrators to easily and quickly perform the initial network configuration of the eth0.
40 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide ipv6_method = ipv6_address_unconfigured ipv6_address = ipv6_prefix_length = ipv6_default_gateway = MAC Address: 00:e0:86:21:67:72 dns: primary_dns = 172.26.29.4 secondary_dns = domain = corp.avocent.
Chapter 4: CLI Overview for Administrators Ports Navigation Tree auto_discovery_timeout_(seconds)= default_speed_on_auto_discovery_failure= probe_speed_115200= probe_speed_1200= probe_speed_19200= probe_speed_230400= probe_speed_2400= probe_speed_38400= probe_speed_4800= probe_speed_57600= probe_speed_9600= probe_timeout_(seconds)= pool_of_ports pool_name= pool_tcp_port_alias= pool_ipv4_alias= pool_ipv4_alias_interface= pool_ipv6_alias= pool_ipv6_alias_interface= pool_members= dial-in_profile secure_dial-i
42 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Ports Navigation Tree otp_login_authentication= ppp_connection= ppp|pap_authentication= Table 4.14: Serial Port Commands Command Summary set_cas Edits the command to configure a list of serial ports with the CAS profile. Syntax: set_cas, This command has five sub-nodes: physical, cas, data_buffering, alerts and power.
Chapter 4: CLI Overview for Administrators 43 status = enabled speed = 9600 parity = none data_bits = 8 stop_bits = 1 flow_control = none Type ls to see availables sub-nodes. --:#- [serial_ports/physical] cli-> ls cas/ data_buffering/ alerts/ power/ Type show to see the content of the page.
44 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide --:- auxiliary_ports cli-> show Device Name: ttyM1 status = disabled speed = 38400 init_chat = "" \d\d\d+++\d\d\dATZ OK ppp_address = no_address ppp_authentication = none chap-interval = 0 chap-max-challenge = 10 chap-restart = 3 ppp_idle_timeout = 0 --:- auxiliary_ports cli->set status=enabled --:- auxiliary_ports cli->commit Appliance without an internal modem: If no internal modem is installed, the port name is ttya1.
Chapter 4: CLI Overview for Administrators 45 Authentication Enter cd authentication to navigate to the authentication level. --:- / cli-> cd authentication NOTE: Kerberos does not work unless the administrator copies the /etc/krb5.keytab file from the Kerberos server and overwrites the /etc/krb5.keytab file in the console server. Table 4.
46 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Users Navigation Tree password_rules password enforcement default expiration authorization groups admin appliance-admin user To add a user and password: 1. Enter cd users/local_accounts/user_names to navigate to the user_names level. --:- / cli-> cd users/local_accounts/user_names 2. Enter add. Then enter set with the parameters all on one line separated by spaces as shown.
Chapter 4: CLI Overview for Administrators Table 4.18: Syslog Options Syslog Navigation Tree remote_server_ipv4 server_ip_or_hostname (to specify multiple servers, separate the entries with commas) remote_server_ipv6 server_ip_or_hostname (to specify multiple servers, separate the entries with commas) appliance_console root_session Events_and_Logs Enter cd events_and_logs to navigate to the events_and_logs level. --:- / cli-> cd events_and_logs Table 4.
48 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Events_and_Logs Navigation Tree nfs_path= segment_size_(kbytes)= spare_segments= syslog_data_buffering_settings syslog_facility= sensors current_temperature:(deg_c, display only) maximum_temperature_(deg_c)= maximum_temperature_threshold_(deg_c)=(positive integer between 0 and 4) minimum_temperature_(deg_c)= minimum_temperature_threshold_(deg_c)=(positive integer between 0 and 4) Power Management The Power Management Options are descri
Chapter 4: CLI Overview for Administrators 3. 49 Enter set newpdu_id=. --:#- [pdus] cli-> set new_pdu_id=mypdu --:#- [pdus] save NOTE: See the Cyclades ACS 6000 Installation/Administration/User guide for how to perform other authorized PDU configuration options. To manage power for a selected outlet: See cycle, on, off, lock and unlock on page 15 for how to manage power at the power_ management level.
50 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide client_ip: none creation_time: Tue Dec 18 03:31:01 2007 session_type: console connection_type: cli target_name: id: 37 parent_id: --:- active_sessions cli-> 3. To kill a session (if authorized), enter kill followed by the session number.
51 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. Welcome to ACS6000 . Type help for more information. --:- / cli-> 2. Enter shell. A warning appears followed by the root prompt. --:- cli-> shell WARNING: Improper use of shell commands could lead to data loss, the deletion of important system files or other unexpected result.
52 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide
Appendices 53 Appendix B: Migration CLI The Migration CLI is a tool that allows you to configure an ACS 6000 console server that is running scripts based in the ACS advanced console server. For full configuration and management commands, it is recommended you use the ACS 6000 console server’s CLI. NOTE: References to an ACS advanced console server in this section refer to any advanced console server other than the ACS 6000 console server.
54 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Table B.
Appendices Command Value or Descriptions delete N/A menutitle N/A config network hostSettings secipaddress secsubnetmask
56 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide Command Value or Descriptions sttyoptions tcpkeepalive terminaltype aixterm, att6386, linux-lat, vt100, vt320, xtermcolor, ansi, ibm3151, scoansi, vt102, vt52, at386, linux, sun, vt220, xterm winems no/yes idletimeout config physicalports power management enableIPMI N/A disableIPMI N/A key N/A server N/A config security addgroup/delgroup N/A config security adduser shell
Appendices Command Value or Descriptions security authentication authtype Otp, Otp/Local pppauthtype Otp, Otp/Local timeout -t
58 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide
Appendices 59 Appendix C: Su and Sudo Commands The su and sudo commands allow a user to execute commands as a different user. Su command Using the su (switch user) command, a user can switch to another user account to execute commands not authorized with their normal account. If used without a username, the su command defaults to root. Only users who are members of the wheel group can execute the su command to log in as root.
60 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide # groups To delete a member from the wheel group: 1. Edit the file /etc/group. 2. Remove the username from the line with wheel::XX:,,. Sudo command Using the sudo (superuser do) command, a user can execute a command using the privileges of another user (often root), as specified in the /etc/sudoers file. The user is authenticated using his own password, not the root password.
Appendices In the preceding example, the users millert, mikef and dowdy can execute the kill, shutdown, reboot and su commands while the users bostley, jwfox and crawl can only shut down and reboot the console server.
62 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide
Appendices 63 Appendix D: Technical Support Our Technical Support staff is ready to assist you with any installation or operational 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.
64 Cyclades™ ACS 6000 Advanced Console Server Command Reference Guide
For Technical Support: www.avocent.
