Emerson Avocent ACS 6000 Operating manual

Avocent® ACS6000 Advanced Console Server
Command Reference Guide

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. Allother marks are the property of their respective
owners. This document may contain confidential and/or proprietary information of Avocent Corporation, and its receipt or
possession does not convey any right to reproduce, disclose its contents, or to manufacture or sell anything that it may describe.
Reproduction, disclosure, or use without specific authorization from Avocent Corporation is strictly prohibited. ©2014 Avocent
Corporation. All rights reserved.
NOTE: This document supports versions up to and including release 3.0
For important safety information, visit:
www.emersonnetworkpower.com/ComplianceRegulatoryInfo

i
TABLE OF CONTENTS
Introduction, Navigation and Commands 1
Access Options and How to Log Into the CLI 2
Configuration Tasks Performed With the CLI 3
CLINavigation 3
Autocompletion 5
Parameters 5
Command Line Syntax 6
CLI Command Set 9
Commands Used for the CLI 9
help 9
add 10
delete 10
cd 10
pwd 11
connect 11
sniff 12
share 12
disconnect 13
exit/quit 13
ftp 13
scp 13
set 14
commit 14
revert 14
ls 15
show 15
list_configuration 15
cycle, on, off, lock and unlock 16
passwd 17
opiepasswd 17
wiz 18
Special Multi-session Commands 18
list_shared_session 19
kill_shared_session 19
sendmsg 19
show_databuf and show_appliance_databuf 19
cleandbuf and clean_appliance_databuf 20
CLI Equivalent Actions to Web Manager Checkbox Selection 20
Port Access and Configuration Examples 23
View Information About the Console Server and Connected Devices 23
Connect to a Device Console Connected to a Serial Port 25

ii.....Avocent® ACS6000 Advanced Console Server
Accessing Serial Ports using ts_menu 26
Manage Power for a Device Connected to an Outlet on a PDU 27
Port Configuration Examples 27
CLI Overview for Administrators 31
System 31
System/Security 31
System/Date and Time 32
System/Help and Language 33
System/General 33
System/Boot Configuration 34
System/Information 34
System/Usage 35
Network 35
Network/Settings 35
Network/IPv4 and IPv6 36
Network/Devices 36
Network/Hosts 37
Network/Firewall 39
Network/IPSec(VPN) 39
Network/SNMP 39
Wiz command 40
Ports 41
Auxiliary ports 43
Pluggable Devices 44
Authentication 44
Users 45
Events_and_Logs 45
Power Management 46
Active Sessions Information 47
Appendices 49
Enabling Firmware Upgrades When the Boot Image is not in Flash 49
Migration CLI 51
Access rights 51
Exceptions 51
Su and Sudo Commands 55
Su command 55
Sudo command 56
Technical Support 59

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.
On console servers, administration can be performed and connected devices can be accessed with
the Command Line Interface (CLI) utility, with the web manager or with DSView™4 management
software. Multiple users and administrators can be logged into the console server and connected to
ports at the same time.
NOTE: All instances of DSView software in this document refer to DSView software version 4 or higher.
This guide describes how to access and navigate the CLI utility and how to use it after the console
server has been installed and assigned an IP address. For information on how to install or operate
your console server using the web manager, see the Avocent ACS 6000
Installation/Administration/User Guide.
The console ports of servers, external modems or power distribution units (PDUs) can be
connected to serial ports on the console server. Supported PDUs include Avocent
PM1000/2000/3000s, Emerson Network Power MPH2 PDUs and RPC2 cards, Cyclades™ PM
IPDUs, Avocent SPC power devices and Server Technology CDUs. Either a PDU or an external
modem can be connected to the AUX/Modem port if the port is not factory-configured for an
internal modem.
Console server ports are shown in the following figure.
Console Server Ports

