Sun Microsystems 3U manual

Sun Microsystems, Inc. 901 San Antonio Road P alo Alto , CA 94303-4900 U .S.A. 650-960-1300 Send comments about this document to: docfeedback@sun.com SunA TM ™ 3U CompactPCI Adapter Installation and User ’s Guide P ar t No . 806-3005-10 February 2001 , Revision A[...]

Please Recycle Copyright 2000 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303-4900 U.S.A. All rights reserved. This product or document is distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written au[...]

iii Regulatory Compliance Statements Y our Sun product is marked to indicate its compliance class: • Federal Communications Commission (FCC) — USA • Industry Canada Equipment Standard for Digital Equipment (ICES-003) — Canada • V oluntary Contr ol Council for Interference (VCCI) — Japan • Bureau of Standar ds Metrology and Inspection [...]

iv SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • Februar y 2001 ICES-003 Class A Notice - A vis NMB-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 - A vis NMB-003, Classe B This Class B digit[...]

v BSMI Class A Notice The following statement is applicable to products shipped to T aiwan and marked as Class A on the pr oduct compliance label.[...]

vi SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • Februar y 2001[...]

vii Declaration of Conformity EMC European Union This equipment complies with the following r equirements of the EMC Dir ective 89/336/EEC: Safety This equipment complies with the following r equirements of the Low V oltage Directive 73/23/EEC: Supplementary Information This product was tested and complies with all the r equirements for the CE Mark[...]

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

ix Contents 1. Product Overview 1 Product Description 1 Software Featur es 1 SunA TM 155 3U Compact PCI Adapter 2 Hardwar e Features 2 SunA TM 622 3U Compact PCI Adapter 3 Hardwar e Features 3 Hardwar e and Software Requir ements 3 Overview of the Installation Procedur e 4 2. Installing the SunA TM Software 5 Checking the System for SunA TM Softwar[...]

x SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 3. Installing and Extracting the Adapter 1 1 Preparing for the Installation 12 T ools and Equipment Needed 12 Contents of the Ship Kit 12 Determining the T ype of Adapter Installation 12 Models of Hot Swap 13 Installing the Adapter 14 ▼ T o Prepare the System for Hot[...]

Contents xi Physical-Layer Parameter Group 30 Framing Interface 30 Signalling Parameter Group 31 UNI V ersion 31 ILMI Parameter Group 32 Classical IP Parameter Group 32 Classical IP Interface T ype 33 Hostname and IP Address 34 Local A TM Address 34 A TM ARP Server Address 35 Permanent V irtual Cir cuit (PVC) 36 LAN Emulation Parameter Group 36 Per[...]

xii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 6. Plumbing and Unplumbing SunA TM Interfaces 61 Starting the SunA TM Software for the First T ime 62 Plumbing and Unplumbing Individual A TM Interfaces 62 7. Classical IP and LAN Emulation Protocols 65 A TM Network Protocols 65 A TM Addresses and Addr ess Registrati[...]

Contents xiii B. T esting the Adapter 81 Using the SunVTS Diagnostic Software 81 Using the OpenBoot PROM FCode Self-T est 82 ▼ T o Run the FCode Self-T est Diagnostic 83 C. Application Programmer ’ s Interface 87 SunA TM API Introduction 87 Using the SunA TM API with the Q.93B and the A TM Device Drivers 88 Q.93B Driver Interface 89 Establishin[...]

xiv SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Error Messages fr om S00sunatm 110 Error Messages Fr om aarsetup and lanesetup 113 Error Messages Fr om the Kernel Drivers 1 15[...]

xv Figur es 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 Me[...]

xvi SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

xvii T ables T ABLE 1-1 Installation Overview 4 T ABLE 2-1 SunATM Software Packages 6 T ABLE 4-1 Basic Navigation Commands in atmadmin 25 T ABLE 4-2 Configurable Parameters in the SunATM Software 28 T ABLE 4-3 Predefined SunATM Variables 35 T ABLE 5-1 /etc/opt/SUNWconn/atm/atmconfig Field Descriptions 42 T ABLE 5-2 /etc/opt/SUNWconn/atm/aarconfig F[...]

xviii SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • F ebruar y 2001 T ABLE B-2 SunVTS Documentation 82 T ABLE C-1 Messages Between the User and the Q.93B Driver 90 T ABLE C-2 Fields in the M_PROTO mblock 91 T ABLE C-3 qcc Functions 93 T ABLE C-4 atm_util Function Overview 96[...]

xix Pr eface The SunA TM 3U CompactPCI Adapter Installation and User ’ s Guide provides instructions for installing and using both the SunA TM™ 155 and the SunA TM 622 3U Compact PCI adapters. This manual also describes how to install and configure the SunA TM software. These instructions are designed for network administrators with experience [...]

