background image

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

Send comments about this document to:

[email protected]

SunATM

3U CompactPCI Adapter

Installation and User’s Guide

Part No. 806-3005-10
February 2001

, Revision A

Summary of Contents for SunATM 3U

Page 1: ...01 San Antonio Road Palo Alto CA 94303 4900 U S A 650 960 1300 Send comments about this document to docfeedback sun com SunATM 3U CompactPCI Adapter Installation and User s Guide Part No 806 3005 10 February 2001 Revision A ...

Page 2: ...tems Inc 901 San Antonio Road Palo Alto CA 94303 4900 Etats Unis Tous droits réservés Ce produit ou document est distribué avec des licences qui en restreignent l utilisation la copie la distribution et la décompilation Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme par quelque moyen que ce soit sans l autorisation préalable et écrite de Sun et de ses bailleurs d...

Page 3: ...e 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...

Page 4: ... 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 Avis NMB 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 ...

Page 5: ...v BSMI Class A Notice The following statement is applicable to products shipped to Taiwan and marked as Class A on the product compliance label ...

Page 6: ...vi SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 7: ...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 EC Type Examination Certificates EN60950 1992 2nd Edition s s Dennis P Symanski DATE Manager Compliance Engineering Peter Arkless DAT...

Page 8: ...viii SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 9: ...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 Configurin...

Page 10: ...ter 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 atma...

Page 11: ...e 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 laneco...

Page 12: ...rnet 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...

Page 13: ... 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 Sun...

Page 14: ...xiv SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 Error Messages from S00sunatm 110 Error Messages From aarsetup and lanesetup 113 Error Messages From the Kernel Drivers 115 ...

Page 15: ...URE 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 ...

Page 16: ...xvi SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 17: ...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 Conne...

Page 18: ...llation and User s Guide February 2001 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 ...

Page 19: ...pact 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...

Page 20: ...VTS 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 proced...

Page 21: ... type when contrasted with on screen computer output su Password AaBbCc123 Book titles new words or terms words to be emphasized Command line variable replace with a real name or value Read Chapter 6 in the User s Guide These are called class options You must be superuser to do this To delete a file type rm filename TABLE P 2 Shell Prompts Shell Prompt C shell machine_name C shell superuser machin...

Page 22: ... interested in improving our documentation and welcome your comments and suggestions You can email your comments to us at docfeedback sun com Please include the part number 806 2995 01 of your document in the subject line of your email TABLE P 3 Related Documentation Application Title System administration System Administration Guide Vol I System administration System Administration Guide Vol II S...

Page 23: ...PCI 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 Classic...

Page 24: ...r 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...

Page 25: ...gns 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 ad...

Page 26: ...our specific installation procedure may require tasks not listed below Note If you experience problems during the installation of the SunATM hardware or software see Appendix D for troubleshooting procedures and error message descriptions TABLE 1 1 Installation Overview Task Chapter Documented Installing the SunATM software Chapter 2 Installing the adapter into the system Chapter 3 Attaching the c...

Page 27: ...nstalling 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 ...

Page 28: ...nstall 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 No...

Page 29: ...rv 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 enviro...

Page 30: ...ommand 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 t...

Page 31: ... You can either use the SunATM configuration program atmadmin to configure the interfaces or you can edit the SunATM configuration files directly Note If you are installing the adapter in a hot swap environment do not reboot your system See Chapter 4 for instructions on how to use the atmadmin program and see Chapter 5 for information about how to edit the SunATM configuration files ...

Page 32: ...10 SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 33: ...ing and extracting the SunATM 3U CompactPCI adapter using either hot swap or cold swap procedures This chapter contains the following sections Preparing for the Installation on page 12 Installing the Adapter on page 14 Attaching the Adapter to the System on page 18 Extracting the Adapter on page 19 ...

Page 34: ...llowing items SunATM CompactPCI card Antistatic wrist strap This manual A product note document if needed Caution Electrostatic discharge can damage the integrated circuits on the cards Leave the cards in their antistatic envelopes until you are ready to install them in the system Determining the Type of Adapter Installation The adapter is a hot swappable component that can be installed into a hot...

Page 35: ...ed into or extracted from a powered and operating CompactPCI platform without affecting the other functions of the platform The standard also defines state transitions fro the hardware and software connection processes that allow the card to be connected and configured The adapter supports two models of hot swap Basic hot swap Full hot swap The models can be explained by first defining the followi...

Page 36: ...a hot or cold installation For the exact procedures required for your system refer to the documentation that shipped with your system To Prepare the System for Hot Installation Follow the appropriate procedures as documented in the system s documentation to prepare the system for a hot installation of the adapter Refer to the system s documentation for the complete hot swap instructions 1 Boot the...

Page 37: ... Once the system has been shut down and powered off you can safely install the card To Install the Adapter Note Refer to the system service or administration guide for detailed instructions for following tasks 1 Get the antistatic wrist strap from the ship kit 2 Unwrap the first two folds of the wrist strap and wrap the adhesive side firmly against your wrist 3 Peel the liner from the copper foil ...

