Vertiv ACS800, Avocent Reference Manual

Avocent® ACS800/8000 Advanced Console System

Command Reference Guide

The information contained in this document is subject to change without notice and may not be suitable for all applications. While every precaution has been taken to ensure the accuracy and completeness of this document, Vertiv assumes no responsibility and disclaims all liability for damages resulting from use of this information or for any errors or omissions. Refer to other local practices or building codes as applicable for the correct methods, tools, and materials to be used in performing procedures not specifically described in this document.

The products covered by this instruction manual are manufactured and/or sold by Vertiv. This document is the property of Vertiv and contains confidential and proprietary information owned by Vertiv. Any copying, use or disclosure of it without the written permission of Vertiv is strictly prohibited.

Names of companies and products are trademarks or registered trademarks of the respective companies. Any questions regarding usage of trademark names should be directed to the original manufacturer.

Technical Support Site

If you encounter any installation or operational issues with your product, check the pertinent section of this manual to see if the issue can be resolved by following outlined procedures. Visit https://www.VertivCo.com/en-us/support/ for additional assistance.

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

TABLE OF CONTENTS

1 Introduction, Navigation and Commands 1

1.1 Access Options and How to Log in to the CLI 1

1.2 Configuration Tasks Performed With the CLI 2

1.3 CLINavigation 2

1.4 Autocompletion 4

1.5 Parameters 4

2 CLI Command Set 5

2.1 Commands Used for the CLI 5

2.1.1 add 5

2.1.2 cd 5

2.1.3 commit 6

2.1.4 delete 6

2.1.5 exit/quit 6

2.1.6 ftp 7

2.1.7 help 7

2.1.8 list_configuration 7

2.1.9 ls 8

2.1.10 opiepasswd 8

2.1.11 pwd 9

2.1.12 passwd 9

2.1.13 revert 9

2.1.14 scp 9

2.1.15 set 9

2.1.16 show 10

2.1.17 wiz 10

2.1.18 connect 11

2.1.19 disconnect 11

2.1.20 cycle, on, off, lock and unlock 11

2.2 Special Multi-session Commands 13

2.2.1 sniff 13

2.2.2 share 13

2.2.3 list_shared_session 14

2.2.4 kill_shared_session 14

2.2.5 sendmsg 14

2.2.6 show_databuf and show_appliance_databuf 14

2.2.7 cleandbuf and clean_appliance_databuf 15

2.3 CLI Equivalent Actions to Web Manager Checkbox Selection 15

3 Port Access and Configuration Examples 19

3.1 View Information About the Console System and Connected Devices 19

3.2 Connect to a Device Console Connected to a Serial Port 21

Vertiv | Avocent® ACS800/8000 Advanced Console System Command Reference Guide | i

3.3 Accessing Serial Ports using ts_menu 22

3.4 Manage Power for a Device Connected to an Outlet on a PDU 22

3.5 Port Configuration Examples 22

4 CLI Overview for Administrators 25

4.1 System 25

4.2 System/Security 25

4.2.1 System/Date and Time 27

4.2.2 System/Help and Language 27

4.2.3 System/General 28

4.2.4 System/Boot Configuration 29

4.2.5 System/Information 29

4.2.6 System/Usage 29

4.3 Network 29

4.3.1 Network/Settings 30

4.3.2 Network/IPv4 and IPv6 30

4.3.3 Network/Devices 31

4.3.4 Network/Hosts 32

4.3.5 Network/Firewall 33

4.3.6 Network/IPSec(VPN) 33

4.4 Network/SNMP 34

4.5 Sensors 34

4.5.1 Wiz command 36

4.6 Ports 37

4.6.1 Auxiliary ports 41

4.7 Pluggable Devices 42

4.8 Authentication 42

4.9 Users 44

4.10 Events_and_Logs 47

4.11 Power Management 48

4.12 Active Sessions Information 49

4.13 Change Password 50

Appendices 51

Appendix A: Recovering a Console System That Will Not Boot From Flash 51

Appendix B: Migration CLI 53

Appendix C: Su and Sudo Commands 57

Vertiv | Avocent® ACS800/8000 Advanced Console System Command Reference Guide | ii

1 INTRODUCTION, NAVIGATION AND COMMANDS

