Helper Utility

You can use the helper utility to perform the following tasks on your Cisco Prime NAM 2300 series appliance:


Note For information about accessing the helper utility, see Recovery Installation.


Figure E-1 Helper Utility Menu

==============================================================================
Cisco Systems, Inc.
Network Analysis Module (NAM2304-RJ45-K9) helper utility
Version 1.1(0.21) *debug*
 
-----
Main menu
1 - Download application image and write to HDD
2 - Download application image and reformat HDD
3 - Install application image from CD and reformat HDD
4 - Display software versions
5 - Reset application image CLI passwords to default
6 - Change file transfer method (currently ftp/http)
7 - Send Ping
8 - Configure Capture RAID settings
9 - Install application image from flash and reformat HDD
f - Check for and fix file system errors on local disk
s - Show upgrade log
n - Configure network
r - Exit and reset Services Engine
h - Exit and shutdown Services Engine
 
Selection [12345678fsnrh]:


 

The following sections describe the Helper Utility Menu, what each option does, and any requirements for using a particular option.

Helper Utility Menu Summary

 

Table E-1 Helper Utility Menu Options Summary

Menu Option
Description
See...

1

Download the application image and write it to the hard disk drive.

Option 1 - Download Application Image and Write to HDD

2

Download the application image and reformat the hard disk drive.

Option 2 - Download Application Image and Reformat HDD

3

Install the application image from a CD.

Option 3 - Install Application Image from CD

4

Display the current NAM application image version stored on your hard disk.

Option 4 - Display Software Versions

5

Reset the password for users root and admin to their default values.

Option 5 - Reset Application Image CLI Passwords to Default

6

Change the file transfer method. Only FTP and HTTP are supported.

Option 6 - Change File Transfer Method

7

Send a ping to determine if network connectivity exists.

Option 7- Send Ping

8

Configure Capture RAID settings.

Option 8 - Configure Capture RAID Settings

9

Install the application image from flash and reformat the hard disk drive.

Option 9 - Install Application Image From Flash and Reformat HDD

f

Check for and fix file system errors on the local disk.

Option f - Check For and Fix Filesystem Errors on Local Disk

s

Display the upgrade log.

Option s - Show Upgrade Log

n

Configure the network parameters for the appliance

Option n - Configure Network

r

Exit the helper utility and power cycle (reboot) into the NAM application image.

Option r - Exit and Reset Services Engine

h

Exit the helper utility and shut down the NAM appliance.

Option h - Exit and Shutdown Services Engine

Option n - Configure Network

Use Option n to configure the network parameters for the appliance.


Step 1 When the Configure Network Interface menu displays, enter 1 to configure the network manually.

-----
Configure Network interface:
1 - Configure network manually
2 - Show config
3 - Write config to application image
r - return to main menu
Selection [123r]: 1
 

Step 2 The utility prompts you for the IP address, netmask, and default gateway for the appliance.

Enter IP configuration:
IP address []: 172.20.122.93
netmask []: 255.255.255.128
default gateway []: 172.20.122.1
 
-----
Configure Network interface:
1 - Configure network manually
2 - Show config
3 - Write config to application image
r - return to main menu
Selection [123r]:
 

Step 3 To check your network configuration, enter 2.

Selection [123r]: 2
 
eth0 Link encap:Ethernet HWaddr 00:0E:0C:EE:50:3E
inet addr:172.20.122.93 Bcast:172.20.122.127 Mask:255.255.255.128
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:210 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:13632 (13.3 KiB) TX bytes:0 (0.0 b)
 
Kernel IP routing table
Destination Gateway Genmask Flags Metric Ref Use Iface
172.20.122.0 0.0.0.0 255.255.255.128 U 0 0 eth0
0.0.0.0 172.20.122.1 0.0.0.0 UG 0 0 eth0
-----
Configure Network interface:
1 - Configure network manually
2 - Show config
3 - Write config to application image
r - return to main menu
Selection [123r]:
 

Option 1 - Download Application Image and Write to HDD

Use Option 1 to download a version of the current application image from an FTP server location and write the image to the hard disk.


Note If the NAM application has already been installed and the network settings were configured, they will be automatically be detected by the helper. Otherwise, you must use Option n to configure the network before using this option.


This option downloads a version of the current application from an FTP server location or from a location you can access using HTTP. You can also download the latest NAM software version from Cisco.com.

This URL requires you to have a Cisco service agreement and access to the internet to download the zipped software.

Option 2 - Download Application Image and Reformat HDD

Use Option 2 to download the current application image and write the image to the hard disk.


Caution Using this option reformats the hard disk before writing the application image and will destroy all data such as reports, packet captures, and configuration. Network connectivity configuration, however, will be retained.


Note If the NAM application has already been installed and the network settings were configured, they will be automatically be detected by the helper. Otherwise, you must use Option n to configure the network before using this option.


This option downloads a version of the current application image from an FTP server location or from a location you can access using HTTP. You can also download the latest NAM software version from Cisco.com.

