Sun Microsystems Gigabit Ethernet Compact PCI Adapter 3U User Manual

SunATM™3U CompactPCI Adapter

Sun Microsystems, Inc.
901 San Antonio Road
Palo Alto, CA 94303-4900 U.S.A.
650-960-1300

Installation and User’s Guide

Part No. 806-3005-10
February 2001, Revision A

Send comments about this document to: [e-mail]

Copyright 2000Sun Microsystems, Inc.,901 SanAntonio Road,Palo Alto,CA 94303-4900U.S.A. Allrights reserved.
This product ordocument isdistributed underlicenses restrictingits use,copying, distribution,and decompilation.No partof thisproduct or

document may be reproduced inany formby anymeans withoutprior writtenauthorization ofSun andits licensors,if any. Third-party
software,including fonttechnology,is copyrighted and licensed fromSun suppliers.

Parts of the product maybe derivedfrom BerkeleyBSD systems,licensed fromthe University of California. UNIX is a registered trademarkin
the U.S. and other countries, exclusively licensed through X/OpenCompany,Ltd.

Sun, Sun Microsystems,the Sunlogo, AnswerBook2,docs.sun.com, SunATM, SunVTS, OpenBoot, and Solaris are trademarks,registered
trademarks, or service marks of Sun Microsystems,Inc. inthe U.S.and othercountries. AllSPARCtrademarks areused under license and are
trademarks or registeredtrademarks ofSPARCInternational, Inc. in the U.S. and other countries. Productsbearing SPARCtrademarks are
based upon an architecture developedby SunMicrosystems, Inc.

The OPEN LOOK and Sun™ Graphical User Interface was developed bySun Microsystems,Inc. forits usersand licensees.Sun acknowledges
the pioneering effortsof Xeroxin researchingand developing the concept of visual orgraphical userinterfaces forthe computerindustry.Sun
holds a non-exclusive license fromXerox tothe XeroxGraphical User Interface, which license also covers Sun’s licensees who implement OPEN
LOOK GUIs and otherwise comply with Sun’s written license agreements.

Federal Acquisitions: CommercialSoftware—Government UsersSubject toStandard License TermsandConditions.
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,

INCLUDING ANY IMPLIED WARRANTYOF MERCHANTABILITY,FITNESS FOR A PARTICULARPURPOSE OR NON-INFRINGEMENT,
ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Copyright 2000 Sun Microsystems, Inc.,901 SanAntonio Road,Palo Alto,CA 94303-4900Etats-Unis. Tousdroits réservés.
Ce produit oudocument estdistribué avecdes licencesqui enrestreignent l’utilisation, la copie, la distribution, et la décompilation. Aucune

partie de ce produit oudocument nepeut êtrereproduitesous aucuneforme, parquelque moyenque cesoit, sansl’autorisation préalableet
écrite de Sun et de ses bailleurs de licence, s’il y en a.Le logicieldétenu pardes tiers,et quicomprend latechnologie relativeaux policesde
caractères,est protégépar uncopyright etlicencié pardes fournisseursde Sun.

Des parties de ce produitpourront êtredérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque
déposée aux Etats-Unis et dans d’autres payset licenciéeexclusivement parX/Open Company,Ltd.

Sun, Sun Microsystems,le logoSun, AnswerBook2,docs.sun.com, SunATM,SunVTS, OpenBoot,et Solarissont desmarques de fabrique ou des
marquesdéposées, oumarques deservice, deSun Microsystems,Inc. aux Etats-Unis et dans d’autres pays.Toutesles marquesSPARCsont
utilisées sous licence et sont des marquesde fabriqueou desmarques déposéesde SPARCInternational, Inc.aux Etats-Uniset dansd’autres
pays. Les produitsportant lesmarques SPARCsont baséssur unearchitecture développée par Sun Microsystems,Inc.

L’interfaced’utilisation graphique OPEN LOOK et Sun™ a été développéepar SunMicrosystems, Inc.pour sesutilisateurs etlicenciés. Sun
reconnaîtles effortsde pionniersde Xeroxpour la rechercheet ledéveloppement duconcept desinterfaces d’utilisationvisuelle ougraphique
pour l’industrie de l’informatique. Sun détient une licence non exclusive deXerox surl’interface d’utilisationgraphique Xerox,cette licence
couvrant également les licenciés de Sun qui mettent en place l’interfaced’utilisation graphiqueOPEN LOOKet quien outrese conformentaux
licences écrites de Sun.