The Avocent® ACS800/8000 Advanced Console System serves as a single point for access and administration of connected devices, such as target device consoles, modems and power devices. Console systems support secure remote data center management and out-of-band management of IT assets from any location worldwide.

This guide describes how to access and navigate the Command Line Interface (CLI)utility and how to use it after the console system has been installed and assigned an IP address. For information on how to install or operate your console system using the web user interface (UI), see the Avocent® ACS800/8000 Advanced Console System Installation/User Guide.

1.1 Access Options and How to Log in to 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 system with session settings of 9600, 8, N and 1, with no flow control. The local console speed can be modified in the device's boot configuration.

• After the console system is connected to the network and has an IP address, it can be accessed by one of the following methods:

• An SSH or Telnet client on a remote computer (if the SSH or Telnet protocol is enabled in the selected Security Profile)

• With the Web Manager - Access - Appliance Viewer button

• With DSView management software

NOTE: For details on the remote access methods and IP address configuration options, see the Avocent® ACS800/8000 Advanced Console System Installation/User Guide.

Administrators have full access to the CLI and to connected devices. An administrator can authorize regular users to access ports, manage power, manage data buffer storage and use one or more console system administration tools. Users can always change their own passwords.

To start the CLI:

1. An administrator can access the CLI through the console port, with Telnet, SSH or through the web manager.

2. Enter the username and password at the prompt. The cli-> prompt appears.

-or-

Aroot user logs into the Linux shell by default. From the shell, type cli to launch the CLI.

Welcome to ACS8000 <host name>. Type help for more information

--:- / cli->

The default username is admin. The first time you log in as admin, leave the password field blank. You are prompted to create a new password.

1.2 Configuration Tasks Performed With the CLI

The navigation structure of the CLI mirrors that of the web manager. Options and parameters are also the same, except that spaces in web manager options and parameters are replaced with underscores (_), as in system_tools. Examples that show how to select an option in the web manager use a dash surrounded by two spaces ( - ). In the CLI, two similar options in a path are separated by a forward slash (/).

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.

Administrators should log into the CLI in one window and log into the web manager in another window to see how the menu options in the web manager map to the navigation options in the CLI. Configuration with the CLI also requires mastery of the following information on CLI navigation and of the CLI commands. For more information, see CLI Command Set on page 5

1.3 CLINavigation

The CLI navigation options are in a nested tree configuration.

When a command line is shown in an example, and the step starts with “Enter,” or when a syntax example is given, the user should type the command as shown and then press Enter. The Enter key is not shown in command line examples unless needed for clarity.

When a user logs in the CLI, the prompt indicates the user is at the / level.

--:- / cli->

No parameters can be set at this level of the navigation tree.

At any CLI prompt at any level, if you type cd <space> Tab Tab or cd Tab 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.

--:-/ cli->cd

access/ monitoring/ sensors/

active_sessions/ network/ system/

authentication/

pluggable_ devices/

system_ tools/

change_password/ ports/ users/

events_and_logs/

power_ management

When a regular user types the cd command and then presses Tab Tab at the / prompt, the following navigation options appear.

--:-/ cli->cd

access/ change_password/ power_management/

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

Enter cd <one_or_more_path_elements> to move down one or more levels of the navigation tree:

--:- / cli-> cd system_tools

A prompt like the following appears at each level:

--:- system_toolscli->

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.

--:- / cli->

add pwd

cd quit

clone_ports reboot

commit

configuration_integrity

reset_port_to_ factory

restore_ configuration

delete revert

disable_ports save_configuration

echo scp

edit set

enable_ports set_cas

exit set_dial-in

factory_defaults set_dial-out

finish set_power

ftp set_socket-client

generate_|_download_ certificate

shell

help show

hostname shutdown

list_configuration upgrade_firmware

ls whoami

opiepasswd wiz

passwd

1 Introduction, Navig ation and Commands

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 ../..

--:- / cli->

1.4 Autocompletion

Autocompletion allows you to type the first few letters of a command or navigation option and then press Tab. The rest of the name is filled in automatically if the letters typed are unique to one command or to a navigation option at that level. If the letters match more than one of the commands or navigation options for that level, the matching options are listed.

