Document Outline

• SunATM™ 3U CompactPCI Adapter Installation and User’s Guide
• Regulatory Compliance Statements
  • FCC Class A Notice
    • 1. This device may not cause harmful interference.
    • 2. This device must accept any interference received, including interference that may cause undes...
  • FCC Class B Notice
    • 1. This device may not cause harmful interference.
    • 2. This device must accept any interference received, including interference that may cause undes...
  • ICES-003 Class A Notice - Avis NMB-003, Classe A
  • ICES-003 Class B Notice - Avis NMB-003, Classe B
  • BSMI Class A Notice
• Declaration of Conformity
  • EMC
    • European Union
  • Safety
  • Supplementary Information
• Contents
  • 1. Product Overview1
  • 2. Installing the SunATM Software5
  • 3. Installing and Extracting the Adapter11
  • 4. Configuring the SunATM Interfaces23
  • 5. Editing SunATM Configuration Files41
  • 6. Plumbing and Unplumbing SunATM Interfaces61
  • 7. Classical IP and LAN Emulation Protocols65
  • 8. SunATM and Solaris Networking Features73
  • A. Specifications77
  • B. Testing the Adapter81
  • C. Application Programmer’s Interface87
  • D. Troubleshooting and SunATM Error Messages99
• Figures
• Tables
  • Preface
• How This Book Is Organized
• Using UNIX Commands
• Typographic Conventions
  • TABLEP1 Typographic Conventions
• Shell Prompts
  • TABLEP2 Shell Prompts
• Related Documentation
  • TABLEP3 Related Documentation
• Accessing Sun Documentation Online
• Sun Welcomes Your Comments
  • 1
  • Product Overview
• Product Description
  • Software Features
    • FIGURE11 SunATM 3U CompactPCI Adapter
  • SunATM 155 3U CompactPCI Adapter
    • Hardware Features
  • SunATM 622 3U CompactPCI Adapter
    • Hardware Features
• Hardware and Software Requirements
• Overview of the Installation Procedure
  • TABLE11 Installation Overview
  • 2
  • Installing the SunATM Software
• Checking the System for SunATM Software
  • To Check for Previously Installed SunATM Software Packages
• Installing the SunATM Software
  • TABLE21 SunATM Software Packages
  • To Install the SunATM Software
  • To Check the Package Installation Using pkginfo
  • To Check the Package Installation Using pkgchk
  • To Remove the Software Packages Using pkgrm
• Configuring the SunATM Interfaces
  • 3
  • Installing and Extracting the Adapter
• Preparing for the Installation
  • Tools and Equipment Needed
  • Contents of the Ship Kit
  • Determining the Type of Adapter Installation
  • Models of Hot Swap
• Installing the Adapter
  • To Prepare the System for Hot Installation
    • 1. Boot the Solaris operating environment with a special operating system kernel.
    • 2. Start cPCI hot swap.
    • 3. Type the following command:
  • To Prepare the System for a Cold Installation
    • 1. Before shutting down the operating environment and halting the system, ensure that all signifi...
    • 2. Follow the appropriate procedures, as documented in the system’s service manual, to shut down ...
    • 3. Power off the system.
    • 4. Verify that the system’s power LED is off (not lit) indicating that the system is completely p...
  • To Install the Adapter
    • 1. Get the antistatic wrist strap from the ship kit.
    • 2. Unwrap the first two folds of the wrist strap and wrap the adhesive side firmly against your w...
    • 3. Peel the liner from the copper foil at the opposite end of the wrist strap and attach the copp...
    • 4. Remove the card from its antistatic envelope and package and place it on the electrostatic dis...
      • FIGURE31 Opening the Ejection Lever
    • 5. Pull back the ejection lever and slide the card into the cPCI slot.
    • 6. Applying even pressure at both corners of the card, push the card until it is firmly seated in...
    • 7. Push the ejection lever over the sprocket toward the card and into the locked position.
      • FIGURE32 Closing the Ejection Lever
    • 8. Check your system documentation for any additional actions that may be required to configure t...
    • 9. Using a No. 0 Phillips screwdriver, tighten the captive screws inside the card’s ejection lever.
      • FIGURE33 Tightening the Ejection Lever Captive Screw
    • 10. Remove the wrist strap from the chassis and your wrist.
    • 11. Connect one end of the multimode fiber cable to the fiber receptacle on the SunATM adapter an...
