3Com ENTERPRISE OS 11.3 - Manual

A BOUT T HIS G UIDE This guide describes how to upgrade your NETBuilder ® bridge/router to Enterprise OS software version 11.3. This guide also describes how to upgrade your PathBuilder™ S5xx series switch to Enterprise OS software version 11.3. You can also use this guide to upgrade your NETBuilder...

8 A BOUT T HIS G UIDE Year 2000 Compliance For information on Year 2000 compliance and 3Com products, visit the 3Com Year 2000 Web page: http://www.3com.com/products/yr2000.html Table 2 Text Conventions Convention Description Syntax The word “syntax” means you must evaluate the syntax provided and s...

1 O VERVIEW This chapter provides an overview of the upgrade tools, process, and support limitations. Upgrade Tools and Process The upgrade procedures in this guide use the Enterprise OS Upgrade Management Utilities on a UNIX or Windows network management station (NMS). Definition of network managem...

10 C HAPTER 1: O VERVIEW Figure 1 shows the typical upgrade process. Figure 1 Upgrade Process How the Utilities Work The software on your bridge/router or switch consists of a bootable image file and configuration files that store all your settings. The Enterprise OS Upgrade Management Utilities upd...

Rules and Support Limitations 11 Rules and Support Limitations Before planning your upgrade, refer to the following rules and support limitations: ■ The utilities do not support Remote Boot and Configuration Services (RBCS) or network booting. ■ Upgrades from NETBuilder bridge/routers running versio...

2 I NSTALLING THE U TILITIES ON A N ETWORK M ANAGEMENT S TATION Before you start the upgrade process, you must install the Enterprise OS Upgrade Management Utilities on a network management station (NMS). If you are using Transcend Enterprise Manager or Transcend Network Control Services, which has ...

14 C HAPTER 2: I NSTALLING THE U TILITIES ON A N ETWORK M ANAGEMENT S TATION 4 Run the setup program for Windows: ■ To install all packages, including the utilities and package definitions for use with Transcend if required, use: bcmsetup <drive>: all Where <drive> is the drive you want ...

Installing the Utilities on a UNIX System 15 ■ If you download the utilities to your hard disk (see Chapter 8 for information about downloading the utilities): a Decompress the utilities. b Change to the utilities directory on your hard disk using: cd /<path>/ 3 Run the setup program. ■ To ins...

3 P LANNING AND P REPARING THE U PGRADE This chapter describes setting up a file transfer method, choosing automatic or manual recovery, checking the required memory for each package, including instructions for checking the memory, and provides planning tables to copy and fill out for each bridge/ro...

18 C HAPTER 3: P LANNING AND P REPARING THE U PGRADE On a UNIX NMS, follow these steps: 1 Create a user on your system with /tftpboot as the home directory. 2 When using the upgrade utilities via the command line or the Transcend Upgrade Manager, specify this user name and password in the BCMFTPUSER...

19 Manual Recovery An upgrade with manual recovery (using the -m option with the bcmsysupgrade utility) formats the flash memory after backing up the current software, then copies the upgraded files to the bridge/router. If the upgrade is not successful, you must restore the software from the NMS. I...

20 C HAPTER 3: P LANNING AND P REPARING THE U PGRADE Checking DRAM To check how much DRAM you have installed on the switch or bridge/router, on the NMS use: bcmuname -M <device> Where <device> is the IP address or hostname of the switch or bridge/router. Checking Flash Memory To check ho...

Checking the Software Version 21 Checking the Software Version To display the current software version and package you are running, use the bcmuname utility on the NMS: bcmuname -R <device> Where <device> is the IP address or hostname of the bridge/router. To display the current software...

Planning Tables 22 NETBuilder II Planning Table Check each appropriate option to use with the command-line utilities: IP Address or Name Flash Memory Enough Flash Memory for Automatic Recovery? Enough Flash Memory for Manual Recovery? CEC Only: Firmware Version (pre-10.3 upgrade only) Current Softwa...

