Testing the Adapter | Sun Microsystems 3U specs

B. Testing the Adapter 81

Using the SunVTS Diagnostic Software 81

Using the OpenBoot PROM FCode

Self-Test 82

▼ To Run the FCode Self-Test Diagnostic 83

C. Application Programmer’s Interface 87
SunATM API Introduction 87
Using the SunATM API with the Q.93B and the ATM Device Drivers 88
Q.93B Driver Interface	89
Establishing a Connection to the Q.93B Driver 89
Setting Up an ATM Connection Over a Switched Virtual Circuit (SVC) 90
Call Setup 93
Release Procedure	94
Exception Conditions 94
Connecting, Sending, and Receiving Data with the ATM Device Driver 96
Raw Mode Connections	97
DLPI Mode Connections	97

D. Troubleshooting and SunATM Error Messages			99
Known Issues About the SunATM 5.0		Release	100
	Redundant LANE Servers 100
	SunATM and Solstice FireWall-1	100
Troubleshooting While Starting a SunATM Interface				101
▼	To Diagnose Generic Configuration Problems			101
▼	To Diagnose Classical IP Configuration Problems 102
▼	To Diagnose LAN Emulation Configuration Problems 105
	Common Problems 108

Error Messages 110

Contents xiii

Image 13

Sun Microsystems 3U Testing the Adapter, Application Programmer’s Interface, Troubleshooting and SunATM Error Messages

Contents

