Guest

Cisco TrafficDirector

TrafficDirector SwitchProbe Upgrade Procedure

Document ID: 7916

Updated: Oct 13, 2005

   Print

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:
  1. Connect to the SwitchProbe console. Below is a sample output:
      ***** Cisco SwitchProbe Model dual-et V4.5.1 (Build 100) ***** 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#:
  1. From the SwitchProbe Configuration menu, select option 11 to enter command line mode.
  2. 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.

  1. Launch the TrafficDirector application.
  2. Select the Admin radio button.
  3. Select the Agent radio button.
  4. Select the agent that you wish to upgrade from the list of agents.
  5. Select the Remote Login button.
Selecting the Remote Login button brings up the SwitchProbe Configuration Menu illustrated below:

      ***** Cisco SwitchProbe Model dual-et V4.5.1 (Build 100) ***** 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

  1. 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.
  1. If the Change TFTP Server Address is not set, select option 9, enter the IP address of your TFTP server, then reboot the probe.
  2. 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.
          ***** Cisco SwitchProbe Model dual-et V4.5.1 (Build 100) ***** 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#:

  1. From the Switch Probe Configuration menu, select option 11 to enter command line mode.
  2. 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

  1. Log in as superuser.
  2. At the UNIX prompt, enter su and press Enter.
  3. When prompted, enter the root password.
  4. Go to the /etc directory
  5. Enter the cd /etc command and press Enter
  6. 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

  1. Uncomment the line.
  2. If the line in Step 6 does not require editing, go to Step 10.
  3. 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
  1. Restart the inetd process to ensure that the process re-reads the configuration files.
  2. Verify that the TFTP directory has permission to copy hex files from a non-root user account.

AIX Systems

  1. Follow Steps 1 - 5 as described above for the Solaris section.
  2. 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

  1. 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.
  2. Verify that the /etc/services contain the following line:
    tftp 69/udp

  3. Verify that the TFTP directory has permission to copy hex files from a non-root user account.
  4. Look for the /etc/tftpaccess.ctl file.
  5. 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

  1. Follow Steps 1 - 5 as described above for the Solaris section.
  2. 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.

  1. To edit or add the TFTP line, use a text editor to make the necessary changes.
  2. View the TFTP line in the passwd file.
  3. Enter the command cat passwd | grep tftp and press Enter.
  4. 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

  5. To edit the line in the passwd file, use a tool (such as SAM) to make the necessary changes.
  6. Go to the adm subdirectory of the /usr directory.
  7. Enter the command cd /usr/adm and then press Enter.
  8. 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.
  9. To edit TFTP deny lines in the inetd.sec file, use a text editor to make the necessary changes.
  10. 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)

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

  1. 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
      %
  1. 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:
  1. Launch the TrafficDirector application.
  2. Select the Admin radio button.
  3. Select the Agent radio button.
  4. Select the agent that you wish to upgrade from the list of agents.
  5. Select the Remote Login button.
    **** Cisco SwitchProbe Model dual-et V4.5.1 (Build 100) ***** 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#:
  1. 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:
  1. Select Remote Login from the TrafficDirector application, which launches the SwitchProbe Configuration Menu.
  2. Select option 12, [12] Reset Agent. The switch probe reboots and loads the new firmware:
      Selection#: 12
      WARNING: agent will be reset, confirm [n]
OR

  1. 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
      %
  1. 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:
  1. Select the Agent radio button.
  2. Select the agent from the list.
  3. Select the Admin radio button.
  4. 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:
  1.   Select the Admin radio button.
  2.   Select the Agent radio button.
  3.   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#:

Related Information

All contents are Copyright © 1992--2001 Cisco Systems Inc. All rights reserved. Important Notic

Updated: Oct 13, 2005
Document ID: 7916