Planning Tables 23 SuperStack II NETBuilder, SuperStack II NETBuilder SI, and OfficeConnect NETBuilder Planning Table Check each appropriate option to use with the command-line utilities: IP Address or Name Flash Memory Enough Flash Memory for Automatic Recovery? Enough Flash Memory for Manual Recov...

4 U PGRADING U SING THE NETB UILDER U PGRADE L INK A PPLICATION This chapter describes how to upgrade the software on a NETBuilder bridge/router or a PathBuilder switch using the Upgrade Link application. Upgrade Link is an easy to use GUI for the upgrade utilities that runs in a web server. Access ...

26 C HAPTER 4: U PGRADING U SING THE NETB UILDER U PGRADE L INK A PPLICATION Minimal disk storage requirements depend on the number of different software versions that are stored on the disk drive. Calculate: ■ 6 MB for each version of the NETBuilder II bridge/router or PathBuilder switch image ■ 4 ...

Status and Settings Pages 27 where port is the TCP socket on which the client can communicate with the server. On UNIX systems, you can add this command to cron. On Windows 95/98/NT systems, this command can be run as a console application. When NoSecurity is specified, the bcmnbrus command allows c...

28 C HAPTER 4: U PGRADING U SING THE NETB UILDER U PGRADE L INK A PPLICATION Settings Page The Setting Page lets you establish basic settings. ■ You can choose the method of file transfers. TFTP is used by default for NETBuilder bridge/router software release 11.0 and lower while FTP is used by defa...

Verifying for Upgrading 29 Verifying for Upgrading Before upgrading, run the diagnostic utility in Upgrade Link to verify connectivity to the switch or bridge/router by following these steps: 1 Choose a switch or bridge/router from the pop-up list in the Console page, or click New to enter the IP ad...

