Installing, Downloading, and Upgrading CBT 3.4
Use the following steps to download and to install CBT 3.4 on a system with the Linux, Solaris, or Windows operating systems. This section contains the following topics:
•Using TCP Ports for CBT 3.4 Upgrade and Operation
•CBT 3.4 Download and Upgrade
•Uninstalling CBT 3.4
Using TCP Ports for CBT 3.4 Upgrade and Operation
Note Cisco implements a default TCP port of 8105 on the licensing server for CBT 3.4. This prevents port conflict with other applications.
If you require a TCP port other than the default of 8105, then set the TCP port after installation of CBT 3.4, but prior to licensing. Refer to Step 5 below. We recommend ports other than 8005, 8080, 9080, 9443, and 9082, as these are used for tomcat and other applications.
The following are the default ports used by CBT 3.4:
•Port 8105: Java Virtual Machine (JVM) server port
•Port 9080: Non-SSL HTTP port
•Port 9443: SSL HTTP port
•Port 9082: Apache JServ Protocol (AJP) 1.3 Connector
•Port 2640: For Sybase database connectivity
•Port 8020: For Poller operation
CBT 3.4 uses the following port ranges for spectrum operations. Spectrum events such as Trace Window, Spectrogram, CNR Trending, and Generic Query use a specified range of port numbers for operation.
•For both Trace Window events and Spectrogram events, port numbers range from 2100 to 2500.
•For Spectrum tools, such as CNR Trending, port numbers range from 3100 to 3500.
•For Diagnostic tools, such as Generic Query, port numbers range from 5100 to 5500.
The usage of these spectrum port numbers is in increments of 1, that is, the first trace Window launched obtains port number 2100, the next Trace Window obtains port 2101, the next Spectrogram window is port 2102, and so forth till port 2500.
CBT 3.4 Download and Upgrade
Step 1 Download CBT 3.4 software for the desired platform from Cisco.com to your local directory <CBT3.4_DOWNLOAD_DIR>.
•Cisco.com (http://www.cisco.com/cisco/software/type.html?mdfid=268439486&flowid=5016&softwareid=281104848)
•The following platform files and release notes are available:
–There is a single file for the Solaris platform—CBT34-Solaris.tar.gz
–There is a single file for the Linux platform—CBT34-Linux.tar.gz
–Platform files for the Windows platform—CBT34-Win.exe
–CBT 3.4 Release Notes—CBT34ReleaseNotes.pdf
Step 2 Extract the software. For Solaris and Linux, use the commands below. For Windows 2000 and Windows XP, skip to Step 3.
•Solaris:
a. cd <CBT3.4_DOWNLOAD_DIR>
b. gunzip CBT34-Solaris.tar.gz
c. tar xvf CBT34-Solaris.tar
•Linux:
a. cd <CBT3.4_DOWNLOAD_DIR>
b. gunzip CBT34-Linux.tar.gz
c. tar xvf CBT34-Linux.tar
Step 3 If there is a previous CBT installation (CBT 2.x, CBT 3.0, CBT 3.2, or CBT 3.3), uninstall it using the following procedures; otherwise, skip to Step 4.
•Solaris: cd <CBT3.x_DOWNLOAD_DIR> ./uninstall
•Linux: cd <CBT3.x_DOWNLOAD_DIR> ./uninstall
•Windows:
–In Windows Explorer, double-click CBT3x-Win.exe in <CBT3.x_DOWNLOAD_DIR>.
–Remove the existing CBT installation.
Step 4 Install CBT 3.4.
•Solaris: cd <CBT3.4_DOWNLOAD_DIR> ./install
•Linux: cd <CBT3.4_DOWNLOAD_DIR> ./install
•Windows:
–From Windows Explorer, double-click CBT34-Win.exe in <CBT3.4_DOWNLOAD_DIR>.
–Select the default answers to the installation questions.
Note A demonstration version of CBT 3.4 is now running (a license is not included in the Cisco.com download). To make the software fully functional, obtain a license for CBT 3.4 from Cisco Systems. See Step 5.
Step 5 Purchased copies of CBT no longer include a software CD, but include a license certificate with a PAK key. This PAK key generates the necessary license file from the following websites, and the software is downloaded from Cisco.com.
•Use this site if you are a registered user of Cisco.com:
www.cisco.com/go/license
•Use this site if you are not a registered user of Cisco.com:
www.cisco.com/go/license/public
Demonstration copies can be obtained either from the Internet, or as an ordered accessory for an universal broadband router product:
•The copy available from the Internet uses a registration page where the PAK key is e-mailed to you.
•The copies supplied with the universal broadband router product include a demo license certificate with a PAK key.
Step 6 Save the license file generated using the PAK key to your system with the name License.
Step 7 Use the following commands or click sequences to copy the license to the license directory and restart CBT 3.4.
•Solaris:
1. cp License /opt/CSCOcbt/httpServer/webapps/ROOT/WEB-INF/classes/lic
2. /opt/CSCOcbt/bin/stop_app
3. /opt/CSCOcbt/bin/start_app
•Linux:
1. cp License /opt/CSCOcbt/httpServer/webapps/ROOT/WEB-INF/classes/lic
2. /opt/CSCOcbt/bin/stop_app
3. /opt/CSCOcbt/bin/start_app
•Windows:
1. copy License <CBT3.4_INSTALLATION_DIR>\httpServer\webapps\ROOT\WEB-INF\classes\lic>
2. Click Start > Programs > Cisco Broadband Troubleshooter > Stop Troubleshooter
3. Click Start > Programs > Cisco Broadband Troubleshooter > Start Troubleshooter
Note When the CBT 3.4 license is installed and is active, additional changes to the license are not supported. License changes disable an otherwise valid license.
Figure 2-1 CBT Log In Window
Installing and Starting CiscoView on Solaris
Note The Solaris installation package for CBT 3.4 includes the CiscoView installation package.
Step 1 Obtain the software as per the instructions in the "CBT 3.4 Download and Upgrade" section.
Step 2 Log in as root.
Step 3 (Optional) If you are not running Solaris Volume Manager as root, you must manually mount the CD:
•If a mount point does not exist, create one by making a new /cdrom directory.
•Enter the following command, where CD-ROM device is the name of your CD-ROM:
mount CD-ROM device /cdrom
Note If you are running Solaris Volume Manager, the CD-ROM automatically mounts on the /cdrom/cdrom0 directory.
Step 4 To change to the CiscoView Solaris directory and install CiscoView, enter:
cd /cdrom/cdrom0/solaris/cv
The CBT server is now running.
Step 5 (Optional) If you are not running Solaris Volume Manager, make sure that no other application is using /cdrom as the current directory so that you can unmount the CD by entering:
Note If you are running Solaris Volume Manager, the CD-ROM automatically unmounts.
Step 6 To eject the CD, enter:
Step 7 To start CBT by using a command line, enter:
or
To access CBT using a browser, open the browser and enter:
http://CBT server IP address:9080/
Note In the URL, CBT server IP address is the server on which you installed CBT.
Step 8 In the Log In window (see Figure 2-1), enter your username and password.
Step 9 (Optional) To stop CBT manually, enter:
Installing and Starting CBT on Windows
Step 1 Obtain the software as per the instructions in the "CBT 3.4 Download and Upgrade" section.
Step 2 From Windows Explorer, double-click CBT34-Win.exe.
Step 3 Select the default answers to the installation questions.
The CBT server is now running.
Step 4 To start CBT by using the menus, choose:
Start > Programs > Cisco Broadband Troubleshooter > Start Troubleshooter
Step 5 To access CBT, open the browser and enter:
http://CBT server IP address:9080/
Note In the URL, CBT server IP address is the server on which you installed CBT.
Step 6 In the Log In window (see Figure 2-1), enter your username and password.
Step 7 (Optional) To stop CBT manually, choose:
Start > Programs > Cisco Broadband Troubleshooter > Stop Troubleshooter
Installing and Starting CBT on Linux
Step 1 Obtain the software as per the instructions in the "CBT 3.4 Download and Upgrade" section.
Step 2 Log in as root.
Step 3 To go to the CBT Linux directory, enter:
Step 4 To start the installation program, enter:
The CBT server is now running.
Step 5 To start CBT by using a command line, enter:
or
To access CBT using a browser, open the browser and enter:
http://CBT server IP address:9080/
Note In the URL, CBT server IP address is the server on which you installed CBT.
Step 6 In the Log In window (see Figure 2-1), enter your username and password.
Step 7 (Optional) To stop CBT manually, enter:
Uninstalling CBT 3.4
This section provides instructions to uninstall CBT 3.4 on each supported platform.
•Uninstalling CBT on Solaris
•Uninstalling CBT on Windows
•Uninstalling CBT on Linux
Uninstalling CBT on Solaris
Step 1 Log in as root.
Step 2 Insert the CBT 3.4 CD-ROM for Solaris into the CD-ROM drive.
Step 3 To change to the CBT Solaris directory, enter:
cd/cdrom/cdrom0/solaris/cbt
Step 4 To uninstall CBT, enter:
If there is a previous CBT installation (CBT 2.x, CBT 3.0, CBT 3.2, or CBT 3.3), uninstall it using the following step:
•cd <CBT3.x_DOWNLOAD_DIR> ./uninstall
Uninstalling CBT on Windows
Step 1 Choose:
Start > Settings > Control Panel > Add/Remove Programs
Step 2 Select Cisco Broadband Troubleshooter.
Step 3 Click Remove.
If there is a previous CBT installation (CBT 2.x, CBT 3.0, CBT 3.2, or CBT 3.3), uninstall it using the following steps.
•From Windows Explorer, double-click CBT34-Win.exe in <CBT3.x_DOWNLOAD_DIR>.
•Choose Remove to remove all installed components of the existing CBT installation.
Uninstalling CBT on Linux
Step 1 Log in as root.
Step 2 Insert the CBT 3.4 CD-ROM into the CD-ROM drive.
Step 3 To mount the CD, enter:
Step 4 To change to the CBT Linux directory, enter:
Step 5 To uninstall CBT, enter:
If there is a previous CBT installation (CBT 2.x, CBT 3.0, CBT 3.2, or CBT 3.3), uninstall it using the following step:
•cd <CBT3.x_DOWNLOAD_DIR> ./uninstall