LA DOCUMENTATION EST FOURNIE “EN L’ETAT” ET TOUTESAUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES
OU TACITES SONT FORMELLEMENTEXCLUES, DANSLA MESUREAUTORISEE PARLA LOIAPPLICABLE, YCOMPRIS NOTAMMENT
TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L’APTITUDE A UNE UTILISATION PARTICULIERE OU A
L’ABSENCE DE CONTREFAÇON.

Please

Recycle

Regulatory Compliance Statements

Your Sun product is marked to indicate its compliance class:

• Federal Communications Commission (FCC) — USA

• Industry Canada Equipment Standard for Digital Equipment (ICES-003) — Canada

• Voluntary Control Council for Interference (VCCI) — Japan

• Bureau of Standards Metrology and Inspection (BSMI) — Taiwan
Please read the appropriate section that corresponds to the marking on your Sun product before attempting to install the

product.

FCC Class A Notice

This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:

1. This device may not cause harmful interference.

2. This device must accept any interference received, including interference that may cause undesired operation.

Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of

the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment
is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy, and if it is
not installed andused in accordance with theinstruction manual, it may causeharmful interference to radio communications.
Operation of thisequipment in a residentialarea is likely to causeharmful interference, in which casethe user will be required
to correct the interference at his own expense.

Shielded Cables:Connections between theworkstation and peripheralsmust be made usingshielded cables tocomply with

FCC radio frequency emission limits. Networking connections can be made using unshielded twisted-pair (UTP) cables.

Modifications: Any modifications made to this device that are not approved by Sun Microsystems, Inc. may void the

authority granted to the user by the FCC to operate this equipment.

FCC Class B Notice

This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:

1. This device may not cause harmful interference.

2. This device must accept any interference received, including interference that may cause undesired operation.

Note: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of

the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential
installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in
accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee
that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or
television reception,which can be determined byturning the equipment offand on, the user isencouraged to try tocorrect the
interference by one or more of the following measures:

• Reorient or relocate the receiving antenna.

• Increase the separation between the equipment and receiver.

• Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.

• Consult the dealer or an experienced radio/television technician for help.

Shielded Cables: Connections between the workstation and peripherals must be made using shielded cables in order to

maintain compliance with FCC radio frequency emission limits. Networking connections can be made using unshielded
twisted pair (UTP) cables.

Modifications: Any modifications made to this device that are not approved by Sun Microsystems, Inc. may void the

authority granted to the user by the FCC to operate this equipment.

iii

ICES-003 Class A Notice- AvisNMB-003, Classe A

This Class A digital apparatus complies with Canadian ICES-003.
Cet appareil numérique de la classe A est conforme à la norme NMB-003 du Canada.

ICES-003 Class B Notice- AvisNMB-003, Classe B

This Class B digital apparatus complies with Canadian ICES-003.
Cet appareil numérique de la classe B est conforme à la norme NMB-003 du Canada.

iv SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

BSMI Class A Notice

The following statement is applicable to products shipped to Taiwan and marked as Class A on the product compliance
label.

v

vi SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Declaration of Conformity

Compliance Model Number: ATM622F3U
Product Name: SunATM 622 3U Compact PCI Adapter (X1268A)

EMC

European Union

This equipment complies with the following requirements of the EMC Directive 89/336/EEC:
EN55022:1995/CISPR22:1997 Class A

EN550024:1998 EN61000-4-2 4 kV (Direct), 8 kV (Air)

EN61000-4-3 3 V/m
EN61000-4-4 1.0 kV Power Lines, 0.5 kV Signal Lines
EN61000-4-5 1 kV Line-Line, 2 kV Line-Gnd Power Lines
EN61000-4-6 3 V
EN61000-4-8 3 A/m

EN61000-4-11 Pass
EN61000-3-2:1995 Pass
EN61000-3-3:1995 Pass

Safety

This equipment complies with the following requirements of the Low Voltage Directive 73/23/EEC:
EC Type Examination Certificates:

