Bay Networks Baystream 7 Quick start guide

Upgrading to BayStream 7.2
Part Number 115400-C Rev. A

ii
Copyright © 1998 Bay Networks, Inc.
All rights reserved. Printed in the USA. February 1998.
The information in this document is subject to change without notice. The statements,
configurations, technical data, and recommendations in this document are believed to be accurate
and reliable, but are presented without express or implied warranty. Users must take full
responsibility for their applications of any products specified in this document. The information
in this document is proprietary to Bay Networks, Inc.
The software described in this document is furnished under a license agreement and may only be
used in accordance with the terms of that license. A summary of the Software License is included
in this document.
Trademarks
BNX and Bay Networks are registered trademarks and BayStream and the Bay Networks logo
are trademarks of Bay Networks, Inc.
Microsoft, MS-DOS, and Windows are registered trademarks of Microsoft Corporation.
All other trademarks and registered trademarks are the property of their respective owners.
Restricted Rights Legend
Use, duplication, or disclosure by the United States Government is subject to restrictions as set
forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at
DFARS 252.227-7013.
Notwithstanding any other license agreement that may pertain to, or accompany the delivery of,
this computer software, the rights of the United States Government regarding its use,
reproduction, and disclosure are as set forth in the Commercial Computer Software-Restricted
Rights clause at FAR 52.227-19.
Statement of Conditions
In the interest of improving internal design, operational function, and/or reliability, Bay
Networks, Inc. reserves the right to make changes to the products described in this document
without notice.

iii
Bay Networks, Inc. does not assume any liability that may occur due to the use or application of
the product(s) or circuit layout(s) described herein.
Portions of the code in this software product may be Copyright © 1988, Regents of the
University of California. All rights reserved. Redistribution and use in source and binary forms
of such portions are permitted, provided that the above copyright notice and this paragraph are
duplicated in all such forms and that any documentation, advertising materials, and other
materials related to such distribution and use acknowledge that such portions of the software
were developed by the University of California, Berkeley. The name of the University may not be
used to endorse or promote products derived from such portions of the software without specific
prior written permission.
SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE.
In addition, the program and information contained herein are licensed only pursuant to a license
agreement that contains restrictions on use and disclosure (that may incorporate by reference
certain limitations and notices imposed by third parties).
Bay Networks, Inc. Software License Agreement
NOTICE: Please carefully read this license agreement before copying or using the
accompanying software or installing the hardware unit with pre-enabled software (each of which
is referred to as “Software” in this Agreement). BY COPYING OR USING THE SOFTWARE,
YOU ACCEPT ALL OF THE TERMS AND CONDITIONS OF THIS LICENSE
AGREEMENT. THE TERMS EXPRESSED IN THIS AGREEMENT ARE THE ONLY
TERMS UNDER WHICH BAY NETWORKS WILL PERMIT YOU TO USE THE
SOFTWARE. If you do not accept these terms and conditions, return the product, unused and in
the original shipping container, within 30 days of purchase to obtain a credit for the full purchase
price.

