cc/td/doc/product/atm
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Installing the Cisco ATM SBus Adapter Software

Installing the Cisco ATM SBus Adapter Software

After you have installed the Cisco ATM SBus adapter, you must install the adapter software. In addition, you need to modify the network configuration files and reboot the system. The installation instructions in this section serve as a guide to complete the installation process.

You should be familiar with the UNIX operating system and a UNIX text editor. Also, you should know the system's superuser login password.

Installation Overview

Before installing the Cisco ATM SBus adapter software, make sure that the SPARCstation, SPARCserver, or compatible system meets the following requirements:

To install the Cisco ATM software, perform the following steps:

Refer to the following subsections for detailed explanations of these steps.

Log In with Superuser Access

You need to log in to the UNIX system as superuser. Ask your system administrator if you do not know your superuser login and password.

Install the Software Package

This section explains the steps necessary to install the Cisco ATM SBus adapter software package onto a system running either Solaris or SunOS operating systems. Refer to the appropriate subsection for instructions.

If you are unsure of the version number of the workstation operating system, type the following at the command line:

root@SYS1% uname -rs

The version of the currently running operating system is returned.

Solaris Installation Procedure

The software installation procedure is automated to support installation and deinstallation of the Cisco ATM SBus adapter software files using the UNIX package add utility (pkgadd). The two distribution diskettes contain a complete set of installation files. Make sure at least one workstation on the network has a floppy disk drive. You can install the software from a local system or you can perform the installation over the network. The network installation involves spooling the contents of the diskettes to a directory located on the server for subsequent mounting and installation from all clients.

Local Installation

To install the software directly onto the workstation, make sure the workstation has a floppy disk drive, then perform the following steps:

Step 1 Before invoking the pkgadd command, make sure that the vold daemon is not running on the workstation that has the floppy disk drive. To determine if the vold daemon is running and to obtain its process ID, enter the following command:

Step 2 If the vold daemon is running, log in as the superuser and terminate the process by entering the following command

The "vold" process can be restarted after the pkgadd process is finished.



Note Use the command without command options. For example, the kill -9 command does not work for this procedure.

Step 3 Insert the floppy diskette designated disk 1 into the floppy drive.

Step 4 Issue the package add command, providing the name of the floppy disk drive. The installation files are copied to the system's /etc, /bin, and /kernel directories unless otherwise specified.

Step 5 For each of the floppies, the following message is displayed during the pkgadd command:

Insert the first floppy and type go to begin installation. After installation of a floppy diskette is complete, type e to eject the floppy diskette.


An interactive installation script appears while the adapter software package is being installed, as follows:


Step 6 When the package selection prompt appears, enter the number corresponding to the Catm driver software. The interactive installation script begins, as follows:

Step 7 When the installation confirmation prompt appears, confirm superuser script execution by typing y and pressing the Return key. The script continues, as follows:

Step 8 When the script is finished, edit the system network configuration files and ATM adapter configuration files as discussed in the "Configure the Adapter" section later in this chapter.

Step 9 Issue the system shutdown command as follows:

Step 10 Reboot the system.

Network Installation

The software for the Cisco ATM SBus adapter is contained in a directory called Catm. The Catm directory can be spooled to a specified directory on a network server. This directory is then network file system (NFS) mounted or copied over the network to the client machines where the package is to be installed. The package is then added from the server or from the client workstation. This is useful when the client machine does not have a floppy disk drive.

To install the Cisco ATM SBus adapter software package over the network, perform the following steps:

Step 1 Before invoking the pkgadd command on the server, make sure that the vold daemon is not running. To determine if the vold daemon is running and to obtain its process ID, enter the following command:

Step 2 If the vold daemon is running, log in as superuser and terminate the process by entering the following command

The vold process can be restarted after the pkgadd process is finished.


Step 3 Insert the floppy designated disk 1 into the floppy drive at the server.

Step 4 Spool the package to a server directory. Execute the following command:

Step 5 Insert the first floppy and type go to begin installation. After installation of a floppy diskette is complete, type e to eject the floppy diskette. For each of the floppies, the following message is displayed during the pkgadd command:


Step 6 Locally from each client workstation that contains a Cisco ATM SBus adapter, install the Catm package by entering the following commands:

An interactive installation script appears while the adapter software package is being installed, as follows:


Step 7 When the package selection prompt appears, enter the number corresponding to the Catm driver software. The interactive installation script begins, as follows:

Step 8 When the installation confirmation prompt appears, confirm superuser script execution by typing y and pressing the Return key. The script continues, as follows:

Step 9 Edit the system network configuration files and ATM adapter configuration files as discussed in the "Configure the Adapter" section later in this chapter.

Step 10 When the script is finished, issue the system shutdown command, as follows:

Step 11 Repeat Step 6 through Step 10 for each Cisco ATM SBus adapter client workstation.

SunOS Installation Procedure

The Cisco ATM SBus adapter software is in floppy diskette media. You install the software on the system from the local floppy drive using the SunOS extract_unbundled utility. To properly initiate the utility, perform the following steps:

The following command examples use SYS1 as the hostname.

Step 1 Issue the following command:

Step 2 The utility prompts for a device name. Provide the floppy_name by typing fd0c, as follows:

Step 3 The utility prompts for a floppy disk. Insert the SunOS installation disk labeled "Disk 1" into the floppy disk drive and press Return.

After the floppy is read, the following interactive installation script appears:


Step 4 When the installation confirmation prompt appears, confirm superuser script execution by typing y and pressing the Return key. The superscript begins, as follows:

Step 5 When prompted for a second floppy disk, insert the SunOS installation disk labeled "Disk 2" into the floppy disk drive and press the Return key. The script continues, as follows:

Step 6 When prompted for a third floppy disk, insert the SunOS installation disk labeled "Disk 3" into the floppy disk drive and press the Return key. The script continues, as follows:

Step 7 Edit the system network configuration files and ATM adapter configuration files as discussed in the "Configure the Adapter" section.

Step 8 Reboot the system log using the /usr/etc/reboot command.

Configure the Adapter

After you have installed the Cisco ATM SBus adapter software, you need to modify certain configuration files to configure the adapter. Perform the following steps:

Step 1 Modify the /etc/hosts file. For each virtual LAN interface, add the host name to IP mapping. When the workstation is rebooted, the mapping will take effect for each virtual LAN interface.

Step 2 Modify the etc/netmask database file. Be sure to update the information to reflect the correct netmask value for each VLAN's IP address:

Step 3 The configuration database can be set up and modified in two ways:

Refer to Appendix B for the detailed configuration file syntax. This approach is a common practice for UNIX system administrators and gives the most direct control of configuration parameters.


Step 4 If the switch attached to this adapter supports ILMI registration, proceed to Step 5. If the switch attached to this adapter does not support ILMI registration, you must modify the /etc/catmilmi.db configuration database file. This file is used for configuring the network prefix to register or deregister ATM addresses with the switch.

Modify the file as follows:


If not obtained from the network, the network prefix will be obtained from this static configuration file. The format is as follows:


For manual registration, make sure that the 20-byte ATM addresses entered at the switch (one for each VLAN) consist of the following:


Step 5 Make sure that the PATH environment variable inclues /etc.

Step 6 Reboot the system as follows:

After the system is rebooted and the Cisco ATM SBus adapter drivers are loaded, the following messages are displayed for a system with a Cisco ATM SBus adapter with a fiber interface:


After the system is rebooted and the Cisco ATM drivers are loaded, the following messages are displayed for a system with a Cisco ATM SBus adapter with a copper interface:


If the drivers do not load sucessfully, an error message is displayed instead of these messages.


What to Do Next

Run the ATM SBus Adapter utility from the /bin directory by entering the atmstat command from the UNIX prompt to change the adapter's physical transmission mode, if necessary, and to configure virtual LAN(s). By default, the adapter is set to the U.S. standard SONET physical transmission mode. This utility facilitates setting the adapter to the European standard SDH mode or to SONET mode. Refer to the "Using the ATM SBus Adapter Utility" chapter for details.

Moving the Adapter to a New Slot

When a package is added to the workstation, a reference to the SBus slot where the adapter resides is stored in the etc/path_to_inst file for future use by the operating system. If the adapter is moved to a different SBus slot after the package has already been added, use a text editor, for example vi, to update the etc/path_to_inst file. The following steps apply to a Solaris workstation:

Step 1 Remove all references to the ATM driver:

Step 2 Remove the reference to this slot from the kernel by rebooting the system:

The workstation should now be able to recognize the adapter's new slot.

Setting User Access to the ATM SBus Adapter Utility

The ATM SBus Adapter utility is shipped with open user permissions allowing any user logged into the host to use it. The ATM SBus Adapter utility allows the user to create or delete VLANs, set the IP address for a VLAN, and to set VLAN operating parameters. If the network administrator wants to restrict access to this powerful utility, the access permissions must be changed to the appropriate level for the local network environment

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.