Cisco Network Module Enhanced Application Performance Assurance User Guide
Utilities
Download this chapter
UtilitiesUtilities
Download the complete book
Cisco Network Module Enhanced Application Performance Assurance User GuideCisco Network Module Enhanced Application Performance Assurance User Guide (PDF - 2 MB)
give_us_feedback

Table Of Contents

Utilities

How to Use the Setup Command

Setup Command Parameters

How to Enter the Setup Command

How to Define Lists in the Setup Utility

Multiple entry parameters (Lists)

Working with NME-APA Module Files

Working with Directories

How to Create a Directory

How to Delete a Directory

How to Change Directories

How to Display your Working Directory

How to List the Files in a Directory

Working with Files

How to Rename a File

How to Delete a File

Copying Files

How to Display File Contents

How to Unzip a File


Utilities

This module describes the following utilities:

•Setup utility command

•File operation utility commands

•User log utility commands

How to Use the Setup Command

•Setup Command Parameters 

•How to Enter the Setup Command 

•How to Define Lists in the Setup Utility 

Setup Command Parameters

The setup utility is an interactive wizard that guides the user through the basic configuration process. It may also be invoked explicitly via Telnet to make changes to the system configuration.

Note The preferred method of setting up an NME-APA module is through the NME-APA Device Console, see the Cisco Network Module Enhanced-Application Performance Assurance (NME-APA) Device Console User Guide .

The following table lists all the command parameters for the setup utility.

Table 5-1 Setup Command Parameters  

Parameter
Definition

hostname

Character string used to identify the NME-APA platform. Maximum length is 20 characters.

admin password

Admin level password

Character string from 4-100 characters beginning with an alpha character.

.root password

Root level password.

Character string from 4-100 characters beginning with an alpha character.

password encryption status

Enable or disable password encryption?

User Anonymous Group Settings

user anonymous group name

Character string used to identify the anonymous users group.

user anonymous group IP range

IP range of the anonymous users group in dotted notation.

Time Settings

time zone name and offset

Standard time zone abbreviation and minutes offset from UTC.

local time and date

Current local time and date. Use the format:

00:00:00 1 January 2007

SNTP Configuration

broadcast client status

Sets the status of the SNTP broadcast client.

If enabled, the NME-APA will synchronize its local time with updates received from SNTP broadcast servers.

unicast query interval

Interval in seconds between unicast requests for update (64 - 1024)

unicast server IP address

IP address of the SNTP unicast server.

SNMP Configuration

SNMP agent status

SNMP agent status Enable or disable SNMP management.

GET community names

Community strings to allow GET access and associated ACLs (maximum 20).

SET community names

Community strings to allow SET access and associated ACLs (maximum 20).

trap managers (maximum 20)

Trap manager IP address, community string, and SNMP version.

Authentication Failure trap status

Sets the status of the Authentication Failure traps.

enterprise traps status

Sets the status of the enterprise traps.

system administrator

Name of the system administrator.


Information regarding these parameters can be found in the appropriate sections throughout this guide.

How to Enter the Setup Command

setup

Step 1 From the NME-APA# prompt, type setup and press Enter.

The following dialog appears: 

