Sun Microsystems 3U - Manuals

ix Contents 1. Product Overview 1 Product Description 1 Software Features 1 SunATM 155 3U Compact PCI Adapter 2 Hardware Features 2 SunATM 622 3U Compact PCI Adapter 3 Hardware Features 3 Hardware and Software Requirements 3 Overview of the Installation Procedure 4 2. Installing the SunATM Software ...

Contents xi Physical-Layer Parameter Group 30 Framing Interface 30 Signalling Parameter Group 31 UNI Version 31 ILMI Parameter Group 32 Classical IP Parameter Group 32 Classical IP Interface Type 33 Hostname and IP Address 34 Local ATM Address 34 ATM ARP Server Address 35 Permanent Virtual Circuit (...

xii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 6. Plumbing and Unplumbing SunATM Interfaces 61 Starting the SunATM Software for the First Time 62 Plumbing and Unplumbing Individual ATM Interfaces 62 7. Classical IP and LAN Emulation Protocols 65 ATM Network Protocols ...

Contents xiii 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...

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

xv Figures FIGURE 1-1 SunATM 3U Compact PCI Adapter 2 FIGURE 3-1 Opening the Ejection Lever 16 FIGURE 3-2 Closing the Ejection Lever 16 FIGURE 3-3 Tightening the Ejection Lever Captive Screw 17 FIGURE 7-1 ATM Address Fields 66 FIGURE 8-1 Using atmsnmpd as a Forwarding Agent 74 FIGURE C-1 ATM Signall...

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

xix Preface The SunATM 3U CompactPCI Adapter Installation and User ’s Guide providesinstructions for installing and using both the SunATM™ 155 and the SunATM 6223U Compact PCI adapters. This manual also describes how to install and configurethe SunATM software. These instructions are designed for ne...

xx SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Chapter 7, “Classical IP and LAN Emulation Protocols,” describes ATM protocolsand how they are supported by the SunATM software. Chapter 8 “SunATM and Solaris Networking Features,” describes how to managenetwork architectu...

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 Web. You can browse the docs.sun.com archive or search for a specific book ti...

1 C H A P T E R 1 Product Overview This chapter introduces the SunATM 155 and SunATM 622 3U CompactPCIadapters. The features, hardware requirements, and software requirements of theseadapters are described in the following sections: ■ “Product Description” on page 1 ■ “Hardware and Software Requirem...

2 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 FIGURE 1-1 SunATM 3U CompactPCI Adapter SunATM 155 3U CompactPCI Adapter The SunATM 155 CompactPCI adapter is a 155 Mbps ATM network interface boardwith a multi-mode fiber optical transceiver for LAN access. The SunATM 155c...

Chapter 1 Product Overview 3 SunATM 622 3U CompactPCI Adapter The SunATM 622 compact PCI adapter is a 622 Mbps ATM network interface boardwith a multi-mode fiber optical transceiver for LAN access. The SunATM 622compact PCI adapter provides full duplex transmission of data between a host on acompact...

4 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Overview of the Installation Procedure The following table lists the major tasks in the order you must perform them whenyou install the SunATM adapter into your system. These tasks are just the common, high level procedures...

5 C H A P T E R 2 Installing the SunATM Software This chapter describes how to install SunATM software from the Solaris SunComputer Systems Supplement CD. You must install the SunATM software beforeinstalling the adapter into your system. This chapter contains the following sections: ■ “Checking the...

Chapter 2 Installing the SunATM Software 7 ▼ To Install the SunATM Software ● Install the SunATM software as described in the Solaris Sun Hardware PlatformGuide included on the Sun Computer Systems Supplement CD-ROM. The Solaris Sun Hardware Platform Guide contains the software package installationi...

8 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 ▼ To Check the Package Installation Using pkginfo ● After installing the SunATM software, you can check the installation using the pkginfo command. The following example shows that pkginfo found the three SunATM software pa...

Chapter 2 Installing the SunATM Software 9 Configuring the SunATM Interfaces After installing the SunATM software, you must configure the SunATM interfacesbefore you reboot your system. You can either use the SunATM configurationprogram, atmadmin , to configure the interfaces, or you can edit the Su...

12 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Preparing for the Installation Before installing the adapter, prepare for the installation by assembling theappropriate tools, unpacking the ship kit, verifying the system software, andselecting an I/O slot. Tools and Equi...

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 hotswap your server is running (full or basic), you may be required to enter softwareco...

14 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 commands during the installation. For example, if you were installing the adapter ina server set to basic hot swap mode, you might use the cfgadm command to identify and attach the adapter during the installation. Installi...

Chapter 3 Installing and Extracting the Adapter 15 ▼ To Prepare the System for a Cold Installation 1. Before shutting down the operating environment and halting the system, ensure that all significant application activity on the server has stopped. 2. Follow the appropriate procedures, as documented...

16 SunATM 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. You may damage the adapter ’...

Chapter 3 Installing and Extracting the Adapter 17 8. Check your system documentation for any additional actions that may be required to configure 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 initia...

18 SunATM 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 adapterand its interfaces. The procedure you use for attaching the adapter to the systemdepends on whether you in...

Chapter 3 Installing and Extracting the Adapter 19 If you have to reinstall the card, be sure to follow the instructions outlined in yoursystem’s service manual for the removal and replacement of I/O cards. Refer to the system documentation for additional troubleshooting instructions. ▼ To Power On ...

24 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Using the atmadmin Configuration Program The SunATM configuration program, atmadmin , is an interactive command-line interface. The program contains a hierarchy of menus, which divide theconfiguration into six main paramet...

26 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 System Parameter Group Menu The system parameter group contains parameters that are not specific to aninterface; they apply to the entire system. The following example shows the systemparameter group menu. ATM SNMP Agent S...

Chapter 4 Configuring the SunATM Interfaces 27 Interface Configuration Menu Once you select a SunATM interface, you will see the atmadmin Interface Configuration menu. From this menu you can proceed to the interface parametergroup submenus, which are described in “atmadmin Parameter Groups” on page ...

30 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Physical-Layer Parameter Group 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...

Chapter 4 Configuring the SunATM Interfaces 31 Signalling Parameter Group The signalling parameter group contains only the UNI version parameter. Thefollowing example shows the signalling parameter menu. UNI Version The SunATM software supports three versions of the ATM Forum's User NetworkInterface...

32 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 ILMI Parameter Group If your ATM switch does not support the Interim Local Management Interface(ILMI), you can turn off the ILMI address registration on your SunATM interfacefrom the ILMI configuration menu. The following ...

Chapter 4 Configuring the SunATM Interfaces 33 If you are planning to run NIS over your ATM network, you must specify the list ofNIS servers (ypservers) using the ypinit -c command. See the ypinit(1M) man page for details of setting up the ypserver. Be sure that the IP addresses of theypservers are ...

34 SunATM 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 andhostname to the interface. If you enter a hostname that appears in the /etc/hosts file, or if NIS, NIS+, or DNS is ena...

Chapter 4 Configuring the SunATM Interfaces 35 To simplify references to ATM addresses in the SunATM software, several system-defined variables are built into the software. Variables are referenced with the $ operator, as in UNIX shell scripts. TABLE 4-3 summarizes the system-defined SunATM ATM addr...

36 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Permanent Virtual Circuit (PVC) The Permanent Virtual Circuit parameter applies only to standalone configurations.It identifies the PVC that will be used to communicate between the two systemsconnected back to back. Both s...

Chapter 4 Configuring the SunATM Interfaces 37 After you configure LAN Emulation parameters, you are asked to choose an existing(previously configured) 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 LA...

38 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Hostname or IP Address If IP traffic runs over a LAN Emulation instance, assign a hostname andcorresponding IP address to the instance. If you enter a hostname that appears in the /etc/hosts file, or if NIS, NIS+, or DNS i...

Chapter 4 Configuring the SunATM Interfaces 39 LECS ATM Address By default, the SunATM software attempts to obtain the LECS address using ILMI,as specified in the LAN Emulation specification. If this is not successful, the “well-known” ATM address, also specified by the ATM Forum, is used. If your L...

Chapter 5 Editing SunATM Configuration Files 43 Changing the Framing Interface in the atmconfig File The framing interface defines the encapsulation method used for ATM cells as theyare sent onto the wire. The default framing interface is SONET, but the SunATMsoftware also supports the SDH interface...

44 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Configuring a Classical Internet ProtocolInterface Classical Internet Protocol (Classical IP), specified by RFC 1577, is one way ofsupporting the TCP/IP and UDP/IP protocols in an ATM environment. In ClassicalIP, an ATM AR...

Chapter 5 Editing SunATM Configuration Files 47 TABLE 5-3 describes the required, optional, and illegal fields for each flag type. If a field is unused, it is represented by a hyphen. Note – Group entries in the aarconfig file in a designated order: the local (l or L) entry first, followed by any ot...

50 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Several rules apply to the use of variables in the aarconfig file: ■ Two variables cannot follow each other in an expression without an interveningcolon. Thus $v1:$v2 is legal while $v1$v2 is not. ■ Fields in each line in ...

Chapter 5 Editing SunATM Configuration Files 53 Configuring a LAN Emulation Interface LAN Emulation, standardized by the ATM Forum’s LAN Emulation 1.0specification, is another way of providing TCP/IP and UDP/IP support over anATM interface. Address resolution information is provided by a series of L...

Chapter 5 Editing SunATM Configuration Files 57 Sample LAN Emulation Configurations The following examples demonstrate entries in the /etc/opt/SUNWconn/atm/ laneconfig file for several common configurations. Although some of the examples show only one sample laneconfig file, similarly configured fil...

65 C H A P T E R 7 Classical IP and LAN EmulationProtocols This chapter describes ATM protocols and how they are supported by the SunATMsoftware. This chapter is composed of the following sections: ■ “ATM Network Protocols” on page 65 ■ “ATM Addresses and Address Registration” on page 66 ■ “Classica...

Chapter 7 Classical IP and LAN Emulation Protocols 67 ATM Address Registration Daemon ( ilmid ) Address registration with a switch is controlled by ilmid . When an ATM interface is brought up at boot time, ilmid is also started. ilmid then begins an exchange of messages with the switch: relaying loc...

68 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 standards for providing redundant ATM ARP servers for a subnet. As specified, theATM ARP server would constitute a single point of failure in the system. From apractical standpoint, however, early configurations can use an...

Chapter 7 Classical IP and LAN Emulation Protocols 69 Although the a entry requires a complete ATM address, you can reference multiple addresses in a single entry using the provided wildcards. See “Using Variables in theaarconfig File” on page 47 for more information about this feature. The advantag...

70 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 The SunATM software implements the client side of the LAN Emulation standard.To use LAN Emulation in an environment, several LAN Emulation services mustalso exist in the emulated LAN. These services, called the LAN Emulati...

Chapter 7 Classical IP and LAN Emulation Protocols 71 as an IP ARP request) is received by the LAN Emulation host from its upper layers,it sends that message to the BUS, which forwards it to all hosts in the emulatedLAN. Just as in the case of ethernet, the correct host responds to the sender, and t...

