Upgrade Management Utilities HOWTO

How to install NETBuilder SW on a PC or UNIX workstation

Introduction

3Com provides the NETBuilder software packages for major releases in tar files. This format was chosen because it provides a platform independent and royalty free method of distributing software.

It also provides a consistent way of installing software which allows support for Transcend Upgrade Manager and includes value added features like complete brouter backup, restore and baselining capabilities.

The tar files contain all the files found on the CD-ROM version of the product. The way to use (install on your workstation and subsequently distribute to a NETBuilder) is to use the free Upgrade Management Utilities.

The following steps will guide you through this process.

Download the latest version of the Upgrade Management Utilities designed for your PC or workstation (for example ruu111.zip for PCs). Please refer to the readme file (for example ruu111.txt) for details about installing Upgrade Management Utilities.
Download the tar file (for example NBDPE-DW.tar) from either the 3Com Software Library or 3Com Software Updates Service into a temporary directory on your PC or workstation. For example, download the tar file NBDPE-DW.tar in the c:/temp directory.
Set the path environment variable to include Upgrade Management Utilities:
- Windows:
  <drive>:\usr\3com\common\data\profile
- UNIX C Shell:
  source /usr/3Com/common/data/.login-bcm
- UNIX Bourne Shell:
  PATH=/usr/3Com/common/data/.profile-bcm export PATH
Use the utilities to untar the NETBuilder software and install it in the documented directory structure required by Upgrade Management Utilities and Transcend Upgrade Manager. Step 1 below describes using Upgrade Link, a browser based GUI application and step 2 below describes the process using the command-line version of Upgrade Management Utilities.
1. Installing a NETBuilder SW package using Upgrade Link
  Run Upgrade Link by entering the following on the command line:
  UpgradeLink
  On the Upgrade Link console select Install a NETBuilder SW Package on NMS and click on Next button.
  Enter the full path and file name in the edit box titled Select the source location or file. For example, enter /tmp/NBDPE-DW.tar.
  Click Apply.
2. Installing a NETBuilder SW package using bcminstall on the command line
  Enter the following on the command line:
  bcminstall -tar
  For example:
  bcminstall -tar c:\temp\NBDPE-DW.tar or bcminstall -tar /tmp/NBDPE-DW.tar
This will install the NB software on the NMS in the following directory structure
- Windows: \%tftpboot%\image\<platform>\SW|FW\<version>\<pkg>
  For example: c:\tftpboot\image\DPE\SW\111\DW\
- UNIX: /tftpboot/image/<platform>/SW|FW/<version>/<pkg>
  For example: /tftpboot/image/DPE/SW/111/DW/

You are now ready to distribute the NETBuilder SW package to the NETBuilder. Use Upgrade Link to install the SW package on the NETBuilder. Click upgrade and follow the prompts. Upgrade Link will handle all the details. It will make a backup, upgrade the configuration files, copy the new image and configuration files to the router and reboot.

Refer to the Upgrading NETBuilder Family Software Guide for detailed information regarding the upgrade process.