EN60950:1992, 2nd Edition

Supplementary Information

This product was tested and complies with all the requirements for the CE Mark.
/s/ /s/

Dennis P. Symanski DATE
Manager, Compliance Engineering

Sun Microsystems, Inc.
901 San Antonio Road, MPK15-102
Palo Alto, CA 94303-4900, USA

Tel: [phone]
Fax: [phone]

Peter Arkless DATE
Quality Manager

Sun Microsystems Scotland, Limited
Springfield, Linlithgow
West Lothian, EH49 7LR
Scotland, United Kingdom

Tel: [phone]
Fax: [phone]

vii

viii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Contents

1. Product Overview 1

Product Description 1

Software Features 1
SunATM 155 3U Compact PCI Adapter 2

Hardware Features 2

SunATM 622 3U Compact PCI Adapter 3

Hardware Features 3
Hardware and Software Requirements 3
Overview of the Installation Procedure 4

2. Installing the SunATM Software 5

Checking the System for SunATM Software 5

▼ To Check for Previously Installed SunATM Software Packages 5

Installing the SunATM Software 6

▼ To Install the SunATM Software 7
▼ To Check the Package Installation Using pkginfo 8
▼ To Check the Package Installation Using pkgchk 8
▼ To Remove the Software Packages Using pkgrm 8

Configuring the SunATM Interfaces 9

ix

3. Installing and Extracting the Adapter 11

Preparing for the Installation 12

Tools and Equipment Needed 12
Contents of the Ship Kit 12
Determining the Type of Adapter Installation 12
Models of Hot Swap 13

Installing the Adapter 14

▼ To Prepare the System for Hot Installation 14
▼ To Prepare the System for a Cold Installation 15
▼ To Install the Adapter 15

Attaching the Adapter to the System 18

▼ To Attach the Adapter in a Hot Swap Environment 18
▼ To Power On the System After a Cold Installation 19

Extracting the Adapter 19

Determining the Type of Adapter Extraction 19

▼ To Extract the Adapter from a Hot Swap Environment 20
▼ To Extract the Adapter from a Cold Environment 21

4. Configuring the SunATM Interfaces 23

Using the atmadmin Configuration Program 24

Starting the atmadmin Configuration Program 24

atmadmin Main Menu 25
atmadmin Navigation Commands 25

System Parameter Group Menu 26

ATM SNMP Agent Status 26

Interface Configuration Menu 27

atmadmin and the SunATM Configuration Files 27

atmadmin Parameter Groups 28

x SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Physical-Layer Parameter Group 30

Framing Interface 30

Signalling Parameter Group 31

UNI Version 31

ILMI Parameter Group 32
Classical IP Parameter Group 32

Classical IP Interface Type 33

Hostname and IP Address 34

Local ATM Address 34

ATM ARP Server Address 35

Permanent Virtual Circuit (PVC) 36

LAN Emulation Parameter Group 36

Per-Instance LAN Emulation 37

5. Editing SunATM Configuration Files 41

Editing the atmconfig File 42

Changing the Framing Interface in the atmconfig File 43
Example of an atmconfig File 43

Configuring a Classical Internet Protocol Interface 44

Editing the aarconfig File 44
Using Variables in the aarconfig File 47
Sample Classical IP Configurations 50

Configuring a LAN Emulation Interface 53

Editing the laneconfig File 53
Using Variables in the laneconfig File 56
Sample LAN Emulation Configurations 57

Supporting Multiple Emulated LANs

on a Single Interface 58

Contents xi

6. Plumbing and Unplumbing SunATM Interfaces 61

Starting the SunATM Software for the First Time 62
Plumbing and Unplumbing Individual ATM Interfaces 62

7. Classical IP and LAN Emulation Protocols 65

ATM Network Protocols 65
ATM Addresses and Address Registration 66

ATM Address Registration Daemon (ilmid)67

Classical Internet Protocol 67

ATM Address Resolution 67
ATM ARP Address Resolution Tables 68

LAN Emulation 69

LAN Emulation Servers 70

LAN Emulation Configuration Server 70
LAN Emulation Server 70
Broadcast and Unknown Address Server 70

Resolving an IP Address to an ATM Connection 71
LAN Emulation Connections 72

