TrafficDirector SwitchProbe Upgrade Procedure [Cisco TrafficDirector]

Document ID: 7916

Updated: Oct 13, 2005

Download PDF

Introduction

Hardware and Software Versions

Upgrade Procedure

Verifying SwitchProbe Memory Requirements

Verifying and Configuring the TFTP Server

Solaris Systems

AIX Systems

HP-UX Systems

Copying an Agent Firmware File to the TFTP Server

Upgrade Firmware on the SwitchProbe

Resetting the SwitchProbe

Verifying the SwitchProbe Firmware Upgrade

Related Information

Introduction

This document describes how to upgrade the firmware of SwitchProbe using the TrafficDirector application.

Hardware and Software Versions

The information in this document is based on the software and hardware versions below.

TrafficDirector version 5.6 and later
SwitchProbe Firmware 4.2 or later

Upgrade Procedure

Verifying SwitchProbe Memory Requirements

SwitchProbe devices are shipped with the latest version of agent firmware already installed in both EPROM and FLASH memory. However, as new agent firmware is released, the firmware that was originally shipped with the device may no longer be the most current version. You might want to upgrade or update the agent software in your switch probe device. The TrafficDirector application supports the most current release of the agent.

Note: You must have 512K memory to upgrade the SwitchProbe firmware to Release 4.7 or later. If the FLASH size is 256K, you must upgrade your device to 512K FLASH before you can install the latest release of firmware. If your device is running release 4.5.4 or later, you can determine the FLASH size by entering the get agent command from the SwitchProbe console.

To verify the FLASH memory size of the switch probe, follow the steps below:

Connect to the SwitchProbe console. Below is a sample output:

Interface number : 1

[1] Change IP Address	10.29.1.134
[2] Change Net Mask	255.255.255.0
[3] Change Default Gateway Address	10.29.1.1
[4] Change Read Community	public
[5] Change Write Community	private
[8] Select Interface	ETHERNET
[9] Change TFTP Server Address	10.68.118.107
[10] Upgrade Software
[11] Enter Command-line mode
[12] Reset Agent

[31] Go to Next Page

Enter your response or Enter "exit" to logout

Selection#:

From the SwitchProbe Configuration menu, select option 11 to enter command line mode.

At the command prompt, enter the % get agent command to display the probe's specifications. Sample output is shown below:

model_number	6010
agent_number	67213695
software_version	4.5.4 (Build 102)
link time	May 28 17:16:21 1999
memory size	8 MB
nvram_version	31
nvram size	32 KB
*flash size*	*512 KB [Large Image]*
agent_location	Agent Location Here
agent_contact	Your Contact Here
agent_name	FE-FDX-Probe
read_community	public
write_community	private
max_host	256
max_matrix	1024
max_log	128
max_controlentry	256
config_server	0.0.0.0
tftp_server	171.69.85.2
tftp_filename	ns6010.hex
tftp_timeout in secs	10
serial_number	0116446679

The above output indicates that the switch probe has the required Flash memory to proceed with the upgrade.

By default, switch probe devices boot from Flash memory. Therefore, when you download new agent firmware to the device, the new agent firmware is loaded in Flash memory during boot.

Note: When you upgrade agent firmware, the original, factory-installed version of firmware remains in EPROM. Therefore, if the upgrade fails or the Flash becomes corrupted, you can force the device to boot from EPROM by setting DIP switch 1 to On.

Launch the TrafficDirector application.

Select the Admin radio button.

Select the Agent radio button.

Select the agent that you wish to upgrade from the list of agents.

Select the Remote Login button.

Selecting the Remote Login button brings up the SwitchProbe Configuration Menu illustrated below:

V4.5.1

Interface number : 1

[1] Change IP Address	10.29.1.134
[2] Change Net Mask	255.255.255.0
[3] Change Default Gateway Address	10.29.1.1
[4] Change Read Community	public
[5] Change Write Community	private
[8] Select Interface	ETHERNET
*[9] Change TFTP Server Address*	*10.68.118.107*
[10] Upgrade Software
[11] Enter Command-line mode
[12] Reset Agent

[31] Go to Next Page

Enter your response or Enter "exit" to logout

Selection#:

In the above sample output, V4.5.1 (Build 100) is the current SwitchProbe firmware version.

Verifying and Configuring the Trivial File Transfer Protocol (TFTP) Server

Make sure that the Change TFTP Server Address option is set to the IP address of your TrafficDirector server (if you are using this as your TFTP server) or your external TFTP server. An example is a Sun SPARC station where the TFTP daemon is turned on in the file /etc/inetd.conf, and a /tftpboot directory is present.

If the Change TFTP Server Address is not set, select option 9, enter the IP address of your TFTP server, then reboot the probe.

Once the switch probe has completed rebooting, launch the TrafficDirector application again and connect to the switch probe using the Remote Login Utility as described above.

Interface number : 1