For example, if you type cd acc and press Tab at the CLI prompt from the / level, the access option will be completed.

--:- / cli-> cd acc <tab>

--:- / cli-> cd access

If you then press Enter, you are changed to the access level, and the access level prompt appears.

--:- accesscli->

The following example illustrates a case when more than one command matches the letters typed.

--:- / cli-> sh <tab><tab> shellshow

1.5 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.

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

2 CLI COMMAND SET

2.1 Commands Used for the CLI

This section describes the general commands used when accessing the console system 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.

2.1.1 add

Add a node.

Syntax:

--:- / cli-> add <Path>

Example:

--:- / cli-> add network/hosts

--:#- [hosts] cli->

2.1.2 cd

Change directory (level).

Syntax:

--:- / cli-> cd <Path>

Example:

--:- / cli-> cd access

Displays the following:

--:- accesscli->

Example:

--:- accesscli-> cd ..

-or-

--:- accesscli-> cd ../

Moves up one directory level and displays the following:

--:- / cli->

Example:

--:- accesscli-> cd /

Moves to the top level and displays the following:

--:- / cli->

Example:

--:- accesscli-> cd /information

Displays the following:

--:- information cli->

2.1.3 commit

Save settings.

Syntax:

**:- settings cli-> commit

2.1.4 delete

Delete a node.

Syntax:

--:- / cli-> delete <Path> <parameter>

2.1.5 exit/quit

Exit the CLI and return to the login prompt.

Syntax:

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

--:- / cli-> exit

-or-

--:- / cli-> quit

2.1.6 ftp

Connect to a remote FTP server.

Syntax:

--:- / cli-> ftp [<server_IP_address>|<hostname>]

NOTE: You must log into the CLI as root to have full control over the local directory path. All normal FTP commands apply.

2.1.7 help

Generate a help message about how to navigate the CLI.

Syntax:

--:- / cli-> help

- Thank you for using the cli Some basicand useful keys ar e:

- tab (once/twice) - shows the next possible commands/option(s)

- up/down arrow - navigatesup/down in the command history

- ls - shows sub-nodes

- show - shows available configuration in the node

- cntrl e - gets the current parameter value for editing Other hints:

- Use backslash '\' to escape spaces, '\' and other control characters when assigning values to parameters.

2.1.8 list_configuration

List the configuration in a format that allows pasting the output directly on the appliance session (console, SSH or Telnet) in order to (re)configure the unit.