8. SunATM and Solaris Networking Features 73

ATM and SNMP 73

SNMP and Solaris 74

Solaris 2.6, Solaris 7, and Solaris 8 Compatible Software 74

ATM and Logical Interfaces 75

A. Specifications 77

Physical Dimensions 77
Performance Specifications 78
Power Specifications 78
Environmental Specifications 78

xii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

B. Testing the Adapter 81

Using the SunVTS Diagnostic Software 81
Using the OpenBoot PROM FCode

Self-Test 82

▼ To Run the FCode Self-Test Diagnostic 83

C. Application Programmer’s Interface 87

SunATM API Introduction 87
Using the SunATM API with the Q.93B and the ATM Device Drivers 88

Q.93B Driver Interface 89
Establishing a Connection to the Q.93B Driver 89
Setting Up an ATM Connection Over a Switched Virtual Circuit (SVC) 90

Call Setup 93

Release Procedure 94

Exception Conditions 94
Connecting, Sending, and Receiving Data with the ATM Device Driver 96

Raw Mode Connections 97
DLPI Mode Connections 97

D. Troubleshooting and SunATM Error Messages 99

Known Issues About the SunATM 5.0 Release 100

Redundant LANE Servers 100
SunATM and Solstice FireWall-1 100

Troubleshooting While Starting a SunATM Interface 101

▼ To Diagnose Generic Configuration Problems 101
▼ To Diagnose Classical IP Configuration Problems 102
▼ To Diagnose LAN Emulation Configuration Problems 105

Common Problems 108

Error Messages 110

Contents xiii

Error Messages from S00sunatm 110
Error Messages From aarsetup and lanesetup 113
Error Messages From the Kernel Drivers 115

xiv SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Figures

FIGURE 1-1 SunATM 3U Compact PCI Adapter 2
FIGURE 3-1 Opening the Ejection Lever 16
FIGURE 3-2 Closing the Ejection Lever 16
FIGURE 3-3 Tightening the Ejection Lever Captive Screw 17
FIGURE 7-1 ATM Address Fields 66
FIGURE 8-1 Using atmsnmpd as a Forwarding Agent 74
FIGURE C-1 ATM Signalling 88
FIGURE C-2 Message Format 91
FIGURE C-3 Message Flow for Normal Call Setup and Tear-Down 95

xv

xvi SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Tables

TABLE 1-1 Installation Overview 4
TABLE 2-1 SunATM Software Packages 6
TABLE 4-1 Basic Navigation Commands in atmadmin 25
TABLE 4-2 Configurable Parameters in the SunATM Software 28
TABLE 4-3 Predefined SunATM Variables 35
TABLE 5-1 /etc/opt/SUNWconn/atm/atmconfig Field Descriptions 42
TABLE 5-2 /etc/opt/SUNWconn/atm/aarconfig File Flag Descriptions 45
TABLE 5-3 /etc/opt/SUNWconn/atm/aarconfig File Flag Requirements and Options 47
TABLE 5-4 Predefined SunATM Variables 48
TABLE 5-5 /etc/opt/SUNWconn/atm/laneconfig Entry Descriptions 54
TABLE 5-6 /etc/opt/SUNWconn/atm/laneconfig Flag Descriptions 54
TABLE 5-7 laneconfig Flag Requirements and Options 55
TABLE 5-8 Predefined SunATM Variables 56
TABLE 6-1 Parameter Options for atmifconfig 63
TABLE 7-1 LAN Emulation Connections 72
TABLE A-1 Physical Dimensions 77

TABLE A-2 Performance Specifications 78
TABLE A-3 Power Specifications 78
TABLE A-4 Environmental Specifications 78
TABLE B-1 SunVTS Tests 81

xvii

TABLE B-2 SunVTS Documentation 82
TABLE C-1 Messages Between the User and the Q.93B Driver 90
TABLE C-2 Fields in the M_PROTO mblock 91
TABLE C-3 qcc Functions 93
TABLE C-4 atm_util Function Overview 96

xviii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Preface

The SunATM 3U CompactPCI Adapter Installation and User’s Guide provides
instructions for installing and using both the SunATM™ 155 and the SunATM 622
3U Compact PCI adapters. This manual also describes how to install and configure
the SunATM software.