30 C HAPTER 4: U PGRADING U SING THE NETB UILDER U PGRADE L INK A PPLICATION Values Procedure To install the new software on the NMS, follow these steps: You must be logged in as root for this procedure (UNIX). 1 You can install the software from a CD-ROM, a tar archive, or a boot image (image-only ...

Upgrading Software 31 5 Click Apply . The Install page appears. 6 Enter the path for the software, or click Browse to use a file browse page. ■ For UNIX CD-ROM, use the following path: cdrom/<mount path>/image/ ■ For Windows CD-ROM, use the following path: <CD-ROM drive>:\image\ ■ For Ar...

32 C HAPTER 4: U PGRADING U SING THE NETB UILDER U PGRADE L INK A PPLICATION 4 Select a software package from the pop-up list. The list includes all packages you have installed on the NMS for your platform. If your package is not listed, install the software by clicking New and see “Installing Softw...

Upgrading Software 33 8 Click the check box for each of the stages you want to complete in the current operation. 9 Click New Hardware if you are replacing your bridge/router with a new system. For example, click New Hardware if you are replacing the CEC module with a DPE module. You cannot upgrade ...

36 C HAPTER 5: U PGRADING A B RIDGE /R OUTER U SING THE C OMMAND -L INE U TILITIES Minimal disk storage requirements depend on the number of different software versions that are stored on the disk drive. Calculate: ■ 6 MB for each version of the NETBuilder II bridge/router image ■ 6 MB for each vers...

Prediagnosing System Problems 37 If no flag is used, TFTP is used by default for software release 11.0 and lower, but FTP is used by default for software release 11.1 and higher. If the -ftp flag is specified on a bridge/router running software version 11.0 or lower, the FTP password is overwritten ...

38 C HAPTER 5: U PGRADING A B RIDGE /R OUTER U SING THE C OMMAND -L INE U TILITIES To check which version you have installed, enter: bcmdiagnose -h The version of the installed utilities is displayed in the following message: bcmdiagnose version 11.3. Copyright 3Com Corporation 1999 If the version o...

Using the Bcmsysupgrade Utility to Upgrade 39 Values Use the bcmuname utility to display your current platform, package, and version. Using the Bcmsysupgrade Utility to Upgrade This section describes how to use the bcmsysupgrade utility for the most common software upgrades. The command syntax for t...

40 C HAPTER 5: U PGRADING A B RIDGE /R OUTER U SING THE C OMMAND -L INE U TILITIES For UNIX, after you have upgraded, check the /tftpboot/CLIENTS/<IP address or mac address>/tmp/stages.log file to ensure that the options were used consistently throughout the upgrade process. For Windows, after...

Upgrading Software Only 41 ■ ccsmacro — file that contains predefined user macros. ■ fpupdate.29k (CEC Only) — file that updates the CEC module firmware. You may also have several configuration files that will be upgraded by the utilities. SuperStack II NETBuilder and OfficeConnect NETBuilder Bridge...

44 C HAPTER 5: U PGRADING A B RIDGE /R OUTER U SING THE C OMMAND -L INE U TILITIES The device reboots. 5 Verify that your upgrade completed successfully. To verify that the software is working properly, you can perform a set of operational integrity checks on the newly upgraded device. These may inc...

Upgrading Hardware and Software 45 “bcmsysupgrade” on page 81 for a list of the options available to use with the bcmsysupgrade utility. To upgrade the bridge/router software and hardware, follow these steps: 1 Back up your current software to the NMS using: bcmsysupgrade [options] -s:from_nb -new_h...

Using Upgrade Link 53 On a UNIX NMS, follow these steps: 1 Create a user on your system with /tftpboot as the home directory. 2 When using the upgrade utilities via the command line or the Transcend Upgrade Manager, specify this user name and password in the BCMFTPUSER and BCMFTPPASS environment var...

54 C HAPTER 6: U PGRADING THE S OFTWARE I MAGE O NLY Verifying the Bridge/Router for Upgrading Before upgrading, run the diagnostic utility in Upgrade Link to verify connectivity to the bridge/router by following these steps: 1 Choose a bridge/router or switch from the pop-up list in the Console pag...

Using Upgrade Link 55 3 Select Upgrade and click Apply . The Upgrade page appears. 4 Select a software package from the pop-up list. The list includes all packages you have installed on the NMS for your platform. If your package is not listed, install the software using the procedure in “Installing ...

Using the Command-Line Utilities 57 Using the Command-Line Utilities Use the command-line utilities within a script or execute the commands manually. Otherwise, use Upgrade Link as described on page 53. Installing the NETBuilder Software You can upgrade from a CD-ROM, a tar file, or an image you hav...

Using the Enterprise OS User Interface 59 ■ Connectivity checks based on network topology. Examples of a connectivity verification include: ■ Checking the connectivity between devices on different networks, through designated bridge/routers or switches. ■ Testing typical device connections on termin...

60 C HAPTER 6: U PGRADING THE S OFTWARE I MAGE O NLY 7 Reboot the system by entering: ReBoot If the reboot is unsuccessful, the bridge/router or switch enters the monitor utility. Boot from the old boot file using: BT /<path>/<old name> For example: BT /primary/oldboot

7 B ACKING U P AND R ESTORING S OFTWARE You should always back up your software and configuration files to a network management station (NMS) in case your hardware or software fails. This chapter describes how to back up and restore the software using Upgrade Link or the command-line utilities. Prer...

62 C HAPTER 7: B ACKING U P AND R ESTORING S OFTWARE Setting Up a File Transfer Method You can choose to transfer files using FTP or TFTP. Setting Up for TFTP File Transfers To use TFTP, you need to set up your NMS in preparation for TFTP file transfers. Make sure your TFTP server is running. On a W...

Backing Up the Software 63 On a Windows NMS, follow these steps: 1 Create a user in 3Com’s 3CServer FTP settings. 2 When using the upgrade utilities via command line or the Transcend Upgrade Manager, specify the ftp user name and password in the BCMFTPUSER and BCMFTPPASS environment variables. You c...

Backing Up the Software 65 If bcmdiagnose shows a failure, check the SNMP read/write community string for FTP/TFTP file transfer permissions. Backing Up the Software To back up your software to an NMS, use: bcmbackup [both | primary | secondary] [-name:<backname>]<device>] Values Directo...