Page 38: ...re at both corners of the card push the card until it is firmly seated in the slot In a full hot swap installation when the card is properly seated and the physical connection is complete the blue LED lights up 7 Push the ejection lever over the sprocket toward the card and into the locked position FIGURE 3 2 Closing the Ejection Lever This locks the card into the slot and completes the hardware i...

Page 39: ...d is not properly seated and you must remove it and repeat the installation procedure If the blue LED does go off proceed to Step 9 9 Using a No 0 Phillips screwdriver tighten the captive screws inside the card s ejection lever FIGURE 3 3 Tightening the Ejection Lever Captive Screw 10 Remove the wrist strap from the chassis and your wrist 11 Connect one end of the multimode fiber cable to the fibe...

Page 40: ...configuration instructions To Attach the Adapter in a Hot Swap Environment 1 Follow the hot swap procedures for attaching an I O card to the system in the system s documentation Refer to the system s server or hardware installation manual for the attachment procedure specific to your system 2 On some systems for example you would log into the system console as superuser and identify the board slot...

Page 41: ...D should be off If the hot swap LED remains on lit the adapter was not installed correctly Remove and reinstall the adapter to make sure it is seated correctly in the slot If you have to reinstall the card be sure to follow the instructions outlined in your system s service manual for the removal and replacement of I O cards Refer to the system documentation for additional troubleshooting instruct...

Page 42: ...with your system To Extract the Adapter from a Hot Swap Environment 1 Start cPCI hot swap 2 As superuser identify the cPCI card to be removed You must know the slot number attachment point ID I O assemblies are indicated by sg The attachment points board slots displayed are numbered starting with 0 at the system board side of the cPCI I O assembly 3 Detach unconfigure the cPCI card to be removed w...

Page 43: ...documented in the system s service manual to shut down and halt the system Refer to the system s documentation for the complete power down procedure 3 Press the power switch on the system s status panel to power down the system Refer to the system s documentation for the location of the power switch 4 Verify that the system s power LED is off unlit indicating that the system is completely powered ...

Page 44: ...22 SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 45: ...ng the atmadmin Configuration Program on page 24 Starting the atmadmin Configuration Program on page 24 atmadmin Main Menu on page 25 atmadmin Navigation Commands on page 25 System Parameter Group Menu on page 26 Interface Configuration Menu on page 27 atmadmin Parameter Groups on page 28 Physical Layer Parameter Group on page 30 Signalling Parameter Group on page 31 ILMI Parameter Group on page 3...

Page 46: ...ly See Chapter 5 for a description of the configuration files contents and formats Note See Chapter 5 and Chapter 7 for more information about ATM protocols and the SunATM implementation of these protocols Caution Modifications to individual interfaces will take effect when the interface is plumbed This will happen at boot time or when you use the atmifconfig utility to plumb interfaces If you pla...

Page 47: ...selecting an interface you will see the Interface Configuration menu see Interface Configuration Menu on page 27 atmadmin Navigation Commands TABLE 4 1 lists the basic commands that let you navigate through the menu hierarchy Welcome to the SunATM Admin Program The following interfaces are installed in your system ba0 S Modify System Parameters X Exit Help Enter interface name or option ba0 TABLE ...

Page 48: ...can configure your SunATM system as an ATM SNMP agent The SunATM SNMP daemon atmsnmpd always runs on an ATM host If you do not run your system as an SNMP agent the daemon does not bind to a UDP port Note See ATM and SNMP on page 73 for more information about the atmsnmpd command options Modifying system wide parameters Currently configured as an ATM SNMP agent using UDP port 1000 The SNMP agent op...

Page 49: ...figuration information from the following directories etc opt SUNWconn atm atmconfig etc opt SUNWconn atm aarconfig etc opt SUNWconn atm laneconfig If no configuration information is found or if the files do not exist the default values listed in TABLE 4 2 are applied to the installed interfaces Caution When saving configuration information atmadmin overwrites the existing SunATM configuration fil...

Page 50: ...able Parameters in the SunATM Software Group Parameters Possible Values Default Values Required System SNMP agent status agent or not_agent not_agent Yes SNMP agent UDP port 0 n 65355 1000 For SNMP agent Physical layer Framing interface SONET or SDH SONET Yes Signalling UNI version 3 0 3 1 4 0 or none No default Yes ILMI ILMI status Enabled or Disabled Enabled Yes Classical IP Hostname IP address ...

Page 51: ...ss For LAN emulation lecs_present LES ATM address Valid ATM address No default For LAN emulation no_lecs Emulated LAN name Character string No default For additional instance on a physical interface Additional hostnames Yes or no No For LAN emulation Per additional hostname Minor instance number 0 n 8190 None For LAN emulation additional IP Hostname IP address Valid hostname and IP address No defa...

Page 52: ...d for ATM cells as they are sent onto the wire The default framing interface is SONET but the SunATM software also supports the SDH interface Your switch product information should indicate whether your switch uses either the SONET or the SDH interface If the switch uses the SDH interface you will need to select SDH from the physical layer parameter group menu Modifying ba0 Current framing interfa...

Page 53: ...pports three versions of the ATM Forum s User Network Interface UNI Specification versions 3 0 3 1 and 4 0 You may choose not to enable signalling but in order to support either Classical IP or LAN emulation or both you must select one of the three UNI versions Modifying ba0 Current UNI Version is 3 0 The UNI versions that may be configured are 3 0 3 1 4 0 N No Signalling Enabled P Previous Menu M...

