Avocent ACS 6000 manual

For T echnical Support : www.avocent.com/support 590- 7 70-50 1B C yclades ® ACS 6000 Command Reference Guide[...]

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. This equipment gener[...]

Cyclades ® ACS 6000 Advanced Console Server Command Reference Guide Avocent, the Avocent lo go, The Power of Being There, DSView and Cyclades are registered trademarks of Avocent Cor p oration or its affiliates in the US and other countrie s. All other marks are the property of their respective owners. © 2008 A vocent Corporation. 590-770-5 01B[...]

Instructions This symbol is inte nded to alert the user to the pres ence of important operating and maintenance (servicing) instructions in the lite rat ure accompanying the appliance. Dangerous V oltage This symbol is intende d to al ert the user to the presen ce of uninsulated dangerous voltage within the prod uct’ s enclosure that ma y be of s[...]

iii Table of Contents List of Tables ............... ...................... .......................... .......................... ....................... . .v i i Chapter 1: Introduction, Navigation and Commands ........... ................ ............. ........... 1 Access Options and How to Log Into the CLI ............. .................... ...[...]

iv Cyclades ACS 600 0 Advanced Console Server Command Reference Guide killuser ............. ................. ................. ................... ................. ................. ................... ............... 14 sendmsg............ ................. ................. ................... ................. ................. ..............[...]

Table of Contents v Overview Options .................... ................. ................. ................... ................. .................... . ............. 49 Information Options ................. ................. ... ................ ................. ... ................. ... ............... .. ........... 50 Active Sessions Informa[...]

vi Cyclades ACS 6000 Advanced Console Server Command Reference Guide[...]

vii List of Tables Table 1.1: ACS 6000 Advanced Console Server Port Descriptions ............ ................ .................... .. 2 Table 2.1: Port Access an d Configuration Tasks ...... .................................................. ............ ........ 19 Table 2.2: Topology Parameters ........... ................. ... .. ..............[...]

viii Cyclades ACS 6000 Advan ced Console Server Command Reference Guide[...]

1 CHAPTER 1 Introduction, Navigation and Commands The Cyclades ACS 6000 advanced cons ole server is a 1U appliance that serves as a single point for access and administration of connected devices, such as target de vice consoles, modems and power devices. ACS 6000 consol e servers support secure remote data center managem ent and out-of-band manage[...]

2 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Figure 1.1: ACS 6000 Advanced Con sole Server Port s T able 1.1: ACS 6000 Advan ced Console Server Port Descriptions Number Description 1S e r i a l P o r t 1 NOTE: Serial port s are also referred to with tty device names, such a s ttSy1, ttyS2 and so forth. 2 Eth1 (eth1) 3 Eth0 (e[...]

Chapter 1: Introduction, Naviga tion and Commands 3 Access Options and How to Log Into the CLI The CLI utility can be accesse d in the following ways: • Through a local terminal or a computer that has a terminal em ulation 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 wh en an administrator selects Appliance Settings - Users - Local Accounts - User Names to get to the User Names screen. To navigate to the equivalent configurat ion lev e l in the CLI, an administrator woul d navi gate in[...]

Chapter 1: Introduction, Naviga tion and Commands 5 A prompt like the following appears at each level: --:- appliance_settings cli-> NOTE: CLI commands are case sen sitive. At any level, you can press Tab Tab at the prompt to see the comman ds that can be entered at the current level. ---:- appliance_settings cli->< Ta b >< Tab > [...]

6 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Parameters Some CLI commands take parameters. If you press Ta b Tab after a command that requires a parameter, you are prompted to enter the parameter. Command Line Synt ax NOTE: Square brackets ([ ]) denote an optional element . Each element is separated by a sp ace. There are no [...]

Chapter 1: Introduction, Naviga tion and Commands 7 | : or () : group CLI Command Set NOTE: Most of the commands w ork from any location when the path to the command parameter is included. NOTE: The word “node” refers to an entity su ch as a r oute, host or user , which can be add ed, configured or deleted. help Generate a help message about ho[...]

8 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Syntax: --:- units cli-> add <Path> Example: --:- units cli-> add appliance_setti ngs/network/hosts --:#- [hosts] cli-> delete Delete a node. Syntax: --:- units cli-> delete <Path> <para meter> cd Change directory (level). Syntax: --:- units cli-> c[...]

Chapter 1: Introduction, Naviga tion and Commands 9 --:- overview cli-> pwd Display the path to the current level (print work ing director y). Syntax: --:- units cli-> pwd connect Connect to a serial or auxiliary port. Syntax: --:- topology cli-> connect < port_name > Example: --:- topology cli-> connect 77-77-70-p-2 -or- (Optiona[...]

10 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Password: -or- Type the hotkey to suspend the conn ectio n: Ctrl + z share Connect to a serial or au xiliary port as an addi tional, read/write user. Syntax: --:- topology cli-> share < port_name > Example: --:- topology cli-> share 77-77-70-p -2 Displays the fo llowin[...]

Chapter 1: Introduction, Navigati on and Commands 11 NOTE: Y ou must log into the CLI as root to have full c ontr ol o ver the local directory p ath. All normal FTP commands apply . scp Perform a secure shell copy. Syntax: --:- units cli-> scp [[ user @ ] host1 :] file 1 [...] [[ u ser @] host2 :] file2 set Set a parameter. Syntax: --:- units cl[...]

12 Cyclades ACS 6000 Advanced Console Server Command Reference Guide show/ls Show the available director ies, commands or paramete rs at the current location. Syntax: --:- units cli-> show -or- --:- units cli-> ls Example: --:- units cli-> show user_profile user_profile change_password/ --:- units cli-> power_cycle, power_o ff and power[...]

Chapter 1: Introduction, Navigati on and Commands 13 --:- units cli-> cd power_management /management/ < PDU_ID > /outlet_table --:- outlet_table cli-> [ cycle | on | of f | lock | unlock ] <outlet_number[,..,outlet_number]> Examples: --:- units cli-> cd power_management/managem ent/myPD U/outlet _table --:- outlet_table cli-&g[...]

14 Cyclades ACS 6000 Advanced Console Server Command Reference Guide FOOD HUGH SKI ALMA LURK BRAD S pecial Multi-session Commands The following commands require navigation to an enabled and configu red port to which one or more users are simultaneously connected. To get to the port , enter the follow ing command. --:- units cli-> cd topology/<[...]

Chapter 1: Introduction, Navigati on and Commands 15 --:- units cli -> inspectdbuf overvi ew/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 o ne window . • /pattern - Search foward in the file for the fi[...]

16 Cyclades ACS 6000 Advanced Console Server Command Reference Guide CLI Equivalent Actions to W eb Manager Checkbox Sele ction NOTE: The following example pr ocedure, which configures IP v6, illustrates the actions to use in the CLI to enable or disable an option when a checkbox woul d be selected or deselected in the Web Manager . T o configure I[...]

Chapter 1: Introduction, Navigati on and Commands 17 [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 an d the AUX/Modem port are disabled. The administrator must enable and configure the ports before anyone can use them. Con figuration of ports differs based on the type of connected device, whi ch can be either a device consol e, a PDU or modem. By default, all users [...]

20 Cyclades ACS 6000 Advanced Console Server Command Reference Guide V iew Information About the Co nsole Server and Connected Devices When a regular user or an adminis trator enters show at the Topology level, information about the following appears in the form at show n in Table 2.2: • The console server • The AUX/Modem port (if it is enabled[...]

Chapter 2: Port Access and Conf iguration Examp les 21 T o view information about the console server and co nnected devices: 1. Log into the CLI and enter cd topo logy to change to th e T opology level. --:- units cli-> cd topology Please wait -- this could take a whi le 2. Enter sh ow . Info rmation about the console server and the ports the cu[...]

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 exam ple of how an administrat or or an authorized user can connect to a device[...]

Chapter 2: Port Access and Conf iguration Examp les 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 Connect ed to an Outlet on a PDU See power_cycle, power _off and power_on on page 12 for how an admi nistrator or an y authorized us[...]

24 Cyclades ACS 6000 Advanced Console Server Command Reference Guide 8. Enter set port_settings/serial_ profile=cas then enter comm it as shown to assign the CAS profile and save the settings. --:- port_settings cli-> set port_se ttings/ serial_profile=cas **:- port_settings cli-> commit --:- port_settings cli-> 9. Enter set port_settings/[...]

Chapter 2: Port Access and Conf iguration Examp les 25 6. T ype set port_settings/ then press Ta b to view the options for the Port _Settin gs parameter . --:- port_settings cli-> set port_se ttings/ < Tab > rj45_pin-out status serial_profile 7. Enter set port_settings/ status=enabled serial_profile= power then enter commit to set the Seri[...]

26 Cyclades ACS 6000 Advanced Console Server Command Reference Guide[...]

27 CHAPTER 3 CLI Appliance Settings Options This chapter describes the Appliance Setting s options. Only administrators and authori zed users can access the appliance_settings level. These procedures assume y ou 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[...]

28 Cyclades ACS 6000 Advanced Console Server Command Reference Guide See Table 3.1 through Table 3.13 for options available at each le vel 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_se[...]

Chapter 3: CLI Appliance Sett ings Options 29 Appliance_Settings/Network 1. Enter cd appliance_settings/netwo rk to na vigate to the Network le vel . --:- units cli-> cd appliance_settings/netwo rk 2. Enter show to view the list of available options. string_9 = string_10 = sensors current_temperature: (deg_c, display only) maximum_temperature_(d[...]

30 Cyclades ACS 6000 Advanced Console Server Command Reference Guide [X] enable_ipv6 (enable d 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.nnn ( ) ipv4_unconfigured ( )ipv6_method (*) stateless ( ) dhcpv6 ( [...]

Chapter 3: CLI Appliance Sett ings Options 31 mask: nnn.nnn.nnn.nnn ( ) ipv4_unconfigured ( ) ipv6_method (*) stateless ( ) dhcpv6 ( ) static ( ) address / prefix_length ( ) ipv6_unconfigured mac address: (information only) bonding bonding with eth0 as primary and eth1 as second mode of access mii mon (milliseconds) = 100 (default) up delay (millis[...]

32 Cyclades ACS 6000 Advanced Console Server Command Reference Guide IPv6 IPv4 addresses are always enabled. An administ rator can also enable IPv6 addres ses at the appliance_settings/netw ork /ipv6 level. A procedure to enable IPv6 is us ed as an example in CLI Equivalent Actions to Web Manager Checkbox Selection on page 16. Devices The procedure[...]

Chapter 3: CLI Appliance Sett ings Options 33 --:- settings cli-> show Host s The following procedure describes how to add a host to the hosts table. T o add a host to the host t able: 1. Enter cd appliance_settings/netwo rk/ho sts to navigate to the Hosts level. --:- units cli-> cd appliance_settings/netwo rk/hosts 2. Enter show to view the [...]

34 Cyclades ACS 6000 Advanced Console Server Command Reference Guide alias: 127.0.0.1/add 172.26.31.164/ 7. Enter cd <IP_address>/settings to navigate to the level where you can perform additio nal 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 Sett[...]

Chapter 3: CLI Appliance Sett ings Options 35 ( ) static address = prefix_length = gateway = (*) ipv6_address_unconfigure d mac address: 00:e0:86:0c:49:7a dns: primary = 172.26.29.4 dns: primary = 172.26.29.4 secondary = domain = corp.avocent.com hostname = ACS6016-0270095142 Some basic and useful keys are: - tab (once/twice) - shows the next possi[...]

36 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Appliance_Settings/Port s Enter cd appliance_se tti ngs/ports to navigate to the Po rt s level. --:- units cli-> cd appliance_settin gs/ports T able 3.3: Ports Options Ports Navigation T ree physical_ports serial_ports auxiliary_ports cas_profile default_settings general alerts[...]

Chapter 3: CLI Appliance Sett ings Options 37 T o enable and assign the Serial profile to a serial port: 1. Enter cd appliance_se tti ngs/ports/physical _po rts/serial_ports/ <n> /port_settings to navigate to the ports_settings le vel. Po rt 3 is used in the exam ple. --:- units cli-> cd appliance_settings/ports /physica l_ports/ serial_po[...]

38 Cyclades ACS 6000 Advanced Console Server Command Reference Guide --:- port_settings cli-> set port_se ttings/ status=enabled serial_profile=cas **:- port_settings cli-> commit --:- port_settings cli-> T o enable and configure the AUX/Modem port: 1. Enter cd appliance_se ttings/ports/physi c al_ports/auxiliary_ports/ttym1/ aux_port_sett[...]

Chapter 3: CLI Appliance Sett ings Options 39 --:- units cli-> cd appliance_settings/ports /dial-in _profile -or- --:- units cli-> cd appliance_settings/ports /power_p rofile Appliance_Settings/Plugga ble Devices Enter cd appliance_settings/p lu ggable_devices to navigate to the pluggable_devices level. --:- units cli-> cd appliance_settin[...]

40 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Appliance_Setting s/Authentication Enter cd appliance_se tti ngs/authentication to navigate to the authentication level. --:- units cli-> cd appliance_settin gs/authentication NOTE: Kerberos does not work unless the adm inistrator copies th e /etc/krb5.keyt ab file from the Ker[...]

Chapter 3: CLI Appliance Sett ings Options 41 Appliance_Settings/Users Enter cd appliance_settings/users to naviga te to the users lev e l. --:- Units cli-> cd appliance_settin gs/users T o add a user and password : 1. Enter cd appliance_settings/users /local_accounts/user_names to n avigate to the user_names level. --:- units cli-> cd applia[...]

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_passwor d=smith123abc --:#- [user_names] cli-> 3. Enter save . --:#- [user_names] cli-> save 4. Enter show to verify that the new user has been added. -[...]

Chapter 3: CLI Appliance Sett ings Options 43 NOTE: T o set a rule, you must enab le the interface, set the rule for the interfac e and physically connect the interface to the network. Appliance_Setti ngs/IPSec(VPN) Enter cd appliance_settings/ipse c(vp n) to navigate to the ipsec(vpn) level. --:- units cli-> cd appliance_settin gs/ipsec(vpn) T [...]

44 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Appliance_Settings/SNMP Enter cd appliance_se ttings/snmp to navigate to t he snmp level . --:- units cli-> cd appliance_settin gs/snmp ip_address = next_hop = subnet = ipsec(vpn)_authentication authentication_method ( ) rsa_key remote_side_rsa = local_side_rsa = ( ) secret pre[...]

Chapter 3: CLI Appliance Sett ings Options 45 Appliance_Settings/Date and T ime Enter cd appliance_settings/date_a nd_time to navigate to the date_and_time level. --:- units cli-> cd appliance_settin gs/date_and_time ( ) version v1/v2 ipv6 source ( ) version v3 authentication_type md5 sha authentication_pass_phrase des_pass_phrase minimum_authen[...]

46 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Appliance_Settings/ Boot Configuration Enter cd appliance_se ttings/boot_confi guration to navigate to the boot_configuration level . --:- units cli-> cd appliance_settin gs/boot_configuration hour = minute = second = time_zone (*) predefined zone = utc ( ) define name = acrony[...]

Chapter 3: CLI Appliance Sett ings Options 47 Appliance_Settings/Online Help Enter cd appliance_settings/onlin e_h elp to navigate to the online_help level. --:- units cli-> cd appliance_settin gs/online_help T o set the online help URL: Perform this procedure i f you have downloaded the online help files to a web server that is accessible to th[...]

48 Cyclades ACS 6000 Advanced Console Server Command Reference Guide[...]

49 CHAPTER 4 CLI Overview , Information, Active Sessions and Power Management Options This section provides procedures for some ta sks th at the administrator can perform at th e following levels of the CLI. Only administrators and authorized users can access the Information, Active Sessions and Power Management levels. Overview Options T o view an[...]

50 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Information Options T o view and perform Information options: 1. Log onto the CLI as an administrator and change to the informatio n level. --:- units cli-> cd information --:- information cli-> 2. Enter show to view the Information options --:- information cli-> show . s[...]

Chapter 4: CLI Overview, Informat ion, Active Sessions and Power Ma nagement Options 51 3. Enter cd < navigation option fr om list > to view any of the options. 4. Enter show to view the list of available parameters. This procedure continues d own th e hierarchical levels. See Table 4.3 for the options and and their default settings. T able 4[...]

52 Cyclades ACS 6000 Advanced Console Server Command Reference Guide inactive Size: 83344 kB mapped Size: 14844 kB memfree Size: 1 19404 kB memtotal Size: 257436 kB nfs_unstable Size: 0 kB pagetables Size: 1000 kB slab Size: 5812 kB sreclaimable Size: 2572 kB sunreclaim Size: 3240 kB swapcached Size: 0 kB swapfree Size: 0 kB swaptotal Size: 0 kB vm[...]

Chapter 4: CLI Overview, Informat ion, Active Sessions and Power Ma nagement Options 53 Active Sessions Information The Active Session information fields are described in Table 4.4. An authorized user can kill an active session with th e Kill command. T o view and kill Active_Sessions: 1. From the units level CLI prompt, enter cd active_s essions .[...]

54 Cyclades ACS 6000 Advanced Console Server Command Reference Guide --:- active_sessions cli-> kill 37 Power Management Options The Power Management Op tions are described in Table 4.5 . T o rename a PDU: 1. Log onto the CLI as an administrator and enter cd power_management/settin gs to navigate to the settings level. --:- units cli-> cd pow[...]

55 Appendices Appendix A: Enabling Firmware Upgrades When the Boot Image is not in Flash T o 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-> s[...]

56 Cyclades ACS 6000 Advanced Console Server Command Reference Guide Appendix B: T echnical Support Our Technical Support staff is ready to assist you with any installation or op erating issues you encounter with your Avocent produ ct. If an issue should develo p, follow the steps belo w for the fastest possible service. T o resolve an issue: 1. Ch[...]

57 INDEX Index A access options (CLI) 3 add command 7 Appliance Settings options 27 autocompletion 5 AUX/Modem port configure 19 enable 38 C CAS Profile 20 , 22 cd command 8 cleandbuf command 15 CLI utility access options 3 introduction 1 log in 3 navigation 4 command line syntax 6 command set 7 commit command 11 connect command 9 connect to a seri[...]

58 Cyclades ACS 6000 Advanced Console Server Command Reference Guide on command 12 opiepasswd command 13 outlet groups 54 Overview options 49 P parameters 6 passwd command 13 PC cards, configure 39 PDUs AUX/Modem port connection 2 manage power on outlets 19 manage power, procedure 24 ports for 1 power management and configurati on op tion s 54 powe[...]

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. This equipment gener[...]

For T echnical Support : www.avocent.com/support 590- 7 70 -50 1B C yclades ® ACS 6000 Installation/Administration/User Guide[...]