• Attaching the Adapter to the System
  • To Attach the Adapter in a Hot Swap Environment
    • 1. Follow the hot swap procedures for attaching an I/O card to the system in the system’s documen...
    • 2. On some systems, for example, you would log into the system console as superuser and identify ...
    • 3. At the system console, activate the adapter with the cfgadm -c connect command:
    • 4. Check the hot swap LED on the adapter.
  • To Power On the System After a Cold Installation
    • 1. Before powering on the system, make sure that all the cables are connected and the peripheral ...
    • 2. Follow the appropriate procedures, as documented in the system’s hardware installation manual,...
    • 3. Check the hot swap LED on the adapter.
    • 4. Verify that the system’s power LED is on (lit), indicating that the system has completely powe...
• Extracting the Adapter
  • Determining the Type of Adapter Extraction
  • To Extract the Adapter from a Hot Swap Environment
    • 1. Start cPCI hot swap.
    • 2. As superuser, identify the cPCI card to be removed.
    • 3. Detach (unconfigure) the cPCI card to be removed.
    • 4. Repeat the attachment point list to confirm the board detachment.
    • 5. Check that the blue LED is on.
    • 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 signifi...
    • 2. Follow the appropriate procedures, as documented in the system’s service manual, to shut down ...
    • 3. Press the power switch on the system’s status panel to power down the system.
    • 4. Verify that the system’s power LED is off (unlit) indicating that the system is completely pow...
    • 5. Pull back the ejection lever.
    • 6. Slide the card out of the cPCI slot.
    • 4
    • Configuring the SunATM Interfaces
• Using the atmadmin Configuration Program
  • Starting the atmadmin Configuration Program
  • atmadmin Main Menu
  • atmadmin Navigation Commands
    • TABLE41 Basic Navigation Commands in atmadmin
  • System Parameter Group Menu
    • ATM SNMP Agent Status
  • Interface Configuration Menu
    • atmadmin and the SunATM Configuration Files
• atmadmin Parameter Groups
  • TABLE42 Configurable Parameters in the SunATM Software
  • Physical-Layer Parameter Group
    • Framing Interface
  • Signalling Parameter Group
    • UNI Version
  • ILMI Parameter Group
  • Classical IP Parameter Group
    • Classical IP Interface Type
    • Hostname and IP Address
    • Local ATM Address
      • ATM Address Formats and Variables
        • TABLE43 Predefined SunATM Variables
    • ATM ARP Server Address
    • Permanent Virtual Circuit (PVC)
  • LAN Emulation Parameter Group
    • Per-Instance LAN Emulation
      • Hostname or IP Address
      • Local ATM Address
      • LECS Indicator
      • LECS ATM Address
      • LES ATM Address
      • Emulated LAN Name
      • Additional Hostnames
        • 5
        • Editing SunATM Configuration Files
• Editing the atmconfig File
  • TABLE51 /etc/opt/SUNWconn/atm/atmconfig Field Descriptions
  • Changing the Framing Interface in the atmconfig File
  • Example of an atmconfig File
• Configuring a Classical Internet Protocol Interface
  • Editing the aarconfig File
    • TABLE52 /etc/opt/SUNWconn/atm/aarconfig File Flag Descriptions
    • TABLE53 /etc/opt/SUNWconn/atm/aarconfig File Flag Requirements and Options
  • Using Variables in the aarconfigFile
    • TABLE54 Predefined SunATM Variables
  • Sample Classical IP Configurations
    • 1. SVC-only: Clients use the default address and access to the ARP server is restricted to client...
      • a. The /etc/opt/SUNWconn/atm/aarconfig file on a client:
      • b. The /etc/opt/SUNWconn/atm/aarconfig file on the server:
    • 2. PVConly: 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. on hostc:
    • 3. SVC with no ARP server: hosta uses SVCs to connect to hostb and hostc. All hosts are connected...
    • 4. PVC/SVC mix: hosta uses an SVC to connect to hostb, and a PVC to connect to hostc. hostb is no...
    • 5. ARP server with access restrictions: Hosts are connected to an ATM ARP server that resolves ad...
      • a. /etc/opt/SUNWconn/atm/aarconfig on hosta:
      • b. /etc/opt/SUNWconn/atm/aarconfig on server:
    • 6. Manual address configuration: Hosts are connected to a switch that does not support ILMI.
      • a. /etc/opt/SUNWconn/atm/aarconfig on server:
      • b. /etc/opt/SUNWconn/atm/aarconfig on client:
• Configuring a LAN Emulation Interface
  • Editing the laneconfig File
    • TABLE55 /etc/opt/SUNWconn/atm/laneconfig Entry Descriptions
    • TABLE56 /etc/opt/SUNWconn/atm/laneconfig Flag Descriptions
    • TABLE57 laneconfig Flag Requirements and Options
  • Using Variables in the laneconfig File
    • TABLE58 Predefined SunATM Variables
  • Sample LAN Emulation Configurations
    • 1. Basic LAN Emulation client. The ATM and MAC address of a frequently used server is provided. T...
    • 2. LAN Emulation client. The LECS requires that the client send the Emulated LAN name in its mess...
• Supporting Multiple Emulated LANs on a Single Interface
  • 6
  • Plumbing and Unplumbing SunATM Interfaces
• Starting the SunATM Software for the First Time
• Plumbing and Unplumbing Individual ATM Interfaces
  • TABLE61 Parameter Options for atmifconfig
  • 7
  • Classical IP and LAN Emulation Protocols
• ATM Network Protocols
• ATM Addresses and Address Registration
  • FIGURE71 ATM Address Fields
  • ATM Address Registration Daemon (ilmid)
• Classical Internet Protocol
  • ATM Address Resolution
  • ATM ARP Address Resolution Tables
• LAN Emulation
  • LAN Emulation Servers
    • LAN Emulation Configuration Server
    • LAN Emulation Server
    • Broadcast and Unknown Address Server
  • Resolving an IP Address to an ATM Connection
    • 1. IP has a message to transmit and only knows the IP address of the target system. IP first send...
    • 2. ARP creates a broadcast request for the MAC address corresponding to the given IP address, whi...
    • 3. The LAN Emulation driver recognizes that this message has a broadcast address, and sends it to...
    • 4. The message is received on each host, and sent up to ARP by the LAN Emulation driver.
    • 5. On the target, ARP recognizes the IP address as its own and sends a response with its MAC addr...
    • 6. The LAN Emulation driver sends an LE ARP request to the LES to resolve the source’s MAC addres...
    • 7. The LES responds with the requested ATM address, and the target host sets up an ATM connection...
    • 8. The LAN Emulation driver on the source receives the IP ARP response message and sends it up to...
    • 9. The LAN Emulation driver then must send an LE ARP request to the LES to resolve the MAC addres...
  • LAN Emulation Connections
    • TABLE71 LAN Emulation Connections
    • 8
    • SunATM and Solaris Networking Features
• ATM and SNMP
  • FIGURE81 Using atmsnmpd as a Forwarding Agent
  • SNMP and Solaris
    • Solaris 2.6, Solaris 7, and Solaris 8 Compatible Software
• ATM and Logical Interfaces
  • A
  • Specifications
• Physical Dimensions
  • TABLEA1 Physical Dimensions
• Performance Specifications
  • TABLEA2 Performance Specifications
• Power Specifications
  • TABLEA3 Power Specifications
• Environmental Specifications
  • TABLEA4 Environmental Specifications
  • B
  • Testing the Adapter
• Using the SunVTS Diagnostic Software
  • TABLEB1 SunVTS Tests
  • TABLEB2 SunVTS Documentation