73 C H A P T E R 8 SunATM and Solaris NetworkingFeatures This chapter discusses the SunATM and Solaris Networking features. This chapter includes the following sections: ■ ATM and SNMP on page 73 ■ ATM and Logical Interfaces on page 75 ATM and SNMP Two of the ATM standards supported by the SunATM so...

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

Chapter 8 SunATM and Solaris Networking Features 75 The SunATM software has been designed to take advantage of this framework if it isinstalled on a system running Solaris 2.6, 7, or 8. The files necessary for the ATMSNMP agent to be recognized by the master agent ( atm.reg and atm.rsrc ) are copied...

77 A P P E N D I X 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

81 A P P E N D I X B Testing the Adapter This appendix describes how to test the adapter using either the SunVTS diagnosticapplication 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 S...

Appendix B Testing the Adapter 83 ▼ To Run the FCode Self-Test 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 sign...

84 SunATM 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 Manual for more information on the test command. If all of the tests pass, you wi...

87 A P P E N D I X C Application Programmer ’s Interface This appendix describes the SunATM Application Programmer ’s Interface (API).This appendix is composed of the following sections: ■ “SunATM API Introduction” on page 87 ■ “Using the SunATM API with the Q.93B and the ATM Device Drivers” on page...

Appendix C Application Programmer’s Interface 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 applicationsrunning in user space. Each set provides functions to build an...