iv
1. License Grant. Bay Networks, Inc. (“Bay Networks”) grants the end user of the Software
(“Licensee”) a personal, nonexclusive, nontransferable license: a) to use the Software either on a
single computer or, if applicable, on a single authorized device identified by host ID, for which it
was originally acquired; b) to copy the Software solely for backup purposes in support of
authorized use of the Software; and c) to use and copy the associated user manual solely in
support of authorized use of the Software by Licensee. This license applies to the Software only
and does not extend to Bay Networks Agent software or other Bay Networks software products.
Bay Networks Agent software or other Bay Networks software products are licensed for use
under the terms of the applicable Bay Networks, Inc. Software License Agreement that
accompanies such software and upon payment by the end user of the applicable license fees for
such software.
2. Restrictions on use; reservation of rights. The Software and user manuals are protected
under copyright laws. Bay Networks and/or its licensors retain all title and ownership in both the
Software and user manuals, including any revisions made by Bay Networks or its licensors. The
copyright notice must be reproduced and included with any copy of any portion of the Software
or user manuals. Licensee may not modify, translate, decompile, disassemble, use for any
competitive analysis, reverse engineer, distribute, or create derivative works from the Software or
user manuals or any copy, in whole or in part. Except as expressly provided in this Agreement,
Licensee may not copy or transfer the Software or user manuals, in whole or in part. The
Software and user manuals embody Bay Networks’ and its licensors’ confidential and
proprietary intellectual property. Licensee shall not sublicense, assign, or otherwise disclose to
any third party the Software, or any information about the operation, design, performance, or
implementation of the Software and user manuals that is confidential to Bay Networks and its
licensors; however, Licensee may grant permission to its consultants, subcontractors, and agents
to use the Software at Licensee’s facility, provided they have agreed to use the Software only in
accordance with the terms of this license.
3. Limited warranty. Bay Networks warrants each item of Software, as delivered by Bay
Networks and properly installed and operated on Bay Networks hardware or other equipment it
is originally licensed for, to function substantially as described in its accompanying user manual
during its warranty period, which begins on the date Software is first shipped to Licensee. If any
item of Software fails to so function during its warranty period, as the sole remedy Bay Networks
will at its discretion provide a suitable fix, patch, or workaround for the problem that may be

v
included in a future Software release. Bay Networks further warrants to Licensee that the media
on which the Software is provided will be free from defects in materials and workmanship under
normal use for a period of 90 days from the date Software is first shipped to Licensee. Bay
Networks will replace defective media at no charge if it is returned to Bay Networks during the
warranty period along with proof of the date of shipment. This warranty does not apply if the
media has been damaged as a result of accident, misuse, or abuse. The Licensee assumes all
responsibility for selection of the Software to achieve Licensee’s intended results and for the
installation, use, and results obtained from the Software. Bay Networks does not warrant a) that
the functions contained in the software will meet the Licensee’s requirements, b) that the
Software will operate in the hardware or software combinations that the Licensee may select, c)
that the operation of the Software will be uninterrupted or error free, or d) that all defects in the
operation of the Software will be corrected. Bay Networks is not obligated to remedy any
Software defect that cannot be reproduced with the latest Software release. These warranties do
not apply to the Software if it has been (i) altered, except by Bay Networks or in accordance with
its instructions; (ii) used in conjunction with another vendor’s product, resulting in the defect; or
(iii) damaged by improper environment, abuse, misuse, accident, or negligence. THE
FOREGOING WARRANTIES AND LIMITATIONS ARE EXCLUSIVE REMEDIES AND
ARE IN LIEU OF ALL OTHER WARRANTIES EXPRESS OR IMPLIED, INCLUDING
WITHOUT LIMITATION ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR
A PARTICULAR PURPOSE. Licensee is responsible for the security of its own data and
information and for maintaining adequate procedures apart from the Software to reconstruct lost
or altered files, data, or programs.
4. Limitation of liability. IN NO EVENT WILL BAY NETWORKS OR ITS LICENSORS BE
LIABLE FOR ANY COST OF SUBSTITUTE PROCUREMENT; SPECIAL, INDIRECT,
INCIDENTAL, OR CONSEQUENTIAL DAMAGES; OR ANY DAMAGES RESULTING
FROM INACCURATE OR LOST DATA OR LOSS OF USE OR PROFITS ARISING OUT OF
OR IN CONNECTION WITH THE PERFORMANCE OF THE SOFTWARE, EVEN IF BAY
NETWORKS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO
EVENT SHALL THE LIABILITY OF BAY NETWORKS RELATING TO THE SOFTWARE
OR THIS AGREEMENT EXCEED THE PRICE PAID TO BAY NETWORKS FOR THE
SOFTWARE LICENSE.

