This chapter provides detailed descriptions of each of the CMTS CLI
commands. The CLI commands are organized alphabetically and apply to both the C4 CMTS and the C4c CMTS unless specified. When you log in to the CLI, you are in User EXEC mode.
User EXEC — User EXEC commands are used for everyday system moni-toring. They allow you to change terminal settings on a temporary basis, perform basic tests and show system information. The prompt C4> indicates User EXEC mode and the default access level is 1.
The User Show commands are part of the User EXEC mode. The prompt will be C4> as in theUser EXEC mode. The User Show commands display system information. The default access level of User Show commands is 1.
Privileged EXEC — The Privileged EXEC mode commands are used to set operating parameters. If a Privileged EXEC password exists, the CLI prompts you to enter it to gain access. The password does not appear on the screen.
Privileged EXEC mode includes the User EXEC commands.
To enter Privileged EXEC mode, enter the enable command at the C4>
prompt. The prompt changes to C4#. If no enable password is configured, any user may enter Privileged EXEC mode without authentication. The default access level of Privileged EXEC mode commands is 15.
Global Configuration —Global Configuration commands apply to features that affect the entire system. These commands apply to system features and enable routing functions.
Enter configure at the command prompt in Privileged EXEC mode to enter the Global Configure mode. The prompt will change to C4<config>#. To return to Privileged EXEC mode, enter quit, exit or press Ctrl+Z.
In the command headings the asterisk (*) represents one or more variables NOTE that have been omitted to save space and to make the heading more readable. All the pertinent variables are found in the command syntax line.
alias
Purpose The alias command is used to create abbreviated versions of CLI commands.
If the command is entered without any parameters, it simply displays a list of all existing aliases. To remove a specific alias, use the [no] option.
There is a size limitation associated with the alias buffer. The alias limit may be reached in two ways; via the alias count, currently 256, or via the alias buffersize which is 8192 characters in length. The alias buffer size consists of all the alias names and their associated commands concatenated together. For example, you could reach the alias limit with just 81 aliases if each alias name/command has a length of 100 characters.
The aliases you create do not persist in memory after the user session is NOTE closed. Aliases can be saved to a file and that file can be called in from a user’s profile. In this manner, a user can have a particular set of aliases that become available each time he or she logs in. Alternatively, the user can save to a file and manually load this file of aliases upon logging in.
Syntax alias [<alias name> <command>] [no]
Example The following example creates the alias slc, which can be entered in place of show linecard status.
C4> alias slc show linecard status
Related Command(s) unalias
Default Access Level Mode
Non-privileged – 1 User EXEC
Parameter Definition
[<alias name> The abbreviation or replacement name to be used as an alias for a CLI command.
<command>] The CLI command that the CMTS will execute when the alias is entered from the command line.
archive
Purpose Places a file for storage on a backup server. Normally, you archive backup files or files that are important but not often used. It can refer to an old copy of current data. That copy could be one minute old or several years old. Such files can be copied to and from the backup server using the archive create/restore option.
Syntax archive {create <archive name> | restore <archive to restore> [force]}
Default Access Level Mode
Privileged – 15 Privileged EXEC
Parameter Definition
create <archive name> Creates an archive with specified name restore <archive to restore> Restores the specified archive file.
[force] If the file exists, the option [force] will then erase it and restore the specified file from archive.
cd
Purpose The cd command switches from the current directory to the specified directory.
Syntax cd <directory name>
Example The following example switches from the current directory to a directory named config_files.
C4> cd config_files
Default Access Level Mode
Non-privileged – 1 User EXEC
Parameter Definition
<directory name> The name of the directory to which you want to go.
chkdisk
Purpose This command unmounts the volumes and check them for errors. If errors are found, it will correct them and re-mount the volumes.
Syntax chkdisk [detail]
The chkdisk and scandisk commands always run on the System Control NOTE Module (SCM) that you are logged in to. On a duplex system it is
recommended that you run these commands on the standby side in order not to affect the active SCM. To run the chkdisk or scandisk command on the standby SCM, you must use telnet to log in to the standby SCM.
First telnet to the standby SCM. Be sure to add the colon “:” at the end:
telnet clone:
The system prompts you to log in. After a successful login the command prompt changes to indicate that you are logged into the standby controller:
C4# chkdisk
The C4c CMTS is simplex only. NOTE
Default Access Level Mode
Privileged – 15 Privileged EXEC
Parameter Definition
[detail] Displays detailed information