• Using the OpenBoot PROM FCode Self-Test
  • To Run the FCode Self-Test Diagnostic
    • 1. Before shutting down the operating environment and halting the system, ensure that all signifi...
    • 2. Follow the appropriate procedures, as documented in the system’s service manual, to shut down ...
    • 3. At the ok prompt, set the auto-boot? configuration variable to false.
    • 4. Set the diag-switch? parameter to true in order to see the diagnostic power-on self- test (POS...
    • 5. Reset the system to activate these parameter changes.
    • 6. Use the show-devs command to display the list of devices.
    • 7. Using the test command and the device path found in Step 6, start the adapter’s FCode self-test.
    • 8. After testing the adapter, type the following commands to return the OpenBoot PROM to the stan...
    • 9. Reset and reboot the system.
    • C
    • Application Programmer’s Interface
• SunATM API Introduction
  • 1. Create the SVC with the Q.93B driver.
  • 2. Establish the data connection with the ma driver.
• Using the SunATM API with the Q.93B and the ATM Device Drivers
  • FIGUREC1 ATM Signalling
  • Q.93B Driver Interface
  • Establishing a Connection to the Q.93B Driver
  • Setting Up an ATM Connection Over a Switched Virtual Circuit (SVC)
    • TABLEC1 Messages Between the User and the Q.93B Driver
    • FIGUREC2 Message Format
    • TABLEC2 Fields in the M_PROTO mblock
    • TABLEC3 qcc Functions
    • Call Setup
    • Release Procedure
    • Exception Conditions
      • FIGUREC3 Message Flow for Normal Call Setup and Tear-Down
• Connecting, Sending, and Receiving Data with the ATM Device Driver
  • TABLEC4 atm_util Function Overview
  • Raw Mode Connections
  • DLPI Mode Connections
    • D
    • Troubleshooting and SunATM Error Messages
• Troubleshooting While Starting a SunATM Interface
  • To Diagnose Generic Configuration Problems
    • 1. Make sure that there is an entry for the interface in /etc/opt/SUNWconn/atm/ atmconfig.
    • 2. Check to see if any error messages were printed during the boot process.
    • 3. Verify linkstate in qccstat(1M).
    • 4. Verify that an address has been registered with the switch.
    • 5. Interfaces that are not running Classical IP or LAN Emulation will not appear in the output of...
    • 6. Verify the packets that are moving over the network with the /etc/opt/ SUNWconn/bin/atmsnoop c...
  • To Diagnose Classical IP Configuration Problems
    • 1. Check all of the generic configuration points.
    • 2. Verify the output of ifconfig(1M).
    • 3. Check the setup_state with aarstat(1M).
    • 4. Verify the interface_state in aarstat(1M).
    • 5. Make sure Classical IP is configured correctly.
    • 6. If the system is a Classical IP client, verify the server connection.
    • 7. If the server_state is no-connection or connecting.
    • 8. Verify that addresses are resolved and connections are made with the ping(1M) command.
      • 1. Check that ARP requests are being sent to the server.
      • 2. Make sure that you are receiving ARP responses from the server.
      • 3. Make sure the address is resolved correctly.
      • 4. Verify that a connection has been established between the two systems.
      • 5. Check for IP problems.
  • To Diagnose LAN Emulation Configuration Problems
    • 1. Check all of the generic configuration points.
    • 2. Verify the output of ifconfig(1M).
    • 3. Check the setup_state with lanestat(1M).
    • 4. Verify that a connection has been made to the LAN Emulation server (LES).
    • 5. Verify that a connection has been made to the BUS.
    • 6. Verify that the host has joined the Emulated LAN.
    • 7. Verify that addresses are resolved and connections are made with the ping command.
      • 1. Check that the IP hostname or address is resolved to a MAC address.
      • 2. Check that the MAC address has been resolved to an ATM address.
      • 3. Verify that a connection has been established between the two systems.
      • 4. Check for IP problems.
  • Common Problems
    • Are you trying to use the /usr/sbin/arp command?
    • Are you using a router with Classical IP and LAN Emulation (LANE)?
    • Are you trying to use the /usr/sbin/snoop command?
    • Do you want to increase system performance by adjusting TCP/IP parameters?
    • Are you trying to mount a diskless, dataless, or autoclient system?
    • Did the atmtest diagnostic fail?
• Error Messages
  • Error Messages from S00sunatm
  • Error Messages From aarsetup and lanesetup
  • Error Messages From the Kernel Drivers
  • Index
• Symbols
• A
• B
• C
• D
• E
• F
• H
• I
• K
• L
• M
• N
• P
• Q
• S
• T
• U
• V