[1] Change IP Address	10.29.1.134
[2] Change Net Mask	255.255.255.0
[3] Change Default Gateway Address	10.29.1.1
[4] Change Read Community	public
[5] Change Write Community	private
[8] Select Interface	ETHERNET
[9] Change TFTP Server Address	10.68.118.107
[10] Upgrade Software
[11] Enter Command-line mode
[12] Reset Agent

[31] Go to Next Page

Enter your response or Enter "exit" to logout

Selection#:

From the Switch Probe Configuration menu, select option 11 to enter command line mode.

At the command prompt, enter the % get agent command to display the probe's specifications. Sample output is shown below:

model_number 6010

agent_number 67213695

software_version 4.5.4 (Build 102)

link time May 28 17:16:21 1999

memory size 8 MB

nvram_version 31

nvram size 32 KB

flash size 512 KB [Large Image]

agent_location Agent Location Here

agent_contact Your Contact Here

agent_name FE-FDX-Probe

read_community public

write_community private

max_host 256

max_matrix 1024

max_log 128

max_controlentry 256

config_server 0.0.0.0

tftp_server 171.69.85.2

tftp_filename ns6010.hex

tftp_timeout in secs 10

serial_number 0116446679

%
The above output shows that the switch probe sends a TFTP get request to 171.69.85.2 for the file ns6010.hex.

Note: The tftp_filename (agent firmware) differs depending on the type of switch probe you are upgrading.

Solaris Systems

At the UNIX prompt, enter su and press Enter.

When prompted, enter the root password.

Go to the /etc directory

Enter the cd /etc command and press Enter

To view the TFTP line in the inetd.conf file, enter the cat inetd.conf | grep tftp command and then press Enter:

The /etc/inetd.conf file should contain the line:

tftp dgram udp wait root /usr/sbin/in.tftpd in.tftpd /tftpboot

Uncomment the line.

If the line in Step 6 does not require editing, go to Step 10.

If the line is Step 6 requires editing:

a. Stop the inetd process by entering the kill -I command and pressing Enter.
b. Make the necessary changes to the /etc/inetd.conf file

Restart the inetd process to ensure that the process re-reads the configuration files.

Verify that the TFTP directory has permission to copy hex files from a non-root user account.

AIX Systems

Follow Steps 1 - 5 as described above for the Solaris section.

To view the TFTP line in the inetd.conf file, enter the command cat inetd.conf | grep tftp and then press Enter.

The /etc/inetd.conf file should contain the line:

tftp dgram udp nowait nobody /usr/sbin/tftpd tftpd

If you need to modify the line listed in Step 2, enter the command refresh-s inetd after making any changes to enable the modifications.

Verify that the /etc/services contain the following line:

tftp 69/udp
Verify that the TFTP directory has permission to copy hex files from a non-root user account.

Look for the /etc/tftpaccess.ctl file.

If the file exists, verify that the default TFTP directory contains an allow statement. To edit an allow line in the tftpaccess.ctl file, use a text editor to make the necessary changes. See the AIX tftpd main page for more information about this feature.

HP-UX Systems

Follow Steps 1 - 5 as described above for the Solaris section.

To view the TFTP line in the inetd.conf file, enter the command cat inetd.conf | grep tftp and then press Enter.

The /etc/inetd.conf file should contain the line:

tftp dgram udp wait root /etc/tftpd tftpd