Appendix C Application Programmer’s Interface 93 Call Setup To make a call, send a SETUP message down to Q.93B and wait for a SETUP_ACKfrom Q.93B. The SETUP message should include a Broadband Higher LayerInformation (BHLI) information element that contains a four-octet SAP identified asUser Specific...

Appendix C Application Programmer’s Interface 95 FIGURE C-3 Message Flow for Normal Call Setup and Tear-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 CallProceeding (9) Connect Conne...

Appendix C Application Programmer’s Interface 97 Note – The following discussion uses user space function names. Refer to TABLE C-4 for the corresponding kernel space function or ioctl . To establish a data path, the application must first open the ATM driver and attachto a specific physical interfa...

Appendix D Troubleshooting and SunATM Error Messages 101 Troubleshooting While Starting aSunATM Interface There are many steps involved in making an interface active on an ATM network.Problems in your configuration may cause a failure at any number of points alongthe way. The following sections cont...

Appendix D Troubleshooting and SunATM 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 descriptionsof the file f...

Appendix D Troubleshooting and SunATM Error Messages 105 ▼ To Diagnose LAN Emulation ConfigurationProblems 1. Check all of the generic configuration points. These are issues that apply to all SunATM interfaces, so they must all be working inorder for LAN Emulation to work. 2. Verify the output of if...

108 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Common Problems This section describes some common problems that you may experience during orafter the SunATM adapter installation. Please review this section before calling SunService for assistance. Are you trying to us...

Appendix D Troubleshooting and SunATM Error Messages 109 Do you want to increase system performance by adjusting TCP/IPparameters? TCP/IP performance over an ATM network can be poor unless you carefullyconfigure your network. Poor performance usually occurs because the TCP/IPpackets are segmented in...

110 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001 Error Messages This section includes a list of some of the most common error messages you mightsee while configuring and bringing up your SunATM interface. For each message,there is a brief explanation of the problem and ...

Appendix D Troubleshooting and SunATM Error Messages 113 Error 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 startedup. The second instance exits with ...

Appendix D Troubleshooting and SunATM 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 remainopen during this change, and if tha...

Index 117 Index SYMBOLS ? wildcard, 49, 57 A a configuration flag, 46, 47, 55, 68, 69 aarconfig file, 67, 68, 69 editing, 44file flags, 45flag options, 47sample configurations, 50using variables, 47 aarsetup program, 44, 67, 68, 69, 113 adapter installing, 15 allocating bandwidth, 97 anymac variable...