66 C HAPTER 7: B ACKING U P AND R ESTORING S OFTWARE Restoring Software from a Backup If your bridge/router fails, you can restore software from a backup on the NMS. If your hardware fails or you lose IP and SNMP configuration, you must first reconfigure IP and SNMP on the bridge/router. If you stil...

Restoring Software from a Backup 67 2 With the Manager parameter, create a new manager with read/write access to the bridge/router. For security reasons, limit the number of network management stations by entering the IP address of the network management station that will have access. For example, e...

68 C HAPTER 7: B ACKING U P AND R ESTORING S OFTWARE Restoring the Software Using Upgrade Link Upgrade Link is an easy to use GUI for the utilities that runs in a web browser. Upgrade Link is an easy to use GUI for the utilities that runs in a web browser. See Chapter 4 for information on running Up...

70 C HAPTER 7: B ACKING U P AND R ESTORING S OFTWARE bcmrestore -new_hw [ -<backname>] <device> If you are not replacing the hardware, use: bcmrestore [ -<backname>] <device> Where <backname> is the name of the backup for the boot blocks.

8 R EFERENCE FOR THE U PGRADE M ANAGEMENT U TILITIES This chapter describes the syntax and options for each utility, as well as how to download the utilities, and where they are installed on your system. Accessing and Downloading the Utilities The Upgrade Management Utilities are provided on CD-ROM ...

72 C HAPTER 8: R EFERENCE FOR THE U PGRADE M ANAGEMENT U TILITIES For instructions on how to decompress and install the utilities, see the ruu110.txt file. The following are the Windows files: Update Log File The bcmsysupgrade utility creates log files in the tftpboot/CLIENTS/<mac_address>/tmp...

Utility Descriptions and Syntax 73 Getting Help Help is available in HTML or (UNIX) man pages. Man Pages On a UNIX system, access the man pages by entering: man bcm-intro To access the man pages for a specific utility, use: man <NMU_name> where <NMU_name> is the name of the upgrade utili...

74 C HAPTER 8: R EFERENCE FOR THE U PGRADE M ANAGEMENT U TILITIES Values Options No available options. Example For example, to backup the primary boot block as MyBackup01 using FTP, enter: bcmbackup primary -ftp -name:MyBackup01 199.199.199.2 bcmconfig Syntax bcmconfig <device>[:<slot>] ...

Utility Descriptions and Syntax 75 Where <boot source> is primary, secondary, test, or dump, the [options] are: bcmctrl Syntax bcmctrl <device>[:<slot>] [-<option>[:<value>]] Description The bcmctrl utility does the following tasks: ■ Reboots a bridge/router. This follo...

76 C HAPTER 8: R EFERENCE FOR THE U PGRADE M ANAGEMENT U TILITIES Values Options The options marked with an asterisk will reboot the bridge/router or individual modules. bcmdf Syntax bcmdf <device>[:<drive:>] Description The bcmdf utility displays the amount of total and available disk s...

78 C HAPTER 8: R EFERENCE FOR THE U PGRADE M ANAGEMENT U TILITIES bcminstall Syntax bcminstall [-h | -cdrom [<path>] | -tar <path> | -r | -diskette | -image <path> | <device>] Description The bcminstall utility installs bridge/router software and firmware onto a network manag...

Utility Descriptions and Syntax 79 bcmloadconfig Syntax bcmloadconfig [-s “<service1> [<service2>...]” | -l <line number>] [-i] -f <config file path>/<filename> <device> [-b] [-t:<reboot timeout>] Description You can execute multiple commands on the Enterpri...

Utility Descriptions and Syntax 81 bcmsetup Syntax For UNIX: bcmsetup <packages> [install_directory] For Windows: bcmsetup <drive:> [all | bcm | nat] Description The bcmsetup utility places the latest version of the Enterprise OS Upgrade Management Utilities on the network managment stat...

82 C HAPTER 8: R EFERENCE FOR THE U PGRADE M ANAGEMENT U TILITIES Stages with an asterisk may reboot the bridge/router. The -s:accept stage only reboots manual and patch upgrades. Options bcmuname Syntax bcmuname [options] <device>[:<slot> | <drive>] -s:accept* Accepts the upgrade ...