xx SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Chapter 7, “Classical IP and LAN Emulation Protocols,” describes A TM pr otocols and how they are supported by the SunA TM software. Chapter 8 “SunA TM and Solaris Networking Features,” describes how to manage network architectur e using the SunA TM simple net[...]

Preface xxi T ypographic Conventions Shell Pr ompts T ABLE P-1 T ypographic Conventions T ypeface Meaning Examples AaBbCc123 The names of commands, files, and directories; on-scr een computer output Edit your .login file. Use ls -a to list all files. % You have mail . AaBbCc123 What you type, when contrasted with on-screen computer output % su Pass[...]

xxii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Related Documentation Accessing Sun Documentation Online The docs.sun.com sm web site enables you to access Sun technical documentation on the W eb. Y ou can browse the docs.sun.com archive or sear ch for a specific book title or subject at: http://docs.sun.com Sun [...]

1 CHAPTER 1 Pr oduct Overview This chapter introduces the SunA TM 155 and SunA TM 622 3U CompactPCI adapters. The features, hardwar e requir ements, and software requir ements of these adapters are described in the following sections: ■ “Product Description” on page 1 ■ “Hardwar e and Software Requirements” on page 3 ■ “Overview of [...]

2 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 FIGURE 1-1 SunA TM 3U CompactPCI Adapter SunA TM 155 3U CompactPCI Adapter The SunA TM 155 CompactPCI adapter is a 155 Mbps A TM network interface board with a multi-mode fiber optical transceiver for LAN access. The SunA TM 155 compact PCI adapter provides full dupl[...]

Chapter 1 Product Overview 3 SunA TM 622 3U CompactPCI Adapter The SunA TM 622 compact PCI adapter is a 622 Mbps A TM network interface board with a multi-mode fiber optical transceiver for LAN access. The SunA TM 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[...]

4 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Overview of the Installation Pr ocedur e The following table lists the major tasks in the order you must perform them when you install the SunA TM adapter into your system. These tasks are just the common, high level pr ocedures r equired to install the SunA TM softw[...]

5 CHAPTER 2 Installing the SunA TM Software This chapter describes how to install SunA TM software from the Solaris Sun Computer Systems Supplement CD. Y ou must install the SunA TM software before installing the adapter into your system. This chapter contains the following sections: ■ “Checking the System for SunA TM Software” on page 5 ■ [...]

6 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 ■ If you see the pkginfo output above, your system already has the SunA TM software installed. If you are certain these ar e new software packages installed from the Solaris Sun Computer Systems Supplement CD, you can install the adapter as described in Chapter 3. [...]

Chapter 2 Installing the SunA TM Software 7 ▼ T o Install the SunA TM Softwar e ● Install the SunA TM 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 ope[...]

8 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 ▼ T o Check the Package Installation Using pkginfo ● After installing the SunA TM software, you can check the installation using the pkginfo command. The following example shows that pkginfo found the three SunA TM software packages. Refer to the pkginfo (1) man [...]

Chapter 2 Installing the SunA TM Software 9 Conf iguring the SunA TM Interfaces After installing the SunA TM software, you must configure the SunA TM interfaces before you r eboot your system. Y ou can either use the SunA TM conf iguration program, atmadmin , to conf igure the interfaces, or you can edit the SunA TM configuration f iles directly . [...]

10 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

11 CHAPTER 3 Installing and Extracting the Adapter This chapter contains instructions for installing and extracting the SunA TM 3U CompactPCI adapter using either hot swap or cold swap procedur es. This chapter contains the following sections: ■ “Preparing for the Installation” on page 12 ■ “Installing the Adapter” on page 14 ■ “Att[...]

12 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Pr eparing for the Installation Before installing the adapter , prepare for the installation by assembling the appropriate tools, unpacking the ship kit, verifying the system software, and selecting an I/O slot. T ools and Equipment Needed ■ Number 0 Phillips scre[...]

Chapter 3 Installing and Extracting the Adapter 13 ■ In a hot swap installation, you can install the adapter while the system is running, without interrupting the operation of the server . Depending on the level of hot swap your server is running (full or basic), you may be requir ed to enter software commands before and after the installation. ?[...]

14 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 commands during the installation. For example, if you were installing the adapter in a server set to basic hot swap mode, you might use the cfgadm command to identify and attach the adapter during the installation. Installing the Adapter This section contains the pr[...]

Chapter 3 Installing and Extracting the Adapter 15 ▼ T o Pr epare the System for a Cold Installation 1. Before shutting down the operating environment and halting the system, ensure that all signif icant application activity on the server has stopped. 2. Follow the appropriate procedures, as documented in the system’ s service manual, to shut d[...]

16 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 FIGURE 3-1 Opening the Ejection Lever 5. Pull back the ejection lever and slide the card into the cPCI slot. Caution – Do not use excessive force when installing the adapter into the cPCI slot. Y ou may damage the adapter ’s connector . If the adapter does not s[...]