Page 54: ... Classical IP specified by RFC 1577 is one way of supporting the TCP IP and UDP IP protocols in an ATM environment In Classical IP an ATM ARP server is used to resolve IP addresses to ATM addresses replacing the traditional ARP protocol In this configuration each host must register with the ARP server when the ATM interface is brought up For more information on the Classical IP protocols see Class...

Page 55: ...fy one router as the default router to provide connectivity outside of the ATM subnet See the route 1M man page for information on using the route command to add specific router entries and to add a default router You can use the Classical IP parameter group menu to define the Classical IP configuration of a SunATM interface Classical IP Interface Type The SunATM software allows you to configure y...

Page 56: ... byte ATM address associated with a specific Classical IP instance You must assign an ATM address to each Classical IP client and server but you do not need to assign an ATM address on standalone back to back configurations The following section describes ATM address formats and some of the SunATM software defined address variables ATM Address Formats and Variables ATM addresses like Network Servi...

Page 57: ...the Classical IP instance as a client you must also enter the address of the ARP server This parameter like the local ATM address must be a 20 byte ATM address See ATM Address Formats and Variables on page 34 for a discussion of ATM address formats and variables TABLE 4 3 Predefined SunATM Variables Variable Description prefix The 13 byte prefix associated with the local switch mac The 6 byte medi...

Page 58: ...ter with these LAN Emulation services known as joining the LAN This registration process and the address resolution process are described in LAN Emulation on page 69 Unlike Classical IP the LAN Emulation protocol provides a broadcast service to the upper layer protocols Therefore the multicast and RIP limitations described in Classical IP Parameter Group on page 32 do not affect LAN Emulation inte...

Page 59: ... configure the per instance LAN Emulation parameters The following lane instances are configured on ba0 lane0 lane1 C Create new lane instance D Delete lane instance P Previous Menu M Main Menu X Exit Help Enter lane instance or option lane0 Modifying lane0 Current Configuration IP atm_lane ATM myaddress LECS Present LECS_Address well known address no additional IP hostnames I Hostname or IP Addre...

Page 60: ...M Address Formats and Variables on page 34 for more information about ATM address formats and variables Each lane instance must be assigned a unique ATM address Each SunATM adapter has been assigned 16 unique MAC addresses if you use the variable myaddress for each lane instance the SunATM software will automatically distribute those MAC addresses to the lane instances associated with each physica...

Page 61: ...applicable they can be used Emulated LAN Name If multiple Emulated LANs ELANs are present you can enter a character string in the Emulated LAN Name parameter The LAN emulation client uses this parameter to tell the LAN emulation services which ELAN it wants to join By default if a SunATM LAN emulation client does not specify an ELAN name it tells the services to assign it to the default or only EL...

Page 62: ...ame displayed in the LAN Emulation instance menu corresponds to the minor instance 0 The additional IP Address parameter indicates if any additional hostnames are assigned to the instance Select this parameter to modify or create additional hostnames You must enter or modify each additional IP hostname in the same manner as other IP hostname and address pairs see ATM Address Formats and Variables ...

Page 63: ...mmand line interface you can change most of the SunATM parameters Caution When the atmadmin program saves configuration information it overwrites the existing SunATM configuration files in the etc opt SUNWconn atm directory Therefore any comments or other changes you made to the files by hand will be lost This chapter contains the following sections Editing the atmconfig File on page 42 Configurin...

Page 64: ...ividual interfaces will take effect when the interface is plumbed This will happen at boot time or when you use the atmifconfig utility to plumb interfaces If you plan to modify an existing already running interface you must first unplumb it with the atmifconfig utility Refer to the atmifconfig 1m man page or Chapter 6 for more information TABLE 5 1 etc opt SUNWconn atm atmconfig Field Description...

Page 65: ...c opt SUNWconn atm atmconfig overrides a variable set in etc system for a particular interface If there is no value in either etc system or etc opt SUNWconn atm atmconfig the default framing interface is SONET Framing entries in etc opt SUNWconn atm atmconfig should appear on individual lines with two fields The first field indicates the interface maN where N is the instance number for example ba0...

Page 66: ... list of NIS servers ypservers See the ypinit 1M man page for details of setting up the ypserver Be sure that the IP addresses of the ypservers are listed in the etc hosts file The Routing Information Protocol RIP also uses the broadcast feature of IP so it is not supported under the Classical IP environment In the Solaris operating environment RIP is implemented by the daemon in routed If you are...

Page 67: ...onfiguration flags and the options they provide TABLE 5 2 etc opt SUNWconn atm aarconfig File Flag Descriptions Flag Description l Represents the ATM address of the local interface on ARP clients or systems not using an ARP server for ATM address resolution and can be used to assign an ATM address to the host Hostname should not appear ATM Address should be provided if and only if SVCs are used If...

Page 68: ...solution for the hosts included in t entries either by using the IP address in the Hostname field of the t entry or by adding an entry to the local etc hosts file a Represents an address that may have access to this host If no a entries appear in the aarconfig file access to the host is unrestricted Including a entries allows access to be restricted to known hosts As an alternative to listing indi...

