Table Of Contents
ACS Express Command Reference
This appendix contains an alphabetical listing of the commands specific to the Cisco Secure ACS Express server software. There are two types of commands:
•
EXEC
–
–
•
–
Each of the commands in this appendix has a brief description of its use, command syntax, usage guidelines, and one or more examples.
Note
EXEC Commands
•
•
•
•
•
•
•
•
•
Show Commands
Configuration Commands
Configuration commands include commands such as interface and repository.
Note
•
•
•
EXEC Commands
Each EXEC command includes a brief description of its use, command syntax, usage guidelines, and sample output.
acsexport
To export the Cisco ACS Express configuration, use the acsexport command in the EXEC mode.
acsexport <filename> repository <word> secret <word>
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Exports an XML file containing Cisco ACS Express configuration which includes configuration and administrative information.
Examples
The following example illustrates the use of acsexport command.
acsexpress1/admin# acsxp-srv2/admin# acsexport master_config.xml repository tftprepo secret secret123Related Commands
acsimport
To import the Cisco ACS Express configuration, use the acsimport command in the EXEC mode.
acsimport <filename> repository <word> [secret <word> ] [ flushconfig | validateflush | validateonly ]
Syntax Description
Defaults
There are no optional values. Default behavior is to import without flushing existing object. The configuration in the XML file is merged with existing configuration.
Command Modes
EXEC
Command History
Usage Guidelines
Imports an XML file containing Cisco ACS Express configuration which includes configuration and administrative information.
Examples
The following example illustrates the use of acsexport command.
acsexpress1/admin# acsimport master_config.xml repository tftprepo flushconfigacsexpress1/admin#Related Commands
acsexport
Exports the Cisco ACS Express configuration or administrative information in an XML file.
application install
To install a specific application, use the application install command in the EXEC mode. To remove this function, use the application remove command.
application {install} application-bundle remote-repository-name
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Installs the specified application bundle on the appliance. The application bundle file is pulled from the specified repository.
Examples
The following example illustrates the use of application install command.
acsexpress1/admin# application install acsexpress.tar.gz tftp repoacsexpress1/admin#Related Commands
application remove
To remove a specific application, use the application remove command in the EXEC mode. To remove this function, use the no form of this command.
application {remove} application-name
Syntax Description
remove
Removes or uninstalls an application.
application-name
Application name; up to 255 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Removes or uninstalls an application.
Examples
The following example illustrates the use of the application remove command.
acsexpress1/admin# application remove acsexpressacsexpress1/admin#Related Commands
application start
To enable a specific application, use the application start command in the EXEC mode. To remove this function, use the no form of this command.
application {start} application-name
Syntax Description
start
Enables an application bundle.
application-name
Name of the predefined application you want to enable; up to 255 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Enables an application.
Examples
The following example illustrates the use of the application start command.
acsexpress1/admin# application start acsexpressacsexpress1/admin#Related Commands
application stop
To disable a specific application, use the application stop command in the EXEC mode. To remove this function, use the no form of this command.
application {stop} application-name
Syntax Description
stop
Disables an application.
application-name
Name of the pre-defined application you want to disable; up to 255 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Disables an application.
Examples
The following example illustrates the use of the application stop command.
acsexpress1/admin# application stop acsexpressacsexpress1/admin#Related Commands
application upgrade
To upgrade a specific application bundle, use the application upgrade command in the EXEC mode. To remove this function, use the application remove command.
application {upgrade} application-bundle remote-repository-name
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Upgrades an existing application and preserves any application configuration data.
Examples
The following example illustrates the use of the application upgrade command.
acsexpress1/admin# application upgrade acsexpress myremoterepositoryacsexpress1/admin#Related Commands
backup
To perform a backup and place the backup in a repository, use the backup command in the EXEC mode. To remove this function, use the no form of this command.
backup backup-name repository repository-name
Syntax Description
backup-name
Name of backup file; up to 100 alphanumeric characters.
repository
Repository command.
repository-name
Location where files should be backed up; up to 30 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Performs a backup and stores the backup file in the specified repository.
For information on repository configuration and to view an example for creating a repository, see repository.
Examples
The following example illustrates the use of the backup command.
acsexpress1/admin# backup mybackup repository myrepositoryacsexpress1/admin#Related Commands
backup-logs
To back up system logs, use the backup-logs command in the EXEC mode. To remove this function, use the no form of this command.
backup-logs backup-name repository repository-name
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Backs up system logs and stores the backup file in the specified repository.
For information on repository configuration and to view an example for creating a repository, see repository.
Examples
The following example illustrates the use of the backup-logs command.
acsexpress1/admin# backup-logs mysyslogs repository myrepositoryacsexpress1/admin#Related Commands
clock
To set the system clock, use the clock command in the EXEC mode. To remove this function, use the no form of this command.
clock {set}[month day hh:min:ss yyyy]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Sets the system clock.
Examples
The following example illustrates the use of the clock command.
acsexpress1/admin# clock set Jan 4 5:05:05 2007acsexpress1/admin#Related Commands
configure
To enter configuration mode, use the configure EXEC command. If using the replace option, copies a remote configuration to the system, overwriting the existing configuration.
configure {terminal | protocol://ip-address/location}
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to enter the configuration mode. Note that commands in this mode write to the running configuration file as soon as you enter them (using the Enter key/Carriage Return).
To leave the configuration mode and return to EXEC mode, type end or exit or press Ctrl-Z.
To view the changes to the configuration you have made, use the show running-config command in the EXEC mode.
Examples
The following example illustrates the use of the configure command.
acsexpress1/admin# configure terminalEnter configuration commands, one per line. End with CNTL/Z.acsexpress1/admin(config)#Related Commands
copy
To copy any file from a source to a destination, use the copy command in the EXEC mode. Currently, the copy command in ACS Express server copies a configuration (either running or startup).
Running configuration
The ACS Express appliance active configuration stores itself in the ACS Express appliance RAM. Every configuration command you give stores itself in the running configuration. If you reboot your ACS Express appliance, you lose the configuration. If you make changes that you want to save, you must copy the running configuration to a safe location, such as a network server, or save it as the ACS Express appliance startup configuration.
Startup configuration
You cannot edit a startup configuration directly. All commands you enter store themselves in the running configuration, which you can copy into the startup configuration.
In other words, when you boot an ACS Express appliance, the startup configuration becomes the initial running configuration. As you modify the configuration, the two diverge: the startup configuration remains the same, while the running configuration reflects the changes you have made. If you want to make your changes permanent, you must copy the running configuration to the startup configuration.
The following command lines show some of the copy command scenarios available:
copy running-configuration startup-configuration
Copies the running-configuration to the startup-configuration. Replaces the startup-configuration with the running-configuration.
Note
copy startup-configuration running-configuration
Copies the startup-configuration to the running-configuration. Merges the startup-configuration on top of the running-configuration.
copy [protocol://hostname/location] startup-configuration
Copies but does not merge a remote file to the startup-configuration.
copy [protocol://hostname/location] running-configuration
Copies and merges a remote file to the running-configuration.
copy startup-configuration [protocol://hostname/location]
Copies the startup-configuration to a remote system.
copy running-configuration [protocol://hostname/location]
Copies the running-configuration to a remote system.
copy logs [protocol://hostname/location]
Copies log files from the system to another location.
Note
Syntax Description
running-
configurationRepresents the current running configuration file.
startup-configuration
Represents the configuration file used during initialization (startup).
protocol
See Table A-1 for protocol keyword options.
hostname
Hostname of destination.
location
Location of destination.
logs
The log files of the system.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
The fundamental function of the copy command allows you to copy a file (such as a system image or configuration file) from one location to another location. The source and destination for the file specified, uses the Application Deployment Engine OS file system, which allows you to specify any supported local or remote file location. The file system being used (a local memory source, or a remote server) dictates the syntax used in the command.
You can enter on the command line all the necessary source and destination information and the username and password to use, or you can enter the copy command and have the ACS Express server system prompt you for any missing information.
Timesaver
The entire copying process might take several minutes and differs from protocol to protocol and from network to network.
Use the filename relative to the directory for file transfers.
Examples
The following example illustrates the use of the copy command.
acsexpress1/admin# copy run startacsexpress1/admin#Related Commands
delete
Deletes a file from the ACS Express system.
dir
Lists a file from the ACS Express system.
reload
Reboots the system.
debug
To display errors or events for command situations, use the debug command in the EXEC mode.
debug [all] [application] [backup-restore] [cdp] [config] [copy] [locks] [logging] [snmp] [system] [transfer] [user] [utils]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use the debug command to identify various failures within the ACS Express system; for example, setup failures or configuration failures.
Examples
The following example illustrates the use of the debug command.
acsexpress1/admin# debug allacsexpress1/admin# mkdir disk:/1acsexpress1/admin# 6 [7178]: utils: vsh_root_stubs.c[2301]: mkdir operation successacsexpress1/admin# rmdir disk:/1acsexpress1/admin# 6 [7180]: utils: vsh_root_stubs.c[2171]: Invoked Remove Directory disk:/1 command 6 [7180]: utils: vsh_root_stubs.c[2228]: Remove Directory operation successacsexpress1/admin# undebug allRelated Commands
undebug
Disables the output (display of errors or events) of the debug command for various command situations.
delete
To delete a file from the ACS Express system, use the delete command in the EXEC mode. To remove this function, use the no form of this command.
delete filename
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
If you attempt to delete the configuration file or image, the system prompts you to confirm the deletion. Also, if you attempt to delete the last valid system image, the system prompts you to confirm the deletion.
Examples
The following example illustrates the use of the delete command.
acsexpress1/admin# delete myfileacsexpress1/admin#Related Commands
dir
To list a file from the ACS Express system, use the dir command in the EXEC mode. To remove this function, use the no form of this command.
dir [word] [recursive]
Syntax Description
word
Directory name; up to 80 alphanumeric characters. Requires disk:/ preceding the directory name.
recursive
Lists a local directory or filename recursively.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following examples illustrate the use of the dir command.
Example 1
acsexpress1/admin# dirDirectory of disk:/16384 Jul 02 2007 08:34:49 lost+found/4096 Jul 16 2007 02:10:20 mytest/4096 Jul 11 2007 09:12:12 save-config/Usage for disk: filesystem49741824 bytes total used6815842304 bytes free7233003520 bytes availableacsexpress1/admin#Example 2
acsexpress1/admin# dir disk:/mytestDirectory of disk:/mytestUsage for disk: filesystem49741824 bytes total used6815842304 bytes free7233003520 bytes availableacsexpress1/admin#Example 3
acsexpress1/admin# dir recursiveDirectory of disk:/4096 Jul 16 2007 02:10:20 mytest/16384 Jul 02 2007 08:34:49 lost+found/4096 Jul 11 2007 09:12:12 save-config/Directory of disk:/mytestNo files in directoryDirectory of disk:/lost+foundNo files in directoryDirectory of disk:/save-config555 Jul 11 2007 09:12:12 running-configUsage for disk: filesystem49741824 bytes total used6815842304 bytes free7233003520 bytes availableRelated Commands
exit
To close an active terminal session by logging out of the ACS Express system or to move up one mode level from the configuration mode, use the exit command in the EXEC mode.
exit
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use the exit command in EXEC mode to exit the active session (log out of the ACS Express appliance) or to move up from the configuration mode.
Examples
The following example illustrates the use of the exit command.
acsexpress1/admin# exitRelated Commands
end
Exits the configuration mode.
exit
Exits the configuration mode or EXEC mode.
Ctrl-Z
Exits the configuration mode.
halt
To shutdown and power off the system, use the halt command in EXEC mode.
halt
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the halt command.
acsexpress1/admin# haltacsexpress1/admin#Related Commands
help
To describe the interactive help system for the ACS Express system, use the help command in EXEC mode.
help
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
All configuration modes
Command History
Usage Guidelines
The help command provides a brief description of the context-sensitive help system, which functions as follows:
•
•
•
Examples
The following example illustrates the use of the help command.
acsexpress1/admin# helpHelp may be requested at any point in a command by enteringa question mark '?'. If nothing matches, the help list willbe empty and you must backup until entering a '?' shows theavailable options.Two styles of help are provided:1. Full help is available when you are ready to enter acommand argument (e.g. 'show ?') and describes each possibleargument.2. Partial help is provided when an abbreviated argument is enteredand you want to know what arguments match the input(e.g. 'show pr?'.)acsexpress1/admin#mkdir
To create a new directory on the ACS Express system, use the mkdir command in EXEC mode.
mkdir directory-name [disk: /path]
Syntax Description
directory-name
The name of the directory to create. Use disk: /path with the directory name; up to 80 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use disk: /path with the directory name. Otherwise, an error indicating that the disk: /path must be included is displayed.
Examples
The following example illustrates the use of the mkdir command.
acsexpress1/admin# mkdir disk:/test/acsexpress1/admin# dirDirectory of disk:/16384 Jun 28 2007 00:09:50 lost+found/4096 Jun 28 2007 14:34:27 test/Usage for disk: filesystem88150016 bytes total used44585803776 bytes free47064707072 bytes available acsexpress1/admin#Related Commands
dir
Displays a list of files on the ACS Express system.
rmdir
Removes an existing directory.
nslookup
To look up the hostname of a remote system on the ACS Express system, use the nslookup command in EXEC mode.
nslookup word
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
TBD
Examples
The following examples illustrate the use of the nslookup command.
Example 1
acsexpress1/admin# nslookup 1.2.3.4Trying "4.3.2.1.in-addr.arpa"Host 4.3.2.1.in-addr.arpa not found: 3(NXDOMAIN) Received 105 bytes from 209.165.200.225#53 in 5 msExample 2
acsexpress1/admin# nslookup 209.165.200.225Trying "225.200.165.209.in-addr.arpa";; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 15007 ;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 2, ADDITIONAL: 2;; QUESTION SECTION:;225.200.165.209.in-addr.arpa. IN PTR;; ANSWER SECTION:225.200.165.209.in-addr.arpa. 86400 IN PTR acsexpress1.cisco.com.;; AUTHORITY SECTION:165.209.in-addr.arpa. 86400 IN NS ns2.cisco.com.165.209.in-addr.arpa. 86400 IN NS ns1.cisco.com.;; ADDITIONAL SECTION:ns1.cisco.com. 86400 IN A 209.165.200.225ns2.cisco.com. 86400 IN A 209.165.200.225Received 146 bytes from 172.69.2.133#53 in 5 msacsexpress1/admin#ping
To diagnose basic network activity on a remote system, use the ping command in EXEC mode.
ping [ip-address|hostname]
Syntax Description
ip-address
IP address of the system to ping; up to 32 alphanumeric characters.
hostname
Host name of the system to ping; up to 32 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
The ping command sends an echo request packet to an address, then awaits a reply. The ping output can help you evaluate path-to-host reliability, delays over the path, and whether you can reach the host or not.
Examples
The following example illustrates the use of the ping command.
acsexpress1/admin# ping 172.16.0.1PING 172.16.0.1 (172.16.0.1) 56(84) bytes of data.64 bytes from 172.16.0.1: icmp_seq=0 ttl=64 time=0.041 ms64 bytes from 172.16.0.1: icmp_seq=1 ttl=64 time=0.029 ms64 bytes from 172.16.0.1: icmp_seq=2 ttl=64 time=0.029 ms64 bytes from 172.16.0.1: icmp_seq=3 ttl=64 time=0.026 ms--- 172.16.0.1 ping statistics ---4 packets transmitted, 4 received, 0% packet loss, time 3000msrtt min/avg/max/mdev = 0.026/0.031/0.041/0.007 ms, pipe 2acsexpress1/admin#reload
To reload the operating system, use the reload command in EXEC mode.
reload
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
The reload command halts the system. Use the reload command after the configuration information is entered into a file and saved to the startup configuration.
Examples
The following example illustrates the use of the reload command.
acsexpress1/admin# reloadacsexpress1/admin#Related Commands
restore
To perform a restore and take the backup out of a repository, use the restore command in the EXEC mode. To remove this function, use the no form of this command.
restore filename.tar.gpg repository repository-name
Note
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the restore command.
acsexpress1/admin# restore backup1.tar.gpg repository repository1acsexpress1/admin#Related Commands
rmdir
To remove an existing directory, use the rmdir command in the EXEC mode.
rmdir word
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the rmdir command.
acsexpress1/admin# mkdir disk:/test/acsexpress1/admin# dirDirectory of disk:/16384 Jun 28 2007 00:09:50 lost+found/4096 Jun 28 2007 14:34:27 test/Usage for disk: filesystem88150016 bytes total used44585803776 bytes free47064707072 bytes available acsexpress1/admin#acsexpress1/admin# rmdir disk:/testacsexpress1/admin# dirDirectory of disk:/16384 Jun 28 2007 00:09:50 lost+found/Usage for disk: filesystem88145920 bytes total used44585807872 bytes free47064707072 bytes available acsexpress1/admin#Related Commands
dir
Displays a list of files on the ACS Express system.
mkdir
Creates a new directory.
show
To show the running system information, use the show command in the EXEC mode. For a complete list of all the ACS Express Show commands, see Table A-2 and the "Show Commands" section.
show keyword
Syntax Description
See Table A-2.
Table A-2 Summary of Show Commands
Displays information about the installed application, for example, status information or version information.
(requires keyword)Displays information about the backup.
(requires keyword)Displays information about the enabled Cisco Discovery Protocol (CDP) interfaces.
Displays the day, date, time, time zone, and year of the system clock.
Displays CPU information.
Displays file system information of the disks.
Displays statistics for all the interfaces configured on the ACS Express system.
(requires keyword)Displays ACS Express system logging information.
(requires keyword)Displays ACS Express login history.
Displays the status of the Network Time Protocol (NTP).
Displays all the processes listening on the active ports.
Displays information about the active processes of the ACS Express system.
(requires keyword)Displays the file contents of a specific repository.
(requires keyword)Displays ACS Express restore history.
Displays the contents of the currently running configuration file on the ACS Express system.
Displays the contents of the startup configuration on the ACS Express system.
Displays system and configuration information you can provide to the Cisco Technical Assistance Center (TAC) when reporting a problem.
Displays information about the terminal configuration parameter settings for the current terminal line.
Displays the current time zone of the ACS Express system.
Displays all the time zones available for use on the ACS Express system.
Displays information about the system's Unique Device Identifier (UDI).
Displays how long the system you are logged in to has been up and running.
Displays information for currently logged-in users.
Displays information about the currently loaded software version along with hardware and device information.
1 The commands in this table require the show command followed by a keyword; for example, show application.
2 Some show commands require an argument or variable after the keyword to function; for example, show application version. This show command displays the version of the application installed on the system (see show application).
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
All show commands require at least one keyword to function.
Examples
The following example illustrates the use of the show command.
acsexpress1/admin# show application<name> <Description>acsexpress Cisco Secure ACS Express 5.0acsexpress1/admin#ssh
To start an encrypted session with a remote system, use the ssh command in EXEC mode.
Note
ssh [ip-address|hostname] username port [number] version [1|2] delete hostkey word
Syntax Description
Defaults
Disabled.
Command Modes
EXEC (Admin or Operator)
Command History
Usage Guidelines
The ssh command enables a system to make a secure, encrypted connection to another remote system or server. This connection provides functionality similar to that of an outbound Telnet connection except that the connection is encrypted. With authentication and encryption, the SSH client allows for a secure communication over an insecure network.
Examples
The following examples illustrate the use of the ssh command.
Example 1
acsexpress1/admin# ssh delete hostkey mtm-sun8acsexpress1/admin#Example 2
acsexpress1/admin# ssh cam2 adminadmin@cam2's password:Last login: Wed Jul 11 05:53:20 2007 from acsexpress1.cisco.comcam2/admin#tech
To dump a Transmission Control Protocol (TCP) package to the console, use the tech command in EXEC mode.
tech {dumptcp} GigabitEthernet count
Syntax Description
dumptcp
Dumps TCP package to console.
GigabitEthernet
GigabitEthernet number 0 or 1.
count
Specific maximum package count.
Defaults
Disabled
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the tech command.
acsexpress1/admin# tech dumptcp 0140816:141088(272) ack 1921 win 1414408:26:12.034630 IP acsexpress1.cisco.com.ssh > dhcp-64-102-82-153.cisco.com.2221: P 141088:141248(160) ack 1921 win 1414408:26:12.034635 IP dhcp-64-102-82-153.cisco.com.2221 > acsexpress1.cisco.com.ssh: . ack 139632 win 6465608:26:12.034677 IP acsexpress1.cisco.com.ssh > dhcp-64-102-82-153.cisco.com.2221: P 141248:141520(272) ack 1921 win 1414408:26:12.034713 IP acsexpress1.cisco.com.ssh > dhcp-64-102-82-153.cisco.com.2221: P 141520:141680(160) ack 1921 win 1414408:26:12.034754 IP acsexpress1.cisco.com.ssh > dhcp-64-102-82-153.cisco.com.2221: P 141680:141952(272) ack 1921 win 1414408:26:12.034756 IP dhcp-64-102-82-153.cisco.com.2221 > acsexpress1N.cisco.com.ssh: . ack 140064 win 6552008:26:12.034796 IP acsexpress1.cisco.com.ssh > dhcp-64-102-82-153.cisco.com.2221: P 141952:142112(160) ack 1921 win 141441000 packets captured1000 packets received by filter0 packets dropped by kernelacsexpress1/admin#telnet
To log in to a host that supports Telnet, use the telnet command in either Operator (user) or EXEC mode.
telnet [ip-address|hostname] port portnumber
Syntax Description
Defaults
No default behavior or values.
Command Modes
Operator
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the telnet command.
acsexpress1/admin# telnet 172.16.0.11 port 23acsexpress1.cisco.com login: adminpassword:Last login: Mon Jul 2 08:45:24 on ttyS0acsexpress1/admin#terminal length
To set the number of lines on the current terminal screen for the current session, use the terminal length command in EXEC mode.
terminal length integer
Syntax Description
integer
Number of lines on the screen. Composed of between 0 to 511 lines, inclusive. A value of zero disables pausing between screens of output.
Defaults
24 lines
Command Modes
EXEC
Command History
Usage Guidelines
The system uses the length value to determine when to pause during multiple-screen output.
Examples
The following example illustrates the use of the terminal length command.
acsexpress1/admin# terminal length 0acsexpress1/admin#terminal session-timeout
To set the inactivity timeout for all sessions, use the terminal session-timeout command in EXEC mode.
terminal session-timeout minutes
Syntax Description
minutes
Sets the number of minutes for the inactivity timeout. From 0 to 525,600. Zero (0) disables the timeout.
Defaults
30 minutes
Command Modes
EXEC
Command History
Usage Guidelines
Setting the terminal session-timeout command to zero results in no timeout being set.
Examples
The following example illustrates the use of the terminal session-timeout command.
acsexpress1/admin# terminal session-timeout 40acsexpress1/admin#Related Commands
terminal session-welcome
Sets a welcome message on the system for all users who log in to the system.
terminal session-welcome
To set a welcome message on the system for all users who log in to the system, use the terminal session-welcome command in EXEC mode.
terminal session-welcome string
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Specify a message less than 2,048 characters in length.
Examples
The following example illustrates the use of the terminal session-welcome command.
acsexpress1/admin# terminal session-welcome welcomeacsexpress1/admin#Related Commands
terminal terminal-type
To specify the type of terminal connected to the current line for the current session, use the terminal terminal-type command in EXEC mode.
terminal terminal-type type
Syntax Description
type
Defines the terminal name and type, and permits terminal negotiation by hosts that provide that type of service; up to 80 alphanumeric characters.
Defaults
VT100
Command Modes
EXEC
Command History
Usage Guidelines
Indicate the terminal type if it is different from the default of VT100.
Examples
The following example illustrates the use of the terminal terminal-type command.
acsexpress1/admin# terminal terminal-type vt220acsexpress1/admin#traceroute
To discover the routes that packets will actually take when traveling to their destination address, use the traceroute command in EXEC mode.
traceroute [ip-address|hostname]
Syntax Description
ip-address
IP address of the remote system; up to 32 alphanumeric characters.
hostname
Host name of the remote system; up to 32 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the traceroute command.
acsexpress1/admin# traceroute 172.16.0.1traceroute to 172.16.0.1 (172.16.0.1), 30 hops max, 38 byte packets1 172.16.0.1 0.067 ms 0.036 ms 0.032 msacsexpress1/admin#undebug
To set a welcome message on the system for all users who log in to the system, use the undebug command in EXEC mode.
undebug [all] [application] [backup-restore] [cdp] [config] [copy] [locks] [logging] [snmp] [system] [transfer] [user] [utils] level
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the undebug command.
acsexpress1/admin# debug allacsexpress1/admin# mkdir disk:/test6 [7168]: utils: vsh_root_stubs.c[2301]: mkdir operation successacsexpress1/admin# rmdir disk:/testacsexpress1/admin# 6 [7170]: utils: vsh_root_stubs.c[2171]: Invoked Remove Directory disk:/test command 6 [7170]: utils: vsh_root_stubs.c[2228]: Remove Directory operation successacsexpress1/admin# undebug allRelated Commands
write
To copy, display, or erase configurations, use the write EXEC command with the appropriate arguments.
write {erase} {memory} {terminal}
Syntax Description
erase
Erases the startup-configuration.
memory
Copies running-configuration to startup-configuration.
terminal
Copies the running-configuration to console.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following examples illustrate the use of the write command.
Example 1
acsexpress1/admin# write memoryGenerating configuration...acsexpress1/admin#Example 2
acsexpress1/admin# write terminalGenerating configuration...!hostname acsexpress1ip domain-name cisco.cominterface GigabitEthernet 0ip address 209.165.200.225 255.255.255.224interface GigabitEthernet 1shutdownip name-server 209.165.201.1ip default-gateway 209.165.202.129clock timezone UTC!!username admin password hash $1$UMCQIJy1$8Z.9tkpO1QzCo4zyc1jso0 role admin!service sshd!password-policylower-case-requiredupper-case-requireddigit-requiredno-usernamedisable-cisco-passwordsmin-password-length 6!logging localhostlogging loglevel 6!!acsexpress1/admin#Show Commands
Each Show command includes a brief description of its use, command syntax, usage guidelines, and sample output.
show application
To show application information for the installed application packages on the system, use the show application command in EXEC mode.
show application {status | version} appname |
Syntax Description
status
Displays the status of the installed application.
version
Displays the application version for an installed application.
appname
Name of installed application.
|
Output modifier commands:
•
•
–
•
•
•
•
–
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following examples illustrate the use of the show application command.
Example 1
acsexpress1/admin# show application<name> <Description>acsexpress Cisco Secure ACS Express 5.0.0.5acsexpress1/admin#Example 2
acsexpress1/admin# show application version acsexpress% ACS EXPRESS VERSION INFORMATION-------------------------------Version : 5.0.0.5 Vendor: Cisco Systems, Inc.Release : 1183108623 Build Date: Fri Jun 29 09:32:23 2007acsexpress1/admin#Example 3
acsexpress1/admin# show application status acsexpressACS Express Server, Running (pid: 2442)ACS Express Server Agent, Running (pid: 2372)ACS Express DB Lock Manager, Running (pid: 2378)ACS Express DB Server, Running (pid: 2383)ACS Express Web Server, Running (pid: 2446)ACS Express AD Agent, Not Running (pid: )acsexpress1/admin#Related Commands
show backup
To display the backup history of the system, use the show backup command in EXEC mode.
show backup history
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show backup command.
acsexpress1/admin# show backup historyWed Jul 18 12:55:21 UTC 2007: backup logs logs-0718.tar.gz to repository fileserver007: successWed Jul 18 12:55:53 UTC 2007: backup full-0718.tar.gpg to repository fileserver007: successacsexpress1/admin#Related Commands
show cdp
To display information about the enabled CDP interfaces, use the show cdp command in EXEC mode.
show cdp {all |neighbors}
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following examples illustrate the use of the show cdp command.
Example 1
acsexpress1/admin# show cdp allCDP protocol is enabled ...broadcasting interval is every 60 seconds.time-to-live of cdp packets is 180 seconds.CDP is enabled on port eth0.Example 2
acsexpress1/admin# show cdp neighborscdp neighbor: ems3560bb03device type: cisco WS-C3560G-24TSport: GigabitEthernet0/22address: 209.165.200.225acsexpress1/admin#Related Commands
show clock
To display the day, month, date, time, time zone, and year of the system software clock, use the show clock command in EXEC mode.
show clock
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show clock command.
acsexpress1/admin# show clockSat Apr 14 16:11:07 UTC 2007acsexpress1/admin#
Note
Related Commands
show cpu
To display CPU information, use the show cpu command in EXEC mode.
show cpu [statistics] [|] [|]
Syntax Description
statistics
Displays CPU statistics.
|
Output modifier commands:
•
•
–
•
•
•
•
–
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following examples illustrate the use of the show cpu command.
Example 1
acsexpress1/admin# show cpuprocessor : 0model : Intel(R) Pentium(R) 4 CPU 3.40GHzspeed(MHz): 3401.350cache size: 2048 KBprocessor : 1model : Intel(R) Pentium(R) 4 CPU 3.40GHzspeed(MHz): 3401.350cache size: 2048 KBacsexpress1/admin#Example 2
acsexpress1/admin# show cpu statisticsuser time: 8312kernel time: 3200idle time: 15510748i/o wait time: 5295irq time: 972acsexpress1/admin#Related Commands
show disks
Displays the system information of all disks.
show memory
Displays the amount of system memory used per system process.
show disks
To display file system information about the disks, use the show disks command in EXEC mode.
show disks [|] [|]
Syntax Description
|
Output modifier commands:
•
•
–
•
•
•
•
–
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
The show disks command is supported only on platforms that have a disk file system.
Examples
The following example illustrates the use of the show disks command.
Example 1
acsexpress1/admin# show disksdisk: 1% used (48564 of 7063480)temp. space 2% used (35844 of 2031952)Internal filesystems:all internal filesystems have sufficient free spaceacsexpress1/admin#Related Commands
show cpu
Displays CPU information.
show memory
Displays the amount of system memory used per system process.
show interface
To display the usability status of interfaces configured for IP, use the show ip interface command in EXEC mode.
show interface [GigabitEthernet] |
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show interface command.
acsexpress1/admin# show interfaceeth0 Link encap:Ethernet HWaddr 00:16:36:56:61:D2inet addr:209.165.200.225 Bcast:209.165.200.255 Mask:255.255.255.224inet6 addr: fe80::216:36ff:fe56:61d2/64 Scope:LinkUP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1RX packets:8783423 errors:0 dropped:0 overruns:0 frame:0TX packets:4178157 errors:0 dropped:0 overruns:0 carrier:0collisions:0 txqueuelen:1000RX bytes:574274908 (547.6 MiB) TX bytes:268869567 (256.4 MiB)Interrupt:169eth1 Link encap:Ethernet HWaddr 00:16:36:56:61:D1inet6 addr: fe80::216:36ff:fe56:61d1/64 Scope:LinkUP BROADCAST MULTICAST MTU:1500 Metric:1RX packets:0 errors:0 dropped:0 overruns:0 frame:0TX packets:0 errors:0 dropped:0 overruns:0 carrier:0collisions:0 txqueuelen:1000RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)Interrupt:177lo Link encap:Local Loopbackinet addr:209.165.201.1 Mask:255.255.255.224inet6 addr: ::1/128 Scope:HostUP LOOPBACK RUNNING MTU:16436 Metric:1RX packets:21617 errors:0 dropped:0 overruns:0 frame:0TX packets:21617 errors:0 dropped:0 overruns:0 carrier:0collisions:0 txqueuelen:0RX bytes:3587148 (3.4 MiB) TX bytes:3587148 (3.4 MiB)sit0 Link encap:IPv6-in-IPv4NOARP MTU:1480 Metric:1RX packets:0 errors:0 dropped:0 overruns:0 frame:0TX packets:0 errors:0 dropped:0 overruns:0 carrier:0collisions:0 txqueuelen:0RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)Related Commands
interface
Configures an interface type and enters the interface configuration mode.
show logging
To display the state of system logging (syslog) and the contents of the standard system logging buffer, use the show logging command in EXEC mode.
show logging {application [application-name]} {internal} {system} |
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
This command displays the state of syslog error and event logging, including host addresses, and for which logging destinations (console, monitor, buffer, or host) logging is enabled. This command also displays Simple Network Management Protocol (SNMP) logging configuration parameters and protocol activity.
Examples
The following examples illustrate the use of the show logging command.
Example 1
acsexpress1/admin# show logging internallog server: localhostGlobal loglevel: 6acsexpress1/admin#Example 2
acsexpress1/admin# show logging systemApr 27 09:23:27 acsexpress1 ADESetup[3100]: [sysconfig] main.c[209] Setup is completeApr 27 09:23:28 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[320]: looking for protocol diskApr 27 09:23:28 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[324]: protocol disk acceptedApr 27 09:23:28 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[59]:created repository history lock fileApr 27 09:23:28 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[83]:obtained repository lockApr 27 09:23:28 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[160]: stored repository SystemDefaultPkgReposApr 27 09:23:28 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[97]:released repository lockApr 27 09:23:28 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[644]: added repository SystemDefaultPkgReposApr 27 09:23:30 acsexpress1 ADEInstall[3318]: Install initiated with bundle - acsexpress.tar.gz, repo - SystemDefaultPkgReposApr 27 09:23:30 acsexpress1 ADEInstall[3318]: [Install] Getting bundle to localmachineApr 27 09:23:30 acsexpress1 ADEInstall[3318]: ADE:repos-mgr:rm_repos_cfg.c[83]:obtained repository lock--More-- (press the spacebar to continue)show logins
To display the state of system logins, use the show logins command in EXEC mode.
show logins cli
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Requires the cli keyword, otherwise an error occurs.
Examples
The following example illustrates the use of the show logins command.
acsexpress1/admin# show logins cliadmin pts/0 dhcp-64-102-82-1 Thu May 3 05:23 still logged inadmin pts/0 dhcp-64-102-82-1 Thu May 3 04:31 - 05:11 (00:39)admin pts/0 dhcp-64-102-82-1 Thu May 3 04:16 - 04:17 (00:00)admin pts/0 dhcp-64-102-82-1 Thu May 3 03:53 - 04:16 (00:22)acsexpress1/admin#show memory
Use the show memory command in EXEC mode to display memory statistics including total space available, free space available, and total memory cached.
show memory
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Requires the show memory keyword, otherwise an error occurs.
Examples
The following example illustrates the use of the show memory command.
acsxp-srv15/admin# show memorytotal memory: 1034600 kBfree memory: 541668 kBcached: 197940 kBswap-cached: 0 kBacsxp-srv15/admin#show ntp
To show the status of the Network Time Protocol (NTP) associations, use the show ntp command in EXEC mode.
show ntp
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show ntp command.
acsexpress1/admin# show ntpPrimary NTP : 1.ntp.esl.cisco.comSecondary NTP : 2.ntp.esl.cisco.comsynchronised to NTP server (209.165.202.129) at stratum 2time correct to within 37 mspolling server every 128 sacsexpress1/admin#Related Commands
ntp server
Allows the synchronization of the software clock by the Network Time Protocol (NTP) server for the system.
show ports
To display information about all the processes listening on the active ports, use the show ports command in EXEC mode.
show ports [|] [|]
Syntax Description
|
Output modifier commands:
•
•
–
•
•
•
•
–
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
The port should have an associated active session when the show ports command is executed.
Examples
The following example illustrates the use of the show ports command.
acsexpress1/admin# show portsProcess : acsxpagent (3960)tcp: 0.0.0.0:2785udp: 209.165.202.129:32768, 209.165.202.129:32769Process : acsxpdbserver (3972)tcp: 0.0.0.0:2786Process : portmap (3623)tcp: 0.0.0.0:111udp: 0.0.0.0:111Process : acsxpserver (3973)tcp: 209.165.200.225:49, 209.165.201.1udp: 209.165.200.225:1812, 209.165.201.1:1812, 209.165.200.225:1813, 209.165.201.1:1813, 209.165.200.225:1645, 209.165.201.1:1645, 209.165.200.225:1646, 209.165.201.1:1646Process : java (3974)tcp: ::ffff:127.0.0.1:8005, :::443Process : sshd (4120)tcp: :::22show process
To display information about the active processes, use the show process command in EXEC mode.
show process |
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show process command (see Table A-7 for process field descriptions).
acsexpress1/admin# show processPID TTY STAT TIME COMMAND1 ? S 0:00 init [3]2 ? S 0:00 [migration/0]3 ? SN 0:00 [ksoftirqd/0]4 ? S 0:00 [migration/1]5 ? SN 0:00 [ksoftirqd/1]6 ? S< 0:00 [events/0]8 ? S< 0:00 \_ [khelper]9 ? S< 0:00 \_ [kacpid]34 ? S< 0:00 \_ [kblockd/0]35 ? S< 0:00 \_ [kblockd/1]53 ? S 0:00 \_ [pdflush]54 ? S 0:00 \_ [pdflush]56 ? S< 0:00 \_ [aio/0]57 ? S< 0:00 \_ [aio/1]310 ? S< 0:00 \_ [ata/0]311 ? S< 0:00 \_ [ata/1]1733 ? S< 0:00 \_ [kauditd]7 ? S< 0:00 [events/1]339 ? S< 0:00 \_ [kmirrord]36 ? S 0:00 [khubd]55 ? S 0:00 [kswapd0]201 ? S 0:00 [kseriod]315 ? S 0:00 [scsi_eh_0]316 ? S 0:00 [scsi_eh_1]360 ? S 0:00 [kjournald]1422 ? S<s 0:00 udevd1804 ? S 0:00 [kjournald]1805 ? S 0:00 [kjournald]1806 ? S 0:00 [kjournald]1807 ? S 0:00 [kjournald]1808 ? S 0:00 [kjournald]1809 ? S 0:00 [kjournald]1810 ? S 0:00 [kjournald]1811 ? S 0:00 [kjournald]1812 ? S 0:00 [kjournald]1813 ? S 0:00 [kjournald]1814 ? S 0:00 [kjournald]2502 ? Ss 0:00 syslogd -m 02506 ? Ss 0:00 klogd -x2516 ? Ss 0:00 irqbalance2534 ? Ss 0:00 portmap2553 ? Ss 0:00 rpc.statd--More-- (press the spacebar to continue)
show repository
To display the file contents of the repository, use the show repository command in EXEC mode.
show repository repository-name
Note
Syntax Description
repository-name
Name of the repository you are showing the contents of; up to 30 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show repository command.
acsexpress1/admin# show repository cdromback1.tar.gpgback2.tar.gpgacsexpress1/admin#Related Commands
show restore
To display the restore history, use the show restore command in EXEC mode.
show restore {history}
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show restore command.
acsexpress1/admin# show restore historyTue Sep 4 03:42:48 PDT 2007: restore 11backup_Local.File2.tar.gpg from repository executeBackupRepo: successTue Sep 4 03:46:15 PDT 2007: restore 11backup_Local.File2.tar.gpg from repository executeBackupRepo: successTue Sep 4 03:51:07 PDT 2007: restore 11backup_Local.File2.tar.gpg from repository executeBackupRepo: successTue Sep 4 03:54:35 PDT 2007: restore 11backup_Local.File2.tar.gpg from repository executeBackupRepo: successWed Sep 5 12:31:21 UTC 2007: restore cdromRestore.tar.gpg from repository cdrom1: successacsexpress1/admin#Related Commands
show running-configuration
To display the contents of the currently running configuration file or the configuration, use the show running-configuration command in EXEC mode.
show running-configuration
Syntax Description
This command has no arguments or keywords.
Defaults
The show running-configuration command displays all of the configuration information.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show running-configuration command.
acsexpress1/admin# show running-configurationGenerating configuration!hostname acsexpress1ip domain-name cisco.comip address 209.165.200.225 255.255.255.224ip name-server 209.165.201.1ip default-gateway 209.165.202.129!!repository backupurl ftp://server/subdiruser bubba password gumprepository localurl disk:subdir/subsubdir!Related Commands
configure
Enters the configuration mode.
show startup-configuration
Displays the contents of the startup configuration file or the configuration.
show startup-configuration
To display the contents of the startup configuration file or the configuration, use the show startup-configuration command in EXEC mode.
show startup-configuration
Syntax Description
This command has no arguments or keywords.
Defaults
The show startup-configuration command displays all of the startup configuration information.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show startup-configuration command.
acsexpress1/admin# show startup-configurationGenerating configuration!hostname acsexpress1ip domain-name cisco.comip address 209.165.200.225 255.255.255.224ip name-server 209.165.201.1ip default-gateway 209.165.202.129!!repository backupurl ftp://server/subdiruser bubba password gumprepository localurl disk:subdir/subsubdir!Related Commands
configure
Enters the configuration mode.
show running-configuration
Displays the contents of the currently running configuration file or the configuration.
show tech-support
To display technical support information including e-mail, use the show tech-support command in EXEC mode.
show tech-support file [word]
Syntax Description
file
Save any technical support data as a file in the local disk.
word
Filename to save; up to 80 alphanumeric characters.
Defaults
Passwords and other security information do not appear in the output.
Command Modes
EXEC
Command History
Usage Guidelines
The show tech-support command is useful for collecting a large amount of information about your ACS Express appliance for troubleshooting purposes. Output provided to technical support representatives when reporting a problem.
Examples
The following example illustrates the use of the show tech-support command.
acsexpress1/admin# show tech-support#################################################Application Deployment Engine (ADE) - Release 1.0Technical Support Debug Info follows...#################################################*****************************************Checking dmidecode Serial Number(s)*****************************************QTFMHQ62200533SerNum0SerNum1SerNum2SerNum3To Be Filled By O.E.M.*****************************************Displaying System Uptime...*****************************************06:31:16 up 11 days, 21:06, 1 user, load average: 0.00, 0.00, 0.00*****************************************Display Memory Usage(KB)*****************************************total used free shared buffers cachedMem: 2074924 420680 1654244 0 110692 160488-/+ buffers/cache: 149500 1925424Swap: 1048568 0 1048568*****************************************Displaying Processes(ax --forest)...*****************************************PID TTY STAT TIME COMMAND1 ? S 0:00 init [3]2 ? S 0:00 [migration/0]3 ? SN 0:00 [ksoftirqd/0]4 ? S 0:00 [migration/1]5 ? SN 0:00 [ksoftirqd/1]6 ? S< 0:00 [events/0]8 ? S< 0:00 \_ [khelper]9 ? S< 0:00 \_ [kacpid]34 ? S< 0:00 \_ [kblockd/0]35 ? S< 0:00 \_ [kblockd/1]53 ? S 0:00 \_ [pdflush]54 ? S 0:00 \_ [pdflush]56 ? S< 0:00 \_ [aio/0]57 ? S< 0:00 \_ [aio/1]310 ? S< 0:00 \_ [ata/0]311 ? S< 0:00 \_ [ata/1]1733 ? S< 0:00 \_ [kauditd]7 ? S< 0:00 [events/1]339 ? S< 0:00 \_ [kmirrord]36 ? S 0:00 [khubd]55 ? S 0:00 [kswapd0]201 ? S 0:00 [kseriod]315 ? S 0:00 [scsi_eh_0]316 ? S 0:00 [scsi_eh_1]360 ? S 0:00 [kjournald]1422 ? S<s 0:00 udevd1804 ? S 0:00 [kjournald]1805 ? S 0:00 [kjournald]1806 ? S 0:00 [kjournald]1807 ? S 0:00 [kjournald]1808 ? S 0:00 [kjournald]1809 ? S 0:00 [kjournald]1810 ? S 0:00 [kjournald]1811 ? S 0:00 [kjournald]1812 ? S 0:00 [kjournald]1813 ? S 0:00 [kjournald]1814 ? S 0:00 [kjournald]2502 ? Ss 0:00 syslogd -m 02506 ? Ss 0:00 klogd -x2516 ? Ss 0:00 irqbalance2534 ? Ss 0:00 portmap2553 ? Ss 0:00 rpc.statd2599 ? S 0:00 /usr/sbin/smartd2623 ? Ss 0:01 /usr/sbin/sshd9127 ? Ss 0:00 \_ sshd: admin [priv]9129 ? S 0:00 \_ sshd: admin@pts/09130 pts/0 Ss 0:00 \_ /bin/bash /opt/system/bin/ADEsh.sh9134 pts/0 S 0:00 \_ /opt/system/bin/ADEsh -s /opt/system/etc/ADEcli/default/main_tree.par9139 pts/0 S+ 0:00 \_ /opt/system/bin/ADEsh -s /opt/system/etc/ADEcli/default/main_tree.par9141 pts/0 S+ 0:00 | \_ sh -c /opt/system/bin/show_tech.sh9151 pts/0 R+ 0:00 | \_ ps ax --forest9140 pts/0 S+ 0:00 \_ more2636 ? Ss 0:00 xinetd -stayalive -pidfile /var/run/xinetd.pid2730 ? Ssl 0:00 /opt/CSCOacsxp/.system/acsxpagent -d2735 ? S 0:00 \_ /opt/CSCOacsxp/.system/acsxpdblockmgr -d -a aiclkmgr2741 ? Ssl 0:02 \_ /opt/CSCOacsxp/.system/acsxpdbserver -Z 0 -P config/mcd/1 -A id=02744 ? Ssl 0:00 \_ /opt/CSCOacsxp/.system/acsxpserver -Z 3 -C servers/name/radius/1 -S servers/name/radius/1 -B /opt/CSCOacsxp/ -P ems-lnx106.cisco.com/name/radius/1 -A id=32745 ? Ssl 4:15 \_ /opt/CSCOacsxp/jre1.5/bin/java -Djava.library.path=/opt/CSCOacsxp/lib:/opt/system/lib -Dos.distro=CentOS -Xms256m -Xmx512m -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.util.logging.config.file=/opt/CSCOacsxp/gui/apache-tomcat-5.5.20/conf/logging.properties -Djava.endorsed.dirs=/opt/CSCOacsxp/gui/apache-tomcat-5.5.20/common/endorsed -classpath :/opt/CSCOacsxp/gui/apache-tomcat-5.5.20/bin/bootstrap.jar:/opt/CSCOacsxp/gui/apache-tomcat-5.5.20/bin/commons-logging-api.jar -Dcatalina.base=/opt/CSCOacsxp/gui/apache-tomcat-5.5.20 -Dcatalina.home=/opt/CSCOacsxp/gui/apache-tomcat-5.5.20 -Djava.io.tmpdir=/opt/CSCOacsxp/gui/apache-tomcat-5.5.20/temp org.apache.catalina.startup.Bootstrap start2842 ? Ss 0:00 gpm -m /dev/input/mice -t exps22853 ? Ss 0:00 crond2870 ? Ss 0:00 /usr/sbin/atd2879 ? Ss 0:00 dbus-daemon-1 --system2890 ? Ss 1:10 hald2898 tty1 Ss+ 0:00 /sbin/mingetty tty12899 tty2 Ss+ 0:00 /sbin/mingetty tty22900 tty3 Ss+ 0:00 /sbin/mingetty tty32901 tty4 Ss+ 0:00 /sbin/mingetty tty42902 tty5 Ss+ 0:00 /sbin/mingetty tty52903 tty6 Ss+ 0:00 /sbin/mingetty tty66217 ttyS0 Ss+ 0:00 /sbin/agetty ttyS0 9600 vt100-nav--More--(Press the Enter or Return key for more timezones.)Related Commands
show terminal
To obtain information about the terminal configuration parameter settings, use the show terminal command in EXEC mode.
show terminal
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show terminal command.
acsexpress1/admin# show terminalTTY: /dev/pts/0 Type: "vt100"Length: 24 lines, Width: 80 columnsSession Timeout: 30 minutesacsexpress1/admin#Table A-8 describes the fields of the show terminal output.
show timezone
To display the time zone as set on the system, use the show timezone command in EXEC mode.
show timezone
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show timezone command.
acsexpress1/admin# show timezoneUTCacsexpress1/admin#Related Commands
clock timezone
Sets the time zone on the system.
show timezones
Displays the time zones available on the system.
show timezones
To obtain a list of time zones from which you can select, use the show timezones command in EXEC mode.
show timezones
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
See the "clock timezone" section for examples of the time zones available for ACS Express software.
Examples
The following example illustrates the use of the show timezones command.
acsexpress1/admin# show timezonesNZArctic/LongyearbyenGMTJapanIcelandAfrica/Addis_AbabaAfrica/KigaliAfrica/MbabaneAfrica/CasablancaAfrica/BanjulAfrica/NouakchottAfrica/CairoAfrica/DakarAfrica/NairobiAfrica/DjiboutiAfrica/KampalaAfrica/GaboroneAfrica/MogadishuAfrica/DoualaAfrica/BrazzavilleAfrica/MalaboAfrica/El_Aaiun--More-- (Press the Enter or Return key for more timezones.)Related Commands
show timezone
Displays the time zone set on the system.
clock timezone
Sets the time zone on the system.
show udi
To display information about the system's Unique Device Identifier (UDI), use the show udi command in EXEC mode.
show udi
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show udi command.
acsexpress1/admin# show udiSPID: ADE-1010VPID: VO1Serial: 123455acsexpress1/admin#show uptime
To display how long you have been logged in to ACS Express, use the show uptime command in EXEC mode.
show uptime |
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show uptime command.
acsexpress1/admin# show uptime4 day(s), 16:36:58acsexpress1/admin#show users
To display a list of users logged in to the ACS Express, use the show users command in EXEC mode.
show users
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the show users command.
acsexpress1/admin# show usersUsername Role Status LoggedInadmin Admin Enabled Yesacsexpress1/admin#show version
To display information about the software version of the system, use the show version command in EXEC mode.
show version
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
This command displays information about the ACS Express software version currently running on the ACS Express appliance.
Examples
The following example illustrates the use of the show version command.
acsexpress1/admin# show versionADE Platform Release 1.0Drop Version No: 5.0Build Version : 1.0.1.84Copyright (c) 2007 by cisco Systems, Inc.All rights reserved.Hostname: acsexpress1Version information about installed applications------------------------------------------------ACS EXPRESS VERSION INFORMATION-------------------------------Version : 5.0.0.3 Vendor: Cisco Systems, Inc.Release : 1181812618 Build Date: Thu Jun 14 09:31:27 2007acsexpress1/admin#Configuration Commands
Each Configuration command includes a brief description of its use, command syntax, usage guidelines, and sample output.
cdp holdtime
To specify the amount of time the receiving device should hold a Cisco Discovery Protocol (CDP) packet from the ACS Express appliance before discarding it, use the cdp holdtime command in configuration mode. To revert to the default setting, use the no form of this command.
cdp holdtime seconds
Syntax Description
Defaults
180 seconds
Command Modes
Configuration
Command History
Usage Guidelines
CDP packets transmit with a time to live, or hold time, value. The receiving device will discard the CDP information in the CDP packet after the hold time has elapsed.
The cdp holdtime command takes only one argument, otherwise an error occurs.
Examples
The following example illustrates the use of the cdp holdtime command.
acsexpress1/admin(config)# cdp holdtime 60acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
cdp timer
Specifies how often the ACS Express software sends Cisco Discovery Protocol (CDP) updates.
cdp run
Enables the Cisco Discovery Protocol (CDP).
cdp run
To enable the Cisco Discovery Protocol (CDP), use the cdp run command in configuration mode. To disable the Cisco Discovery Protocol, use the no form of this command.
cdp run [ethernet0] /[ethernet1]
Syntax Description
Defaults
The default behavior is for CDP to run on interfaces that are up.
When bringing up an interface, CDP needs to be stopped and started again.
Command Modes
Configuration
Command History
Usage Guidelines
The command has one optional argument, an interface name. Without an optional interface name, the command enables CDP on all interfaces.
Examples
The following example illustrates the use of the cdp run command.
acsexpress1/admin(config)# cdp run ethernet0acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
cdp timer
To specify how often the ACS Express software sends Cisco Discovery Protocol (CDP) updates, use the cdp timer command in configuration mode. To revert to the default setting, use the no form of this command.
cdp timer seconds
Syntax Description
seconds
Specifies how often, in seconds, the ACS Express software sends CDP updates. Value from 5 to 254 seconds.
Defaults
60 seconds
Command Modes
Configuration
Command History
Usage Guidelines
CDP packets transmit with a time to live, or hold time, value. The receiving device will discard the CDP information in the CDP packet after the hold time has elapsed.
The cdp timer command takes only one argument, otherwise an error occurs.
Examples
The following example illustrates the use of the cdp timer command.
acsexpress1/admin(config)# cdp timer 60acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
clock timezone
To set the time zone, use the clock timezone command in configuration mode. To disable this function, use the no form of this command.
clock timezone timezone
Syntax Description
Defaults
UTC
Command Modes
Configuration
Command History
Usage Guidelines
The system internally keeps time in Coordinated Universal Time (UTC). If you do not know your specific time zone, you can enter the region, country, and city (see Tables A-9, A-10, and A-11 for sample time zones to enter on your system).
Table A-10 Australia Time Zones
ACT2
Adelaide
Brisbane
Broken_Hill
Canberra
Currie
Darwin
Hobart
Lord_Howe
Lindeman
LHI3
Melbourne
North
NSW4
Perth
Queensland
South
Sydney
Tasmania
Victoria
West
Yancowinna
1 Enter the country and city together separated by a forward slash (/); for example, Australia/Currie.
2 ACT = Australian Capital Territory.
3 LHI = Lord Howe Island
4 NSW = New South Wales
Table A-11 Asia Time Zones
Aden2
Almaty
Amman
Anadyr
Aqtau
Aqtobe
Ashgabat
Ashkhabad
Baghdad
Bahrain
Baku
Bangkok
Beirut
Bishkek
Brunei
Calcutta
Choibalsan
Chongqing
Columbo
Damascus
Dhakar
Dili
Dubai
Dushanbe
Gaza
Harbin
Hong_Kong
Hovd
Irkutsk
Istanbul
Jarkarta
Jayapura
Jerusalem
Kabul
Kamchatka
Karachi
Kashgar
Katmandu
Kuala_Lumpur
Kuching
Kuwait
Krasnoyarsk
1 The Asia time zone includes cities from East Asia, Southern South East Asia, West Asia, and Central Asia.
2 Enter the region and city or country together separated by a forward slash (/); for example, Asia/Aden.
Note
Examples
The following example illustrates the use of the clock timezone command.
acsexpress1/admin(config)# clock timezone ESTacsexpress1/admin(config)# exitacsexpress1/admin# show timezoneESTacsexpress1/admin#Related Commands
show timezones
Displays a list of available time zones on the system.
show timezone
Displays the current time zone set on the system.
do
To execute an EXEC-level command from configuration mode or any configuration submode, use the do command in any configuration mode.
do arguments
Syntax Description
arguments
The EXEC command to execute (see Table A-12).
Command Default
No default behavior or values.
Command Modes
Configuration or any configuration submode
Command History
Usage Guidelines
Use this command to execute EXEC commands (such as show, clear, and debug commands) while configuring your server. After the EXEC command executes, the system will return to the configuration mode you were using.
Examples
The following example illustrates the use of the do command.
acsexpress1/admin(config)# do show runGenerating configuration...!hostname ems-lnx106ip domain-name cisco.cominterface GigabitEthernet 0ip address 209.165.200.225 255.255.255.224interface GigabitEthernet 1shutdownip name-server 209.165.201.1ip default-gateway 209.165.202.129clock timezone Cuba!!username admin password hash $1$hB$MxIZHvecMiey/P9mM9PvN0 role admin!!logging localhostlogging loglevel 6!acsexpress1/admin(config)#end
To end the current configuration session and return to the EXEC mode, use the end command in configuration mode.
end
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
This command brings you back to EXEC mode regardless of what configuration mode or configuration submode you are in.
Use this command when you are done configuring the system and you want to return to EXEC mode to perform verification steps.
Examples
The following example illustrates the use of the end command.
acsexpress1/admin(config)# endacsexpress1/admin#Related Commands
exit
Exits from configuration mode.
exit (EXEC)
Closes the active terminal session by logging out of the ACS Express appliance.
exit
To exit any configuration mode to the next highest mode in the CLI mode hierarchy, use the exit command in configuration mode.
exit
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
The exit command is used in ACS Express to exit from the current command mode to the next highest command mode in the CLI mode hierarchy.
For example, use the exit command in configuration mode to return to EXEC mode. Use the exit command in the configuration submodes to return to configuration mode. At the highest level, EXEC mode, the exit command exits the EXEC mode and disconnects from the ACS Express appliance (see the "exit" section for a description of the exit (EXEC) command).
Examples
The following example illustrates the use of the exit command.
acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
end
Exits from configuration mode.
exit (EXEC)
Closes the active terminal session by logging out of the ACS Express appliance.
hostname
To set the hostname of the system, use the hostname command in configuration mode. To delete the hostname from the system, use the no form of this command. This resets the system to localhost.
hostname word
Syntax Description
word
Name of the host. Composed of at least 2 to 64 alphanumeric characters and an underscore ( _ ). The hostname must begin with a character that is not a space.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
A single instance type of command, hostname only occurs once in the configuration of the system. The hostname must contain one argument, otherwise an error occurs.
Examples
The following example illustrates the use of the hostname command.
acsexpress1/admin(config)# hostname myservermyserver/admin(config)# exitmyserver/admin#interface
To configure an interface type and enter the interface configuration mode, use the interface command in configuration mode. This command does not have a no form.
interface GigabitEthernet number
Syntax Description
GigabitEthernet
Specifies Ethernet IEEE 802.3 interface as the type being created.
number
Number of Ethernet port to configure.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
With this command you can configure subinterfaces to support various requirements.
Examples
The following example illustrates the use of the interface command.
acsexpress1/admin(config)# interface gigabitethernet 0acsexpress1/admin(config-ethernet)#Related Commands
ip address
To set the IP address and netmask for the Ethernet interface, use the ip address command in Ethernet configuration mode. To remove an IP address or disable IP processing, use the no form of this command.
ip address ip-address netmask
Syntax Description
Defaults
Enabled.
Command Modes
Ethernet configuration
Command History
Usage Guidelines
Requires exactly one address and one netmask, otherwise an error occurs.
Examples
The following example illustrates the use of the ip address command.
acsexpress1/admin(config)# interface GigabitEthernet 1acsexpress1/admin(config-ethernet)# ip address 209.165.200.225 255.255.255.224acsexpress1/admin(config-ethernet)#Related Commands
ip default-gateway
To define or set a default gateway with an IP address, use the ip default-gateway command in configuration mode. To disable this function, use the no form of this command.
ip default-gateway ip-address
Syntax Description
Defaults
Disabled.
Command Modes
Configuration
Command History
Usage Guidelines
If you enter more than one argument or no arguments at all, an error occurs.
Examples
The following example illustrates the use of the ip default-gateway command.
acsexpress1/admin(config)# ip default-gateway 209.165.202.129acsexpress1/admin(config)# exitacsexpress1/admin#ip domain-name
To define a default domain name that the ACS Express software uses to complete host-names, use the ip domain-name command in configuration mode. To disable this function, use the no form of this command.
ip domain-name word
Syntax Description
word
Default domain name used to complete the host names. Composed of at least 2 to 64 alphanumeric characters.
Defaults
Enabled.
Command Modes
Configuration
Command History
Usage Guidelines
If you enter more or fewer arguments, an error occurs.
Examples
The following example illustrates the use of the ip domain-name command.
acsexpress1/admin(config)# ip domain-name cisco.comacsexpress1/admin(config)#Related Commands
ip name-server
To set the Domain Name Server (DNS) servers for use during a DNS query, use the ip name-server command in configuration mode. You can configure one to three DNS servers. To disable this function, use the no form of this command.
Note
ip name-server ip-address [ip-address] [ip-address]
Syntax Description
ip-address
Address of a name server.
ip-address
(Optional) IP addresses of additional name servers (a maximum of three name servers).
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
The first name server added with the ip name-server command will occupy the first position and the system will use that server first in resolving the ip addresses.
Name servers can be added to the system either one at a time or all at once, until the maximum (3) is reached.
If the system is already configured with three name servers, no additional name servers can be added until at least one is removed.
To place a name server in the first position, so that the subsystem will use it first, all name servers will need to be removed with the no command before proceeding.
Examples
The following example illustrates the use of the ip name-server command.
acsexpress1/admin(config)# ip name-server 209.165.201.1acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
ip domain-name
Defines a default domain name that the ACS Express software uses to complete host-names.
logging
To enable the system to forward logs to a remote system or to configure the log level, use the logging command in configuration mode. To disable this function, use the no form of this command.
logging [ip-address|hostname] {loglevel} level
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
This command requires either an IP address or hostname or the loglevel keyword, otherwise an error occurs if you enter two or more of these arguments.
Examples
The following examples illustrate the use of the logging command.
Example 1
acsexpress1/admin(config)# logging 209.165.200.225acsexpress1/admin(config)# exitacsexpress1/admin#Example 2
acsexpress1/admin(config)# logging loglevel 0acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
ntp server
To allow for software clock synchronization by the Network Time Protocol (NTP) server for the system, use the ntp server command in configuration mode. Allows up to two servers. To disable this capability, use the no form of this command.
ntp server {ip-address|hostname} [ip-address|hostname]
Note
Syntax Description
ip-address|hostname
IP address or hostname of the server providing the clock synchronization. Arguments are limited to 255 alphanumeric characters.
Defaults
No servers are configured by default.
Command Modes
Configuration
Command History
Usage Guidelines
Use this command if you want to allow the system to synchronize with a specified server.
To terminate NTP service on a device, you must enter the no ntp command without keywords. For example, if you previously issued the ntp server command and you now want to remove not only the server synchronization capability, but all NTP functions from the device, use the no ntp command without any keywords. This ensures that all NTP functions disable and that the NTP service also terminates.
Examples
The following example illustrates the use of the ntp server command.
acsexpress1/admin(config)# ntp server 209.165.201.31acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
password-policy
To enable or configure the passwords on the system, use the password-policy command in configuration mode. To disable this function, use the no form of this command.
password-policy {policy-option}
Note
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the password-policy command.
Note
acsexpress1/admin(config)# password-policyacsexpress1/admin(config-password-policy)# password-expiration-days 30acsexpress1/admin(config-password-policy)# exitacsexpress1/admin(config)# exitacsexpress1/admin#repository
To enter the repository submode for configuration of backups, use the repository command in configuration mode.
repository repository-name
Syntax Description
Note
Syntax Description
do
EXEC command. Allows you to perform any of the EXEC commands in this mode (see the "do" section).
end
Exits from this mode.
exit
Exits from this mode.
no
Negates the command in this mode.
Two keywords available:
•
•
url
URL of the repository; up to 80 alphanumeric characters.
user
Username for repository access; up to 80 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
For information on backup, see backup and backup-logs commands.
Examples
The following example illustrates the use of the repository command.
Note
acsexpress1/admin(config)# repository myrepositoryacsexpress1/admin(config-Repository)# url sftp://starwars.test.com/repository/system1acsexpress1/admin(config-Repository)# user Luke password plain skywalkeracsexpress1/admin(config-Repository)# exitacsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
service
To specify a service to manage, use the service command in configuration mode. To disable this function, use the no form of this command
service sshd
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
None.
Examples
The following examples illustrate the use of the service command.
Example 1
acsexpress1/admin#config tEnter configuration commands, one per line. End with CNTL/Z.acsexpress1/admin(config)# service sshdacsexpress1/admin(config)# exitacsexpress1/admin#Example 2
acsexpress1/admin# config tEnter configuration commands, one per line. End with CNTL/Z.acsexpress1/admin(config)# no service sshdacsexpress1/admin(config)# exitacsexpress1/admin#snmp-server community
To set up the community access string to permit access to the Simple Network Management Protocol (SNMP), use the snmp-server community command in configuration mode. To disable this function, use the no form of this command.
snmp-server community word {ro}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
The snmp-server community command requires a community string and an argument (ro), otherwise an error occurs.
Examples
The following example illustrates the use of the snmp-server community command.
acsexpress1/admin(config)# snmp-server community new roacsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
snmp-server contact
To configure the SNMP contact Management Information Base (MIB) value on the system, use the snmp-server contact command in configuration mode. To remove the system contact information, use the no form of this command.
snmp-server contact word
Syntax Description
word
String that describes the system contact information of the node; up to 255 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the snmp-server contact command.
acsexpress1/admin(config)# snmp-server contact Lukeacsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
snmp-server host
To send SNMP traps to a remote user, use the snmp-server host command in configuration mode. To remove trap forwarding, use the no form of this command.
snmp-server host [ip-address|hostname] {version [1|2c]} [community]
Syntax Description
Defaults
Disabled.
Command Modes
Configuration
Command History
Usage Guidelines
The command takes arguments as listed, otherwise an error occurs.
Examples
The following example illustrates the use of the snmp-server host command.
acsexpress1/admin(config)# snmp-server community new ro 10acsexpress1/admin(config)# snmp-server host 209.165.202.129 version 1 passwordacsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
snmp-server location
To configure the SNMP location management information base (MIB) value on the system, use the snmp-server location command in configuration mode. To remove the system location information, use the no form of this command.
snmp-server location word
Syntax Description
word
String that describes the system's physical location information; up to 255 alphanumeric characters.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
Usage Guidelines
None.
Examples
The following example illustrates the use of the snmp-server location command.
acsexpress1/admin(config)# snmp-server location Building 3/Room 214acsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
username
To add a user to the ACS Express system with a password and a privileged level, use the username configuration command. If a user currently exists, the password and/or privilege level changes with this command. To delete the user from the system, use the no form of this command.
username username password password [hash|plain] role [admin|user]
For an existing user, use the following options:
username username password password role [admin|user]
username username password password
username username role [admin|user]
Syntax Description
Defaults
The initial user during setup.
Command Modes
Configuration
Command History
Usage Guidelines
The username command requires the username and password followed by the hash/plain and admin/user.
Examples
The following example illustrates the use of the username command.
acsexpress1/admin(config)# username ###### password hash ###### role adminacsexpress1/admin(config)# exitacsexpress1/admin#Related Commands
password-policy
Enables and configures the password policy.
show users
Displays a list of users and their privilege level. It also displays a list of logged-in users.
