Manuale d’uso / di manutenzione del prodotto 3U del fabbricante Sun Microsystems
Vai alla pagina of 142
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 .
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.
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 Digita.
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.
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 equireme.
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.
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 .
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.
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.
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.
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 Dr.
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 FIGUR.
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.
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.
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.
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.
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 .
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.
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 de.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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 $myaddr.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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 .
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 Nam.
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.
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.
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.
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: ■.
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.
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 .
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.
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.
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.
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.
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).
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 ■.
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.
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.
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.
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 id.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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() .
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.
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.
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.
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 .
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.
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.
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 .
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.
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.
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 .
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.
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.
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.
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).
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.
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.
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.
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.
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 var.
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 .
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 .
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 .
Un punto importante, dopo l’acquisto del dispositivo (o anche prima di acquisto) è quello di leggere il manuale. Dobbiamo farlo per diversi motivi semplici:
Se non hai ancora comprato il Sun Microsystems 3U è un buon momento per familiarizzare con i dati di base del prodotto. Prime consultare le pagine iniziali del manuale d’uso, che si trova al di sopra. Dovresti trovare lì i dati tecnici più importanti del Sun Microsystems 3U - in questo modo è possibile verificare se l’apparecchio soddisfa le tue esigenze. Esplorando le pagine segenti del manuali d’uso Sun Microsystems 3U imparerai tutte le caratteristiche del prodotto e le informazioni sul suo funzionamento. Le informazioni sul Sun Microsystems 3U ti aiuteranno sicuramente a prendere una decisione relativa all’acquisto.
In una situazione in cui hai già il Sun Microsystems 3U, ma non hai ancora letto il manuale d’uso, dovresti farlo per le ragioni sopra descritte. Saprai quindi se hai correttamente usato le funzioni disponibili, e se hai commesso errori che possono ridurre la durata di vita del Sun Microsystems 3U.
Tuttavia, uno dei ruoli più importanti per l’utente svolti dal manuale d’uso è quello di aiutare a risolvere i problemi con il Sun Microsystems 3U. Quasi sempre, ci troverai Troubleshooting, cioè i guasti più frequenti e malfunzionamenti del dispositivo Sun Microsystems 3U insieme con le istruzioni su come risolverli. Anche se non si riesci a risolvere il problema, il manuale d’uso ti mostrerà il percorso di ulteriori procedimenti – il contatto con il centro servizio clienti o il servizio più vicino.