Page 69: ...ciated with the variable is denoted by a dollar sign followed immediately by the variable name Note Use variables in the ATM address field only They are not valid in any of the other fields in an entry You can use a colon to concatenate multiple variables to represent a single ATM address expression Thus if one variable v1 is set to 11 22 and another variable v2 is set to 33 44 the sequence v1 v2 ...

Page 70: ... use the prefix variable or any other variables that use it including myaddress and localswitch_server on interfaces that are not using ILMI address registration set VARIABLE EXPRESSION TABLE 5 4 Predefined SunATM Variables Variable Description prefix The 13 byte prefix associated with the local switch mac The 6 byte medium access control MAC address associated with the local host or interface sel...

Page 71: ...rent switches and thus have different local prefix values In the case of a single switch network you can use localswitch_server as a well known server address that includes the prefix associated with the local switch and a MAC address It will restrict server access to clients on the local switch and provide a unique ATM address among all ATM clients connected to that switch Thus any host with a ne...

Page 72: ...variables is a reserved MAC address The hexadecimal values of the reserved addresses are localswitch_server 08 00 20 75 48 08 sunmacselN base 08 00 20 75 48 10 To calculate the ESI portion for a sunmacselN address simply add the value of N converted to a hexadecimal number to the sunmacselN base address For example the ESI portion of sunmacsel20 would be 08 00 20 75 48 10 0x14 08 00 20 75 48 24 Sa...

Page 73: ...t to hostb and hostc All hosts are connected to the same switch there is no ARP server Interface Host ATM Address VCI Flag ba0 localswitch_server L Interface Host ATM Address VCI Flag ba0 l ba0 hostb 100 t ba0 hostc 101 t Interface Host ATM Address VCI Flag ba0 l ba0 hosta 100 t ba0 hostc 102 t Interface Host ATM Address VCI Flag ba0 l ba0 hosta 101 t ba0 hostb 102 t Interface Host ATM Address VCI...

Page 74: ...nnected to a switch that does not support ILMI a etc opt SUNWconn atm aarconfig on server b etc opt SUNWconn atm aarconfig on client Interface Host ATM Address VCI Flag ba0 myaddress l ba0 hostb 45 00 00 00 00 00 00 00 0f 00 00 00 00 08 00 20 d5 08 a8 00 t ba0 hostc 100 t Interface Host ATM Address VCI Flag ba0 myaddress l ba0 prefix sunmacsel0 s Interface Host ATM Address VCI Flag ba0 prefix sunm...

Page 75: ... IP the LAN Emulation protocol provides a broadcast service to the upper layer protocols Therefore the multicast and broadcast limitations described in Configuring a Classical Internet Protocol Interface on page 44 do not affect LAN emulation interfaces Editing the laneconfig File The etc opt SUNWconn atm laneconfig file contains the required configuration information for each interface that uses ...

Page 76: ...ddress entry There must be a l entry for each interface running LAN Emulation The interface and the ATM address must be included the MAC address may be included default is the MAC address assigned to the board t This flag designates a table entry for the local MAC ATM address resolution table If you want to avoid the address resolution process for a frequently accessed system for instance you may ...

Page 77: ... Emulation standard The interface and ATM address or VCI must be included s This flag specifies the LES address or VCI and instructs the system to contact the LES directly and to use default subnet configuration information This flag should be used if your subnet does not have an LECS Without this entry the system first connects to the LECS which provides the LES address and configuration informat...

Page 78: ...er entry types such as in table t entries Note You cannot use the prefix variable or any other variables that use it including myaddress on interfaces that are not using ILMI address registration required illegal xor1 xor s required illegal illegal illegal m 1xor means that you can use either the ATM Address field or the VCI field but not both TABLE 5 8 Predefined SunATM Variables Variable Descrip...

Page 79: ... card representing any 6 byte ESI Should only be used in a entries anymacsel A wild card representing any 7 byte ESI and Selector combination Should only be used in a entries A wild card matching one or two hexadecimal digits within any colon separated field For example prefix anymac is equivalent to both prefix anymac and prefix anymacsel However it is not the same as prefix anymacsel 0 which req...

Page 80: ...ress and MAC address associated with it In addition assign an ELAN name to the instance if any ELAN other than the default is to be joined Provide this information with the exception of the MAC address which is retrieved from the board itself in the etc opt SUNWconn atm atmconfig and etc opt SUNWconn atm laneconfig configuration files Note Only one signalling protocol for example UNI 3 0 or 3 1 an...

Page 81: ...000 lane0 flags 863 UP BROADCAST NOTRAILERS RUNNING MULTICAST mtu 1500 inet 192 29 240 36 netmask ffffff00 broadcast 192 29 240 255 ether 8 0 20 7a 37 af lane1 flags 863 UP BROADCAST NOTRAILERS RUNNING MULTICAST mtu 1500 inet 192 29 241 36 netmask ffffff00 broadcast 192 29 241 255 ether 8 0 20 7a 37 b0 lane2 flags 863 UP BROADCAST NOTRAILERS RUNNING MULTICAST mtu 1500 inet 192 29 242 36 netmask ff...

