Avocent ACS 800/ACS 8000 Advanced Console System Command Reference Guide

58 Pages·2017·0.45 MB·English

Avocent® ACS800/8000
Advanced Console System
CommandReference Guide
Theinformationcontainedinthisdocumentissubjecttochangewithoutnotice
andmaynotbesuitableforallapplications.Whileeveryprecautionhasbeen
takentoensuretheaccuracyandcompletenessofthisdocument,Vertiv
assumesnoresponsibilityanddisclaimsallliabilityfordamagesresultingfrom
useofthisinformationorforanyerrorsoromissions.Refertootherlocal
practicesorbuildingcodesasapplicableforthecorrectmethods,tools,and
materialstobeusedinperformingproceduresnotspecificallydescribedinthis
document.
Theproductscoveredbythisinstructionmanualaremanufacturedand/orsold
byVertiv.ThisdocumentisthepropertyofVertivandcontainsconfidential
andproprietaryinformationownedbyVertiv.Anycopying,useordisclosureof
itwithoutthewrittenpermissionofVertivisstrictlyprohibited.
Namesofcompaniesandproductsaretrademarksorregisteredtrademarksof
therespectivecompanies.Anyquestionsregardingusageoftrademarknames
shouldbedirectedtotheoriginalmanufacturer.
TechnicalSupportSite
Ifyouencounteranyinstallationoroperationalissueswithyourproduct,checkthepertinentsectionofthis
manualtoseeiftheissuecanberesolvedbyfollowingoutlinedprocedures.
Visithttps://www.VertivCo.com/en-us/support/foradditionalassistance.
Vertiv™|Avocent®ACS800/8000AdvancedConsoleSystemCommandReferenceGuide
TABLE OFCONTENTS
1Introduction,NavigationandCommands 1
1.1 AccessOptionsandHowtoLogintotheCLI 1
1.2 ConfigurationTasksPerformedWiththeCLI 2
1.3 CLI Navigation 2
1.4 Autocompletion 4
1.5 Parameters 4
2CLICommandSet 5
2.1 CommandsUsedfortheCLI 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,lockandunlock 11
2.2 SpecialMulti-sessionCommands 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_databufandshow_appliance_databuf 14
2.2.7 cleandbufandclean_appliance_databuf 15
2.3 CLIEquivalentActionstoWebManagerCheckboxSelection 15
3PortAccessandConfigurationExamples 19
3.1 ViewInformationAbouttheConsoleSystemandConnectedDevices 19
3.2 ConnecttoaDeviceConsoleConnectedtoaSerialPort 21
Vertiv|Avocent®ACS800/8000AdvancedConsoleSystemCommandReferenceGuide| i
3.3 AccessingSerialPortsusingts_menu 22
3.4 ManagePowerforaDeviceConnectedtoanOutletonaPDU 22
3.5 PortConfigurationExamples 22
4CLIOverviewforAdministrators 25
4.1 System 25
4.2 System/Security 25
4.2.1 System/DateandTime 27
4.2.2 System/HelpandLanguage 27
4.2.3 System/General 28
4.2.4 System/BootConfiguration 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/IPv4andIPv6 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 Wizcommand 36
4.6 Ports 37
4.6.1 Auxiliaryports 41
4.7 PluggableDevices 42
4.8 Authentication 42
4.9 Users 44
4.10 Events_and_Logs 47
4.11 PowerManagement 48
4.12 ActiveSessionsInformation 49
4.13 ChangePassword 50
Appendices 51
AppendixA: RecoveringaConsoleSystemThatWillNotBootFromFlash 51
AppendixB: MigrationCLI 53
AppendixC: SuandSudoCommands 57
Vertiv|Avocent®ACS800/8000AdvancedConsoleSystemCommandReferenceGuide| ii
1 INTRODUCTION, NAVIGATION AND COMMANDS
TheAvocent®ACS800/8000AdvancedConsoleSystemservesasasinglepointforaccessandadministrationof
connecteddevices,suchastargetdeviceconsoles,modemsandpowerdevices.Consolesystemssupportsecureremote
datacentermanagementandout-of-bandmanagementofITassetsfromanylocationworldwide.
ThisguidedescribeshowtoaccessandnavigatetheCommandLineInterface(CLI) utilityandhowtouseitafterthe
consolesystemhasbeeninstalledandassignedanIPaddress.Forinformationonhowtoinstalloroperateyourconsole
systemusingthewebuserinterface(UI),seetheAvocent®ACS800/8000AdvancedConsoleSystemInstallation/User
Guide.
1.1 Access Options andHow to Loginto the CLI
TheCLIutilitycanbeaccessedinthefollowingways:
• Throughalocalterminaloracomputerthathasaterminalemulationprogramconnectedtotheconsoleportof
theconsolesystemwithsessionsettingsof9600,8,Nand1,withnoflowcontrol.Thelocalconsolespeedcan
bemodifiedinthedevice'sbootconfiguration.
• AftertheconsolesystemisconnectedtothenetworkandhasanIPaddress,itcanbeaccessedbyoneofthe
followingmethods:
• AnSSHorTelnetclientonaremotecomputer(iftheSSHorTelnetprotocolisenabledintheselected
SecurityProfile)
• WiththeWebManager-Access-ApplianceViewerbutton
• WithDSViewmanagementsoftware
NOTE:FordetailsontheremoteaccessmethodsandIPaddressconfigurationoptions,seetheAvocent®
ACS800/8000AdvancedConsoleSystemInstallation/UserGuide.
AdministratorshavefullaccesstotheCLIandtoconnecteddevices.Anadministratorcanauthorizeregularuserstoaccess
ports,managepower,managedatabufferstorageanduseoneormoreconsolesystemadministrationtools.Userscan
alwayschangetheirownpasswords.
TostarttheCLI:
1. AnadministratorcanaccesstheCLIthroughtheconsoleport,withTelnet,SSHorthroughthewebmanager.
2. Entertheusernameandpasswordattheprompt.Thecli->promptappears.
-or-
A rootuserlogsintotheLinuxshellbydefault.Fromtheshell,typeclitolaunchtheCLI.
WelcometoACS8000<hostname>.
Typehelpformoreinformation
--:-/cli->
Thedefaultusernameisadmin.Thefirsttimeyouloginasadmin,leavethepasswordfieldblank.Youarepromptedto
createanewpassword.
1
1.2 ConfigurationTasks PerformedWiththe CLI
ThenavigationstructureoftheCLImirrorsthatofthewebmanager.Optionsandparametersarealsothesame,exceptthat
spacesinwebmanageroptionsandparametersarereplacedwithunderscores(_),asinsystem_tools.Examplesthatshow
howtoselectanoptioninthewebmanageruseadashsurroundedbytwospaces( -).IntheCLI,twosimilaroptionsina
pathareseparatedbyaforwardslash(/).
Forexample,inthewebmanager,userconfigurationisdonewhenanadministratorselectsUsers-LocalAccounts-User
NamestogettotheUserNamesscreen.TonavigatetotheequivalentconfigurationlevelintheCLI,anadministratorwould
usethecdcommandfollowedbythepath:cd/users/local_accounts/user_names.
AdministratorsshouldlogintotheCLIinonewindowandlogintothewebmanagerinanotherwindowtoseehowthemenu
optionsinthewebmanagermaptothenavigationoptionsintheCLI.ConfigurationwiththeCLIalsorequiresmasteryof
thefollowinginformationonCLInavigationandoftheCLIcommands.Formoreinformation,seeCLICommandSetonpage
5
1.3 CLI Navigation
TheCLInavigationoptionsareinanestedtreeconfiguration.
Whenacommandlineisshowninanexample,andthestepstartswith“Enter,”orwhenasyntaxexampleisgiven,theuser
shouldtypethecommandasshownandthenpressEnter.TheEnterkeyisnotshownincommandlineexamplesunless
neededforclarity.
WhenauserlogsintheCLI,thepromptindicatestheuserisatthe/level.
--:-/cli->
Noparameterscanbesetatthislevelofthenavigationtree.
AtanyCLIpromptatanylevel,ifyoutypecd<space>TabTaborcdTabTabTab,thenavigationoptions(pathelements)
forthatlevelarelisted.Differentoptionsappearforadministratorsandforauthorizedusers.
• WhenanadministratortypesthecdcommandandthenpressesTabTabatthe/prompt,thefollowing
navigationoptions(pathelements)appear.
--:-/cli->cd
access/ monitoring/ sensors/
active_sessions/ network/ system/
pluggable_ system_
authentication/
devices/ tools/
change_password/ ports/ users/
power_
events_and_logs/
management
WhenaregularusertypesthecdcommandandthenpressesTabTabatthe/prompt,thefollowingnavigationoptions
appear.
--:-/cli->cd
access/ change_password/ power_management/
2 Vertiv™|Avocent®ACS800/8000AdvancedConsoleSystemCommandReferenceGuide
Entercd<one_or_more_path_elements>tomovedownoneormorelevelsofthenavigationtree:
--:-/cli->cdsystem_tools
Apromptlikethefollowingappearsateachlevel:
--:-system_toolscli->
NOTE:CLIcommandsarecasesensitive.
Atanylevel,youcanpressTabTabattheprompttoseethecommandsthatcanbeenteredatthecurrentlevel.
--:-/cli->
add pwd
cd quit
clone_ports reboot
reset_port_to_
commit
factory
restore_
configuration_integrity
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_
shell
certificate
help show
hostname shutdown
list_configuration upgrade_firmware
ls whoami
opiepasswd wiz
passwd
1Introduction,NavigationandCommands 3
Ifyouknowthepath,youcanentermultiplepathelementsinasinglecommandseparatedwithforwardslashes(/).
--:-/cli->cdports/serial_ports/
--:-serialportscli->
Entercd..tomoveuponelevelofthenavigationtree.Entercd../..[/..]tomoveupmultiplelevels.
--:-serialportscli->cd../..
--:-/cli->
1.4 Autocompletion
AutocompletionallowsyoutotypethefirstfewlettersofacommandornavigationoptionandthenpressTab.Therestof
thenameisfilledinautomaticallyiftheletterstypedareuniquetoonecommandortoanavigationoptionatthatlevel.If
thelettersmatchmorethanoneofthecommandsornavigationoptionsforthatlevel,thematchingoptionsarelisted.
Forexample,ifyoutypecdaccandpressTabattheCLIpromptfromthe/level,theaccessoptionwillbecompleted.
--:-/cli->cdacc<tab> 
--:-/cli->cdaccess
IfyouthenpressEnter,youarechangedtotheaccesslevel,andtheaccesslevelpromptappears.
--:-accesscli->
Thefollowingexampleillustratesacasewhenmorethanonecommandmatchestheletterstyped.
--:-/cli->sh<tab> <tab>
shellshow
1.5 Parameters
SomeCLIcommandstakeparameters.IfyoupressTabTabafteracommandthatrequiresaparameter,youareprompted
toentertheparameter.
4 Vertiv™|Avocent®ACS800/8000AdvancedConsoleSystemCommandReferenceGuide
2 CLI COMMAND SET
2.1 Commands Usedfor the CLI
Thissectiondescribesthegeneralcommandsusedwhenaccessingtheconsolesystemwiththecommandlineinterface.
NOTE:Mostofthecommandsworkfromanylocationwhenthepathtothecommandparameterisincluded.
NOTE:Theword“node”referstoanentitysuchasaroute,hostoruser,whichcanbeadded,configuredordeleted.
2.1.1 add
Addanode.
Syntax:
--:-/cli->add<Path>
Example:
--:-/cli->addnetwork/hosts
--:#-[hosts]cli->
2.1.2 cd
Changedirectory(level).
Syntax:
--:-/cli->cd<Path>
Example:
--:-/cli->cdaccess
Displaysthefollowing:
--:-accesscli->
Example:
--:-accesscli->cd..
-or-
5
--:-accesscli->cd../
Movesuponedirectorylevelanddisplaysthefollowing:
--:-/cli->
Example:
--:-accesscli->cd/
Movestothetoplevelanddisplaysthefollowing:
--:-/cli->
Example:
--:-accesscli->cd/information
Displaysthefollowing:
--:-informationcli->
2.1.3 commit
Savesettings.
Syntax:
**:-settingscli->commit
2.1.4 delete
Deleteanode.
Syntax:
--:-/cli->delete<Path><parameter>
2.1.5 exit/quit
ExittheCLIandreturntotheloginprompt.
Syntax:
6 Vertiv™|Avocent®ACS800/8000AdvancedConsoleSystemCommandReferenceGuide