Sun Microsystems SunATM 3U Installation And User Manual
  1. Manuals
  2. Brands
  3. Sun Microsystems Manuals
  4. PCI Card
  5. SunATM 3U
  6. Installation and user manual
Sun Microsystems SunATM 3U Installation And User Manual

Sun Microsystems SunATM 3U Installation And User Manual

Sunatm 3u compactpci adapter
Hide thumbs Also See for SunATM 3U:
Table of Contents

Advertisement

Quick Links

Download this manual
SunATM
3U CompactPCI Adapter
™
Installation and User's Guide
Sun Microsystems, Inc.
901 San Antonio Road
Palo Alto, CA 94303-4900 U.S.A.
650-960-1300
Part No. 806-3005-10
February
2001, Revision A
Send comments about this document to: docfeedback@sun.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SunATM 3U and is the answer not in the manual?

Questions and answers

Related Manuals for Sun Microsystems SunATM 3U

Summary of Contents for Sun Microsystems SunATM 3U

  • Page 1 SunATM 3U CompactPCI Adapter ™ Installation and User’s Guide Sun Microsystems, Inc. 901 San Antonio Road Palo Alto, CA 94303-4900 U.S.A. 650-960-1300 Part No. 806-3005-10 February 2001, Revision A Send comments about this document to: docfeedback@sun.com...
  • Page 2 Sun, Sun Microsystems, the Sun logo, AnswerBook2, docs.sun.com, SunATM, SunVTS, OpenBoot, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc.

  • Page 3: Regulatory Compliance Statements

    FCC radio frequency emission limits. Networking connections can be made using unshielded twisted-pair (UTP) cables. Modifications: Any modifications made to this device that are not approved by Sun Microsystems, Inc. may void the authority granted to the user by the FCC to operate this equipment.
  • Page 4 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. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 5 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 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 7: Declaration Of Conformity

    Dennis P. Symanski DATE Peter Arkless DATE Manager, Compliance Engineering Quality Manager Sun Microsystems, Inc. Sun Microsystems Scotland, Limited 901 San Antonio Road, MPK15-102 Springfield, Linlithgow Palo Alto, CA 94303-4900, USA West Lothian, EH49 7LR Scotland, United Kingdom Tel: 650-786-3255...
  • Page 8 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 9: Table Of Contents

    Contents 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 Installing the SunATM Software 5 Checking the System for SunATM Software 5 To Check for Previously Installed SunATM Software Packages 5...
  • Page 10 Navigation Commands 25 System Parameter Group Menu 26 ATM SNMP Agent Status 26 Interface Configuration Menu 27 atmadmin and the SunATM Configuration Files 27 atmadmin Parameter Groups 28 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 11 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 (PVC) 36 LAN Emulation Parameter Group 36 Per-Instance LAN Emulation 37...
  • Page 12 Solaris 2.6, Solaris 7, and Solaris 8 Compatible Software 74 ATM and Logical Interfaces 75 Specifications 77 Physical Dimensions 77 Performance Specifications 78 Power Specifications 78 Environmental Specifications 78 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 13 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 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...
  • Page 14 Error Messages from S00sunatm 110 Error Messages From aarsetup and lanesetup 113 Error Messages From the Kernel Drivers 115 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 15 Figures SunATM 3U Compact PCI Adapter 2 FIGURE 1-1 Opening the Ejection Lever 16 FIGURE 3-1 Closing the Ejection Lever 16 FIGURE 3-2 Tightening the Ejection Lever Captive Screw 17 FIGURE 3-3 ATM Address Fields 66 FIGURE 7-1 Using atmsnmpd as a Forwarding Agent 74...
  • Page 16 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 17 Tables Installation Overview 4 TABLE 1-1 SunATM Software Packages 6 TABLE 2-1 Basic Navigation Commands in atmadmin 25 TABLE 4-1 Configurable Parameters in the SunATM Software 28 TABLE 4-2 Predefined SunATM Variables 35 TABLE 4-3 /etc/opt/SUNWconn/atm/atmconfig Field Descriptions 42 TABLE 5-1 /etc/opt/SUNWconn/atm/aarconfig File Flag Descriptions 45 TABLE 5-2 /etc/opt/SUNWconn/atm/aarconfig File Flag Requirements and Options 47...
  • Page 18 Messages Between the User and the Q.93B Driver 90 TABLE C-1 Fields in the M_PROTO mblock 91 TABLE C-2 qcc Functions 93 TABLE C-3 atm_util Function Overview 96 TABLE C-4 xviii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 19 Preface The SunATM 3U CompactPCI Adapter Installation and User’s Guide provides instructions for installing and using both the SunATM™ 155 and the SunATM 622 3U Compact PCI adapters. This manual also describes how to install and configure the SunATM software.
  • Page 20 See one or more of the following for this information: Solaris on Sun Hardware Platform Guide AnswerBook2™ online documentation for the Solaris™ operating environment Other software documentation that you received with your system SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 21: Typographic Conventions

    Typographic Conventions Typographic Conventions TABLE P-1 Typeface Meaning Examples The names of commands, files, Edit your .login file. AaBbCc123 and directories; on-screen Use ls -a to list all files. computer output % You have mail. What you type, when AaBbCc123 contrasted with on-screen Password: computer output...

  • Page 22: Related Documentation

    We are 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. xxii SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 23: Product Overview

    “Overview of the Installation Procedure” on page 4 Product Description The SunATM 3U CompactPCI 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.

  • Page 24: Sunatm 155 3U Compactpci Adapter

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

  • Page 25: Sunatm 622 3U Compactpci Adapter

    SunATM 622 3U CompactPCI Adapter The SunATM 622 compact PCI adapter is a 622 Mbps ATM network interface board with a multi-mode fiber optical transceiver for LAN access. The SunATM 622 compact PCI adapter provides full duplex transmission of data between a host on a compact PCI (cPCI) bus and the fiber optics with a data rate of 622 Mbits/sec.

  • Page 26: Overview Of The Installation Procedure

    Plumbing the SunATM interface Chapter 6 Note – If you experience problems during the installation of the SunATM hardware or software, see Appendix D for troubleshooting procedures and error message descriptions. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 27: Installing The Sunatm Software

    C H A P T E R Installing the SunATM Software This chapter describes how to install SunATM software from the Solaris Sun Computer Systems Supplement CD. You must install the SunATM software before installing the adapter into your system. This chapter contains the following sections: “Checking the System for SunATM Software”...

  • Page 28: Installing The Sunatm Software

    SUNWatmu SNMP management system. Contains the SunATM interim API libraries and header files. SUNWatma Note – For basic ATM functionality, the SUNWatm package is the only required software package. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 29: To Install The Sunatm Software

    To Install the SunATM Software Install the SunATM software as described in the Solaris Sun Hardware Platform Guide included on the Sun Computer Systems Supplement CD-ROM. The Solaris Sun Hardware Platform Guide contains the software package installation instructions specific to the Solaris operating environment supported by the software. The software from the SunATM packages will be installed in the following directories: SunATM Device Drivers and Utilities (SUNWatm) go into:...

  • Page 30: To Check The Package Installation Using Pkginfo

    In this example, the pkgrm command will remove the three SunATM software packages from the system. # /usr/sbin/pkgrm SUNWatm SUNWatma SUNWatmu Refer to the pkgrm(1M) man page for more information about the command. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 31: Configuring The Sunatm Interfaces

    Configuring the SunATM Interfaces After installing the SunATM software, you must configure the SunATM interfaces before you reboot your system. You can either use the SunATM configuration program, atmadmin, to configure the interfaces, or you can edit the SunATM configuration files directly. Note –...
  • Page 32 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 33: Installing And Extracting The Adapter

    C H A P T E R Installing and Extracting the Adapter This chapter contains instructions for installing 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”...

  • Page 34: Preparing For The Installation

    Determine whether you want to perform a hot swap installation of the adapter or a cold installation. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 35: Models Of Hot Swap

    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 required to enter software commands before and after the installation.

  • Page 36: Installing The Adapter

    2. Start cPCI hot swap. % drvconfig -i sghsc 3. Type the following command: % cfgadm pci Confirm that the intended slot can be identified as unconfigured on the list. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 37: To Prepare The System For A Cold Installation

    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 in the system’s service manual, to shut down and halt the system.

  • Page 38: Figure 3-1 Opening The Ejection Lever

    If the blue LED does not go off, it either means the system into which you inserted the card does not fully support the hot-swap feature or the card is not properly seated. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 39: Figure 3-3 Tightening The Ejection Lever Captive Screw

    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: % cfgadm -c configure attachment_point This turns off the blue LED and initiates the software, which responds by configuring the system software for the newly inserted card.

  • Page 40: Attaching The Adapter To The System

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

  • Page 41: To Power On The System After A Cold Installation

    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 instructions. To Power On the System After a Cold Installation 1.

  • Page 42: To Extract The Adapter From A Hot Swap Environment

    The Removal OK LED must change from green to amber to signal the unconfigured state. When the Removal OK LED is amber, it is safe to remove the cPCI card. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 43: To Extract The Adapter From A Cold Environment

    6. Pull back the ejection lever. 7. Slide the card out of the cPCI slot. To Extract the Adapter from a Cold Environment 1. Before shutting down the operating environment and halting the system, ensure that all significant application activity on the server has stopped. 2.
  • Page 44 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 45: Configuring The Sunatm Interfaces

    C H A P T E R Configuring the SunATM Interfaces After installing the adapter in your system, you must configure the SunATM software before you can use the new interface. This chapter describes how to configure the software using the atmadmin configuration program. This program enables you to configure the software parameters through an interactive command- line interface.

  • Page 46: Using The Atmadmin Configuration Program

    The atmadmin program is installed with the SUNWatm software package in the /etc/opt/SUNWconn/bin directory. The program must be run as superuser (root). It can be run in any local or remote shell on the SunATM system. # /etc/opt/SUNWconn/bin/atmadmin SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 47: Atmadmin Main Menu

    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 group menu (see “System Parameter Group Menu” on page 26) or enter the SunATM interface you want to configure.

  • Page 48: System Parameter Group Menu

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

  • Page 49: Interface Configuration Menu

    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 parameter group submenus, which are described in “atmadmin Parameter Groups” on page 28. You can use these sub-menus to change the SunATM interface configuration parameters.

  • Page 50: Atmadmin Parameter Groups

    Destination hostname Valid hostname and No default For Classical IP or IP address IP address standalones LAN emulation Instance number 0 <= n <= 999 No default For LAN emulation SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 51 Configurable Parameters in the SunATM Software (Continued) TABLE 4-2 Group Parameters Possible Values Default Values Required? Per-instance Hostname/IP address Valid hostname and No default For LAN parameters IP address emulation Local ATM address Valid ATM address For LAN $myaddress emulation LECS indicator No LECS or LECS For LAN...

  • Page 52: Physical-Layer Parameter Group

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

  • Page 53: Signalling Parameter Group

    Signalling Parameter Group The signalling parameter group contains only the UNI version parameter. The following example shows the signalling parameter menu. Modifying ba0; Current UNI Version is 3.0 The UNI versions that may be configured are: [N] No Signalling Enabled [P] Previous Menu [M] Main Menu [X] Exit...

  • Page 54: Ilmi Parameter Group

    Because Classical IP over ATM does not support broadcast, you cannot use the ypbind -broadcast UNIX command to automatically locate the NIS server (ypserver) on a Classical IP ATM subnet. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 55: Classical Ip Interface Type

    If you are planning to run NIS over your ATM network, you must specify the list of NIS servers (ypservers) using the ypinit -c command. See the ypinit(1M) man page for details of setting up the ypserver. Be sure that the IP addresses of the ypservers are listed in the /etc/hosts file.

  • Page 56: Hostname And Ip Address

    ATM address are called the Network Prefix. This field should be derived from the ATM switch fabric to which the interface is connected. Every ATM switch fabric is configured with a 13-octet prefix. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 57: Atm Arp Server Address

    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. summarizes the system-defined TABLE 4-3 SunATM ATM address variables. Predefined SunATM Variables TABLE 4-3 Variable...

  • Page 58: Permanent Virtual Circuit (Pvc)

    Note – A requirement for supporting this feature is that the adapter card be assigned multiple MAC addresses, which the adapter supports. Use the atmgetmac(1M) command with the count option to find the number of MAC addresses assigned to your SunATM adapter. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 59: Per-Instance Lan Emulation

    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. The following lane instances are configured on ba0: lane0 lane1 [C] Create new lane instance...
  • Page 60 LAN Emulation Instance menu. Note – If the value of this parameter is No LECS, you must specify a value for the LES ATM Address parameter. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 61 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 LECS uses a different ATM address (not the well-known address), and does not make that address available via ILMI, specify it using this parameter.
  • Page 62 IP hostname and address pairs (see “ATM Address Formats and Variables” on page 34 for more details), and associate it with a minor number between 0 and 255. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 63: Editing Sunatm Configuration Files

    C H A P T E R Editing SunATM Configuration Files This chapter describes how to configure SunATM interfaces by editing the configuration files. You are not required to edit these configuration files by hand. You can use the atmadmin configuration program, described in “Using the atmadmin Configuration Program”...

  • Page 64: Editing The Atmconfig File

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

  • Page 65: Changing The Framing Interface In The Atmconfig File

    Changing the Framing Interface in the atmconfig File The framing interface defines the encapsulation method used 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 which interface your switch uses.

  • Page 66: Configuring A Classical Internet Protocol Interface

    ATM ARP server. The environment allows for a mix of PVCs and switched virtual circuits (SVCs). Each time the /etc/opt/SUNWconn/atm/aarconfig file is modified, run the ATM ARP setup program, aarsetup, which is in the /etc/opt/SUNWconn/bin directory. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 67: Table 5-2 /Etc/Opt/Sunwconn/Atm/Aarconfig File Flag Descriptions

    Every node, or client, has both an IP address and either an ATM address or a virtual circuit identifier (VCI). See “ATM Address Resolution” on page 67, for ATM addressing scheme information. In the IP-ATM address table shown in the /etc/opt/SUNWconn/atm/aarconfig file: Interface is the last part of the device name (ba0, for example).
  • Page 68 RFC 1577 does not specify this case. For interoperability with other implementations, connections to the server should use SVCs. Note – For two hosts to communicate over PVCs, corresponding PVC connections must also be established in the ATM switch fabric. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 69: Using Variables In The Aarconfig File

    describes the required, optional, and illegal fields for each flag type. If a TABLE 5-3 field is unused, it is represented by a hyphen. /etc/opt/SUNWconn/atm/aarconfig File Flag Requirements and Options TABLE 5-3 Interface * Host ATM Address Flags required illegal SVC only illegal local information...

  • Page 70: Table 5-4 Predefined Sunatm Variables

    A wild card representing any 6-byte ESI. Should only be used anymac in a entries. A wild card representing any 7-byte ESI and Selector anymacsel combination. Should only be used in a entries. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 71 Predefined SunATM Variables (Continued) TABLE 5-4 Variable Description 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 requires that the first digit of the selector byte is a 0.

  • Page 72: Sample Classical Ip Configurations

    1. SVC-only: Clients use the default address and access to the ARP server is restricted to clients on the local switch only. a. The /etc/opt/SUNWconn/atm/aarconfig file on a client: Interface Host ATM Address VCI Flag $myaddress $localswitch_server SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 73 b. The /etc/opt/SUNWconn/atm/aarconfig file on the server: Interface Host ATM Address Flag $localswitch_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: Interface Host ATM Address Flag hostb hostc b.
  • Page 74 /etc/opt/SUNWconn/atm/aarconfig on server: set prfx = 45:00:00:00:00:00:00:00:0f:00:00:00:00 Interface Host ATM Address Flag $prfx:$sunmacsel0 b. /etc/opt/SUNWconn/atm/aarconfig on client: set prfx = 45:00:00:00:00:00:00:00:0f:00:00:00:00 Interface Host ATM Address Flag $prfx:$macsel $prfx:$sunmacsel0 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 75: Configuring A Lan Emulation Interface

    Configuring a LAN Emulation Interface LAN Emulation, standardized by the ATM Forum’s LAN Emulation 1.0 specification, is another way of providing TCP/IP and UDP/IP support over an ATM interface. Address resolution information is provided by a series of LAN Emulation services. When a LAN Emulation interface is brought up, it must “join the LAN;”...

  • Page 76: Table 5-5 /Etc/Opt/Sunwconn/Atm/Laneconfig Entry Descriptions

    The default MTU size is 1500 bytes. With the M flag, you can set the MTU size to be either 4 Kbytes (4528 bytes) or 9 Kbytes (9218 bytes). SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 77: Table 5-7 Laneconfig Flag Requirements And Options

    /etc/opt/SUNWconn/atm/laneconfig Flag Descriptions (Continued) TABLE 5-6 Flag Description Represents an address that may have access to this host. If no a entries appear in the laneconfig file, access to the host is unrestricted. Including a entries allows access to be restricted to known hosts. As an alternative to listing individual addresses, the ATM address field may contain a prefix, followed by the wildcard $anymacsel, which matches any 7-byte ESI/Selector combination following the given prefix.

  • Page 78: Using Variables In The Laneconfig File

    The 6-byte MAC address associated with the local host or interface. The default 1-byte selector for the local interface. The concatenation of $mac:$sel. macsel The concatenation of $prefix:$mac:$sel, resulting in the myaddress default address for the local interface. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 79: Sample Lan Emulation Configurations

    Predefined SunATM Variables (Continued) TABLE 5-8 Variable Description A wild card representing any 6-byte ESI. Should only be used anymac in a entries. A wild card representing any 7-byte ESI and Selector anymacsel combination. Should only be used in a entries. A wild card matching one or two hexadecimal digits within any colon-separated field.

  • Page 80: Supporting Multiple Emulated Lans On A Single Interface

    Classical IP. It joins four emulated LANs: the default, elan1, elan2, and elan3. The example /etc/opt/SUNWconn/atm/atmconfig file: Interface CIP Hostname LANE Instance LANE Hostname atm0 atm1 atm2 atm3 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 81 The corresponding example /etc/opt/SUNWconn/atm/laneconfig file: Interface MAC Address/ ATM Address VCI Flag ELAN Name lane0 $myaddress lane1 $myaddress lane1 elan1 lane2 $myaddress lane2 elan2 lane3 $myaddress lane3 elan3 The resulting ifconfig -a output: # ifconfig -a lo0: flags=849<UP,LOOPBACK,RUNNING,MULTICAST> mtu 8232 inet 127.0.0.1 netmask ff000000 lane0:flags=863<UP,BROADCAST,NOTRAILERS,RUNNING,MULTICAST>...
  • Page 82 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 83: Plumbing And Unplumbing Sunatm Interfaces

    C H A P T E R Plumbing and Unplumbing SunATM Interfaces This chapter describes how to start the SunATM software on your system or use the atmifconfig utility to connect and disconnect individual SunATM interfaces without rebooting the system. Note –...

  • Page 84: Starting The Sunatm Software For The First Time

    This will set up or tear down all the ATM instances on this physical interface, including up to 16 LAN Emulation instances and the Classical IP instance. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 85: Table 6-1 Parameter Options For Atmifconfig

    A summary of the parameter options for the atmifconfig utility is provided in TABLE 6-1 Parameter Options for atmifconfig TABLE 6-1 Utility Interface Name Plumb Instruction atmifconfig plumb atmifconfig unplumb laneN atmifconfig plumb laneN atmifconfig unplumb atmifconfig plumb-all atmifconfig unplumb-all The following example shows the use of atmifconfig and the output of ifconfig -a before and after the utility is run.
  • Page 86 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 87: Classical Ip And Lan Emulation Protocols

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

  • Page 88: Atm Addresses And Address Registration

    ATM address. The ILMI service interface is based on the use of SNMP over AAL5. In the SunATM software package, ILMI service is provided by an address registration daemon, ilmid. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 89: Atm Address Registration Daemon (Ilmid)

    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 local address information (the seven-octet ESI and selector) to the switch and receiving the 13-octet network prefix information from the switch.

  • Page 90: Atm Arp Address Resolution Tables

    /etc/opt/SUNWconn/atm/aarconfig file. If no a entries appear, any host can connect to the server. If any a entries exist, only those hosts whose addresses match those specified will be allowed to connect. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 91: Lan Emulation

    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 the aarconfig File” on page 47 for more information about this feature. The advantage of having an ATM ARP server in the subnet is that it represents a known source for all address resolutions.

  • Page 92: Lan Emulation Servers

    LES for the broadcast address. Once established, this connection is used to send broadcast messages to the BUS, which will add the client to a point-to-multipoint call including all hosts on the emulated LAN. Thus when a broadcast message (such SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 93: Resolving An Ip Address To An Atm Connection

    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 emulated LAN. Just as in the case of ethernet, the correct host responds to the sender, and thus the IP address is resolved to a MAC address.

  • Page 94: Lan Emulation Connections

    Multicast Forward BUS —> LEC Point-to-multipoint connection over which the BUS sends broadcast messages. Hosts may not send on this connection. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 95: Sunatm And Solaris Networking Features

    C H A P T E R SunATM and Solaris Networking Features 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 software (the User Network Interface (UNI) and LAN Emulation (LANE) specifications) include definitions of...

  • Page 96: Snmp And Solaris

    This framework provides a single agent at port 161 with the combined capabilities of the master agent and all the additional subagents. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 97: Atm And Logical Interfaces

    The SunATM 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 ATM SNMP agent to be recognized by the master agent (atm.reg and atm.rsrc) are copied under /etc/snmp/conf by the S00sunatm startup script if it detects that the system is running Solaris 2.6, 7, or 8.
  • Page 98 192.29.240.36 netmask ffffff00 broadcast 192.29.240.255 ether 8:0:20:8b:6d:d0 lane0:1: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 4 inet 192.29.241.36 netmask ffffff00 broadcast 192.29.241.255 lane0:2: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 4 inet 192.29.242.36 netmask ffffff00 broadcast 192.29.242.255 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 99: Specifications

    A P P E N D I X Specifications This appendix lists the specifications of the SunATM 3U compact PCI adapter. Physical Dimensions Physical Dimensions TABLE A-1 Dimension Measurement Length 160 mm Width 100 mm...

  • Page 100: Performance Specifications

    -25 to 70 C(-25 to +131 F) Relative humidity 5 to 85% non-condensing 0 to 95% non-condensing (40 C,wet bulb temperature) 40 C/hour Altitude -1000 to +15,000 ft. -1000 to +50,000 ft. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 101 Environmental Specifications TABLE A-4 Condition Operating Specification Storage Specification Shock 5g, 1/2 sine wave, 11 msec 30g, 1/2 sine wave, 11 msec Vibration, pk to pk 0.005 in. max. (5 to 32 Hz) 0.1 in. max (5 to 17 Hz) displacement Vibration, peak 0.25g (5 to 500 Hz)
  • Page 102 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 103: Testing The Adapter

    A P P E N D I X Testing the Adapter This appendix describes how to test the adapter using either the SunVTS diagnostic application or the onboard FCode self-test. This appendix contains the following sections: “Using the SunVTS Diagnostic Software” on page 81 “Using the OpenBoot PROM FCode Self-Test”...

  • Page 104: Using The Openboot Prom Fcode Self-Test

    Note – The self-test does not require connection to the network. The self-test will test the internal loopback up to the adapter’s saturn user network interface (SUNI) ASIC. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 105: To Run The Fcode Self-Test Diagnostic

    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 significant application activity on the server has acquiesced. 2.
  • Page 106 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 setenv diag-switch? false ok setenv auto-boot? true SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 107 9. Reset and reboot the system. ok reset-all Follow the procedures in the system’s documentation for the correct procedures to bring up the system. Appendix B Testing the Adapter...
  • Page 108 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 109: Application Programmer's Interface

    SunATM API Introduction The Application Programmers’ Interface (API) provided with this software release is an interim API from Sun Microsystems, Inc. that can be used on Sun Platforms. In the ATM environment, data is sent between hosts over Virtual Circuits (VCs). VCs are point-to-point (or point-to-multipoint) connections between two or more ATM hosts.

  • Page 110: Using The Sunatm Api With The Q.93B And The Atm Device Drivers

    For examples of applications that use the SunATM API, see the sample programs installed in /opt/SUNWconn/atm/examples. User Kernel Q.93B Driver SSCOP SSCOP ATM Device Driver (ma driver) ATM Signalling FIGURE C-1 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 111: Q.93B Driver Interface

    Q.93B Driver Interface The signalling API, called Q.2931 Call Control (qcc), consists of two sets of similar functions: one for applications running in the kernel and one for applications running in user space. Each set provides functions to build and parse Q.2931 signalling messages, which are required to set up and tear down connections.

  • Page 112: Setting Up An Atm Connection Over A Switched Virtual Circuit (Svc)

    RESTART_ACK BOTH ADD_PARTY BOTH ADD_PARTY_ACK BOTH ADD_PARTY_REJECT BOTH PARTY_ALERTING BOTH DROP_PARTY BOTH DROP_PARTY_ACK BOTH LEAF_SETUP_FAIL BOTH LEAF_SETUP_REQ *UP is from Q.93B to user; DOWN is from user to Q.93B SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 113: Figure C-2 Message Format

    The Q.93B driver is an M-to-N mux STREAMS driver. Multiple application programs can be plumbed above the driver, and multiple physical interfaces can be connected below Q.93B. Applications can access any or all of the physical interfaces, and messages received on the physical interfaces can be directed to any of the applications.
  • Page 114 , or man qcc_bld man qcc_bld_setup illustrates the message flow during typical call man qcc_bld_connect FIGURE C-3 setup and tear-down. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 115: Call Setup

    qcc Functions TABLE C-3 Name Functionality Input Output Creates and encodes a message; Parameter values Encoded Q.2931 qcc_bld_* enables customization of a limited message (in the format set of values, depending on the shown in FIGURE C-2 message type. Configurable values are passed in as parameters.

  • Page 116: Release Procedure

    SETUP_ACK is returned with an error value set, and call setup is not continued. The error value will be one of the cause codes specified in the ATM Forum UNI standard. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 117: Figure C-3 Message Flow For Normal Call Setup And Tear-Down

    USER Q.93B SWITCH Q.93B USER Null (0)1 Null(0) SetUp SetUpAck SetUp SetUp Call Initiated (1) SetUp CallProceeding* CallProceeding* Call Present (6) Outgoing Call CallProceeding* Proceeding (3) Incoming Call Proceeding (9) Connect Connect Connect Connect Request ConnectAck Connect ConnectAck ConnectAck Active (10) Active (10) Release Release...

  • Page 118: Connecting, Sending, And Receiving Data With The Atm Device Driver

    Allocates constant bit rate bandwidth atm_allocate_cbr_bw A_ALLOCBW_CBR ioctl with more granularity than atm_allocate_bw Allocates variable bit rate bandwidth atm_allocate_vbr_bw A_ALLOCBW_VBR ioctl Releases previously allocated bandwidth atm_release_bw A_RELSE_BW ioctl SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 119: Raw Mode Connections

    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 attach to a specific physical interface using atm_open() and atm_attach(). Next, the connection is associated with one or more VC(s), using atm_add_vpci().
  • Page 120 If a packet is LLC- encapsulated, it is sent to the stream that has bound (using atm_bind()) the SAP found in the LLC header. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 121: Troubleshooting And Sunatm Error Messages

    A P P E N D I X Troubleshooting and SunATM Error Messages This troubleshooting section will need to be updated for adapters installed in the Serengeti system. This appendix describes troubleshooting procedures for diagnosing problems with the SunATM interfaces. This appendix is composed of the following sections: “Troubleshooting While Starting a SunATM Interface”...

  • Page 122: Known Issues About The Sunatm 5.0 Release

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

  • Page 123: Troubleshooting While Starting A Sunatm Interface

    Troubleshooting While Starting a SunATM 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 along the way. The following sections contain steps you can take to determine where in the process your system failed, and what to do to remedy the situation.

  • Page 124: To Diagnose Classical Ip Configuration Problems

    Check for error messages during the boot process. The meanings and possible solutions for error messages can be found in “Error Messages” on page 110. If your interface appears but has incorrect information, verify your configuration files. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 125 The information given to ifconfig comes from the /etc/opt/SUNWconn/atm/ atmconfig and /etc/opt/SUNWconn/atm/aarconfig files. Check the entries in those files that apply to this interface and verify their contents. For descriptions of the file formats, see “Editing the atmconfig File” on page 42, and “Editing the aarconfig File”...
  • Page 126 If the address has been resolved correctly, and a connection has been established between the two systems, but they still cannot ping, the problem is likely outside the scope of ATM. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 127: To Diagnose Lan Emulation Configuration Problems

    To Diagnose LAN Emulation Configuration Problems 1. Check all of the generic configuration points. These are issues that apply to all SunATM interfaces, so they must all be working in order for LAN Emulation to work. 2. Verify the output of ifconfig(1M). Executing the command ifconfig -a should display the ATM LAN Emulation interface, laneN, where N is the instance number.
  • Page 128 MTU size larger than 9 Kbytes, the SunATM host will not join (9 Kbytes is the largest MTU size supported by the SunATM product). If the host is not able to join, an error message will be printed with an explanation. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 129 7. Verify that addresses are resolved and connections are made with the ping command. Once you have two systems configured and running to this point, they should be able to ping each other. To ping client2 from client1: % ping client2 client2 is alive If the ping is not successful: 1.

  • Page 130: Common Problems

    The /usr/bin/snoop command, which can be used to detect network problems, does not support SunATM interfaces at this time. A version of the snoop command, /etc/opt/SUNWconn/atm/bin/atmsnoop, provides this support. Refer to the atmsnoop(1M) man page for more information. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 131 Do you want to increase system performance by adjusting TCP/IP parameters? TCP/IP performance over an ATM network can be poor unless you carefully configure your network. Poor performance usually occurs because the TCP/IP packets are segmented into cells for transmission by the ATM software. Therefore, a loss of a single cell can cause the loss of an entire TCP/IP packet which can lead to retransmissions that congest the network.

  • Page 132: Error Messages

    The script ignores the new UNI version and continues processing the entry and the remaining entries in the file. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 133 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 board (or 1 if the board has no MAC address).You can check the number of MAC addresses on a board using the count option of the atmgetmac(1m) command.
  • Page 134 Either the LAN Emulation or the Classical IP startup script failed and exited with an error value. Check the error messages that were printed by aarsetup or lanesetup, and verify the values you have entered in /etc/opt/SUNWconn/ atm/aarconfig and/or /etc/opt/SUNWconn/atm/laneconfig. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 135: Error Messages From Aarsetup And Lanesetup

    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 started up. The second instance exits with this error message. Make sure that there is not a previous instance of the program still running.
  • Page 136 LAN. Reset your LAN Emulation services to use an MTU size less than or equal to 9 Kbytes, and rerun lanesetup to join the emulated LAN. SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

  • Page 137: Error Messages From The Kernel Drivers

    ifname: frame-size change (please rerun lanesetup) The MTU size was changed by the LAN Emulation Services; rerun lanesetup to notify IP of the change. There is a slight chance that TCP connections will remain open during this change, and if that is the case, performance on those connections is affected by the change.
  • Page 138 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 139 Index SYMBOLS Application Programmers Interface See API ? wildcard, 49, 57 ARP address resolution tables, 68 address, 34, 38, 45, 54, 66, 69 aarconfig field, 45 a configuration flag, 46, 47, 55, 68, 69 laneconfig field, 54 registration, 67 aarconfig file, 67, 68, 69 resolution, 67 editing, 44 ARP address resolution tables, 68...
  • Page 140 109 DLPI encapsulated connections, 97 kernel drivers error messages, 115 emulated LAN name, 39 end system identifier field, 66 L configuration flag, 45, 47 Error Messages, 110 to 115 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...
  • Page 141 l configuration flag, 45, 47, 54, 55 TCP/IP, 109 LAN Emulation, 53, 65, 69 permanent virtual circuit, 36 configuration server, 38, 70 permanent virtual circuits, 87 configuring interface, 36 to 40, 53 ping command, 104 connections, 72 troubleshooting, 104, 107 driver, 69, 71 pkgchk instance number, 42...
  • Page 142 Type message, 91 UNI field, 42 UNI specification, 42, 66 UNI version, 31 variable bit rate bandwidth, 96 VBR, 97 VCI field, 45, 54 virtual circuit identifier, 36, 45 SunATM 3U CompactPCI Adapter Installation and User’s Guide • February 2001...

This manual is also suitable for:

806-3005-10

Table of Contents