vi
5. Government Licensees. This provision applies to all Software and documentation acquired
directly or indirectly by or on behalf of the United States Government. The Software and
documentation are commercial products, licensed on the open market at market prices, and were
developed entirely at private expense and without the use of any U.S. Government funds. The
license to the U.S. Government is granted only with restricted rights, and use, duplication, or
disclosure by the U.S. Government is subject to the restrictions set forth in subparagraph (c)(1)
of the Commercial Computer Software––Restricted Rights clause of FAR 52.227-19 and the
limitations set out in this license for civilian agencies, and subparagraph (c)(1)(ii) of the Rights
in Technical Data and Computer Software clause of DFARS 252.227-7013, for agencies of the
Department of Defense or their successors, whichever is applicable.
6. Use of Software in the European Community. This provision applies to all Software
acquired for use within the European Community. If Licensee uses the Software within a country
in the European Community, the Software Directive enacted by the Council of European
Communities Directive dated 14 May, 1991, will apply to the examination of the Software to
facilitate interoperability. Licensee agrees to notify Bay Networks of any such intended
examination of the Software and may procure support and assistance from Bay Networks.
7. Term and termination. This license is effective until terminated; however, all of the
restrictions with respect to Bay Networks’ copyright in the Software and user manuals will cease
being effective at the date of expiration of the Bay Networks copyright; those restrictions relating
to use and disclosure of Bay Networks’ confidential information shall continue in effect.
Licensee may terminate this license at any time. The license will automatically terminate if
Licensee fails to comply with any of the terms and conditions of the license. Upon termination
for any reason, Licensee will immediately destroy or return to Bay Networks the Software, user
manuals, and all copies. Bay Networks is not liable to Licensee for damages in any form solely
by reason of the termination of this license.
8. Export and Re-export. Licensee agrees not to export, directly or indirectly, the Software or
related technical data or information without first obtaining any required export licenses or other
governmental approvals. Without limiting the foregoing, Licensee, on behalf of itself and its
subsidiaries and affiliates, agrees that it will not, without first obtaining all export licenses and
approvals required by the U.S. Government: (i) export, re-export, transfer, or divert any such
Software or technical data, or any direct product thereof, to any country to which such exports or
re-exports are restricted or embargoed under United States export control laws and regulations,

vii
or to any national or resident of such restricted or embargoed countries; or (ii) provide the
Software or related technical data or information to any military end user or for any military end
use, including the design, development, or production of any chemical, nuclear, or biological
weapons.
9. General. If any provision of this Agreement is held to be invalid or unenforceable by a court
of competent jurisdiction, the remainder of the provisions of this Agreement shall remain in full
force and effect. This Agreement will be governed by the laws of the state of California.
Should you have any questions concerning this Agreement, contact Bay Networks, Inc., 4401
Great America Parkway, P.O. Box 58185, Santa Clara, California 95054-8185.
LICENSEE ACKNOWLEDGES THAT LICENSEE HAS READ THIS AGREEMENT,
UNDERSTANDS IT, AND AGREES TO BE BOUND BY ITS TERMS AND CONDITIONS.
LICENSEE FURTHER AGREES THAT THIS AGREEMENT IS THE ENTIRE AND
EXCLUSIVE AGREEMENT BETWEEN BAY NETWORKS AND LICENSEE, WHICH
SUPERSEDES ALL PRIOR ORAL AND WRITTEN AGREEMENTS AND
COMMUNICATIONS BETWEEN THE PARTIES PERTAINING TO THE SUBJECT
MATTER OF THIS AGREEMENT. NO DIFFERENT OR ADDITIONAL TERMS WILL BE
ENFORCEABLE AGAINST BAY NETWORKS UNLESS BAY NETWORKS GIVES ITS
EXPRESS WRITTEN CONSENT, INCLUDING AN EXPRESS WAIVER OF THE TERMS
OF THIS AGREEMENT.

