Avocent® ACS 6000 Advanced Console Server Command Reference Guide
For important safety information, visit: www.emersonnetworkpower.com/ComplianceRegulatoryInfo Emerson, Emerson Network Power and the Emerson Network Power logo are trademarks or service marks of Emerson Electric Co. Avocent, the Avocent logo and Cyclades are trademarks or service marks of Avocent Corporation or its affiliates in the U.S. and other countries. Liebert is a trademark and service mark of Liebert Corporation. All other marks are the property of their respective owners.
i TABLE OF CONTENTS Introduction, Navigation and Commands Access Options and How to Log Into the CLI Configuration Tasks Performed With the CLI CLI Navigation Autocompletion Parameters Command Line Syntax CLI Command Set Commands Used for the CLI help add delete cd pwd connect sniff share disconnect exit/quit ftp scp set commit revert ls show list_configuration cycle, on, off, lock and unlock passwd opiepasswd wiz Special Multi-session Commands list_shared_session kill_shared_session sendmsg show_databuf a
ii.....
Introduction, Navigation and Commands The Avocent® 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-of-band management of IT assets from any location worldwide.
2.....Avocent® ACS 6000 Advanced Console Server Console Server Port Descriptions Number Description 1 Serial Port 1. Serial ports are also referred to with tty device names, such as ttSy1, ttyS2 and so forth. 2 Eth1 (eth1) 3 Eth0 (eth0) 4 AUX/Modem Port (ttyM1 or ttyA1). If an internal modem is ordered and factory installed, this port is configured internally as a modem port.
Introduction, Navigation and Commands..... 3 NOTE: The default password for admin is avocent and for root is linux. The password for these users may have been changed during installation of the console server. If not, change the default root and admin passwords to avoid potential security breaches.
4.....Avocent® ACS 6000 Advanced Console Server At any CLI prompt at any level, if you type cd and press Tab Tab, the navigation options (path elements) for that level are listed. Different options appear for administrators and for authorized users. • When an administrator types the cd command and then presses Tab Tab at the / prompt, the following navigation options (path elements) appear.
Introduction, Navigation and Commands..... 5 ---:- system_tools cli-> If you know the path, you can enter multiple path elements in a single command separated with forward slashes (/). --:- / cli-> cd ports/serial_ports/ --:- serial ports cli-> Enter cd .. to move up one level of the navigation tree. Enter cd ../..[/..] to move up multiple levels. --:- serial ports cli-> cd ../..
6.....Avocent® ACS 6000 Advanced Console Server Command Line Syntax NOTE: Square brackets ([ ]) denote an optional element. Each element is separated by a space. There are no spaces between sub-elements.
Introduction, Navigation and Commands.....
Introduction, Navigation and Commands.....
CLI Command Set 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.....Avocent® ACS 6000 Advanced Console Server 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 ..
CLI Command Set..... 11 Example: --:- access cli-> cd / Moves to the top level and displays the following: --:- / cli-> Example: --:- 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.....Avocent® ACS 6000 Advanced Console Server Type the hotkey to suspend the connection: Ctrl + z NOTE: The connect, sniff and share commands allow you to connect to serial ports. These commands require authentication when single sign-on is disabled, so the password must be entered to authenticate the user in the authentication type configured for the serial port. If single sign-on is enabled or the user has already been authenticated, the session is opened.
CLI Command Set..... 13 -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. Syntax: Ctrl+z exit/quit Exit the CLI and return to the login prompt. Syntax: --:- / cli-> exit -or--:- / cli-> quit ftp Connect to a remote FTP server. Syntax: --:- / 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.
14.....Avocent® ACS 6000 Advanced Console Server 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. **:- / cli-> Save the change: **:- / cli-> commit -orUndo the change: **:- / cli-> revert NOTE: After a commit or revert command, the asterisks at the beginning of the CLI prompt are replaced by hyphens.
CLI Command Set..... 15 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).
16.....Avocent® ACS 6000 Advanced Console Server --:- eth0 cli-> list_configuration echo off cd /network/devices/eth0 batch_mode set status=enabled set ipv4_method=dhcp #set ipv4_method=static #ipv4_address=192.168.160.10 #ipv4_mask=255.255.255.
CLI Command Set..... 17 --:- / cli-> cd access/ 2. Launch the power command with a specific outlet (number or name), range of outlets (use a hyphen to specify the range) or list of outlets (number or name separated by a comma).
18.....Avocent® ACS 6000 Advanced Console Server NOTE: Use this command to restart the sequence number. Syntax: --:- / cli-> opiepasswd -f -c Example: opiepasswd -f -c teste Adding teste: Only use this method from the console; NEVER from remote. If you are using telnet, xterm, or a dial-in, type ^C now or exit with no password. Then run opiepasswd without the -c parameter. Using MD5 to compute responses.
CLI Command Set..... 19 list_shared_session List the users connected to the shared serial port. Syntax: --:- cli-> list_shared_session kill_shared_session Terminate the connection of a user on the port. The user is returned to the cli-> prompt. Syntax: --:- cli-> kill_shared_session Example: --:- cli-> kill_shared_session admin@139 sendmsg Send a message to a user connected to the port.
20.....Avocent® ACS 6000 Advanced Console Server --:- / cli -> show_appliance_databuf The following commands are available for show data buffering: • 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.
CLI Command Set..... 21 --:- settings cli-> show hostname = ACS6048 primary_dns = 110.126.129.4 secondary_dns = domain = corp.tst.com enable_ipv6 = no enable_bonding = no enable_ipv4_multiple_routing_tables = no 3. Type set enable_ipv6= and press Tab to view the options for the parameter. --:- ipv6 cli-> set enable_ipv6= no yes 4. Enter set enable_ipv6=no to disable IPv6. --:- ipv6 cli-> set enable_ipv6=no -orEnter set enable_ipv6=yes to enable IPv6. --:- ipv6 cli-> set enable_ipv6=yes 5.
CLI Command Set.....
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.
24.....
Port Access and Configuration Examples..... 25 --:- access cli->ls ACS6016-0011223344/ 21-67-72-p-1/ 21-67-72-p-2/ 21-67-72-p-4/ myPDU/ Type show to see the content of the page --:- access 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.
26.....Avocent® ACS 6000 Advanced Console Server fremont-techpubs login: fred Password: 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 # Accessing Serial Ports using ts_menu The ts_menu is an application to facilitate connection to the serial ports. It displays a menu showing the server names connected to the serial ports of the console server.
Port Access and Configuration Examples..... 27 Manage Power for a Device Connected to an Outlet on a PDU See cycle, on, off, lock and unlock on page 16 for how an authorized user can manage power on PDU outlets when the PDU is connected to an enabled port configured with the Power Profile and the PDU is connected to the network and added to the appliance as Network PDU.
28.....Avocent® ACS 6000 Advanced Console Server --:#- [serial_ports/physical] cli-> 4. Enter set status=enabled, then enter show and save as shown to enable the configured port and verify and save the configuration. --:- serial_ports/physical cli-> set status=enabled --:- serial_ports/physical cli-> show --:- serial_ports/physical cli-> save To enable a power management port: 1.
Port Access and Configuration Examples.....
Port Access and Configuration Examples.....
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.
32.....
CLI Overview for Administrators..... 33 Date and Time Options Date and Time Navigation Tree date_and_time date_and_time settings= day= hour= minute= month= second= year= time_zone= 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.
34.....Avocent® ACS 6000 Advanced Console Server --:- / cli-> cd system/general To set the login banner: 1. Enter the following command. --:- / cli> cd system/general/ 2. Enter the following command. --:- general cli-> set enable_login_banner=yes **:- general cli> set login_banner= NOTE: with new lines: Type the text between double quotes and enter the new line as \\n (double back slash and the character). A line similar to the following appears.
CLI Overview for Administrators..... 35 System/Usage Enter cd system/usage to navigate to the Usage level. --:- / cli> cd system/usage/ 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.
36.....Avocent® ACS 6000 Advanced Console Server 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 20.
CLI Overview for Administrators..... 37 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. --:- eth0 cli-> set ipv4_address=172.26.31.10 ipv4_mask=255.255.255.0 **:- eth0 cli-> commit 4. Enter show to view the changes.
38.....Avocent® ACS 6000 Advanced Console Server --:#- [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. --:#- [hosts] cli-> save 6. Enter show to verify the changes took place and to view the new host entry. --:- hosts cli-> show 127.0.0.1 ip: 127.0.0.
CLI Overview for Administrators..... 39 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.
40.....Avocent® ACS 6000 Advanced Console Server Wiz command The wiz command allows administrators to easily and quickly perform the initial network configuration of the eth0. At the command prompt at the / level, enter wiz to view the current IP configuration. To change the IP configuration, press Tab to move through the parameters, and press Esc + Tab to edit the selected parameter. When you are finished, enter yes to confirm that all parameters are correct and to save the new parameters.
CLI Overview for Administrators..... 41 Other hints: - Use backslash '\' to escape spaces, '\' and other control characters when assigning values to parameters. Current IPv4 address: 172.26.30.249 Current IPv6 address: eth0: device_status (disabled, enabled) [enabled]: Ports Enter cd ports to navigate to the Ports level.
42.....Avocent® ACS 6000 Advanced Console Server Ports Navigation Tree pool_members= dial-in_profile secure_dial-in callback_users settings log_in_to_appliance= otp_login_authentication= ppp_connection= ppp|pap_authentication= 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.
CLI Overview for Administrators..... 43 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 availables sub-nodes. --:#- [serial_ports/physical] cli-> ls cas/ data_buffering/ alerts/ power/ Type show to see the content of the page.
44.....Avocent® ACS 6000 Advanced Console Server If no internal modem is installed, the port name is ttyA1. If an internal modem is installed, the port name is ttyM1. Enter the commands: set_dial-in, set dial-out or set_power to configure the auxiliary port. NOTE: The set_power command will not be available when an internal modem is installed.
CLI Overview for Administrators..... 45 Users Enter cd users to navigate to the users level. --:- / cli-> cd users Users Options Users Navigation Tree local_accounts user_names root admin 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.
46.....
CLI Overview for Administrators..... 47 Option Description pdus show up in the PDUs node when they are discovered. Only power control opearation is supported by these PDUs. To rename a PDU: 1. Log onto the CLI as an administrator and enter cd power_management/pdus to navigate to the pdus level. --:- / cli-> cd power_management/pdus 2. Type rename and press Tab Tab to expand the parameters. --:- pdus cli-> rename 3. Enter set newpdu_id= .
48.....Avocent® ACS 6000 Advanced Console Server --:- / cli-> cd active_sessions --:- active_sessions cli-> 2. Enter show. Information displays as shown about all active sessions. --:- active_sessions cli-> show 37 user: admin 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.
Appendices 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.
Appendices.....
..... 51 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.
52.....
.....
54.....
..... 55 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. NOTE: The wheel group is a Linux group and is included in the firmware by default.
56.....Avocent® ACS 6000 Advanced Console Server # 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.
..... 57 PARTTIMERS ALL = SHUTDOWN, REBOOT 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.
.....
..... 59 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.
.....
About Emerson Network Power Emerson Network Power, a business of Emerson (NYSE:EMR), delivers software, hardware and services that maximize availability, capacity and efficiency for data centers, healthcare and industrial facilities.