2.....Avocent® ACS6000 Advanced Console Server
Number Description
1Serial 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. If an internal modem is not installed, the port is configured as an auxiliary port, and a PDU or an
external modem can be connected to it. The figure shows an external modem connected.
5 Console Port
Console Server Port Descriptions
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.
•After the console server 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 - Overview - Appliance Session button
•With DSView management software
NOTE: For details on the remote access methods and IP address configuration options, see the Avocent
ACS 6000 Installation/Administration/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 server administration tools. Users can always change their own passwords.
To start the CLI:
1. 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.
Welcome to ACS6000 <host name>.
Type help for more information
--:- / cli->

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.
Configuration Tasks Performed With the CLI
NOTE: This manual provides some configuration procedures as examples of how to use the CLI; an
administrator who wants to use the CLI for configuration should reference the
installation/administration/user guide for more information.
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 shown in Chapter 2.
CLINavigation
The CLI navigation options are in a nested tree configuration.
NOTE: 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.

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.
--:- / cli-> cd<Tab><Tab>
access/ monitoring/ system/
active_sessions/ network/
system_tools/
authentication/ pluggable_devices/ users/
change_password/ ports/
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<Tab><Tab>
access/ power_management/
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_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.
---:- system_tools cli-><Tab><Tab>
batch_mode ls scp
cd opiepasswd shell
commit passwd show
echo pwd shutdown
exit quit upgrade_firmware
ftp reboot whoami
help restore_configuration wiz
hostname revert
list_configuration save_configuration

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 ../..
--:- / cli->
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.
--:- access cli->
The following example illustrates a case when more than one command matches the letters typed.
--:- / cli-> sh<Tab>
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.

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.
Command only (help, pwd):
--:- <current_level> cli-> <command>
Commands with paths only (cd, ls, add):
--:- <current_level> cli-> <command> [Path]
Commands with targets (del):
--:- <current_level> cli-> <command> [Path] <Targets>
Commands that require parameters (set):
--:- <current_level> cli-> <command> [Path] <Params>
Commands with values only (sendmsg, ftp...):
--:- <current_level> cli-> <command> [Path] <Values>
where:
Path := path_elem[/path_elem]*
path_elem := . | .. | Section_Label | ^/
Targets := Row_Label(,Row_Label)
Params := Param_Names=PValues
Param_Names := Param_Label(:Param_Label)*
PValues := Value_text(,Value_text)*
Values := Value_text Value_text
Section_Label
Param_Label
Value_text := labels or data from the UIC.
Syntax used:
^ : beginning of the element
* : 0 - many
| : or
() : group

Introduction, Navigation and Commands.....7

Introduction, Navigation and Commands.....8

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.
Syntax:
--:- / cli-> help
- Thank you for using the cli -
This interface allows you to easily modify configurations
to customize and define the functionality of your unit.
Press <tab> <tab> to see the list of available commands.
Please refer to the Reference Guide for a description of
commands, special keys and additional information on how to
use this interface.
Some basic and useful keys are:
up/down arrow - navigates up/down in the command history
tab (once/twice) - shows the next possible option(s)
Other hints:
Use backslash '\' to escape spaces, '\' and other control
characters when assigning values to parameters.

10.....Avocent® ACS6000 Advanced Console Server
add
Add a node.
Syntax:
--:- / cli-> add <Path>
Example:
--:- / cli-> add network/hosts
--:#- [hosts] cli->
delete
Delete a node.
Syntax:
--:- / cli-> delete <Path> <parameter>
cd
Change directory (level).
Syntax:
--:- / cli-> cd <Path>
Example:
--:- / cli-> cd access
Displays the following:
--:- access cli->
Example:
--:- access cli-> cd ..
-or-
--:- access cli-> cd ../
Moves up one directory level and displays the following:
--:- / cli->

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.
Syntax:
--:- access cli-> connect <port_name>
Example:
--:- access cli-> connect 77-77-70-p-2
-or-
(Optional) From the default directory:
--:- / cli-> connect access/77-77-70-p-2
Displays the following:
Password:
-or-

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.
sniff
Connect to a serial port as an additional, view-only user.
Syntax:
--:- access cli-> sniff <port_name>
Example:
--:- access cli-> sniff 77-77-70-p-2
Displays the following:
Password:
-or-
Type the hotkey to suspend the connection:
Ctrl + z
share
Connect to a serial port as an additional, read/write user.
Syntax:
--:- access cli-> share <port_name>
Example:
--:- access cli-> share 77-77-70-p-2
Displays the following:
Password:

CLI Command Set.....13
-or-
Type 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 [<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.
scp
Perform a secure shell copy.
Syntax:
--:- / cli-> scp [[user@]host1:]file1[...] [[user@]host2:]file2

14.....Avocent® ACS6000 Advanced Console Server
set
Set a parameter.
Syntax:
--:- / 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-> revert
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->).
commit
Save settings.
Syntax:
**:- settings cli-> commit
revert
Undo a previous parameter setting.
Syntax:
**:- / cli-> revert

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).
Syntax:
--:- / cli-> show
Example:
--:- language cli-> show
appliance_languate = english
--:- / cli->
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:
.list configuration of network device eth0:
--:- cli-> cd network/devices/eth0

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.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 past operation.
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.
--:- / cli-> cd/access
2. Launch the power command with the argument being the target name or PDU ID.
--:- access cli-> [cycle|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.