1
Overview of BayStream Version 7.2 Upgrade Procedure
This guide describes how to upgrade to BayStream™ Multiservice
Software Version 7.2 from an earlier release, as follows:
Task What You Do Page
1 Review BayStream Site Manager system requirements. 2
2 Upgrade BayStream Site Manager Software Version 7.2. 5
3 Load BayStream Multiservice Software onto a PC or UNIX
workstation. 16
4 Back up the current BayStream software image file. 20
5 Transfer the image file to the BayStream platform. 21
6 Upgrade the configuration file, which includes booting the
BayStream platform and backing up and converting the
current configuration files.
29
7 Distribute the changes to redundant memory cards. 33

2
Task 1: Reviewing BayStream Site Manager
System Requirements
BayStream Site Manager is a graphical user interface that you use to
configure and manage BayStream platforms. To run BayStream Site
Manager Version 7.2, your PC or UNIX workstation must meet the
hardware and software requirements listed in Table 1.
Refer to BayStream 7.2 Documentation Change Notice for the software
image size for your BayStream platform.
Note: If you are installing BayStream Multiservice
Software for the first time, see Installing BayStream Site
Manager 7.2 for instructions.

3
Table 1. System Requirements
Platform Hardware and Software Requirements
PC • 386 PC (486 PC recommended)
• Microsoft®Windows®95, or Windows 3.1 or later
• MS-DOS®5.0 or later
• 8 megabytes (MB) of RAM (minimum)
• 32 MB of disk space (minimum)
• WinSock-compliant TCP/IP stack, including
products such as NetManage Chameleon, Novell
LAN Workplace, FTP Software PC/TCP for DOS,
Sun PC-NFS, and Microsoft Windows 95
• Network interface card (NIC) with a driver type of
Packet, Network Driver Interface Specification (NDIS),
or Novell Open Data Link Interface (ODI)
• CD-ROM drive
• VGA monitor (SuperVGA monitor recommended)
(continued)

4
Platform Hardware and Software Requirements
SPARCstation • Supported workstation: Sun Microsystems
Sun4SPARCstation
• SunOS 4.1 or later, or Solaris 2.3 or later
• Sun OpenWindows 3.0 or later, or MIT X11 Window
System 4.0 or later
• 16 MB of RAM (minimum)
• 55 MB of disk space (minimum)
• 32 MB of swap space
• Ethernet, token ring, or FDDI network adapter
• CD-ROM drive
IBM workstation • RISC System/6000
• IBM AIX Version 3.2.4 or later
• AIX Motif 1.1.4 or later
• X11 Release 5 or later
• 16 MB of RAM (minimum)
• 50 MB of disk space (minimum)
• 64 MB of swap space (minimum. With the NetView/
6000 application, 96 MB of swap space required.)
• IBM Ethernet high-performance network adapter or an
IBM token ring high-performance network adapter
• CD-ROM drive
Table 1. System Requirements (continued)

5
Task 2:
Upgrading to BayStream Site Manager Version 7.2
This section describes how to upgrade BayStream Site Manager software
Version 7.2 on a PC, SPARCstation, or RS/6000. Instructions for upgrading
on a SPARCstation begin on page 9; for upgrading on an RS/6000, see
page 13.
Upgrading BayStream Site Manager on a PC
Before you upgrade Site Manager on your PC, make sure you review the
system requirements in Table 1 on page 3.
You upgrade Site Manager on a PC in this order:
1. Upgrade the TCP/IP stack, if necessary.
2. Delete existing state files.
3. Load the Site Manager software.
Upgrading the TCP/IP Stack on a PC
If you intend to upgrade the TCP/IP stack on the PC on which you will
use Site Manager, you must do so before installing Site Manager. Refer
to the installation instructions supplied by the manufacturer of the
TCP/IP stack.

6
Deleting Existing State Files
Site Manager creates state files for all Site Manager tools you use. State
files describe the state of the application when you last exited it. You
must delete these files before you install the new version of Site
Manager on your PC or Site Manager may not function properly when
you restart it.
To delete the existing Site Manager state files, type the following
command at the MS-DOS prompt:
del c:\wf\*.sts
Where
c is the name of the hard drive where these files are located.