These instructions are designed for network administrators with experience in
installing similar hardware and software.

How This Book Is Organized

This manual contains the following chapters and appendixes:
Chapter 1, “Product Overview,” introduces the SunATM 155 and SunATM 622 3U

Compact PCI adapters.
Chapter 3, “Installing and Extracting the Adapter,” contains instructions on

installing and extracting the SunATM 622 3U Compact PCI adapter using either hot
swap or cold installation procedures.

Chapter 2, “Installing the SunATM Software,” describes how to install SunATM
software from the Solaris Sun Computer Systems Supplement CD.

Chapter 4, “Configuring the SunATM Interfaces,” describes how to configure the
software using the atmadmin configuration program.

Chapter 5, “Editing SunATM Configuration Files,” describes how you can
optionally edit the SunATM configuration files by hand.

Chapter 6, “Plumbing and Unplumbing SunATM Interfaces,” explains how you
can plumb and unplumb the configured SunATM interface using the atmifconfig
command.

xix

Chapter 7, “Classical IP and LAN Emulation Protocols,” describes ATM protocols
and how they are supported by the SunATM software.

Chapter 8 “SunATM and Solaris Networking Features,” describes how to manage
network architecture using the SunATM simple network management protocol
(SNMP) software.

Appendix A, “Specifications,” lists the adapter’s specifications.
Appendix B, “Testing the Adapter,” describes how to test the adapter using either

the SunVTS diagnostic application or the onboard FCode self-test.
Appendix C, “Application Programmer’s Interface,” describes the SunATM

Application Programmer’s Interface (API).
Appendix D, “Troubleshooting and SunATM Error Messages,” describes

troubleshooting procedures for diagnosing problems with the SunATM interfaces.

Using UNIX Commands

This document may not contain information on basic UNIX®commands and
procedures such as shutting down the system, booting the system, and configuring
devices.

See one or more of the following for this information:

■ Solaris on Sun Hardware Platform Guide

■ AnswerBook2™ online documentation for the Solaris™ operating environment

■ Other software documentation that you received with your system

xx SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

Typographic Conventions

TABLEP-1 Typographic Conventions

Typeface Meaning Examples

AaBbCc123 The names of commands, files,

and directories; on-screen
computer output

AaBbCc123

AaBbCc123 Book titles, new words or terms,

What you type, when
contrasted with on-screen
computer output

words to be emphasized

Edit your .login file.
Use ls -a to list all files.

% You have mail.
% su

Password:

Read Chapter 6 in the User’s Guide.
These are called class options.
You must be superuser to do this.

Command-line variable; replace
with a real name or value

To delete a file, type rm filename.

Shell Prompts

TABLEP-2 Shell Prompts

Shell Prompt

C shell machine_name%
C shell superuser machine_name#
Bourne shell and Korn shell $
Bourne shell and Korn shell superuser #

Preface xxi

Related Documentation

TABLEP-3 Related Documentation

Application Title

System administration System Administration Guide, Vol. I
System administration System Administration Guide, Vol. II
System administration System Administration Guide, Vol. III
Software installation Solaris Sun Hardware Platform Guide
Configuration Platform Notes: SunATM Driver Software

Accessing Sun Documentation Online

The docs.sun.comsmweb site enables you to access Sun technical documentation
on the Web. You can browse the docs.sun.com archive or search for a specific book
title or subject at:

http://docs.sun.com

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments
and suggestions. You can email your comments to us at:

[e-mail]

Please include the part number (806-2995-01) of your document in the subject line of
your email.

xxii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

CHAPTER

1

Product Overview

This chapter introduces the SunATM 155 and SunATM 622 3U CompactPCI
adapters. The features, hardware requirements, and software requirements of these
adapters are described in the following sections:

■ “Product Description” on page 1

■ “Hardware and Software Requirements” on page 3

■ “Overview of the Installation Procedure” on page 4

Product Description

The SunATM 3U CompactPCI adapters are designed for operation in hot swap
systems that run under Solaris 8 6/00. An on-board FCode PROM provides the
configuration support that identifies the SunATM 3U compact PCI adapters to the
system.

Software Features