This URL requires you to have a Cisco service agreement and access to the internet to download the zipped software.

Option 3 - Install Application Image from CD

Use Option 3 to install the current application image from the recovery CD. This option might be necessary if you are unable to connect to your network and download a version of NAM software you archived earlier.


Caution This option reformats the hard disk before writing the application image and will destroy all data such as reports, packet captures, and configuration. Network connectivity configuration, however, will be retained.


Note The version of NAM software available on the recovery CD is the first release of the software and has no patches or upgrades. If you use this option, see Upgrading Your Software.


Option 4 - Display Software Versions

Use Option 4 to display the current NAM application image version stored on your hard disk.

Selection [123456789dnfrh]:4
 
-----
NAM application version: 5.1(3)(1)
 
Selection [123456789dnfrh]:
 

Option 5 - Reset Application Image CLI Passwords to Default

Use Option 5 to reset the password for users root and admin to their default values.

Option 6 - Change File Transfer Method

Use Option 6 to change the file transfer method. This option is only necessary if you change the file transfer method by mistake. Only FTP and HTTP are supported.

Selection [123456789dnfrh]: 6
-----
Change file transfer method menu
The current file transfer method is ftp/http.
1 - Change to FTP/HTTP
r - return to main menu
 

Option 7- Send Ping

Use Option 7 to send a ping to determine if network connectivity exists. When prompted, enter the IP address or full domain name of the location to send the ping.

 
IP address to ping []: 172.20.122.91
 
Sending 5 ICPM ECHO_REQUEST packets to 172.20.122.91.
PING 172.20.122.91 (172.20.122.91) 56(84) bytes of data.
64 bytes from 172.20.122.91: icmp_seq=1 ttl=64 time=0.151 ms
64 bytes from 172.20.122.91: icmp_seq=2 ttl=64 time=0.153 ms
64 bytes from 172.20.122.91: icmp_seq=3 ttl=64 time=0.125 ms
64 bytes from 172.20.122.91: icmp_seq=4 ttl=64 time=0.102 ms
64 bytes from 172.20.122.91: icmp_seq=5 ttl=64 time=0.166 ms
 
--- 172.20.122.91 ping statistics ---
5 packets transmitted, 5 received, 0% packet loss, time 4000ms
rtt min/avg/max/mdev = 0.102/0.139/0.166/0.025 ms
 

Option 8 - Configure Capture RAID Settings

Use Option 8 to configure the Capture RAID settings. This option contains the following suboptions:

-----
Capture RAID Menu
1 - Rebuild all failed disks
2 - Add all new disks to the Capture RAID
3 - Decommission the Capture RAID (destructive)
4 - Construct the Capture RAID (destructive)
c - Show current Capture RAID configuration
p - Show all progress of Capture RAID reconfiguration
r - return to main menu
_
Selection [1234cpr]:
 

The following table describes each of these suboptions.

 

Table E-2 Capture RAID Menu Options

Menu Option
Description

1

Rebuild all failed disks.

2

Add new disks to the Capture RAID. If any disks have been installed since the last NAM application reformat install, the RAID will be expanded to include them.

3

Decommission the Capture RAID. Using this option cleans the hard disk and will destroy only the capture data; all other data is on the system RAID.

4

Construct the Capture RAID.

c

Show the current Capture RAIID configuration.

p

Show the progress of the Capture RAID reconfiguration.

r

Return to the main menu.

Option 9 - Install Application Image From Flash and Reformat HDD

Use Option 9 to install the application image from flash and reformat the hard disk.


Caution This option reformats the hard disk before writing the application image and will destroy all data such as reports, packet captures, and configuration. Network connectivity configuration, however, will be retained.


Note If the NAM application has already been installed and the network settings were configured, they will be automatically be detected by the helper. Otherwise, you must use Option n to configure the network before using this option.


Option f - Check For and Fix Filesystem Errors on Local Disk

Use Option f to find and fix file system errors on the local disk. Depending on the partition size, this option might take a long time.

Option s - Show Upgrade Log

Use Option s to display the upgrade log.

Option r - Exit and Reset Services Engine

Use Option r to exit the helper utility and power cycle (reboot) into the newly installed application image.

Option h - Exit and Shutdown Services Engine

Use Option h to exit the helper utility and shut down the NAM appliance.

------------------------------------------------------------------------
Selection [12345678fsnrh]: h
About to exit and shutdown NAM.
Are you sure? [y/N] y
Stopping internet superserver: inetd.
Stopping OpenBSD Secure Shell server: sshd.
Stopping internet superserver: xinetd.
Stopping internet superserver: xinetd-ipv4.
: done.
Shutting down NAM (NAM2304-RJ45-K9), part 1:
Stopping klogd...
Stopping syslogd...
Sending all processes the TERM signal... done.
Sending all processes the KILL signal... done.
Unmounting remote filesystems... done.
Deactivating swap...done.
Unmounting local filesystems...done.
Starting halt command: halt
Power down.
-----------------------------------------------------------------------------------------