Chapter 3 Installing and Extracting the Adapter 17 8. Check your system documentation for any additional actions that may be required to conf igure the system software for the newly inserted card. For example, in some systems you must type the following command: This turns off the blue LED and initiates the softwar e, which responds by configuring [...]

18 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Attaching the Adapter to the System After installing the adapter , you must make the system recognize the new adapter and its interfaces. The procedure you use for attaching the adapter to the system depends on whether you installed the adapter in a hot swap or cold[...]

Chapter 3 Installing and Extracting the Adapter 19 If you have to reinstall the car d, be sure to follow the instructions outlined in your system’s service manual for the removal and replacement of I/O car ds. Refer to the system documentation for additional troubleshooting instructions. ▼ T o Power On the System After a Cold Installation 1. Be[...]

20 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 ■ In a hot swap extraction, you may be required to enter software commands before and after the extraction to detach the adapter from the system correctly . ■ In a cold extraction, you must shut down the system’s operating system and power down the system befo[...]

Chapter 3 Installing and Extracting the Adapter 21 6. Pull back the ejection lever . 7. Slide the card out of the cPCI slot. ▼ T o Extract the Adapter fr om a Cold Envir onment 1. Before shutting down the operating environment and halting the system, ensure that all signif icant application activity on the server has stopped. 2. Follow the approp[...]

22 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

23 CHAPTER 4 Conf iguring the SunA TM Interfaces After installing the adapter in your system, you must configur e the SunA TM software befor e you can use the new interface. This chapter describes how to configur e the software using the atmadmin configuration program. This pr ogram enables you to configur e the software parameters through an inter[...]

24 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Using the atmadmin Conf iguration Pr ogram The SunA TM configuration program, atmadmin , is an interactive command-line interface. The program contains a hierar chy of menus, which divide the configuration into six main parameter gr oups: system, physical layer , si[...]

Chapter 4 Configur ing the SunA TM Interfaces 25 atmadmin Main Menu After you start the atmadmin configuration program, you see the atmadmin Main Menu. From this menu, you can either go to the system parameter gr oup menu (see “System Parameter Group Menu” on page 26) or enter the SunA TM interface you want to configur e. The following screen e[...]

26 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 System Parameter Gr oup Menu The system parameter group contains parameters that are not specif ic to an interface; they apply to the entire system. The following example shows the system parameter group menu. A TM SNMP Agent Status Y ou can configure your SunA TM s[...]

Chapter 4 Configur ing the SunA TM Interfaces 27 Interface Conf iguration Menu Once you select a SunA TM interface, you will see the atmadmin Interface Configuration menu. Fr om this menu you can proceed to the interface parameter group submenus, which ar e described in “atmadmin Parameter Groups” on page 28. Y ou can use these sub-menus to cha[...]

28 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 atmadmin Parameter Gr oups The atmadmin configuration pr ogram contains a series of menus where you can input or alter the configuration of specific SunA TM software parameters. T ABLE 4-2 summarizes the configurable parameters in each parameter group. Although the [...]

Chapter 4 Configur ing the SunA TM Interfaces 29 Per-instance parameters Hostname/IP address V alid hostname and IP address No default For LAN emulation Local A TM address V alid A TM addr ess $myaddress For LAN emulation LECS indicator No LECS or LECS present LECS Present For LAN emulation LECS A TM address V alid A TM addr ess ILMI value or the w[...]

30 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Physical-Layer Parameter Gr oup The physical-layer parameter group contains only the framing interface parameter . The following example shows the physical-layer parameter menu. Framing Interface The framing interface defines the encapsulation method used for A TM c[...]

Chapter 4 Configur ing the SunA TM Interfaces 31 Signalling Parameter Gr oup The signalling parameter group contains only the UNI version parameter . The following example shows the signalling parameter menu. UNI V ersion The SunA TM software supports three versions of the A TM Forum's User Network Interface (UNI) Specification: versions 3.0, [...]

32 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 ILMI Parameter Gr oup If your A TM switch does not support the Interim Local Management Interface (ILMI), you can turn off the ILMI addr ess registration on your SunA TM interface from the ILMI conf iguration menu. The following example shows the ILMI configuration [...]

Chapter 4 Configur ing the SunA TM Interfaces 33 If you are planning to run NIS over your A TM network, you must specify the list of NIS servers (ypservers) using the ypinit -c command. See the ypinit(1M) man page for details of setting up the ypserver . Be sur e that the IP addresses of the ypservers are listed in the /etc/hosts file. The Routing [...]

34 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Hostname and IP Address Regardless of the Classical IP interface type, you must assign an IP address and hostname to the interface. If you enter a hostname that appears in the /etc/hosts file, or if NIS, NIS+, or DNS is enabled and the hostname is r esolvable over i[...]

