User ManualTable of ContentsSunATM™ 3U CompactPCI Adapter Installation and User’s Guide1Regulatory Compliance Statements3FCC Class A Notice31. This device may not cause harmful interference.32. This device must accept any interference received, including interference that may cause undes...3FCC Class B Notice31. This device may not cause harmful interference.32. This device must accept any interference received, including interference that may cause undes...3ICES-003 Class A Notice - Avis NMB-003, Classe A4ICES-003 Class B Notice - Avis NMB-003, Classe B4BSMI Class A Notice5Declaration of Conformity7EMC7European Union7Safety7Supplementary Information7Contents91. Product Overview192. Installing the SunATM Software593. Installing and Extracting the Adapter11104. Configuring the SunATM Interfaces23105. Editing SunATM Configuration Files41116. Plumbing and Unplumbing SunATM Interfaces61127. Classical IP and LAN Emulation Protocols65128. SunATM and Solaris Networking Features7312A. Specifications7712B. Testing the Adapter8113C. Application Programmer’s Interface8713D. Troubleshooting and SunATM Error Messages9913Figures15Tables17Preface19How This Book Is Organized19Using UNIX Commands20Typographic Conventions21TABLEP1 Typographic Conventions21Shell Prompts21TABLEP2 Shell Prompts21Related Documentation22TABLEP3 Related Documentation22Accessing Sun Documentation Online22Sun Welcomes Your Comments22Product Overview23Product Description23Software Features23FIGURE11 SunATM 3U CompactPCI Adapter24SunATM 155 3U CompactPCI Adapter24Hardware Features24SunATM 622 3U CompactPCI Adapter25Hardware Features25Hardware and Software Requirements25Overview of the Installation Procedure26TABLE11 Installation Overview26Installing the SunATM Software27Checking the System for SunATM Software27To Check for Previously Installed SunATM Software Packages27Installing the SunATM Software28TABLE21 SunATM Software Packages28To Install the SunATM Software29To Check the Package Installation Using pkginfo30To Check the Package Installation Using pkgchk30To Remove the Software Packages Using pkgrm30Configuring the SunATM Interfaces31Installing and Extracting the Adapter33Preparing for the Installation34Tools and Equipment Needed34Contents of the Ship Kit34Determining the Type of Adapter Installation34Models of Hot Swap35Installing the Adapter36To Prepare the System for Hot Installation361. Boot the Solaris operating environment with a special operating system kernel.362. Start cPCI hot swap.363. Type the following command:36To Prepare the System for a Cold Installation371. Before shutting down the operating environment and halting the system, ensure that all signifi...372. Follow the appropriate procedures, as documented in the system’s service manual, to shut down ...373. Power off the system.374. Verify that the system’s power LED is off (not lit) indicating that the system is completely p...37To Install the Adapter371. Get the antistatic wrist strap from the ship kit.372. Unwrap the first two folds of the wrist strap and wrap the adhesive side firmly against your w...373. Peel the liner from the copper foil at the opposite end of the wrist strap and attach the copp...374. Remove the card from its antistatic envelope and package and place it on the electrostatic dis...37FIGURE31 Opening the Ejection Lever385. Pull back the ejection lever and slide the card into the cPCI slot.386. Applying even pressure at both corners of the card, push the card until it is firmly seated in...387. Push the ejection lever over the sprocket toward the card and into the locked position.38FIGURE32 Closing the Ejection Lever388. Check your system documentation for any additional actions that may be required to configure t...399. Using a No. 0 Phillips screwdriver, tighten the captive screws inside the card’s ejection lever.39FIGURE33 Tightening the Ejection Lever Captive Screw3910. Remove the wrist strap from the chassis and your wrist.3911. Connect one end of the multimode fiber cable to the fiber receptacle on the SunATM adapter an...39Attaching the Adapter to the System40To Attach the Adapter in a Hot Swap Environment401. Follow the hot swap procedures for attaching an I/O card to the system in the system’s documen...402. On some systems, for example, you would log into the system console as superuser and identify ...403. At the system console, activate the adapter with the cfgadm -c connect command:404. Check the hot swap LED on the adapter.40To Power On the System After a Cold Installation411. Before powering on the system, make sure that all the cables are connected and the peripheral ...412. Follow the appropriate procedures, as documented in the system’s hardware installation manual,...413. Check the hot swap LED on the adapter.414. Verify that the system’s power LED is on (lit), indicating that the system has completely powe...41Extracting the Adapter41Determining the Type of Adapter Extraction41To Extract the Adapter from a Hot Swap Environment421. Start cPCI hot swap.422. As superuser, identify the cPCI card to be removed.423. Detach (unconfigure) the cPCI card to be removed.424. Repeat the attachment point list to confirm the board detachment.425. Check that the blue LED is on.426. Pull back the ejection lever.437. Slide the card out of the cPCI slot.43To Extract the Adapter from a Cold Environment431. Before shutting down the operating environment and halting the system, ensure that all signifi...432. Follow the appropriate procedures, as documented in the system’s service manual, to shut down ...433. Press the power switch on the system’s status panel to power down the system.434. Verify that the system’s power LED is off (unlit) indicating that the system is completely pow...435. Pull back the ejection lever.436. Slide the card out of the cPCI slot.43Configuring the SunATM Interfaces45Using the atmadmin Configuration Program46Starting the atmadmin Configuration Program46atmadmin Main Menu47atmadmin Navigation Commands47TABLE41 Basic Navigation Commands in atmadmin47System Parameter Group Menu48ATM SNMP Agent Status48Interface Configuration Menu49atmadmin and the SunATM Configuration Files49atmadmin Parameter Groups50TABLE42 Configurable Parameters in the SunATM Software50Physical-Layer Parameter Group52Framing Interface52Signalling Parameter Group53UNI Version53ILMI Parameter Group54Classical IP Parameter Group54Classical IP Interface Type55Hostname and IP Address56Local ATM Address56ATM Address Formats and Variables56TABLE43 Predefined SunATM Variables57ATM ARP Server Address57Permanent Virtual Circuit (PVC)58LAN Emulation Parameter Group58Per-Instance LAN Emulation59Hostname or IP Address60Local ATM Address60LECS Indicator60LECS ATM Address61LES ATM Address61Emulated LAN Name61Additional Hostnames61Editing SunATM Configuration Files63Editing the atmconfig File64TABLE51 /etc/opt/SUNWconn/atm/atmconfig Field Descriptions64Changing the Framing Interface in the atmconfig File65Example of an atmconfig File65Configuring a Classical Internet Protocol Interface66Editing the aarconfig File66TABLE52 /etc/opt/SUNWconn/atm/aarconfig File Flag Descriptions67TABLE53 /etc/opt/SUNWconn/atm/aarconfig File Flag Requirements and Options69Using Variables in the aarconfigFile69TABLE54 Predefined SunATM Variables70Sample Classical IP Configurations721. SVC-only: Clients use the default address and access to the ARP server is restricted to client...72a. The /etc/opt/SUNWconn/atm/aarconfig file on a client:72b. The /etc/opt/SUNWconn/atm/aarconfig file on the server:732. PVConly: hosta is connected to hostb and hostc over PVCs. There is no ARP server.73a. /etc/opt/SUNWconn/atm/aarconfig on hosta:73b. on hostb:73c. on hostc:733. SVC with no ARP server: hosta uses SVCs to connect to hostb and hostc. All hosts are connected...734. PVC/SVC mix: hosta uses an SVC to connect to hostb, and a PVC to connect to hostc. hostb is no...745. ARP server with access restrictions: Hosts are connected to an ATM ARP server that resolves ad...74a. /etc/opt/SUNWconn/atm/aarconfig on hosta:74b. /etc/opt/SUNWconn/atm/aarconfig on server:746. Manual address configuration: Hosts are connected to a switch that does not support ILMI.74a. /etc/opt/SUNWconn/atm/aarconfig on server:74b. /etc/opt/SUNWconn/atm/aarconfig on client:74Configuring a LAN Emulation Interface75Editing the laneconfig File75TABLE55 /etc/opt/SUNWconn/atm/laneconfig Entry Descriptions76TABLE56 /etc/opt/SUNWconn/atm/laneconfig Flag Descriptions76TABLE57 laneconfig Flag Requirements and Options77Using Variables in the laneconfig File78TABLE58 Predefined SunATM Variables78Sample LAN Emulation Configurations791. Basic LAN Emulation client. The ATM and MAC address of a frequently used server is provided. T...792. LAN Emulation client. The LECS requires that the client send the Emulated LAN name in its mess...79Supporting Multiple Emulated LANs on a Single Interface80Plumbing and Unplumbing SunATM Interfaces83Starting the SunATM Software for the First Time84Plumbing and Unplumbing Individual ATM Interfaces84TABLE61 Parameter Options for atmifconfig85Classical IP and LAN Emulation Protocols87ATM Network Protocols87ATM Addresses and Address Registration88FIGURE71 ATM Address Fields88ATM Address Registration Daemon (ilmid)89Classical Internet Protocol89ATM Address Resolution89ATM ARP Address Resolution Tables90LAN Emulation91LAN Emulation Servers92LAN Emulation Configuration Server92LAN Emulation Server92Broadcast and Unknown Address Server92Resolving an IP Address to an ATM Connection931. IP has a message to transmit and only knows the IP address of the target system. IP first send...932. ARP creates a broadcast request for the MAC address corresponding to the given IP address, whi...933. The LAN Emulation driver recognizes that this message has a broadcast address, and sends it to...934. The message is received on each host, and sent up to ARP by the LAN Emulation driver.935. On the target, ARP recognizes the IP address as its own and sends a response with its MAC addr...936. The LAN Emulation driver sends an LE ARP request to the LES to resolve the source’s MAC addres...937. The LES responds with the requested ATM address, and the target host sets up an ATM connection...938. The LAN Emulation driver on the source receives the IP ARP response message and sends it up to...939. The LAN Emulation driver then must send an LE ARP request to the LES to resolve the MAC addres...93LAN Emulation Connections94TABLE71 LAN Emulation Connections94SunATM and Solaris Networking Features95ATM and SNMP95FIGURE81 Using atmsnmpd as a Forwarding Agent96SNMP and Solaris96Solaris 2.6, Solaris 7, and Solaris 8 Compatible Software96ATM and Logical Interfaces97A99Specifications99Physical Dimensions99TABLEA1 Physical Dimensions99Performance Specifications100TABLEA2 Performance Specifications100Power Specifications100TABLEA3 Power Specifications100Environmental Specifications100TABLEA4 Environmental Specifications100B103Testing the Adapter103Using the SunVTS Diagnostic Software103TABLEB1 SunVTS Tests103TABLEB2 SunVTS Documentation104Using the OpenBoot PROM FCode Self-Test104To Run the FCode Self-Test Diagnostic1051. Before shutting down the operating environment and halting the system, ensure that all signifi...1052. Follow the appropriate procedures, as documented in the system’s service manual, to shut down ...1053. At the ok prompt, set the auto-boot? configuration variable to false.1054. Set the diag-switch? parameter to true in order to see the diagnostic power-on self- test (POS...1055. Reset the system to activate these parameter changes.1056. Use the show-devs command to display the list of devices.1057. Using the test command and the device path found in Step 6, start the adapter’s FCode self-test.1068. After testing the adapter, type the following commands to return the OpenBoot PROM to the stan...1069. Reset and reboot the system.107C109Application Programmer’s Interface109SunATM API Introduction1091. Create the SVC with the Q.93B driver.1092. Establish the data connection with the ma driver.109Using the SunATM API with the Q.93B and the ATM Device Drivers110FIGUREC1 ATM Signalling110Q.93B Driver Interface111Establishing a Connection to the Q.93B Driver111Setting Up an ATM Connection Over a Switched Virtual Circuit (SVC)112TABLEC1 Messages Between the User and the Q.93B Driver112FIGUREC2 Message Format113TABLEC2 Fields in the M_PROTO mblock113TABLEC3 qcc Functions115Call Setup115Release Procedure116Exception Conditions116FIGUREC3 Message Flow for Normal Call Setup and Tear-Down117Connecting, Sending, and Receiving Data with the ATM Device Driver118TABLEC4 atm_util Function Overview118Raw Mode Connections119DLPI Mode Connections119D121Troubleshooting and SunATM Error Messages121Troubleshooting While Starting a SunATM Interface123To Diagnose Generic Configuration Problems1231. Make sure that there is an entry for the interface in /etc/opt/SUNWconn/atm/ atmconfig.1232. Check to see if any error messages were printed during the boot process.1233. Verify linkstate in qccstat(1M).1234. Verify that an address has been registered with the switch.1245. Interfaces that are not running Classical IP or LAN Emulation will not appear in the output of...1246. Verify the packets that are moving over the network with the /etc/opt/ SUNWconn/bin/atmsnoop c...124To Diagnose Classical IP Configuration Problems1241. Check all of the generic configuration points.1242. Verify the output of ifconfig(1M).1243. Check the setup_state with aarstat(1M).1254. Verify the interface_state in aarstat(1M).1255. Make sure Classical IP is configured correctly.1256. If the system is a Classical IP client, verify the server connection.1257. If the server_state is no-connection or connecting.1258. Verify that addresses are resolved and connections are made with the ping(1M) command.1261. Check that ARP requests are being sent to the server.1262. Make sure that you are receiving ARP responses from the server.1263. Make sure the address is resolved correctly.1264. Verify that a connection has been established between the two systems.1265. Check for IP problems.126To Diagnose LAN Emulation Configuration Problems1271. Check all of the generic configuration points.1272. Verify the output of ifconfig(1M).1273. Check the setup_state with lanestat(1M).1274. Verify that a connection has been made to the LAN Emulation server (LES).1285. Verify that a connection has been made to the BUS.1286. Verify that the host has joined the Emulated LAN.1287. Verify that addresses are resolved and connections are made with the ping command.1291. Check that the IP hostname or address is resolved to a MAC address.1292. Check that the MAC address has been resolved to an ATM address.1293. Verify that a connection has been established between the two systems.1294. Check for IP problems.129Common Problems130Are you trying to use the /usr/sbin/arp command?130Are you using a router with Classical IP and LAN Emulation (LANE)?130Are you trying to use the /usr/sbin/snoop command?130Do you want to increase system performance by adjusting TCP/IP parameters?131Are you trying to mount a diskless, dataless, or autoclient system?131Did the atmtest diagnostic fail?131Error Messages132Error Messages from S00sunatm132Error Messages From aarsetup and lanesetup135Error Messages From the Kernel Drivers137Index139Symbols139A139B140C140D140E140F140H140I140K140L140M141N141P141Q141S141T142U142V142Size: 1.06 MBPages: 142Language: EnglishOpen manual