7
Caution: Installing Site Manager will overwrite any
existing c:\windows\siteman.ini file.
To run multiple versions of Site Manager on the same PC,
make a copy of the current Site Manager initialization
file, siteman.ini, before you install a new version of
Site Manager. Be sure to rename the copy with a new file
name.
After you install another version of Site Manager, edit its
siteman.ini file to include information from the earlier
version.
Note: Do not update the config.sys file or copy the driver
file to the c:\etc directory; you did this when you initially
installed Site Manager.

8
Loading the BayStream Site Manager Software on a PC
To load the Site Manager software onto a PC:
1. Insert the BayStream software CD into the CD-ROM drive.
2. Start Windows.
3. Double-click on the File Manager icon if you are using
Windows 3.1 or later, or choose Start > Programs > Windows
Explorer if you are using Windows 95.
The File Manager or Windows Explorer window opens.
4. Click on the CD-ROM drive icon (for example, Drive D).
5. Click on the ms_win directory.
6. Double-click on the setup.exe utility.
The installation process prompts you for the directory in which you
want to install Site Manager.
7. Type the name of the directory in which you want to install Site
Manager, or accept the default, c:\WF.
The setup.exe utility installs the Site Manager files in the directory.
When the installation completes, the following prompt appears:
Create Windows program group/items automatically?

9
8. Click on Yes to let the setup.exe utility automatically create a
Windows program group or shortcut.
9. At the prompt, click on Yes to start Site Manager.
The following prompt appears:
Do you want to start Site Manager now?
10. Click on Yes to start Site Manager, or click on No to return to
Windows.
When you finish upgrading the Site Manager software on a PC, see
“Task 3: Loading BayStream Multiservice Software onto a PC or
UNIX Workstation” on page 16.
Upgrading BayStream Site Manager on a SPARCstation
Before you upgrade Site Manager on your Sun SPARCstation, make sure
you review the system requirements in Table 1 on page 4.
You upgrade Site Manager on a Sun SPARCstation in this order:
1. Delete existing state files.
2. Load the Site Manager software.

10
Deleting Existing State Files
Site Manager creates state files for all Site Manager tools you use. State
files describe the state of the application when you last exited it. You
must delete these files before you install the new version of Site
Manager on your SPARCstation or Site Manager may not function
properly when you restart it.
To delete the existing Site Manager state files:
1. Get superuser privileges.
Type the following command at the UNIX prompt:
su
2. Exit from the current version of Site Manager if it is open.
3. Delete the existing Site Manager state files.
To delete the Site Manager state files, type the following command
from the home directory of every user account:
rm
<home_directory>/ .wf*

11
Loading the BayStream Site Manager Software on a
SPARCstation
To load the Site Manager software on your SPARCstation:
1. Insert the BayStream software CD into the CD-ROM drive.
2. If you have not created a CD-ROM mountpoint, log in as root
and create a root-level directory. For example, type:
mkdir /cdrom
3. Mount the CD-ROM drive as follows:
On SunOS, type:
mount -r -t hsfs /dev/
<device_number> /cdrom
<device-number> is the device number assigned to the
CD-ROM drive.
Note: If you are using X11R6, you must upgrade to fix
12 of X11R6 for Site Manager to operate correctly with
that product.

12
On Solaris, type:
mount -F hsfs -o ro /dev/dsk/
<device_number> /cdrom
<device_number> is the device number assigned to the
CD-ROM drive.
4. To change to the CD-ROM mountpoint, type:
cd /cdrom
or, if you use Solaris and are running the vold daemon, type:
cd /cdrom/release_720_720
5. To start the script to load the Site Manager software, type:
. / install.sh
The installation process:
• Lists the directories that contain enough space to install
Site Manager. You can then specify the directory you want to
use.
Note: If you use Solaris and you are running the vold
daemon, the CD-ROM will automatically mount as
/cdrom/release_1210_610 rather than /cdrom.