Reference Guide
Page 9
..., only experienced users should use these instructions. Subsequent sections build on the CSACS-1121 appliance. This preface includes: • Who Should Read This Guide, page ix • How to Use This Guide Cisco makes the following recommendations for using the CLI in the Cisco Application Deployment Engine (ADE) OS 1.2 that, in combination with ACS 5.1, runs...
..., only experienced users should use these instructions. Subsequent sections build on the CSACS-1121 appliance. This preface includes: • Who Should Read This Guide, page ix • How to Use This Guide Cisco makes the following recommendations for using the CLI in the Cisco Application Deployment Engine (ADE) OS 1.2 that, in combination with ACS 5.1, runs...
Reference Guide
Page 11
...-specific documentation helpful: • Installation and Upgrade Guide for the Cisco Secure Access Control System 5.1 • User Guide for the Cisco Secure Access Control System 5.1 • Regulatory Compliance and Safety Information for Cisco 1121 Secure Access Control System 5.1 and Cisco NAC Appliance 4.7 • Migration Guide for the Cisco Secure Access Control System 5.1 • Supported and Interoperable Devices...
...-specific documentation helpful: • Installation and Upgrade Guide for the Cisco Secure Access Control System 5.1 • User Guide for the Cisco Secure Access Control System 5.1 • Regulatory Compliance and Safety Information for Cisco 1121 Secure Access Control System 5.1 and Cisco NAC Appliance 4.7 • Migration Guide for the Cisco Secure Access Control System 5.1 • Supported and Interoperable Devices...
Reference Guide
Page 13
... • Windows PC running Windows XP/Vista. • Apple Computer running Mac OS X 10.4 or later. • PC running the Cisco Application Deployment Engine (ADE) OS 1.2. This chapter provides an overview of the following sections describe the ACS CLI: • Accessing the ACS ...in ACS, page 1-1 • Types of Command Modes in ACS Two different types of the ACS Command Line Interface Cisco Secure Access Control System (ACS) 5.1 uses the CSACS-1121 appliance running Linux. For detailed information on the ACS server: • Admin (administrator) • Operator (user) OL...
... • Windows PC running Windows XP/Vista. • Apple Computer running Mac OS X 10.4 or later. • PC running the Cisco Application Deployment Engine (ADE) OS 1.2. This chapter provides an overview of the following sections describe the ACS CLI: • Accessing the ACS ...in ACS, page 1-1 • Types of Command Modes in ACS Two different types of the ACS Command Line Interface Cisco Secure Access Control System (ACS) 5.1 uses the CSACS-1121 appliance running Linux. For detailed information on the ACS server: • Admin (administrator) • Operator (user) OL...
Reference Guide
Page 14
... mode (see Types of Command Modes in ACS, page 1-5). Table 1-1 lists the command privileges for the Cisco Secure Access Control System 5.1 1-2 OL-18996-01 After you enter the initial configuration information, the appliance automatically reboots and prompts you to the ACS CLI, you must use the ACS CLI. While an Admin... Accounts and Modes in ACS Chapter 1 Overview of the ACS Command Line Interface When you power up the CSACS-1121 appliance for the first time, you are prompted to run the setup utility to the ACS CLI for the first time. Table 1-1 Command Privileges Command access...
... mode (see Types of Command Modes in ACS, page 1-5). Table 1-1 lists the command privileges for the Cisco Secure Access Control System 5.1 1-2 OL-18996-01 After you enter the initial configuration information, the appliance automatically reboots and prompts you to the ACS CLI, you must use the ACS CLI. While an Admin... Accounts and Modes in ACS Chapter 1 Overview of the ACS Command Line Interface When you power up the CSACS-1121 appliance for the first time, you are prompted to run the setup utility to the ACS CLI for the first time. Table 1-1 Command Privileges Command access...
Reference Guide
Page 19
...welcome message on ACS. Table 1-3 Summary of the disks. Displays information about the hardware inventory, including the ACS appliance model and serial number. Displays CPU information. Displays file-system information of Show Commands Command acs-cores acs-logs...debug command for all the interfaces configured on the system for various command situations; Indicates whether an interface is disabled or enabled for the Cisco Secure Access Control System 5.1 1-7 Displays statistics for all terminal sessions. See Table 1-3 for example, backup and restore, configuration, copy,...
...welcome message on ACS. Table 1-3 Summary of the disks. Displays information about the hardware inventory, including the ACS appliance model and serial number. Displays CPU information. Displays file-system information of Show Commands Command acs-cores acs-logs...debug command for all the interfaces configured on the system for various command situations; Indicates whether an interface is disabled or enabled for the Cisco Secure Access Control System 5.1 1-7 Displays statistics for all terminal sessions. See Table 1-3 for example, backup and restore, configuration, copy,...
Reference Guide
Page 26
...; Netmask • Gateway • Domain • Nameserver • User ID • Password CLI Reference Guide for the Cisco Secure Access Control System 5.1 2-2 OL-18996-01 Power up the CSACS-1121 appliance for the Cisco Secure Access Control System 5.1. The appliance boots automatically and the setup utility appears (see Figure 2-1). The setup utility (that you configure the...
...; Netmask • Gateway • Domain • Nameserver • User ID • Password CLI Reference Guide for the Cisco Secure Access Control System 5.1 2-2 OL-18996-01 Power up the CSACS-1121 appliance for the Cisco Secure Access Control System 5.1. The appliance boots automatically and the setup utility appears (see Figure 2-1). The setup utility (that you configure the...
Reference Guide
Page 27
...log in to the ACS CLI, ensure that you have completed the hardware installation and configuration process outlined in to the ACS CLI for the Cisco Secure Access Control System 5.1 2-3 Accessing the ACS CLI Before logging in Before Accessing the ACS CLI, page 2-1. Y/N : n Enter ... Rebooting... Chapter 2 Using the ACS Command Line Interface Accessing the ACS CLI This example shows sample output of the setup command. Appliance is configured Installing applications... Installing acs ... You must explicitly create users with SSH access to the ACS CLI. OL-18996-01 CLI...
...log in to the ACS CLI, ensure that you have completed the hardware installation and configuration process outlined in to the ACS CLI for the Cisco Secure Access Control System 5.1 2-3 Accessing the ACS CLI Before logging in Before Accessing the ACS CLI, page 2-1. Y/N : n Enter ... Rebooting... Chapter 2 Using the ACS Command Line Interface Accessing the ACS CLI This example shows sample output of the setup command. Appliance is configured Installing applications... Installing acs ... You must explicitly create users with SSH access to the ACS CLI. OL-18996-01 CLI...
Reference Guide
Page 29
.... The console port (EIA/TIA-232 asynchronous) requires only a null-modem cable. To connect a PC running terminal-emulation software or an ASCII terminal-to the CSACS-1121 appliance's console port (see Figure 2-1) by using Windows XP. Note If using a null-modem cable. OL-18996-01 CLI Reference Guide for the console port are...-emulation software to the console port, use a DB-9 female to DB-25 male straight-through the setup utility to a wired WAN) via a PC by using a Cisco switch on the Add Profile window. The default parameters for the...
.... The console port (EIA/TIA-232 asynchronous) requires only a null-modem cable. To connect a PC running terminal-emulation software or an ASCII terminal-to the CSACS-1121 appliance's console port (see Figure 2-1) by using Windows XP. Note If using a null-modem cable. OL-18996-01 CLI Reference Guide for the console port are...-emulation software to the console port, use a DB-9 female to DB-25 male straight-through the setup utility to a wired WAN) via a PC by using a Cisco switch on the Add Profile window. The default parameters for the...
Reference Guide
Page 43
... the backup in a repository. Synchronizes the secondary ACS database to stop command to the primary ACS database. Shows the debug log level status for the Cisco Secure Access Control System 5.1 A-5 Installs and removes ACS patches. Backs up . Appendix A ACS Command Reference EXEC Commands Usage Guidelines If you use the 'show version... start Starting ACS To verify that ACS processes are running, use the acs stop your ACS, the ACS instance automatically starts the next time the CSACS-1121 appliance boots up system logs.
... the backup in a repository. Synchronizes the secondary ACS database to stop command to the primary ACS database. Shows the debug log level status for the Cisco Secure Access Control System 5.1 A-5 Installs and removes ACS patches. Backs up . Appendix A ACS Command Reference EXEC Commands Usage Guidelines If you use the 'show version... start Starting ACS To verify that ACS processes are running, use the acs stop your ACS, the ACS instance automatically starts the next time the CSACS-1121 appliance boots up system logs.
Reference Guide
Page 44
...following error message: % Error: This is not configured. Stops an ACS process. Attempting to stop , it automatically starts the next time the CSACS-1121 appliance boots up. Starts or stops the management process of an ACS server. Starts or stops the view-alertmanager process of an ACS server. Defaults ...Command Modes EXEC Usage Guidelines If you attempted to start or stop any ACS process, it prompts you start . CLI Reference Guide for the Cisco Secure Access Control System 5.1 A-6 OL-18996-01 When ACS cannot start or stop the ACS process that you want to start a view-...
...following error message: % Error: This is not configured. Stops an ACS process. Attempting to stop , it automatically starts the next time the CSACS-1121 appliance boots up. Starts or stops the management process of an ACS server. Starts or stops the view-alertmanager process of an ACS server. Defaults ...Command Modes EXEC Usage Guidelines If you attempted to start or stop any ACS process, it prompts you start . CLI Reference Guide for the Cisco Secure Access Control System 5.1 A-6 OL-18996-01 When ACS cannot start or stop the ACS process that you want to start a view-...
Reference Guide
Page 54
... ACS to continue? Examples acs/admin# acs reset-config This command will reset the ACS configuration. A-16 CLI Reference Guide for the Cisco Secure Access Control System 5.1 OL-18996-01 Would you like to the factory default configuration, any configurations you use the acs reset-config... To reset the ACS configuration to be running when you have performed are not affected. Defaults No default behavior or values. however, the appliance settings (such as network settings and backup repositories) are lost; ACS does not need to factory defaults, use this command. acs reset-...
... ACS to continue? Examples acs/admin# acs reset-config This command will reset the ACS configuration. A-16 CLI Reference Guide for the Cisco Secure Access Control System 5.1 OL-18996-01 Would you like to the factory default configuration, any configurations you use the acs reset-config... To reset the ACS configuration to be running when you have performed are not affected. Defaults No default behavior or values. however, the appliance settings (such as network settings and backup repositories) are lost; ACS does not need to factory defaults, use this command. acs reset-...
Reference Guide
Page 62
... repository. Command Modes EXEC Usage Guidelines Removes or uninstalls an application. Upgrades an application bundle. Shows application information for the Cisco Secure Access Control System 5.1 OL-18996-01 To remove this function, use the application remove command in progress. Examples acs.../admin# application remove acs acs/admin# A-24 CLI Reference Guide for the installed application packages on the appliance. Stops or disables an application. Try again shortly. Application name. The application bundle file is in the EXEC mode. EXEC ...
... repository. Command Modes EXEC Usage Guidelines Removes or uninstalls an application. Upgrades an application bundle. Shows application information for the Cisco Secure Access Control System 5.1 OL-18996-01 To remove this function, use the application remove command in progress. Examples acs.../admin# application remove acs acs/admin# A-24 CLI Reference Guide for the installed application packages on the appliance. Stops or disables an application. Try again shortly. Application name. The application bundle file is in the EXEC mode. EXEC ...
Reference Guide
Page 63
Starts or enables an application. Shows application information for the Cisco Secure Access Control System 5.1 A-25 application start To enable a specific application, use the application start command in the EXEC mode. Up to factory defaults....Reference Guide for the installed application packages on the system. application reset-config To reset an application configuration to factory defaults without reimaging the ACS appliance or VM. Command Modes EXEC Usage Guidelines You can use the application reset-config command to reset the ACS configuration to factory defaults, use...
Starts or enables an application. Shows application information for the Cisco Secure Access Control System 5.1 A-25 application start To enable a specific application, use the application start command in the EXEC mode. Up to factory defaults....Reference Guide for the installed application packages on the system. application reset-config To reset an application configuration to factory defaults without reimaging the ACS appliance or VM. Command Modes EXEC Usage Guidelines You can use the application reset-config command to reset the ACS configuration to factory defaults, use...
Reference Guide
Page 113
show inventory To display information about the hardware inventory, including the ACS appliance model and serial number, use the show inventory | Syntax Description | Output modifier variables: • begin-Matched pattern. Add number after the word count. •...the word last. Up to 80 alphanumeric characters. • count-Count the number of output. Default 10. OL-18996-01 CLI Reference Guide for the Cisco Secure Access Control System 5.1 A-75 show inventory command in the interface. Up to 80 alphanumeric characters. • last-Display last few lines of lines...
show inventory To display information about the hardware inventory, including the ACS appliance model and serial number, use the show inventory | Syntax Description | Output modifier variables: • begin-Matched pattern. Add number after the word count. •...the word last. Up to 80 alphanumeric characters. • count-Count the number of output. Default 10. OL-18996-01 CLI Reference Guide for the Cisco Secure Access Control System 5.1 A-75 show inventory command in the interface. Up to 80 alphanumeric characters. • last-Display last few lines of lines...
Reference Guide
Page 175
...[0,1] file, located at /etc/sysconfig/network-scripts, using this command, you lose connectivity to the CSACS-1121 appliance through that interface (even though the appliance is still powered on the appliance with a different IP and have not shut down an interface using the ONBOOT parameter: • Disable...the IP address of the default gateway of this command. Specifies read-only access. Sets the IP address and netmask for the Cisco Secure Access Control System 5.1 A-137 To disable this function, use the snmp-server community command in Configuration mode. snmp-server ...
...[0,1] file, located at /etc/sysconfig/network-scripts, using this command, you lose connectivity to the CSACS-1121 appliance through that interface (even though the appliance is still powered on the appliance with a different IP and have not shut down an interface using the ONBOOT parameter: • Disable...the IP address of the default gateway of this command. Specifies read-only access. Sets the IP address and netmask for the Cisco Secure Access Control System 5.1 A-137 To disable this function, use the snmp-server community command in Configuration mode. snmp-server ...
Reference Guide
Page 190
Index show commands 1-7, A-49, A-59 SSH 1-1, 2-5 starting the CSACS appliance server 2-2 submodes, configuration 2-8 supported platforms hardware 2-4 software 2-4 T types of commands 1-5 U user accounts 1-1 command privileges (table) 1-2 modes 1-4 using PC locally 2-5 SSH 2-5 utility, setup 2-2 IN-4 CLI Reference Guide for the Cisco Secure Access Control System 5.1 OL-18996-01
Index show commands 1-7, A-49, A-59 SSH 1-1, 2-5 starting the CSACS appliance server 2-2 submodes, configuration 2-8 supported platforms hardware 2-4 software 2-4 T types of commands 1-5 U user accounts 1-1 command privileges (table) 1-2 modes 1-4 using PC locally 2-5 SSH 2-5 utility, setup 2-2 IN-4 CLI Reference Guide for the Cisco Secure Access Control System 5.1 OL-18996-01