There must not be a comment (#) character in the first position of the TFTP command line.

To edit or add the TFTP line, use a text editor to make the necessary changes.

View the TFTP line in the passwd file.

Enter the command cat passwd | grep tftp and press Enter.

Verify that the following line (or an equivalent one) exists in your /etc/passwd file. There must not be a comment (#) character in the first position of the TFTP command line:

tftp:*:510:guest:Trivial FTP user:/usr/tftpdir:/bin/false
To edit the line in the passwd file, use a tool (such as SAM) to make the necessary changes.

Go to the adm subdirectory of the /usr directory.

Enter the command cd /usr/adm and then press Enter.

Check for the existence of an inetd.sec file. This file provides TFTP security using allow and deny statements. If the inetd.sec file exists, verify that the IP address or hostname of the agent you want to upgrade is not listed in a TFTP deny line in this file.

To edit TFTP deny lines in the inetd.sec file, use a text editor to make the necessary changes.

Verify that the TFTP directory has permission to copy hex files from a non-root user account.

Copying An Agent Firmware File to the TFTP Server

When TrafficDirector is installed, it creates a directory called binagent. This directory contains the default firmware for all the switch probe models used with a particular version of TrafficDirector. The location of this directory is:

On Windows: C:\Program Files\TD\binagent (if TrafficDirector is installed in the default directory and location)

On UNIX: /opt/CSCOtd5/binagent (where /opt is the default install location)

Newer versions of the Switch Probe firmware can be downloaded from the Cisco SwitchProbe Planner page (available to Registered CCO users only).

Copy the firmware file to the /tftpboot directory of your TFTP server defined in the above sample output.

For UNIX:

If upgrading from the $NSHOME\binagent agent directory, use the following commands:

# cd /opt/CSCOtd5/binagent
# cp $FILENAME /tftpboot
(where $FILENAME is equal to the value of tftp_filename from the output of the get agent command and /tftpboot is the root of the tftpserver specified in /etc/inetd.conf).

chmod 777 /tftpboot/$FILENAME

For Windows:

If upgrading from the $NSHOME\binagent directory, use the following commands:

C:\ cd c:\Program Files\TD\binagent
C:\ copy $FILENAME C:\Program Files\CSCOpx\tftpboot
(where $FILENAME is equal to the value of tftp_filename from the output of the get agent command).

Notes:

C:\Program Files\CSCOpx\ is the default install directory for CiscoWorks 2000 (CW2000). This path is different if a non-default directory was specified during the installation of CW2000.

C:\Program Files\TD is the default install directory for Traffic Director. If you do not have CW2000 installed, you can use any TFTP server of your choice.
Note: The Microsoft® Windows® based TFTP server previously provided by Cisco Systems has been discontinued and is no longer supported. Persons still using the server should consider replacing it with any of the high quality freeware and shareware TFTP servers which have become available since the Microsoft Windows based Cisco TFTP server was first released in 1995. As a historical note, the Cisco TFTP server was released to customers at a time when no other freely available TFTP servers existed. Today there are dozens of freeware or shareware versions available.

Note: You should install the agent firmware files into the $NSHOME\binagent directory on the network management system (TrafficDirector).

Upgrade Firmware on the SwitchProbe

Once the switch probe firmware file is copied to the TFTP server root directory, you can upgrade the probe's firmware. Two ways to do this are explained below:

Command Line Interface (CLI) Upgrade

Connect to the SwitchProbe using the console and select option 11, [11] Enter Command-line mode:

Selection#: 11

Enter quit to exit command-line mode

From the command line of the probe, use the do tftp command with the following syntax:

% do tftp $FILENAME

Warning ! This command will erase the software in FLASH memory

Continue (n):

Note: If you do not specify a filename, the value of tftp_filename is used. $FILENAME may be used to get a file that is named something other than the default value of tftp_filename. In most cases, the default works fine.

Upgrade using TrafficDirector Remote Login Utility

Another method of upgrading the firmware in the switch probe is to use the Probe Configuration Menu (Remote Login Utility) using TrafficDirector as shown below:

Launch the TrafficDirector application.

Select the Admin radio button.

Select the Agent radio button.

Select the agent that you wish to upgrade from the list of agents.

Select the Remote Login button.

Interface number : 1

[1] Change IP Address	10.29.1.134
[2] Change Net Mask	255.255.255.0
[3] Change Default Gateway Address	10.29.1.1
[4] Change Read Community	public
[5] Change Write Community	private
[8] Select Interface	ETHERNET
[9] Change TFTP Server Address	10.68.118.107
[10] Upgrade Software
[11] Enter Command-line mode
[12] Reset Agent

[31] Go to Next Page

Enter your response or Enter "exit" to logout

Selection#:

Select option [10] Upgrade Software to run the equivalent of the previously mentioned do tftp command:

Selection#: 10

Warning! This Command will erase the software in the FLASH memory

Continue (n):

A TFTP get request uses interface 1 to the Server address. The file is then transferred using TFTP to the SwitchProbe.

Resetting the SwitchProbe

Once the upgrade is complete, you must reset the switch probe to load the new firmware. You can do this in two ways:

Select Remote Login from the TrafficDirector application, which launches the SwitchProbe Configuration Menu.

Select option 12, [12] Reset Agent. The switch probe reboots and loads the new firmware:

Selection#: 12

WARNING: agent will be reset, confirm [n]

Connect to the switch probe using the console and select option 11, [11] Enter Command-line mode:

Selection#: 11

Enter quit to exit command-line mode

Issue the do reset command from the command line. The probe reboots and loads the new firmware.

% do reset

WARNING: agent will be reset, confirm [n]

Verifying the SwitchProbe Firmware Upgrade

To verify the switch probe upgrade, follow these steps from the main TrafficDirector window as shown below:

Select the Agent radio button.

Select the agent from the list.

Select the Admin radio button.

Select the Test Agent button.

If the test was successful, you should get results similar to the following:

To verify that the probe upgrade has occurred, do the following from the main TrafficDirector Screen:

Select the Admin radio button.

Select the Agent radio button.

Select the Remote Login button

Notice that the SwitchProbe version is now 4.5.4 (Build 102) in the SwitchProbe Configuration menu:

**** Cisco SwitchProbe Model dual-et V4.5.4 (Build 102) *****
Interface number : 1

[1] Change IP Address 10.29.1.134

[2] Change Net Mask 255.255.255.0

[3] Change Default Gateway Address 10.29.1.1

[4] Change Read Community public

[5] Change Write Community private

[8] Select Interface ETHERNET

[9] Change TFTP Server Address 10.68.118.107

[10] Upgrade Software

[11] Enter Command-line mode

[12] Reset Agent

[31] Go to Next Page

Enter your response or Enter "exit" to logout

Selection#:

Cisco TrafficDirector