Page 82: ...60 SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 83: ...u only need to start the SunATM software on your system if you have just installed the SunATM software and one or more SunATM adapters on your system If the software is already operating on your system or if you have rebooted your system you do not need to start the software manually This chapter contains the following sections Starting the SunATM Software for the First Time on page 62 Plumbing an...

Page 84: ... the utility are an interface name and plumbing instructions If an interface is being set up for native ATM applications no TCP IP or for Classical IP the interface name should have the format baN where N is the instance number For LAN Emulation instances the interface should have the format laneN where N is the LAN Emulation instance number The second required parameter is the plumbing instructio...

Page 85: ...TRAILERS RUNNING MULTICAST mtu 9180 inet 129 144 234 12 netmask ffffff00 broadcast 129 144 234 255 ether 8 0 20 84 e5 31 lane0 flags 863 UP BROADCAST NOTRAILERS RUNNING MULTICAST mtu 1500 inet 129 144 161 12 netmask ffffff00 broadcast 129 144 161 255 ether 8 0 20 84 e5 31 atmifconfig ba0 unplumb ifconfig a lo0 flags 849 UP LOOPBACK RUNNING MULTICAST mtu 8232 inet 127 0 0 1 netmask ff000000 lane0 f...

Page 86: ...64 SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 87: ...tecture supports both of these methods This chapter discusses some of the key ideas of these two methods Both methods allow IP to run transparently over the ATM interface Thus IP itself sees the ATM interface just as it sees any traditional network interface Every SunATM interface has a subnet IP address As an ATM interface starts up appropriate modules and drivers are plumbed All the TCP IP and U...

Page 88: ...I field within the ATM address is a unique six octet value this can be the IEEE hardware MAC address conventionally associated with every network interface The Selector field is one octet long The 13 octets that make up the rest of the ATM address are called the Network Prefix and are derived from the ATM switch fabric to which the interface is connected Every ATM switch fabric is configured with ...

Page 89: ... that destination must be established Classical IP does this via a database of IP ATM address pairs that is either provided by an ATM ARP server that is accessible to all hosts on the subnet or is maintained locally in each host ATM Address Resolution Traditional TCP IP and UDP IP applications use IP addresses for communicating to a destination For these applications to run like traditional applic...

Page 90: ...ATM address The server then replies to ATM ARP requests by sending an ATM ARP response If the server does not have the IP to ATM address entry then it replies with NAK All the IP to ATM address entries specified in the etc opt SUNWconn atm aarconfig file are entered into a kernel resident table by the ATM ARP setup program aarsetup Additional entries in the kernel table are added dynamically using...

Page 91: ...t and a client for another This is handled transparently by aarsetup LAN Emulation As described in previous sections Classical IP provides its own IP to ATM address resolution mechanism that corresponds to and replaces ARP thus allowing IP based applications to run transparently over ATM A shortcoming of Classical IP and a primary reason it must replace the traditional ARP is that it does not supp...

Page 92: ...meters for the emulated LAN as well as the address of the LES LAN Emulation Server The second step in joining an emulated LAN is to make a connection to the LAN Emulation Server After receiving the LES address from the LECS a host will establish a connection to the LES The LES may add the host to a point to multipoint call that is maintained by the LES with connections to every host in the emulate...

Page 93: ...uest for the MAC address corresponding to the given IP address which it sends to the LAN Emulation driver 3 The LAN Emulation driver recognizes that this message has a broadcast address and sends it to the BUS which forwards the message to every host on the emulated LAN 4 The message is received on each host and sent up to ARP by the LAN Emulation driver 5 On the target ARP recognizes the IP addre...

Page 94: ...required to remain open after the initial join of the emulated LAN and thus may time out after a host has joined the LAN Control Direct LEC LES Point to point connection over which the host may send LE ARP requests and receive responses from the LES Control Distribute LES LEC Point to multipoint connection over which the LES may send administrative information to all hosts Hosts may not send on th...

Page 95: ...ctively The ATM SNMP daemon atmsnmpd handles requests for information in both MIBs as well as the system MIBs from SNMP based network management systems such as the SunNet Manager program and from ilmid when it is required for SNMP requests coming from the switch atmsnmpd can be used as a forwarding agent If you configure it as a forwarding agent atmsnmpd will forward SNMP requests for unknown MIB...

Page 96: ...in SunATM supports a framework for SNMP agents however this means that its setup depends on the version of the Solaris operating environment in which it is running This section discusses those differences which are mostly transparent to the user Solaris 2 6 Solaris 7 and Solaris 8 Compatible Software The Solaris 2 6 7 and 8 operating environments include a bundled SNMP agent that is designed to ru...

Page 97: ... to the lane instance number and the minor number which distinguishes the logical interfaces on a single physical interface The format of a LAN Emulation logical interface name is laneN X where N is the major number and X is the minor number Each logical interface will be associated with a unique IP hostname and address All logical interfaces on a given physical interface will be associated with t...