The SunATM software is compatible with relevant emerging standards (including
existing ATM Forum baseline specifications and ITU-TS), and supports:

■ IETF RFC 1577 for Classical IP over ATM

■ IETF RFC 1483 for Protocol Encapsulation over ATM (except for bridge

encapsulation)

■ ATM Forum recommendation for UNI 3.0, 3.1, or 4.0

■ ATM Forum recommendation for LAN Emulation 1.0

1

Hot swap LED

Ejection lever in locked position

FIGURE 1-1 SunATM 3U CompactPCI Adapter

SunATM 155 3U CompactPCI Adapter

The SunATM 155 CompactPCI adapter is a 155 Mbps ATM network interface board
with a multi-mode fiber optical transceiver for LAN access. The SunATM 155
compact PCI adapter provides full duplex transmission of data between a host on a
compact PCI (cPCI) bus and the fiber optics with a data rate of 155 Mbits/sec.

Hardware Features

■ Supports 155-Mbps operation over 62.5/125 µ multimode fiber

■ Integrates PCI and SAR (segmentation and reassembly) functions in an ASIC

implemented in standard CMOS

■ Aligns SAR function with ATM Forum specified and International

Telecommunications Union-Telecommunication Sector (ITU-TS) approved ATM
Adaptation Layer (AAL) 5

■ Supports 32- and 64-bit bus master interface

■ Supports 33 MHz clock speeds

■ Supports the SONET and SDH (Synchronous Optical NETwork/Synchronous

Digital Hierarchy) physical layer framing structure

2 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

SunATM 622 3U CompactPCI Adapter

The SunATM 622 compact PCI adapter is a 622 Mbps ATM network interface board
with a multi-mode fiber optical transceiver for LAN access. The SunATM 622
compact PCI adapter provides full duplex transmission of data between a host on a
compact PCI (cPCI) bus and the fiber optics with a data rate of 622 Mbits/sec.

Hardware Features

■ Supports 622-Mbps operation over 62.5/125 µ multimode fiber cable at 1300 nm

wavelength

■ Integrates PCI and SAR (segmentation and reassembly) functions in an ASIC

implemented in standard CMOS

■ Aligns SAR function with ATM Forum specified and International

Telecommunications Union-Telecommunication Sector (ITU-TS) approved ATM
Adaptation Layer (AAL) 5

■ Supports 32- and 64-bit bus master interface

■ Supports 33 MHz clock speeds

■ Supports the SONET and SDH (Synchronous Optical NETwork/Synchronous

Digital Hierarchy) physical layer framing structure

Hardware and Software Requirements

To connect the Sun adapter to an ATM switch, you need a multimode fiber cable
with an SC connector.

Refer to the manuals supplied with the ATM switch for specific instructions about
the switch’s cable connections and cabling an ATM network.

The software drivers required for operating the adapter are located on the Solaris
Sun Computer Systems Supplement CD-ROM, which is included with the Solaris
software.

Chapter 1 Product Overview 3

Overview of the Installation Procedure

The following table lists the major tasks in the order you must perform them when
you install the SunATM adapter into your system.

These tasks are just the common, high level procedures required to install the
SunATM software and hardware. Because of the complexity of the ATM networking
environment, your specific installation procedure may require tasks not listed below.

TABLE1-1 Installation Overview

Task Chapter Documented

Installing the SunATM software Chapter 2
Installing the adapter into the system Chapter 3
Attaching the cable to an ATM network Chapter 3
Configuring the SunATM software interface:

• Using the interactive atmadmin utility Chapter 4

• Editing the configuration files by hand Chapter 5
Plumbing the SunATM interface Chapter 6

Note – If you experience problems during the installation of the SunATM hardware

or software, see Appendix D for troubleshooting procedures and error message
descriptions.

4 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

CHAPTER

2

Installing the SunATM Software

This chapter describes how to install SunATM software from the Solaris Sun
Computer Systems Supplement CD. You must install the SunATM software before
installing the adapter into your system.

This chapter contains the following sections:

■ “Checking the System for SunATM Software” on page 5

■ “Installing the SunATM Software” on page 6

■ “Configuring the SunATM Interfaces” on page 9

Checking the System for SunATM Software

Before installing the new SunATM software, check to see if it is already installed on
the system.