Utility Descriptions and Syntax 83 Description The bcmuname utility displays system information about the specified bridge/router or switch or Intelligent I/O module (IIO). If no options are specified, all the device-level options are printed. Values Options If an option is required, it must be spec...

84 C HAPTER 8: R EFERENCE FOR THE U PGRADE M ANAGEMENT U TILITIES When using the bcmupdate option on a Windows95, Windows98, or Windows NT version 4.0 system, the following files are copied but not converted or changed: The filenames are numbers in the es directory, and the text files are located in...

A T ROUBLESHOOTING This appendix describes error codes and messages that may be displayed during the upgrade process as a result of running the bcmdiagnose utility or when network dependencies have not been met. Getting Help For UNIX , to obtain help information about a utility, use: <utility>...

86 A PPENDIX A: T ROUBLESHOOTING The required file(s) <ipaddress>:<drive>:/<config file path> could not be located. Meaning: The bcmtest utility was unable to verify the presence of a file or directory. Action: Make sure that the required files and directories are available to the ...

Hardware-Related Messages 87 Hardware-Related Messages The XX package must have 20 MB of memory installed on the CEC or DPE module. There is only 12 MB available. Meaning: The bcmsysupgrade utility cannot continue because it does not detect a CEC 20 or DPE in the system. The software package require...

88 A PPENDIX A: T ROUBLESHOOTING There is a problem with the installation of the Enterprise OS Upgrade Utilities. The location of the Enterprise OS Upgrade Utilities was not added to the path environment variable or the directory does not contain all the required programs. Meaning: The installation ...

Installation Troubleshooting Messages 89 The bridge/router is not responding to SNMP set requests. Ensure that the SNMP service is configured on the bridge/router and that you have read and write access via SNMP. Also check the values of the community strings in the /etc/snmp.cfg file. They should m...

90 A PPENDIX A: T ROUBLESHOOTING Could not create "test3.com". Check that <tftpboot_dir> and subdirectories have full read/write/create file permissions. Meaning: The UNIX copy command could not create the test file. Action: Assign full read/write/create file access permissions to the ...

Installation Troubleshooting Messages 91 Downloading an Upgrade File $local TestFile could not be removed. Make sure <tftpboot_dir> and "test3.com" have full read/write/create file permissions. Meaning: The UNIX remove command could not delete the test file. Action: Assign full read/wr...

B C HOOSING A S OFTWARE P ACKAGE This chapter lists software packages from 8.0 through 11.2 and provides recommended equivalent packages in 11.3. NETBuilder II Upgrade Migration Path Table 7 outlines the recommended migration path from previous software packages to the latest packages supported in v...