Page 98: ... 0 atm0 ba0 0 1 atm1 ba0 0 2 atm2 Interface MAC Address ATM Address VCI Flag ELAN Name lane0 myaddress l ifconfig a lo0 flags 1000849 UP LOOPBACK RUNNING MULTICAST IPv4 mtu 8232 index 1 inet 127 0 0 1 netmask ff000000 ba0 flags 1000843 UP BROADCAST RUNNING MULTICAST IPv4 mtu 9180 index 3 inet 192 29 235 36 netmask ffffff00 broadcast 192 29 235 255 ether 8 0 20 7a 37 af lane0 flags 1000843 UP BROAD...

Page 99: ...7 APPENDIX A Specifications This appendix lists the specifications of the SunATM 3U compact PCI adapter Physical Dimensions TABLE A 1 Physical Dimensions Dimension Measurement Length 160 mm Width 100 mm ...

Page 100: ...es sec cPCI bus modes Master Slave TABLE A 3 Power Specifications Specification Measurement Power dissipation 8 Watt 33 MHz operation mode Voltage tolerance 5 Ripple 100 mV Operational current 1 6 Amps 33 MHz operation mode TABLE A 4 Environmental Specifications Condition Operating Specification Storage Specification Temperature 0 to 70 C 32 to 131 F 25 to 70 C 25 to 131 F Relative humidity 5 to 8...

Page 101: ...c Vibration pk to pk displacement 0 005 in max 5 to 32 Hz 0 1 in max 5 to 17 Hz Vibration peak acceleration 0 25g 5 to 500 Hz Sweep rate 1 octave min 1 0g 5 to 500 Hz Sweep rate 1 octave min TABLE A 4 Environmental Specifications Condition Operating Specification Storage Specification ...

Page 102: ...80 SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 103: ...e user interface It is used to verify the configuration and functionality of most hardware controllers and devices The SunVTS software operates primarily from a user interface that enables you to set test parameters while the program performs diagnostic test operations The following SunVTS tests can be used to test the SunATM adapter Note Do not run nettest and atmtest at the same time TABLE B 1 S...

Page 104: ...Code PROM on the adapter You can only invoke the FCode self test diagnostics using the OpenBoot PROM test or test all commands In order to access the OpenBoot PROM you must shut down and halt your system The adapter s self test does not automatically run after you power on or reset the system but you can use the self test any time you want to determine the status of the hardware If you encounter a...

Page 105: ...fter shutting down the system you should now see the OpenBoot PROM ok prompt on the system console 3 At the ok prompt set the auto boot configuration variable to false 4 Set the diag switch parameter to true in order to see the diagnostic power on self test POST messages 5 Reset the system to activate these parameter changes 6 Use the show devs command to display the list of devices Among the list...

Page 106: ... that the adapter hardware is installed correctly If necessary replace the adapter or contact your service provider for support 8 After testing the adapter type the following commands to return the OpenBoot PROM to the standard operating mode ok test device path ok test pci if 0 pci 1 pci 1 pci a SUNW ma 0 Register Test succeeded Memory Test succeeded SAHI Internal Loopback Test succeeded SUNI Int...

Page 107: ...Appendix B Testing the Adapter 85 9 Reset and reboot the system Follow the procedures in the system s documentation for the correct procedures to bring up the system ok reset all ...

Page 108: ...86 SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 109: ...is sent between hosts over Virtual Circuits VCs VCs are point to point or point to multipoint connections between two or more ATM hosts VCs can be created in one of two ways Manual configuration at each host and each intermediate network point also known as Permanent Virtual Circuits PVC ATM signalling also known as Switched Virtual Circuits SVC After the VC has been created the application notifi...

Page 110: ...is to create the connections between their application and the Q 93B and ATM device drivers Both the Q 93B and ATM device driver are STREAMS drivers connecting to them is for the most part no different than connecting to other STREAMS drivers The following sections describe the steps required to connect to each driver use the drivers to establish ATM connections and send data over those connection...

Page 111: ...ppropriate connections to the Q 93B driver q_ioc_bind associates a service access point SAP with the specified connection to the Q 93B driver The driver uses the SAP to direct incoming messages to applications Establishing a Connection to the Q 93B Driver Use the open 2 system call to obtain a file descriptor to the driver After opening the driver q_ioc_bind should be called associating in the Q 9...

Page 112: ...lish switched virtual circuits SVCs using the Q 2931 signalling protocol The Q 2931 message set is displayed in TABLE C 1 TABLE C 1 Messages Between the User and the Q 93B Driver Message Type Direction SETUP BOTH SETUP_ACK UP CALL_PROCEEDING BOTH ALERTING BOTH CONNECT BOTH CONNECT_ACK UP RELEASE DOWN RELEASE_COMPLETE BOTH STATUS_ENQUIRY DOWN STATUS UP NOTIFY BOTH RESTART BOTH RESTART_ACK BOTH ADD_...

Page 113: ...s defined as the qcc_hdr_t structure in the atm qcctypes h header file In the second mblock the Q 2931 header portion 9 bytes of the Q 2931 message is blank and is later filled in by the TABLE C 2 Fields in the M_PROTO mblock Message Explanation Ifname Null terminated string containing the device name Call_ID Unique number from Q 93B for each interface Type Same as the Q 2931 message type except t...