SunATM 3U CompactPCI Adapter Installation and User’s Guide Please Recycle FCC Class a Notice Regulatory Compliance StatementsFCC Class B Notice ICES-003 Class B Notice Avis NMB-003, Classe B ICES-003 Class a Notice Avis NMB-003, Classe a Bsmi Class a Notice Page EMC Declaration of ConformityPage Contents Configuring the SunATM Interfaces Installing and Extracting the Adapter Editing SunATM Configuration Files Specifications SunATM and Solaris Networking FeaturesPlumbing and Unplumbing SunATM Interfaces Classical IP and LAN Emulation Protocols Troubleshooting and SunATM Error Messages Testing the AdapterApplication Programmer’s Interface Page Figures Page Tables SunVTS Documentation How This Book Is Organized Preface Solaris on Sun Hardware Platform Guide Using Unix Commands Shell Prompts Typographic ConventionsTable P-1Typographic Conventions Table P-2Shell Prompts Related Documentation Accessing Sun Documentation OnlineSun Welcomes Your Comments Table P-3Related Documentation Product Overview Software FeaturesProduct Description SunATM 155 3U CompactPCI Adapter Hardware Features SunATM 622 3U CompactPCI Adapter Hardware and Software Requirements 1Installation Overview Overview of the Installation Procedure To Check for Previously Installed SunATM Software Packages Installing the SunATM SoftwareChecking the System for SunATM Software 1SunATM Software Packages Installing the SunATM Software SunATM Interim API SUNWatma goes into To Install the SunATM Software To Remove the Software Packages Using pkgrm To Check the Package Installation Using pkgchk Configuring the SunATM Interfaces Page Installing and Extracting Adapter Contents of the Ship Kit Preparing for the InstallationDetermining the Type of Adapter Installation Tools and Equipment Needed Models of Hot Swap To Prepare the System for Hot Installation Installing the AdapterType the following command Start cPCI hot swap To Install the Adapter To Prepare the System for a Cold InstallationPower off the system 1Opening the Ejection Lever Cfgadm -c configure attachmentpoint To Attach the Adapter in a Hot Swap Environment Attaching the Adapter to the SystemCheck the hot swap LED on the adapter Extracting the Adapter To Power On the System After a Cold InstallationDetermining the Type of Adapter Extraction To Extract the Adapter from a Hot Swap Environment Detach unconfigure the cPCI card to be removedCheck that the blue LED is on To Extract the Adapter from a Cold Environment Page Configuring the SunATM Interfaces Starting the atmadmin Configuration Program Using the atmadmin Configuration Program 1Basic Navigation Commands in atmadmin Atmadmin Navigation Commands ATM Snmp Agent Status System Parameter Group Menu Atmadmin and the SunATM Configuration Files Interface Configuration Menu 2Configurable Parameters in the SunATM Software Atmadmin Parameter Groups Lecs indicator Framing Interface Physical-Layer Parameter Group UNI Version Signalling Parameter Group Classical IP Parameter Group Ilmi Parameter Group Classical IP Interface Type Local ATM Address Hostname and IP Address 3Predefined SunATM Variables ATM ARP Server Address Permanent Virtual Circuit PVC LAN Emulation Parameter Group Per-Instance LAN Emulation Hostname or IP Address Lecs ATM Address Page Editing SunATM Configuration Files Etc/opt/SUNWconn/atm/atmconfig Field Descriptions Editing the atmconfig File Example of an atmconfig File Changing the Framing Interface in the atmconfig File Editing the aarconfig File Configuring a Classical Internet Protocol Interface FlagDescription Etc/opt/SUNWconn/atm/aarconfig File Flag Descriptions Using Variables in the aarconfig File 4Predefined SunATM Variables Wild card matching one or two hexadecimal digits within /etc/opt/SUNWconn/atm/aarconfig file on a client Sample Classical IP Configurations On hostb Etc/opt/SUNWconn/atm/aarconfig on hosta Editing the laneconfig File Configuring a LAN Emulation Interface These entry fields are described in Table 7laneconfig Flag Requirements and Options 8Predefined SunATM Variables Using Variables in the laneconfig File Sample LAN Emulation Configurations Supporting Multiple Emulated LANs on a Single Interface Example /etc/opt/SUNWconn/atm/atmconfig file Resulting ifconfig -aoutput Page Plumbing and Unplumbing SunATM Interfaces Plumbing and Unplumbing Individual ATM Interfaces Starting the SunATM Software for the First Time # atmifconfig ba0 unplumb # ifconfig -a 1Parameter Options for atmifconfigPage ATM Network Protocols Classical IP and LAN Emulation Protocols 1ATM Address Fields ATM Addresses and Address Registration Classical Internet Protocol ATM Address ResolutionATM Address Registration Daemon ilmid ATM ARP Address Resolution Tables LAN Emulation LAN Emulation Servers LAN Emulation Configuration ServerLAN Emulation Server Broadcast and Unknown Address Server Resolving an IP Address to an ATM Connection 1LAN Emulation Connections LAN Emulation Connections ATM and Snmp SunATM and Solaris Networking Features Solaris 2.6, Solaris 7, and Solaris 8 Compatible Software Snmp and Solaris ATM and Logical Interfaces Interface MAC Address ATM Address Physical Dimensions Specifications Power Specifications Performance SpecificationsEnvironmental Specifications Appendix a Specifications Page Using the SunVTS Diagnostic Software Testing the AdapterTable B-1SunVTS Tests Table B-2SunVTS Documentation Using the OpenBoot Prom FCode Self-Test Reset the system to activate these parameter changes To Run the FCode Self-Test DiagnosticUse the show-devscommand to display the list of devices Ok setenv diag-switch? false ok setenv auto-boot? true Reset and reboot the system Page SunATM API Introduction Application Programmer’s Interface API Establishing a Connection to the Q.93B Driver 93B Driver Interface Table C-1Messages Between the User and the Q.93B Driver Table C-2Fields in the Mproto mblock Figure C-2Message FormatPage Call Setup Exception Conditions Release Procedure Release Request Table C-4atmutil Function Overview Dlpi Mode Connections Raw Mode ConnectionsPage Troubleshooting and SunATM Error Messages Redundant Lane Servers Known Issues About the SunATM 5.0 ReleaseSunATM and Solstice FireWall-1 To Diagnose Generic Configuration Problems Troubleshooting While Starting a SunATM Interface Verify that an address has been registered with the switch To Diagnose Classical IP Configuration ProblemsCheck all of the generic configuration points Verify the output of ifconfig1M If the serverstate is no-connection or connecting Make sure Classical IP is configured correctly Ping client2 To Diagnose LAN Emulation Configuration Problems Verify that the host has joined the Emulated LAN Verify that a connection has been made to the BUS Ping client2 Are you trying to use the /usr/sbin/arp command? Common Problems Did the atmtest diagnostic fail? Error Messages from S00sunatm Error Messages Please install SUNWatm Page Error Messages From aarsetup and lanesetup Undefined variable Error Messages From the Kernel Drivers Page Index Symbols CIPHost field Snmp