All configurable parameters are listed under the current node. When the parameter is not configured, the parameter name has the number sign character (#) as its prefix.

Syntax:

--:- / cli-> list_configuration

Example:

2 CLI Comman d Set

.list configuration of network device eth0:

--:- cli-> cd network/dev ices/eth0

--:- eth0 cli-> lis t_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.0 #set ipv4_method=ipv4_address_unconfigured #set ipv6_method=stateless #set ipv6_method=dhcpv6 #set ipv6_method=static #ipv6_address= #ipv6_prefix_length= set ipv6_method=ipv6_address_unconfigured set mode=auto submit echo on commit

--:- eth0 cli->

NOTE: Check the configuration of the program used to open a session against the appliance (SSH/Telnet, TeraTerm / HypertTerminal for console, and so on) to avoid the inclusion of a line feed character in lines that exceed terminal width, because this will affect the paste operation.

2.1.9 ls

Show the available directories or subnodes at the current location.

Syntax:

--:- / cli-> ls

Example:

--:- / cli-> ls authentication appliance_authentication/ authentication_servers/

--:- / cli->

2.1.10 opiepasswd

Configure a one time password (OTP) for the local user. After you type the command, you will be asked for the passphrase to use for the OTP.

NOTE: Use this command to restart the sequence number.

Syntax:

--:- / cli-> opiepasswd -f -c <username>

Example:

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

opiepasswd -f -c teste Adding teste: Onlyuse 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. Enter new secret pass phrase: Again new secret passphrase: ID teste OTP key is 499 AC0241 FOOD HUGH SKI ALMA LURK BRAD

2.1.11 pwd

Display the path to the current level (print working directory).

Syntax:

--:- / cli-> pwd

2.1.12 passwd

Configure the password for the current user. The terminal does not echo the password.

Syntax:

--:- / cli-> passwd

2.1.13 revert

Undo a previous parameter setting.

Syntax:

**:- / cli-> rev ert

2.1.14 scp

Perform a secure shell copy.

Syntax:

--:- / cli-> scp [[user@]host1:]file1 [...] [[user@]host2:]file2

2.1.15 set

Set a parameter.

Syntax:

2 CLI Comman d Set

--:- / cli-> set <Path> <Parameter>=<Value>

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

-or-

Undo the change:

**:- / cli-> rev ert

NOTE: After a commit or revert command, the asterisks at the beginning of the CLI prompt are replaced by hyphens. Asterisks will not appear after the execution of the set command if using wizard mode, which can be recognized by a prompt that has a pound sign after the colon and the current directory in square brackets (example, --:#- [hosts] cli>).

2.1.16 show

Show the content of the current location (shows tables and parameters with current values).

Syntax:

--:- / cli-> show

Example:

--:- language cli-> show appliance_language = english

--:- / cli->

2.1.17 wiz

Configures the IP parameters for the Eth0 interface. Shows the current configuration and asks for new values for the following parameters:

• Status of the interface (enabled or disabled)

• IPv4 method (dhcp or static)

• IPv6 method (dhcp or static)

• IP address, mask and gateway (if static is chosen for either of the previous parameters)

• DNS Primary Server, Secondary Server, Domain Name and Hostname

• Enable or disable IPv6 support

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

After setting all parameters, confirm that all parameters are correct to save them.

2.1.18 connect

Connect to a serial port.

Syntax:

--:- accesscli-> connect <port_name>

Example:

--:- accesscli-> connect 77-77-70-p-2

Displays the following:

Password:

-or-

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.

2.1.19 disconnect

Use the text session hotkey to suspend the target session and return to the CLI.

Syntax:

Ctrl+z

2.1.20 cycle, on, off, lock and unlock

Control power on outlets on a PDU that is either connected to a serial port or to the AUX/Modem port when the port is enabled and configured with the Power Profile.

NOTE: Lock and unlock commands are only supported on Cyclades and Avocent PDUs.

To power control (on, off, cycle) all outlets of PDUs or outlets merged to a target (serial port configured as CAS profile with merged outlets):

1. Go to the access level.

2 CLI Comman d Set

--:- / cli-> cd/ acc ess

2. Launch the power command with the argument being the target name or PDU ID.

--:- accesscli-> [cy cle|on|off][<PDU_ID>]|<target name>]

To power control (on, off, cycle) outlets of one specific PDU:

1. Go to the PDU level under access.

--:- / cli-> cd acc ess/<PDU_ID>

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).

--:- <PDU_ID> cli-> [c ycl e|on|off][<outlet name>|<outlet number >]

-or-

--:- <PDU_ID> cli-> [c ycl e|on|off]<outlet number>-<outlet number]

-or-

--:- <PDU_ID> cli-> [c ycl e|on|off]<outlet number>,<outlet number>

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/<PDU_ID>/outlets

2. Launch the power command with a specific outlet number, range of outlets (use a hyphen to specify the range) or list of outlets (number or name separated by a comma).

--:- outlets cli-> [c ycl e|on|off] [<outlet number>]

-or-

--:- outlets cli-> [c ycl e|on|off] <outlet number>-<outlet number]

-or-

--:- outlets cli-> [c ycl e|on|off] <outlet number>,<outlet number>

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

2.2 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.

--:- / cli-> cd acc ess/<serial_port_ID>

2.2.1 sniff

Connect to a serial port as an additional, view-only user.

Syntax:

--:- / <port name>cli-> sniff

Example:

--:- / 77-77-70-p-2 cli->sniff

Displays the following:

Password:

-or-

Type the hotkey to suspend the connection:

Ctrl + z

2.2.2 share

Connect to a serial port as an additional, read/write user.

Syntax:

--:-/ <port_name> cli-> share

Example:

--:- / 77-77-70-p-2 cli->share

Displays the following:

-or-

2 CLI Comman d Set

Password:

Type the hotkey to suspend the connection:

Ctrl + z

2.2.3 list_shared_session

List the users connected to the shared serial port.

Syntax:

--:- <serial_port_ID> cli-> list_shared_s essi on

2.2.4 kill_shared_session

Terminate the connection of a user on the port. The user is returned to the cli-> prompt.

NOTE: You must enable the Kill Multi Session option from the Port Access Rights settings for this command to be available.

Syntax:

--:- <serial_port_ID> cli-> kill_shared_session<username>

Example:

--:- <serial_port_ID> cli-> kill_shared_session admin@139

2.2.5 sendmsg

Send a message to a user connected to the port.

NOTE: You must enable the Send Message Multi Session option from the Port Access Rights settings for this command to be available.

Syntax:

--:- <serial_port_ID> cli-> sendmsg <username> <message>

Example:

--:- <serial_port_ID> cli-> sendmsg admin@139 You are being terminated.

2.2.6 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:

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

--:- <serial_port_ID> cli-> show_databuf

View the data logging for the appliance. Appliance Session Data logging must be enabled in Events and Logs/Appliance Logging.

Syntax:

--:- / 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.

2.2.7 cleandbuf and clean_appliance_databuf

Clear the data buffer. Data buffering must be enabled in the CAS Profile for the port and the user must be authorized for data buffer management.

Syntax:

--:- <serial_port_ID> cli-> clean_databuf

Clear the data logging for the appliance. Appliance Session Data logging must be enabled in Events and Logs/Appliance Logging.

Syntax:

--:- / cli-> clean_appliance_databuf

2.3 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. Log into the CLI and enter cd network/settings.

--:- / cli-> cd network/s ettings

2 CLI Comman d Set

2. Enter show to view the status of IPv6 configuration.

--:- settings cli-> show hostname = ACS8048 primary_dns = 110.126.129.4 secondary_dns = domain = corp.tst.com search = enable_lldp = no enable_ipv6 = no get_dns_from_dhcpv6 = no get_domain_from_dhcpv6 = no multiple_routing = none enable_bonding = no

3. Type set enable_ipv6= and press Tab to view the options for the parameter.

--:- settings cli-> set enable_ipv6= no yes

4. Enter set enable_ipv6=no to disable IPv6.

--:- settings cli-> set enable_ipv6=no

-or-

Enter set enable_ipv6=yes to enable IPv6.

--:- settings cli-> set enable_ipv6=yes

5. (Optional) Enter either of the following commands to enable subparameters.

**:- settings cli-> set get_dns_from_dhcpv6=yes **:- settings cli-> set get_domain_from_dhcpv6=yes

6. Enter show to verify the change.

**:- settings cli-> show hostname = ACS8048 primary_dns = 110.126.129.4 secondary_dns = domain = corp.tst.com search = enable_lldp = no enable_ipv6 = yes get_dns_from_dhcpv6 = no get_domain_from_dhcpv6 = no multiple_routing = none enable_bonding = no

7. Enter commit.

Vertiv™ | Avocent® ACS800/8000 Advanced Console System Comman d Reference Guide

+ 44 hidden pages

Vertiv ACS800, Avocent Reference Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

1 INTRODUCTION, NAVIGATION AND COMMANDS

1.1 Access Options and How to Log in to the CLI

1.2 Configuration Tasks Performed With the CLI

1.4 Autocompletion

1.5 Parameters

2 CLI COMMAND SET

2.1 Commands Used for the CLI

2.1.1 add

2.1.2 cd

2.1.3 commit

2.1.4 delete

2.1.5 exit/quit

2.1.6 ftp

2.1.7 help

2.1.8 list_configuration

2.1.9 ls

2.1.10 opiepasswd

2.1.11 pwd

2.1.12 passwd

2.1.13 revert

2.1.14 scp

2.1.15 set

2.1.16 show

2.1.17 wiz

2.1.18 connect

2.1.19 disconnect

2.1.20 cycle, on, off, lock and unlock

2.2 Special Multi-session Commands

2.2.1 sniff

2.2.2 share

2.2.3 list_shared_session

2.2.4 kill_shared_session

2.2.5 sendmsg

2.2.6 show_databuf and show_appliance_databuf

2.2.7 cleandbuf and clean_appliance_databuf

2.3 CLI Equivalent Actions to Web Manager Checkbox Selection