Page 114: ...on the procedures refer to the ATM Forum s User Network Interface Specification version 3 0 3 1 or 4 0 For further information on the qcc functions which are outlined in TABLE C 3 see the appropriate man pages in Section 3 for user applications or Section 9F for kernel applications You can find the man pages under the function group name or any specific function name For example the man page that ...

Page 115: ...GURE C 2 Parameter values qcc_len_ Returns the maximum length of the buffer that should be allocated for the second strbuf in a Q 2931 message Only applicable to user space applications the kernel API allocates the buffers inside the qcc_bld qcc_pack functions none Maximum length of the message qcc_create_ Creates a message structure with the required values set You can further customize the struc...

Page 116: ... Q 93B and wait for a RELEASE_COMPLETE from Q 93B Any time you receive a RELEASE_COMPLETE message from Q 93B release the virtual channel if the call is active or in progress Q 93B never sends a RELEASE message to the end user it will always send a RELEASE_COMPLETE Only send the RELEASE_COMPLETE message when rejecting a call in response to a SETUP message from Q 93B At any other time to reject or t...

Page 117: ...esent 6 CallProceeding CallProceeding Outgoing Call Incoming Call Proceeding 9 Connect Connect Connect Request 8 Active 10 Active 10 Release Release_Complete Release_Complete Release Request 11 Null 0 Null 0 SetUp SetUp Connect Connect ConnectAck ConnectAck Release Release Release_Complete Release_Complete ConnectAck CallProceeding Proceeding 3 1 XX n Q 2931 State Name Q 2931 State Number Optional...

Page 118: ...m_close Closes a stream to the ATM device driver Must be done by a user space setup program atm_attach Attaches to a physical interface Must be done by a user space setup program atm_detach Detaches from a physical interface Must be done by a user space setup program atm_bind Binds to a Service Access Point send DL_BIND_REQ atm_unbind Unbinds from a Service Access Point send DL_UNBIND_REQ atm_setr...

Page 119: ...ludes the SAP associated with the application s stream using atm_bind You can also select a mode of operation to determine the format of the message blocks passed to the ATM device driver DLPI mode is set by default however the user can select raw mode with a call to atm_setraw DLPI mode implies that two or more mblocks will be sent to the driver The first which corresponds to the ctl buffer sent ...

Page 120: ...ode however the driver does not modify the packets at all This includes any header included with the packet Thus an application using raw mode and LLC encapsulation must include its own headers on transmit and receives data with the LLC header intact Received packets are directed to application streams based on the type of encapsulation in use If a packet is null encapsulated it is sent up the str...

Page 121: ... composed of the following sections Troubleshooting While Starting a SunATM Interface on page 101 To Diagnose Generic Configuration Problems on page 101 To Diagnose Classical IP Configuration Problems on page 102 To Diagnose LAN Emulation Configuration Problems on page 105 Common Problems on page 108 Error Messages on page 110 Error Messages from S00sunatm on page 110 Error Messages From aarsetup ...

Page 122: ...the SunATM 5 0 software release Redundant LANE Servers SunATM adapter software does not support redundant LAN Emulation Services such as Cisco System s Simple Server Redundancy Protocol SSRP for LAN Emulation SunATM and Solstice FireWall 1 The Solstice FireWall 1 product does not currently support the SunATM 5 0 release Refer to the bug report BugID 4073989 for more information ...

Page 123: ...mconfig 4 man page 2 Check to see if any error messages were printed during the boot process If there were error messages see Error Messages on page 110 3 Verify linkstate in qccstat 1M This command indicates the signalling status of your interface If the linkstate is not DL_ACTIVE your interface is not communicating properly with your switch Make sure that your switch and interface are configured...

Page 124: ...iagnostic information 5 Interfaces that are not running Classical IP or LAN Emulation will not appear in the output of the ifconfig command ifconfig 1M displays interfaces that have been configured for IP In order to support IP ATM interfaces must run either Classical IP or LAN Emulation Therefore an ATM interface that is not configured to support IP by running one of these two protocols will not ...

Page 125: ...aarconfig are valid and run aarsetup again If you see any error messages check their meaning in Error Messages on page 110 4 Verify the interface_state in aarstat 1M The interface_state is either up or down and reflects the linkstate given in the output of qccstat If the linkstate is DL_ACTIVE the interface_state is up otherwise the interface_ state is down If aarstat indicates that the interface_...

Page 126: ...rify that it is up and running as a server 3 Make sure the address is resolved correctly Run the atmarp command for the system you are trying to ping and verify that its IP address has been resolved to the correct ATM address If not make sure that the remote system is registering the correct address with the ATM ARP server If the address has not been resolved at all make sure that the remote syste...

Page 127: ...ify their contents For descriptions of the file formats see Editing the atmconfig File on page 42 and Editing the laneconfig File on page 53 or the atmconfig 4 and laneconfig 4 man pages 3 Check the setup_state with lanestat 1M This command provides information about the LAN Emulation status on your interface The setup_state refers to the completion of the lanesetup program If the setup_state is s...

Page 128: ...e an LECS you must provide the address Create an entry in etc opt SUNWconn atm laneconfig See Editing the laneconfig File on page 53 You can check the LES address currently being used in the output of lanestat Verify that the LECS if present and LES are configured properly 5 Verify that a connection has been made to the BUS In addition to the LES connection s a LAN Emulation client must also estab...