--- System Configuration Dialog --- 
At any point you may enter a question mark `?' followed by `Enter' for help. 
Use ctrl-C to abort configuration dialog at any prompt. 
Use ctrl-Z to jump to the end of the configuration dialog at any prompt. 
Default settings are in square brackets `[]'. 
Would you like to continue with the System Configuration Dialog? [yes/no]: y 
system configuration dialog begins.

How to Define Lists in the Setup Utility

Multiple entry parameters (Lists)

When explicitly invoked, the setup utility offers the option of multiple entries (lists) for certain parameters.

Several parameters are actually lists containing several entries. If these lists are empty (initial configuration) or contain only one entry, they act the same as any scalar parameter, except that you are given the option of adding additional entries to the list.

If these lists already contain more than one entry, the entire list is displayed, and you are then presented with several options. Following is an excerpt from the SNMP trap manager menu, illustrating how to configure list entries.

Step 1 The entries in the list are displayed. 

There are 2 SNMP trap managers in the current configuration as follows: 
IP address: 10.10.10.10 	Community: private	Version: 1 
IP address: 10.11.10.1 	Community: pcube	Version: 2c

Step 2 Three options are presented.

Note If only one entry exists in the table, it is displayed as the default [ ] to be either accepted or changed. The three list options are not displayed. 

Please choose one of the following options: 
1. Leave the running configuration unchanged. 
2. Clear the existing lists and configure new ones. 
3. Add new entries. 
Enter your choice:

Step 3 You are prompted to continue the setup, depending on the choice you entered:

•Leave the running configuration unchanged:

The dialog proceeds to the next question. The list remains unchanged.

•Clear the existing entries and configure new ones:

The dialog prompts you for a new entry in the list.

After completing the first entry, you are asked whether you would like to add another new entry. 

Would you like to add another SNMP trap manager? [no]:y

Since the list was empty, you may enter the maximum number of entries.

•Add new entries:

The dialog prompts you for a new entry in the list.

After the completing one entry, you are asked whether you would like add another new entry. 

Would you like to add another SNMP trap manager? [no]:y

You may enter only enough additional entries to reach the maximum number

Working with NME-APA Module Files

The CLI commands include a complete range of file management commands. These commands allow you to create, delete, copy, and display both files and directories

Note Regarding disk capacity: While performing disk operations, the user should take care that the addition of new files that are stored on the NME-APA disk do not cause the disk to exceed 70%.

Working with Directories

•How to Create a Directory 

•How to Delete a Directory 

•How to Change Directories 

•How to Display your Working Directory 

•How to List the Files in a Directory 

How to Create a Directory

mkdir

Step 1 From the NME-APA# prompt, type Would you like to add another SNMP trap manager? [no]:directory-name and press Enter.

How to Delete a Directory

There are two different commands for deleting a directory, depending on whether the directory is empty or not.

•How to Delete a Directory and All its Files 

•How to Delete an Empty Directory 

How to Delete a Directory and All its Files

delete

Step 1 From the NME-APA# prompt, type Would you like to add another SNMP trap manager? [no]:directory-name/recursive and press Enter.

The recursive flag deletes all files and sub-directories contained in the specified directory.

How to Delete an Empty Directory

rmdir

Step 1 From the NME-APA# prompt, type mkdir directory-nameand press Enter.

Use this command only for an empty directory.

How to Change Directories

Use this command to change the path of the current working directory.

cd

Step 1 From the NME-APA# prompt, type delete new pathand press Enter.

How to Display your Working Directory

pwd

Step 1 From the NME-APA# prompt, type rmdir and press Enter.

How to List the Files in a Directory

You can display a listing of all files in the current working directory. This list may be filtered to include only application files. The listing may also be expanded to include all files in any sub-directories.

•How to List the Files in the Current Directory 

•How to List the Applications in the Current Directory 

•How to Include Files in Sub-Directories in the Directory Files List 

How to List the Files in the Current Directory

dir

Step 1 From the NME-APA# prompt, type cd and press Enter.

How to List the Applications in the Current Directory

Step 1 From the NME-APA# prompt, type pwd and press Enter.

How to Include Files in Sub-Directories in the Directory Files List

Step 1 From the NME-APA# prompt, type dir and press Enter.

Working with Files

•How to Rename a File 

•How to Delete a File 

•Copying Files 

•How to Display File Contents 

•How to Unzip a File 

How to Rename a File

rename

Step 1 From the NME-APA# prompt, type dir applications current-file-name new-file-nameand press Enter.

How to Delete a File

delete

Step 1 From the NME-APA# prompt, type dir -r file-name and press Enter.

Copying Files

You can copy a file from the current directory to a different directory. You can also copy a file (upload/download) to or from an FTP site.

To copy a file using passive FTP, use the copy-passive command.

•How to Copy a File 

•How to Download a File from an FTP Site 

•How to Upload a File to a Passive FTP Site 

How to Copy a File

copy

Step 1 From the NME-APA# prompt, type rename source-file-name destination-file-name and press Enter.

Copying a File: Example

The following example copies the local analysis.sli file located in the root directory to the applications directory. 

NME-APA#copy analysis.sli applications/analysis.sli 
NME-APA#

How to Download a File from an FTP Site

Use the copy command to upload and download commands from and FTP site. In this case,either the source or destination filename must begin with ftp:// .

Step 1 From the NME-APA# prompt, type delete ftp://source destination-file-name and press Enter.

To upload a file to an FTP site, specify the FTP site as the destination (ftp://destination)

How to Upload a File to a Passive FTP Site

copy-passive

Step 1 From the NME-APA# prompt, type copy source-file-name ftp://destination and press Enter.

To download a file from a passive FTP site, specify the FTP site as the source ( ftp://source)

Uploading a File to a Passive FTP Site: Example

The following example uploads the analysis.sli file located on the local flash file system to the host 10.1.1.105, specifying Passive FTP. 

NME-APA#copy-passive /appli/analysis.sli 
ftp://myname:mypw@10.1.1.105/p:/appli/analysis.sli 
NME-APA#

How to Display File Contents

more

Step 1 From the NME-APA# prompt, type copy file-name and press Enter.

How to Unzip a File

unzip

Step 1 From the NME-APA# prompt, type copy-passive file-name and press Enter.