Chapter 4 Configur ing the SunA TM Interfaces 35 T o simplify references to A TM addresses in the SunA TM software, several system- defined variables ar e built into the software. V ariables are r eferenced with the $ operator , as in UNIX shell scripts. T ABLE 4-3 summarizes the system-defined SunA TM A TM address variables. Note – The $prefix v[...]

36 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Permanent V irtual Circuit (PVC) The Permanent V irtual Cir cuit parameter applies only to standalone configurations. It identifies the PVC that will be used to communicate between the two systems connected back to back. Both systems must use the same PVC value. The[...]

Chapter 4 Configur ing the SunA TM Interfaces 37 After you configur e LAN Emulation parameters, you are asked to choose an existing (previously conf igured) LAN Emulation ( lane ) instance or to create a new one in the LAN Emulation Instance menu. The following is an example of this menu. Per-Instance LAN Emulation The Per-Instance LAN Emulation Pa[...]

38 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Hostname or IP Address If IP traff ic runs over a LAN Emulation instance, assign a hostname and corresponding IP addr ess to the instance. If you enter a hostname that appears in the /etc/hosts file, or if NIS, NIS+, or DNS is enabled and the hostname is resolvable [...]

Chapter 4 Configur ing the SunA TM Interfaces 39 LECS A TM Address By default, the SunA TM software attempts to obtain the LECS address using ILMI, as specified in the LAN Emulation specification. If this is not successful, the “well- known” A TM address, also specified by the A TM Forum, is used. If your LECS uses a differ ent A TM address (no[...]

40 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 The SunA TM software associates each logical interface with a unique hostname and IP address. All logical interfaces on a given physical interface are associated with the same A TM and MAC addresses. The hostname displayed in the LAN Emulation instance menu correspo[...]

41 CHAPTER 5 Editing SunA TM Configuration Files This chapter describes how to configure SunA TM interfaces by editing the configuration f iles. Y ou are not requir ed to edit these configuration files by hand. Y ou can use the atmadmin configuration pr ogram, described in “Using the atmadmin Configuration Program” on page 24, to configure the [...]

42 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Editing the atmconfig File The /etc/opt/SUNWconn/atm/atmconfig file is a generic f ile that must appear on every SunA TM system. The file provides general conf iguration information used by the SunA TM setup utilities to bring up SunA TM interfaces that ar e plumbed[...]

Chapter 5 Editing SunA TM Configuration Files 43 Changing the Framing Interface in the atmconfig File The framing interface defines the encapsulation method used for A TM cells as they are sent onto the wir e. The default framing interface is SONET , but the SunA TM software also supports the SDH interface. Y our switch product information should i[...]

44 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Conf iguring a Classical Internet Pr otocol Interface Classical Internet Protocol (Classical IP), specified by RFC 1577, is one way of supporting the TCP/IP and UDP/IP protocols in an A TM environment. In Classical IP , an A TM ARP server is used to resolve IP addre[...]

Chapter 5 Editing SunA TM Configuration Files 45 Every node, or client, has both an IP address and either an A TM address or a virtual circuit identif ier (VCI). See “A TM Address Resolution” on page 67, for A TM addressing scheme information. In the IP-A TM address table shown in the /etc/opt/SUNWconn/atm/aarconfig file: ■ Interface is the l[...]

46 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Note – Although SunA TM supports PVC connections to a server for ARP traffic, RFC 1577 does not specify this case. For interoperability with other implementations, connections to the server should use SVCs. Note – For two hosts to communicate over PVCs, correspo[...]

Chapter 5 Editing SunA TM Configuration Files 47 T ABLE 5-3 describes the required, optional, and illegal f ields for each flag type. If a field is unused, it is r epresented by a hyphen. Note – Group entries in the aarconfig file in a designated or der: the local ( l or L ) entry first, followed by any other f lags in any order . Y ou only need [...]

48 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Use the following format to define variables in the aarconfig file: where V ARIABLE is the name of a variable and EXPRESSION is an expression concatenating one or two-digit hexadecimal numbers or the values of variables that have been previously def ined. The equal [...]

Chapter 5 Editing SunA TM Configuration Files 49 In most network configurations, the A TM address assigned to the local interface is $myaddress ; using this variable in the l entry makes it possible to use identical aarconfig files on all Classical IP clients using a given server . The sunmacsel N variables can be used in conjunction with a prefix,[...]

50 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Several rules apply to the use of variables in the aarconfig file: ■ T wo variables cannot follow each other in an expression without an intervening colon. Thus $v1:$v2 is legal while $v1$v2 is not. ■ Fields in each line in the aarconfig file are separated by wh[...]

Chapter 5 Editing SunA TM Configuration Files 51 b. The /etc/opt/SUNWconn/atm/aarconfig f ile on the server: 2. PVC-only: hosta is connected to hostb and hostc over PVCs. There is no ARP server . a. /etc/opt/SUNWconn/atm/aarconfig on hosta : b. on hostb : c. on hostc : 3. SVC with no ARP server: hosta uses SVCs to connect to hostb and hostc . All h[...]

52 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 4. PVC/SVC mix: hosta uses an SVC to connect to hostb , and a PVC to connect to hostc . hostb is not on the local switch; there is no ARP server . 5. ARP server with access restrictions: Hosts ar e connected to an A TM ARP server that resolves addr esses. Access is [...]

Chapter 5 Editing SunA TM Configuration Files 53 Conf iguring a LAN Emulation Interface LAN Emulation, standardized by the A TM Forum’s LAN Emulation 1.0 specification, is another way of pr oviding TCP/IP and UDP/IP support over an A TM interface. Address resolution information is provided by a series of LAN Emulation services. When a LAN Emulati[...]

54 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 These entry fields ar e described in T ABLE 5-5 . T ABLE 5-6 describes the flags used in the /etc/opt/SUNWconn/atm/laneconfig file. T ABLE 5-5 /etc/opt/SUNWconn/atm/laneconfig Entry Descriptions Field Description Interf ace Refers to the LAN Emulation interface, lan[...]

Chapter 5 Editing SunA TM Configuration Files 55 T ABLE 5-7 describes the required, optional, and illegal f ields for each flag type. a Represents an addr ess that may have access to this host. If no a entries appear in the laneconfig file, access to the host is unr estricted. Including a entries allows access to be restricted to known hosts. As an[...]

56 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Note – Designate unused fields in the /etc/opt/SUNWconn/atm/laneconfig f ile with a dash. Using V ariables in the laneconfig File Y ou can use some of the predefined variables fr om /etc/opt/SUNWconn/atm/ aarconfig file in the /etc/opt/SUNWconn/atm/laneconfig f il[...]

Chapter 5 Editing SunA TM Configuration Files 57 Sample LAN Emulation Conf igurations The following examples demonstrate entries in the /etc/opt/SUNWconn/atm/ laneconfig file for several common conf igurations. Although some of the examples show only one sample laneconfig file, similarly configur ed files must appear on each LAN Emulation client. 1[...]

58 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Supporting Multiple Emulated LANs on a Single Interface The SunA TM software allows a single A TM interface to join up to 16 emulated local area networks (ELANs), pr ovided this is allowed by the switch and LAN Emulation (LANE) services. Each ELAN joined will be rep[...]

Chapter 5 Editing SunA TM Configuration Files 59 The corresponding example /etc/opt/SUNWconn/atm/laneconfig file: The resulting ifconfig -a output: Interface MAC Address/ ATM Address VCI Flag ELAN Name lane0 - $myaddress - l lane1 - $myaddress - l lane1 elan1 - - n lane2 - $myaddress - l lane2 elan2 - - n lane3 - $myaddress - l lane3 elan3 - - n # [...]

60 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

61 CHAPTER 6 Plumbing and Unplumbing SunA TM Interfaces This chapter describes how to start the SunA TM software on your system or use the atmifconfig utility to connect and disconnect individual SunA TM interfaces without rebooting the system. Note – Y ou only need to start the SunA TM softwar e on your system if you have just installed the SunA[...]

62 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Starting the SunA TM Softwar e for the First T ime This section will describe how to use the drvconfig command and the S00sunatm run control script to start up the SunA TM software and load the driver module to the system. When you reboot the system, these commands [...]

Chapter 6 Plumbing and Unplumbing SunA TM Interfaces 63 A summary of the parameter options for the atmifconfig utility is provided in T ABLE 6-1 . The following example shows the use of atmifconfig and the output of ifconfig -a before and after the utility is run. T ABLE 6-1 Parameter Options for atmifconfig Utility Interface Name Plumb Instruction[...]

64 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

65 CHAPTER 7 Classical IP and LAN Emulation Pr otocols This chapter describes A TM protocols and how they are supported by the SunA TM software. This chapter is composed of the following sections: ■ “A TM Network Protocols” on page 65 ■ “A TM Addresses and Address Registration” on page 66 ■ “Classical Internet Protocol” on page 67[...]

66 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 The transparency to IP is enabled in dif ferent ways in Classical IP and LAN Emulation. Those differences will be discussed in later sections of this chapter . SunA TM signalling conforms to the user network interface (UNI) specification of the A TM Forum. V ersions[...]

Chapter 7 Classical IP and LAN Emulation Protocols 67 A TM Addr ess Registration Daemon ( ilmid ) Address r egistration with a switch is controlled by ilmid . When an A TM interface is brought up at boot time, ilmid is also started. ilmid then begins an exchange of messages with the switch: relaying local addr ess information (the seven-octet ESI a[...]

68 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 standards for pr oviding redundant A TM ARP servers for a subnet. As specified, the A TM ARP server would constitute a single point of failure in the system. From a practical standpoint, however , early configurations can use an IP-to-A TM address database in every [...]

Chapter 7 Classical IP and LAN Emulation Protocols 69 Although the a entry requir es a complete A TM address, you can reference multiple addresses in a single entry using the pr ovided wildcards. See “Using V ariables in the aarconf ig File” on page 47 for more information about this featur e. The advantage of having an A TM ARP server in the s[...]

70 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 The SunA TM software implements the client side of the LAN Emulation standard. T o use LAN Emulation in an environment, several LAN Emulation services must also exist in the emulated LAN. These services, called the LAN Emulation Configuration Server (LECS), the LAN [...]

Chapter 7 Classical IP and LAN Emulation Protocols 71 as an IP ARP request) is r eceived by the LAN Emulation host from its upper layers, it sends that message to the BUS, which forwards it to all hosts in the emulated LAN. Just as in the case of ethernet, the correct host responds to the sender , and thus the IP address is r esolved to a MAC addre[...]

72 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 LAN Emulation Connections There ar e several connections established at all times when a host is a member of an emulated LAN. The following table outlines the various LAN Emulation-related connections that should be on a LAN Emulation client (LEC). Note – Use the [...]

73 CHAPTER 8 SunA TM and Solaris Networking Featur es This chapter discusses the SunA TM and Solaris Networking features. This chapter includes the following sections: ■ A TM and SNMP on page 73 ■ A TM and Logical Interfaces on page 75 A TM and SNMP T wo of the A TM standards supported by the SunA TM software (the User Network Interface (UNI) a[...]

74 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 FIGURE 8-1 Using atmsnmpd as a Forwar ding Agent Note – If you do not specify a forwarding port for unknown requests, atmsnmpd will respond with a “No Such Name” err or to requests for MIBs that it does not support. If you do specify a forwarding port, atmsnmpd [...]

Chapter 8 SunA TM and Solar is Networking Features 75 The SunA TM software has been designed to take advantage of this framework if it is installed on a system running Solaris 2.6, 7, or 8. The files necessary for the A TM SNMP agent to be recognized by the master agent ( atm.reg and atm.rsrc )a r e copied under /etc/snmp/conf by the S00sunatm star[...]

76 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 The following examples show the atmconfig and laneconfig files and the ifconfig -a output for a system with one physical interface, ba0 . That interface runs both Classical IP and LAN Emulation under UNI 3.1, and has 4 differ ent IP addresses. Conf igure the hostnames[...]

77 APPENDIX A Specif ications This appendix lists the specifications of the SunA TM 3U compact PCI adapter . Physical Dimensions T ABLE A-1 Physical Dimensions Dimension Measurement Length 160 mm W idth 100 mm[...]

78 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Performance Specif ications Power Specif ications Envir onmental Specif ications T ABLE A-2 Performance Specifications Feature Specification cPCI clock 33MHz . Maximum burst transfer rate 34 Mbytes/sec (approximately) Steady state transfer rate 5 Mbytes/sec cPCI bus[...]

Appendix A Specifications 79 Shock 5g, 1/2 sine wave, 1 1 msec 30g, 1/2 sine wave, 1 1 msec V ibration, pk to pk displacement 0.005 in. max. (5 to 32 Hz) 0.1 in. max (5 to 17 Hz) V ibration, peak acceleration 0.25g (5 to 500 Hz) (Sweep rate = 1 octave/min.) 1.0g (5 to 500 Hz) (Sweep rate = 1 octave/min.) T ABLE A-4 Environmental Specif ications Con[...]

80 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

81 APPENDIX B T esting the Adapter This appendix describes how to test the adapter using either the SunVTS diagnostic application or the onboard FCode self-test. This appendix contains the following sections: ■ “Using the SunVTS Diagnostic Software” on page 81 ■ “Using the OpenBoot PROM FCode Self-T est” on page 82 Using the SunVTS Diag[...]

82 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 T o use these diagnostic tests, you must have the SunVTS software installed on your system. Refer to the Solaris on Sun Hardware Platform Guide for SunVTS installation instructions. Refer to the SunVTS documentation (listed in T able) for instructions on how to run [...]

Appendix B T esting the Adapter 83 ▼ T o Run the FCode Self-T est Diagnostic For more information about the OpenBoot commands (including test ) in this section, refer to the OpenBoot Command Reference manual. 1. Before shutting down the operating environment and halting the system, ensure that all signif icant application activity on the server h[...]

84 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 7. Using the test command and the device path found in Step 6, start the adapter ’ s FCode self-test. Refer to the OpenBoot Command Reference Manua l for more information on the test command. If all of the tests pass, you will see these messages: If the adapter fa[...]

Appendix B T esting the Adapter 85 9. Reset and reboot the system. Follow the procedur es in the system’s documentation for the correct procedur es to bring up the system. ok reset-all[...]

86 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

87 APPENDIX C Application Pr ogrammer ’s Interface This appendix describes the SunA TM Application Programmer ’s Interface (API). This appendix is composed of the following sections: ■ “SunA TM API Introduction” on page 87 ■ “Using the SunA TM API with the Q.93B and the A TM Device Drivers” on page 88 ■ “Connecting, Sending, and[...]

88 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Using the SunA TM API with the Q.93B and the A TM Device Drivers The architectur e illustrated in FIGURE C-1 must be established on a SunA TM system in order to perform Q.2931 signalling and send data over established connections. The A TM device driver , SSCOP modu[...]

Appendix C Application Programmer’ s Interf ace 89 Q.93B Driver Interface The signalling API, called Q.2931 Call Control ( qcc ), consists of two sets of similar functions: one for applications running in the kernel and one for applications running in user space. Each set provides functions to build and parse Q.2931 signalling messages, which are[...]

90 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Setting Up an A TM Connection Over a Switched V irtual Circuit (SVC) After connecting to the Q.93B driver , either by directly calling the functions as a user application or by having a setup program connect your application driver as described in the preceding sect[...]

Appendix C Application Programmer’ s Interf ace 91 The Q.93B driver is an M-to-N mux STREAMS driver . Multiple application programs can be plumbed above the driver , and multiple physical interfaces can be connected below Q.93B. Applications can access any or all of the physical interfaces, and messages received on the physical interfaces can be [...]

92 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Q.93B driver . The application should also reserve 16 bytes at the end of the second mblock for the layer 2 (Q.SAAL) protocol performance. The qcc functions can be used to create messages in this format. The following sections give a brief overview of Q.2931 signall[...]

Appendix C Application Programmer’ s Interf ace 93 Call Setup T o make a call, send a SETUP message down to Q.93B and wait for a SETUP_ACK from Q.93B. The SETUP message should include a Br oadband Higher Layer Information (BHLI) information element that contains a four-octet SAP identified as User Specific Information. The SAP is used to identify[...]

94 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 CONNECT , or RELEASE_COMPLETE message from Q.93B (all other messages are ignored by Q.93B). After you r eceive the CONNECT message, you can use the virtual channel. Respond to a SETUP message from Q.93B with a CALL_PROCEEDING, ALER TING, CONNECT , or RELEASE_COMPLET[...]

Appendix C Application Programmer’ s Interf ace 95 FIGURE C-3 Message Flow for Normal Call Setup and T ear-Down SetUp USER Q.93B SWITCH Q.93B USER SetUpAck SetUp Null (0)1 Null(0) Call Initiated (1) Call Present (6) CallProceeding* CallProceeding* Outgoing Call Incoming Call Proceeding (9) Connect Connect Connect Request (8) Active (10) Active (1[...]

96 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Connecting, Sending, and Receiving Data with the A TM Device Driver Connecting to the A TM device driver involves several steps, some of which include several ioctl calls. T o create a more standardized interface for user space applications, a set of atm_util functi[...]

Appendix C Application Programmer’ s Interf ace 97 Note – The following discussion uses user space function names. Refer to T ABLE C-4 for the corresponding kernel space function or ioctl . T o establish a data path, the application must first open the A TM driver and attach to a specific physical interface using atm_open() and atm_attach() . N[...]

98 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 The driver ’s handling of packets depends on both the encapsulation method and the operational mode. For LLC-encapsulated traffic r unning in dlpi mode, the driver automatically adds the LLC header on transmit and strips the LLC header on receive before sending th[...]

99 APPENDIX D T roubleshooting and SunA TM Err or Messages This troubleshooting section will need to be updated for adapters installed in the Ser engeti system. This appendix describes troubleshooting procedur es for diagnosing problems with the SunA TM interfaces. This appendix is composed of the following sections: ■ “T roubleshooting While S[...]

100 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Known Issues About the SunA TM 5.0 Release This section contains important information and news about the SunA TM 5.0 software r elease. Redundant LANE Servers SunA TM adapter software does not support redundant LAN Emulation Services, such as Cisco System’s Simp[...]

Appendix D T roubleshooting and SunA TM Error Messages 101 T r oubleshooting While Starting a SunA TM Interface There ar e many steps involved in making an interface active on an A TM network. Problems in your conf iguration may cause a failure at any number of points along the way . The following sections contain steps you can take to determine wh[...]

102 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 4. V erify that an address has been registered with the switch. The qccstat(1M) command also lists all addresses r egistered to the interface with the switch. See “A TM Addresses and Address Registration” on page 66, for more information about address registrat[...]

Appendix D T roubleshooting and SunA TM Error Messages 103 The information given to ifconfig comes from the /etc/opt/SUNWconn/atm/ atmconfig and /etc/opt/SUNWconn/atm/aarconfig files. Check the entries in those files that apply to this interface and verify their contents. For descriptions of the file formats, see “Editing the atmconf ig File” o[...]

104 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 8. V erify that addresses are resolved and connections are made with the ping(1M) command. Once you have two systems configur ed and running to this point, they should be able to ping each other . T o ping client2 from client1: If the ping is not successful: 1. Che[...]

Appendix D T roubleshooting and SunA TM Error Messages 105 ▼ T o Diagnose LAN Emulation Conf iguration Pr oblems 1. Check all of the generic conf iguration points. These are issues that apply to all SunA TM interfaces, so they must all be working in order for LAN Emulation to work. 2. V erify the output of ifconfig(1M) . Executing the command ifc[...]

106 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 4. V erify that a connection has been made to the LAN Emulation server (LES). A LAN Emulation client must establish and maintain a connection to the LES. In most cases, the LES also establishes and maintains a second connection to the client. Find the LES address i[...]

Appendix D T roubleshooting and SunA TM Error Messages 107 7. V erify that addresses are resolved and connections are made with the ping command. Once you have two systems configur ed and running to this point, they should be able to ping each other . T o ping client2 from client1: If the ping is not successful: 1. Check that the IP hostname or add[...]

108 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Common Pr oblems This section describes some common problems that you may experience during or after the SunA TM adapter installation. Please review this section before calling Sun Service for assistance. Are you trying to use the /usr/sbin/arp command? Since the C[...]

Appendix D T roubleshooting and SunA TM Error Messages 109 Do you want to increase system performance by adjusting TCP/IP parameters? TCP/IP performance over an A TM network can be poor unless you carefully configur e your network. Poor performance usually occurs because the TCP/IP packets are segmented into cells for transmission by the A TM softw[...]

110 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 Err or Messages This section includes a list of some of the most common error messages you might see while configuring and bringing up your SunA TM interface. For each message, there is a brief explanation of the problem and a possible solution. Err or Messages fro[...]

Appendix D T roubleshooting and SunA TM Error Messages 111 warning: can't plumb <lane instance>: too many lane instances on <device> A physical interface will support up to n lane instances, where n is the number of MAC addresses on the boar d (or 1 if the board has no MAC address).Y ou can check the number of MAC addresses on a bo[...]

112 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 warning: duplicate entry <lane device> There wer e multiple entries in /etc/opt/SUNWconn/atm/atmconfig using the same LAN Emulation instance number . This is not a fatal error; the script continues to run. However , only the first entry for each LAN Emulation[...]

Appendix D T roubleshooting and SunA TM Error Messages 113 Err or Messages From aarsetup and lanesetup aarsetup: could not become control process lanesetup: could not become control process An instance of the setup program was running when another instance was started up. The second instance exits with this error message. Make sure that ther e is n[...]

114 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001 aarsetup: waiting for ilmid to provide prefix lanesetup: waiting for ilmid to provide prefix In some cases, the address r egistration process may take several minutes. If so, aarsetup or lanesetup prints out this message saying that it cannot complete until address[...]

Appendix D T roubleshooting and SunA TM Error Messages 115 ifname: frame-size change (please rerun lanesetup) The MTU size was changed by the LAN Emulation Services; rerun lanesetup to notify IP of the change. There is a slight chance that TCP connections will remain open during this change, and if that is the case, performance on those connections[...]

116 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • February 2001[...]

Index 117 Index SYMBOLS ? wildcard, 49, 57 A a configuration f lag, 46, 47, 55, 68, 69 aarconfig file, 67, 68, 69 editing, 44 file flags, 4 5 flag options, 4 7 sample configurations, 5 0 using variables, 4 7 aarsetup program, 44, 67, 68, 69, 1 13 adapter installing, 15 allocating bandwidth, 97 anymac variable, 48, 57 anymacsel variable, 48, 57 [...]

118 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • F ebruar y 2001 editing, 4 2 to 43 example, 43 atmreg program, 67 atmstat command, 102 atmtest, failure, 109 B ba device, 43, 47 broadcast and unknown addr ess server, 70 broadcast messages, 69 C c configuration f lag, 55 caching, 69 Call_ID message, 91 Call_Tag message, 91 CBR,[...]

Index 119 l configuration f lag, 45, 47, 54, 55 LAN Emulation, 53, 65, 69 configuration server, 3 8, 70 configuring interface, 3 6 to 40, 5 3 connections, 72 driver, 6 9, 71 instance number, 4 2 IP address to an A TM connection, 39, 71 multiple Emulated LANs, 3 9 sample configurations, 5 7 server, 3 8, 70 troubleshooting, 105 lane # interface, 3[...]

120 SunA TM 3U CompactPCI Adapter Installation and User’ s Guide • F ebruar y 2001 specifications, ?? to 7 8 SunA TM/P 155 MMF illustrated, 2 sunmacsel N variable, 35, 49 SUNW atm device drivers package, 6 SUNW atma interim API support package, 6 , 7 SUNW atmu man pages, 7 runtime support package, 6, 7 SVC, 87 switched virtual circuits, 87 sys[...]