Page 129: ...s has been resolved to an ATM address This is the second address resolution step and is accomplished by the LAN Emulation software and communication with the LES You can use the lanearp command to verify that MAC addresses have been properly resolved to ATM addresses If they have not verify the connections to the LES and make sure data is being transmitted and received on the connection s to the L...

Page 130: ... size For example suppose a TCP connection is set up between Host A and Host B where packets from Host A travel to Host B over the LANE interface and packets from Host B travel to Host A travel over the Classical IP interface Host A attempts to send a 9180 byte packet that cannot traverse the LANE network to Host B TCP recovers from this error and retransmits the packet but a significant performan...

Page 131: ... network performance from the SunATM adapter and software by adjusting your application s socket buffer size to 48 Kbytes Refer to the application s documentation for instructions on how to set the socket buffer size Are you trying to mount a diskless dataless or autoclient system The SunATM adapters do not currently support diskless dataless or autoclient systems The root filesystem must be local...

Page 132: ...he SunATM interfaces during system boot If the etc opt SUNWconn atm atmconfig file is not present S00sunatm prints this warning message and exits The etc opt SUNWconn atm atmconfig file is installed with the SUNWatm package as etc opt SUNWconn atm atmconfig template if you choose autoconfiguration or if no previous etc opt SUNWconn atm atmconfig file exists pkgadd copies this template file to etc ...

Page 133: ...s the remaining entries in etc opt SUNWconn atm atmconfig although further entries for the failed interface are not processed correctly warning invalid interface lane instance The minor number provided in a logical interface name was not in the range 0 255 The script proceeds without attempting to configure the invalid lane device warning only one classical ip hostname is allowed on device An addi...

Page 134: ...ifconfig failed for lane instance The script attempted to run ifconfig for the specified interface Error messages indicate why ifconfig failed use that information to check your values in etc opt SUNWconn atm atmconfig In particular verify that the hostname you provide in etc opt SUNWconn atm atmconfig appears in the etc hosts file on your system warning invalid lane instance lane instance for dev...

Page 135: ...Wconn atm aarconfig or etc opt SUNWconn atm laneconfig file or the file specified on the command line Verify that the appropriate file exists and has the proper permissions Also make sure you run aarsetup or lanesetup as root aarsetup exiting because of errors lanesetup exiting because of errors Errors were encountered while parsing the etc opt SUNWconn atm aarconfig or etc opt SUNWconn atm laneco...

Page 136: ...eated a variable in etc opt SUNWconn atm aarconfig or etc opt SUNWconn atm laneconfig that was syntactically invalid Variable names are a combination of letters digits and underscores _ Choose a conforming variable name and run aarsetup or lanesetup again variable name too long You created a variable in etc opt SUNWconn atm aarconfig or etc opt SUNWconn atm laneconfig with a name that is greater t...

Page 137: ...ATM interface The number of Emulated LANs that can be joined over a single physical interface is limited by the number of MAC addresses on the ATM interface board This message indicates that you tried to join more Emulated LANs than allowed by the number of MAC addresses on the specified interface You can find the number of MAC addresses on an interface by using the count option on the atmgetmac 1...

Page 138: ...116 SunATM 3U CompactPCI Adapter Installation and User s Guide February 2001 ...

Page 139: ...ctions 97 VBR allocation 97 Application Programmers Interface See API ARP address resolution tables 68 ATM address 34 38 45 54 66 69 aarconfig field 45 laneconfig field 54 registration 67 resolution 67 ARP address resolution tables 68 ARP server 32 33 44 45 50 52 67 68 69 address 35 caching 69 M_PROTO mblock fields 91 q93b driver 89 router 68 switch 66 switched virtual circuit 90 ATM Address field...

Page 140: ...uration variables in the aarconfig file 47 rules 50 setting 48 constant bit rate 96 D diagnostics atmtest failure 109 DLPI encapsulated connections 97 E emulated LAN name 39 end system identifier field 66 Error Messages 110 to 115 error messages aarsetup 113 kernel drivers 115 lanesetup 113 Error_Code message 91 F Flag field 54 framing interface SDH 30 setting 30 SONET 30 H hardware installation 1...

Page 141: ... variable 35 48 56 macsel variable 35 48 56 man pages 7 myaddress variable 35 48 56 N n configuration flag 54 55 netstat command 65 network prefix 66 P parameters TCP IP 109 permanent virtual circuit 36 permanent virtual circuits 87 ping command 104 troubleshooting 104 107 pkgchk checking package installation 8 pkginfo checking package installation 8 pkgrm removing packages 8 prefix variable 35 48...

Page 142: ... 7 runtime support package 6 7 SVC 87 switched virtual circuits 87 system performance 109 T t configuration flag 46 47 54 55 TCP IP parameters increasing performance 109 troubleshooting 101 to 107 atmtest failure 109 autoclient 109 dataless client 109 diskless client 109 snoop command 108 Type message 91 U UNI field 42 UNI specification 42 66 UNI version 31 V variable bit rate bandwidth 96 VBR 97 ...

Reviews: