|
|
This chapter contains the following sections:
Tunnel Builder Pro is a licensed client-server application. Multiple Tunnel Builder Pro clients can connect to a single Tunnel Builder Pro server. The Tunnel Builder Pro server communicates with supported network hardware platforms running supported Cisco IOS releases.
This section describes the following:
Tunnel Builder Pro can be used on any network platform that supports MPLS Traffic Engineering (TE).
The Tunnel Builder Pro application supports devices running Cisco IOS Release 12.0(22)S or later with MPLS TE enabled.
The Tunnel Builder Pro server can run on Solaris, Version 2.8.
The Tunnel Builder Pro client can run on Microsoft Windows 2000 and Microsoft Windows NT.
 |
Note A higher version of the operating system is not necessarily supported. |
The following memory and processor requirements should be met on the system:
The installation of Tunnel Builder Pro server requires that you have at least 90 MB of free disk space. Disk space requirements for the operation of the Tunnel Builder Pro server depend on the network size.
To ensure that the Backup Route Generator (BRG) performs as expected, the target installation workstation(s) must have the directory $JAVA_HOME/bin in the user's path.
Tunnel Builder Pro requires one of the following web browsers and the Java Plug-in specified below:
Windows 2000 and Windows NT clients—If you are using Netscape Version 4.7, you need to install the Java Plug-in Version 1.3.1 before running Tunnel Builder Pro.
To install Cisco MPLS Tunnel Builder Pro, you must enter two authorized license keys. These license keys are specified on your Right to Use document included in your product. The keys authorize the following:
The application prompts you for these two license keys during setup.
If you exceed the limit of the license, you are notified by a message like the following:
Number of TE routers (xxx) in the 1.2.3.4 network exceeds the number allowed by your
Tunnel Builder Pro license (yyy). Please contact your administrator.
Where:
You can choose to upgrade the maximum number of TE-enabled routers supported for any single seed router in Tunnel Builder Pro. You will need a new Right to Use document and a new authorized license key for each level through which you upgrade.
Right to Use documents and authorized license keys are available for the following levels:
To install and start the Tunnel Builder Pro application on Solaris systems, perform the following steps.
|
Note Default values are in brackets. |
Step 1 Copy the tb-*-kit-sol.tar and tb-*-setup-sol.sh files to a directory under your web server doc directory in which you plan to install the application. For example, /scratch/suitespot/docs/TunnelBuilderPro.
Step 2 Make sure that you can execute the tb-*-setup-sol.sh script:
chmod 755 tb-*-setup-sol.sh
Step 3 Log in as root.
$ su root
password: password
Step 4 Run the ./tb-*-setup-sol.sh file.
web-server-doc-dir% ./tb-*-setup-sol.sh
The setup file, tb-*-setup-sol.sh, runs a script that asks you where you want to locate the Tunnel Builder Pro files. Enter the full path of your web server doc directory.
Where (in what directory) would you like the Tunnel Builder Pro client and server to be
installed?
/scratch/suitespot/docs/TunnelBuilderPro
You will have several configuration options.
Please enter the license key (or hit return if evaluation version).
Please enter (eval) for evaluation version of BRG, (perm) for permanent version of BRG, or
(none) for Non-BRG version.
If you entered eval or perm, one of the following requests appears:
Please enter the license key for evaluation version.
Please enter the license key for permanent version.
What port would you like to use for the Tunnel Builder client and server communication?
[7271]
If you entered eval or perm, the following question appears:
What RMI port would you like to use for the BRG Server? [1098]
Would you like to receive SNMP trap notification of links and tunnels changing status?
[no]
If you entered yes, the following two questions appear. If you entered no, they do not appear.
What port would you like to use for receiving UDP datagrams? [162]
|
Note If port 162 conflicts with other network management applications, then enter another port number. UDP port 162 is the standard port for SNMP communication. |
What SNMP community string would you like to use? [public]
Would you like to run the Tunnel Builder Pro server in debug mode? [no]
Would you like to enable logging of Tunnel Builder Pro commands and logging of commands
sent to the router? [no]
Step 5 When the installation script is complete, you are asked if you want to run the server automatically.
To start the server manually, execute a startTopoServer command from your web server doc directory.
web-server-doc-dir% cd /scratch/suitespot/docs/TunnelBuilderPro/serverkit
web-server-doc-dir% ./startTopoServer
Step 6 To start the Tunnel Builder Pro application, use your web browser to find and select the ServerControl.html file. For example:
http:// server-host-name/TunnelBuilderPro/clientkit/ServerControl.html
To access the Tunnel Builder Pro application from your laptop, use your web browser to find and select the ServerControlLaptop.html file. For example:
http:// server-host-name/TunnelBuilderPro/clientkit/ServerControlLaptop.html
|
Note If you have not previously downloaded and installed the Java Plug-in Version 1.3.1, you may be prompted to do so at this point. |
The Tunnel Builder Pro application is displayed in your browser window.
You need to reinstall the Cisco MPLS Tunnel Builder software to do any of the following upgrades:
The Tunnel Builder Pro installation process automatically starts the BRG server if you have the appropriate license. Restarting the BRG server is usually unnecessary, but after an incident such as a machine reboot you need to restart it.
If you need to restart the BRG server, from the serverkit/installed directory, as root, enter the following command:
./bin/install.sh -p ./data/system.properties -Djava.security.policy=data/server.policy
ABCD
Where ABCD is the RMI port chosen at installation time. It must match the RMIPORT specified in the serverkit/TBconfig.txt file.
setenv NPX_PLUGIN_PATH=~java/j2rel_3_1_01/plugin/sparc/ns4
After you install Tunnel Builder Pro, we recommend that you set up Tunnel Builder Pro for your network. See "Using Tunnel Builder Pro for the First Time."
Posted: Fri Oct 11 11:07:57 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.