Table Of Contents

Utility Commands

How to Use the Setup Command

Setup Command Parameters

Entering the Setup Command

Defining Lists in the Setup Utility

Multiple Entry Parameters (Lists)

Working with NME-APA Module Files

Working with Directories

Creating a Directory

Deleting a Directory

Changing Directories

Displaying your Working Directory

Listing the Files in a Directory

Working with Files

Renaming a File

Deleting a File

Copying Files

Displaying File Contents

Unzipping a File

Utility Commands

---

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 

•Entering the Setup Command 

•Defining 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 using Telnet to make changes to the system configuration.

---

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

---

Table 5-1 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.

Entering 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.

---

Defining 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

•Creating a Directory 

•Deleting a Directory 

•Changing Directories 

•Displaying your Working Directory 

•Listing the Files in a Directory 

Creating a Directory

mkdir

---

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

---

Deleting a Directory

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

•Deleting a Directory and All its Files 

•Deleting an Empty Directory 

Deleting a Directory and All its Files

delete

---

Step 1 From the NME-APA# prompt, type delete directory-name /recursive and press Enter.

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

---

Deleting an Empty Directory

rmdir

---

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

Use this command only for an empty directory.

---

Changing Directories

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

cd

---

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

---

Displaying your Working Directory

pwd

---

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

---

Listing 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.

•Listing the Files in the Current Directory 

•Listing the Applications in the Current Directory 

•Including Files in Sub-Directories in the Directory Files List 

Listing the Files in the Current Directory

dir

---

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

---

Listing the Applications in the Current Directory

---

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

---

Including Files in Sub-Directories in the Directory Files List

---

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

---

Working with Files

•Renaming a File 

•Deleting a File 

•Copying Files 

•Displaying File Contents 

•Unzipping a File 

Renaming a File

rename

---

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

---

Deleting a File

delete

---

Step 1 From the NME-APA# prompt, type delete 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 or download) to or from an FTP site.

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

•Copying a File 

•Downloading a File from an FTP Site 

•Uploading a File to a Passive FTP Site 

Copying a File

copy

---

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

---

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#

Downloading 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 copy 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)

---

Uploading a File to a Passive FTP Site

copy-passive

---

Step 1 From the NME-APA# prompt, type copy-passive 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)

---

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#

Displaying File Contents

more

---

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

---

Unzipping a File

unzip

---

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

---