NETBuilder II Upgrade Migration Path 95 From Version 9.0/9.1 To Version 11.3 CP DW (DPE), DE (DPE) or DS (DPE) The DE package has all the features of DW plus 56-bit encryption. The DS package has all the features of DW plus 128-bit encryption. A hardware upgrade to a DPE module is required. FF DW (D...

96 A PPENDIX B: C HOOSING A S OFTWARE P ACKAGE SuperStack II NETBuilder Upgrade Migration Path Table 8 outlines the recommended migration path from prior version software packages to the latest packages supported in version 11.3. Use this table to identify the new software package that is most simil...

SuperStack II NETBuilder Upgrade Migration Path 97 Table 8 SuperStack II NETBuilder Bridge/Router Software Package Migration to 11.3 Model Recommended Upgrade Notes 22x Series From Version 8.0 To Version 11.3 BA, RB, BX, AR, CF or CX n/a There is no equivalent package in version 11.3. From Version 8...

98 A PPENDIX B: C HOOSING A S OFTWARE P ACKAGE SuperStack II NETBuilder SI Upgrade Migration Path Table 9 outlines the recommended migration path from prior version software packages to the latest packages supported in version 11.3. Use this table to identify the new software package that is most si...

OfficeConnect NETBuilder Upgrade Migration Path 99 OfficeConnect NETBuilder Upgrade Migration Path Table 10 outlines the recommended migration path from previous software package versions to the latest packages supported in version 11.3. Use this table to identify the new software package that is mo...

100 A PPENDIX B: C HOOSING A S OFTWARE P ACKAGE FD FD n/a VE VE has 56-bit encryption. From Version 10.1 To Version 11.3 BX BF BF BF AB NW, NE or NS The NE package has all the features of NW plus 56-bit encryption. the NS package has all the features of NW plus 128-bit encryption. OF OF, OE or OS Th...

PathBuilder Upgrade Migration Path 101 PathBuilder Upgrade Migration Path Table 11 outlines the recommended migration path from previous software packages to the latest packages supported in version 11.3. Use this table to identify the new software package that is most similar to the package you are...

C M OUNTING THE CD-ROM ON A UNIX P LATFORM This appendix describes how to mount the CD-ROM for UNIX Solaris 2.5.x, HP-UX 10.x and IBM AIX 4.1.x through 4.2.x operating systems. Mounting the CD-ROM on Solaris 2.5.x If you are mounting the CD-ROM from a drive that is directly connected to the network ...

104 A PPENDIX C: M OUNTING THE CD-ROM ON A UNIX P LATFORM a At the command prompt on the remote system, enter: /usr/bin/su b At the Password prompt, enter your root password. Solaris 2.5.x uses a Volume Management Utility that by default mounts the CD-ROM under the /cdrom directory. 3 Verify that th...

Mounting the CD-ROM on HP-UX 10.x 105 Mounting the CD-ROM on HP-UX 10.x If you are mounting the CD-ROM from a drive that is directly connected to the network management station where you have installed the Enterprise OS Upgrade Management Utilities, enter the commands in this section. If you will mo...

Unmounting the CD-ROM 107 Unmounting the CD-ROM To unmount the CD-ROM, follow these steps: 1 Make sure that no processes (shelltool, commandtool or any other application) have /cdrom as the current working directory. 2 Make sure that you have Superuser (root) access. If you do not have this access, ...

D T ECHNICAL S UPPORT 3Com provides easy access to technical support information through a variety of services. This appendix describes these services. Information contained in this appendix is correct at time of publication. For the most recent information, 3Com recommends that you access the 3Com ...

110 A PPENDIX D: T ECHNICAL S UPPORT You do not need a user name and password with Web browser software such as Netscape Navigator and Internet Explorer. 3Com Bulletin Board Service The 3Com BBS contains patches, software, and drivers for 3Com products. This service is available through analog modem...

Support from 3Com 111 Support from 3Com If you are unable to obtain assistance from the 3Com online technical resources or from your network supplier, 3Com offers technical telephone support services. To find out more about your support options, please the 3Com technical telephone support phone numb...

112 A PPENDIX D: T ECHNICAL S UPPORT Returning Products for Repair Before you send a product directly to 3Com for repair, you must first obtain an authorization number. Products sent to 3Com without authorization numbers will be returned to the sender unopened, at the sender’s expense. To obtain an ...

G LOSSARY automatic recovery An upgrade method that copies the primary boot source to the NMS, then copies the upgraded software back to the bridge/router as the test boot source. After a successful test boot, the upgraded software is designated as the primary boot source while the original software...

G LOSSARY 115 software package A defined subset of bridge/router services and protocols that are appropriate for a particular model of the NETBuilder bridge/router family of products. split image files A boot image that spans multiple diskettes. Split images occur on a few SuperStack II NETBuilder b...

I NDEX Numbers 3Com bulletin board service (3Com BBS) 110 3Com Knowledgebase Web Services 109 3Com URL 109 3ComFacts 110 B Back up verification 63 bcmbackup 72 syntax 73 bcmconfig 72 syntax 74 bcmctrl 72 syntax 75 bcmdf 72 , 76 syntax 76 , 77 bcmdiagnose 37 , 72 return codes 86 syntax 77 bcminstall ...

3Com Corporation L IMITED W ARRANTY H ARDWARE 3Com warrants its hardware products to be free from defects in workmanship and materials, under normal use and service, for the following lengths of time from the date of purchase from 3Com or its authorized reseller: If a product does not operate as war...