▼ To Check for Previously Installed SunATM

Software Packages

● Using the pkginfo command, check your system for the SunATM software

packages.

# /usr/bin/pkginfo | grep SUNWatm
system SUNWatm SunATM Device Drivers
application SUNWatma SunATM Interim Api Support Software
application SUNWatmu SunATM Runtime Support Software

5

■ If you see the pkginfo output above, your system already has the SunATM

software installed. If you are certain these are new software packages installed
from the Solaris Sun Computer Systems Supplement CD, you can install the adapter
as described in Chapter 3.

■ If these packages may have been installed from a previous SunATM installation,

remove them as described in “To Remove the Software Packages Using pkgrm”
on page 8.

■ If your system does not have the SunATM software installed, install the software

as described in “Installing the SunATM Software” on page 6.

Note – Refer to the pkginfo(1) man page for more information about the

command.

Installing the SunATM Software

The table below describes the SunATM software packages included on the Sun

Computer Systems Supplement CD-ROM. Refer to the Solaris Sun Hardware Platform
Guide for more information about the contents of this CD-ROM.

TABLE2-1 SunATM Software Packages

Package Description

SUNWatm Contains the device driver software.
SUNWatmu Contains the man pages and the files required to configure an ATM

SNMP management system.

SUNWatma Contains the SunATM interim API libraries and header files.

Note – For basic ATM functionality, the SUNWatm package is the only required

software package.

6 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001

▼ To Install the SunATM Software

● Install the SunATM software as described in the Solaris Sun Hardware Platform

Guide included on the Sun Computer Systems Supplement CD-ROM.

The Solaris Sun Hardware Platform Guide contains the software package installation
instructions specific to the Solaris operating environment supported by the software.

The software from the SunATM packages will be installed in the following
directories:

■ SunATM Device Drivers and Utilities (SUNWatm) go into:

■ /kernel/mod

■ /kernel/mod/sparcv9

■ /kernel/drv

■ /etc/init.d

■ /kernel/drv/sparcv9

■ /etc/opt/SUNWconn/atm

■ /etc/rc2.d

■ /etc/opt/SUNWconn/bin

■ SunATM Runtime Support Software (SUNWatmu) goes into:

■ /opt/SUNWconn/atm

■ /opt/SUNWconn/man.

Note – Man pages contained in the SUNWatmu package will be installed in

/opt/SUNWconn/atm/man and will have symbolic links in /opt/SUNWconn/man.
(To view these man pages, add the /opt/SUNWconn/man directory to your system’s
$MANPATH environment variable.) Interim API examples will go into
/opt/SUNWconn/atm/examples.

■ SunATM Interim API (SUNWatma) goes into:

■ /opt/SUNWconn/atm/include

■ /opt/SUNWconn/atm/lib

■ /opt/SUNWconn/include

■ /opt/SUNWconn/lib.

Note – The SunATM adapters are not currently supported on diskless, dataless, or

autoclient systems. The root and /usr file systems must be local for SunATM to
operate.

Chapter 2 Installing the SunATM Software 7

▼ To Check the Package Installation Using

pkginfo

● After installing the SunATM software, you can check the installation using the

pkginfo command.

The following example shows that pkginfo found the three SunATM software
packages.

# /usr/bin/pkginfo | grep SUNWatm
system SUNWatm SunATM Device Drivers
application SUNWatma SunATM Interim Api Support Software
application SUNWatmu SunATM Runtime Support Software

Refer to the pkginfo(1) man page for more information about the command.

▼ To Check the Package Installation Using pkgchk

● Once the package is installed, you can use the pkgchk command to see if the

installation is complete.

# /usr/sbin/pkgchk SUNWatm

You can specify multiple packages at the command line by separating the package
names with a space. If you do not specify a package identifier, the entire contents of
the machine are checked. Refer to the pkgchk(1M) man page for more information
about the command.

▼ To Remove the Software Packages Using pkgrm

● To remove the SunATM software packages from your system, use the pkgrm

command as superuser.

In this example, the pkgrm command will remove the three SunATM software
packages from the system.

# /usr/sbin/pkgrm SUNWatm SUNWatma SUNWatmu

Refer to the pkgrm(1M) man page for more information about the command.

8 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001