Sun Microsystems HIPPI/P 1.0 User Guide

Sun HIPPI/P 1.0 Installation and User’s Guide

Sun Microsystems Computer Company
A Sun Microsystems, Inc. Business

901 San Antonio Road Palo Alto, CA 94303-4900 USA
650 960-1300
fax [phone]

Part No.: 805-7133-10
Revision A, March 1999

1999 SunMicrosystems,Inc., 901 San Antonio Road, Palo Alto, California 94303-4900 U.S.A.
All rights reserved.
This product or document is protected by copyright and distributed under licenses restricting itsuse, copying,distribution, anddecompilation.

No part of this productor document may be reproducedin anyform byany meanswithout priorwritten authorizationof Sunand itslicensors,
if any.

Portions of this product may be derived from the UNIX® system, licensed from Novell,Inc., andfrom the Berkeley 4.3 BSD system, licensed
fromthe University of California. UNIX is a registered trademark in theUnited States and in other countriesand is exclusively licensed by
X/Open Company Ltd. Third-party software, including font technology in this product, is protected by copyright and licensed from Sun’s
suppliers. RESTRICTED RIGHTS: Use, duplication, or disclosureby the U.S. Government is subject to restrictions of FAR52.227-14(g)(2)(6/87)
and FAR52.227-19(6/87), or DFAR252.227-7015(b)(6/95) and DFAR227.7202-3(a).

Sun, Sun Microsystems,the Sun logo, and Solaris are trademarks or registeredtrademarks of Sun Microsystems, Inc. in the United States and in
other countries. All SPARCtrademarks are used under license and are trademarks or registeredtrademarks of SPARCInternational,Inc. in the
United States and in other countries. Productsbearing SPARCtrademarks are based upon an architecture developed by Sun Microsystems, Inc.

The OPEN LOOK® and Sun™ Graphical User Interfaces weredeveloped by Sun Microsystems, Inc. for its users and licensees. Sun
acknowledges the pioneering efforts of Xerox Corporation in researching and developing the concept of visual or graphical user interfaces for
the computer industry. Sun holds a nonexclusive license fromXerox to the Xerox Graphical User Interface, which license also coversSun’s
licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements.

THIS PUBLICATIONIS PROVIDED “AS IS” WITHOUT WARRANTYOF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT
NOT LIMITED TO,THE IMPLIED WARRANTIESOFMERCHANTABILITY,FITNESS FOR A PARTICULARPURPOSE,OR NON­INFRINGEMENT.

Copyright 1999 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, Californie 94303-4900 U.S.A. Tousdroits réservés.
Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie et la décompilation.

Aucune partie de ce produitou de sa documentation associée ne peut être reproduitesous aucune forme, par quelque moyen que ce soit, sans
l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a.

Des parties de ce produitpourront être derivées du système UNIX® licencié par Novell, Inc. et du systèmeBerkeley 4.3 BSD licenciépar
l’Université de Californie. UNIX est une marqueenregistrée aux Etats-Unis et dans d’autres pays, et licenciée exclusivement par X/Open
Company Ltd. Le logiciel détenu par des tiers, et qui comprendla technologie relative aux polices de caractères,est protégépar un copyright et
licencié par des fournisseurs de Sun.

Sun, Sun Microsystems,le logo Sun, et Solaris sont des marques déposées ou enregistréesde SunMicrosystems, Inc. aux Etats-Unis et dans
d’autrespays. Toutesles marques SPARC,utiliséessous licence, sont des marques déposées ou enregistrées de SPARCInternational, Inc. aux
Etats-Unis et dans d’autres pays. Les produits portant les marques SPARCsont basés sur une architecturedéveloppée par Sun Microsystems,
Inc.

Les utilisateurs d’interfaces graphiques OPEN LOOK® et Sun™ ont été développés de Sun Microsystems, Inc. pour ses utilisateurs et licenciés.
Sun reconnaît les efforts de pionniers de XeroxCorporation pourla rechercheet le développement du concept des interfaces d’utilisation
visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xeroxsur l’interface d’utilisation graphique,
cette licence couvrant aussi les licenciés de Sun qui mettent en place les utilisateurs d’interfaces graphiques OPEN LOOK et qui en outre se
conforment aux licences écrites de Sun.

CETTE PUBLICATIONEST FOURNIE "EN L’ETAT"SANS GARANTIE D’AUCUNE SORTE, NI EXPRESSE NI IMPLICITE, Y COMPRIS, ET
SANS QUE CETTE LISTE NE SOIT LIMITATIVE,DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DES
PRODUITS A REPONDRE A UNE UTILISATIONPARTICULIERE OU LE FAITQU’ILS NE SOIENT PASCONTREFAISANTSDE PRODUITS
DE TIERS.

Please
Recycle

Please
Recycle

Please
Recycle

Contents

1. Sun HIPPI Overview 13

Feature Summary 13
HIPPI Conformance 14

2. Installing the Sun HIPPI Adapter 15

Device Instances and Device Names 15
Inventory Items 16
Installing Sun HIPPI PCI Cards 16
Connecting Fiber-Optic Cables 18
Cleaning the Fiber-Optic Cable 19

3. Installing the Sun HIPPI Software 21

Declaring IP Addresses for Sun HIPPI 21
Removing Conflicting Packages 22
Installing and Configuring Sun HIPPI 22

Loading and Mounting the CD-ROM 22
Installing Sun HIPPI By Using pkgadd 23

Installing the Device Driver (SUNWhip)24
Installing the Online Documentation (SUNWhipmn)28
Installing the Developer Utilities (SUNWhipc)28

Contents iii

Finishing the Installation 28
Verifying the Installation 29

Deinstalling Sun HIPPI 30

Stopping the Driver 30
Unloading HIPPI Drivers 31
Removing Sun HIPPI 31

4. Configuring the Sun HIPPI Interface 33

High Performance HIPPI Networks 33
Data Throughput Improvement 33
Improving Performance 34

Changing the High Water Marks 34
Tuning the High Water Mark 35
Tuning Window Scaling 36
Tuning the Congestion Window Maximum 36
Tuning the High and Low Water Marks at Boot Time 36
Tuning the Socket Options 37

5. Troubleshooting and Diagnostics 39

Troubleshooting Checklist 39

Checking the MAC Address 39
Checking the Sun HIPPI Driver 40
Checking the IP Addresses 40
Checking the IP Routing 41
Checking the Protocol Statistics 41
Checking HIPPI Operation 42

Solving Common Problems 43
Loading the Device Driver Manually (Solaris 2.x)44

iv Sun Enterprise 10000 Dynamic Reconfiguration User’s Guide • May 1999

6. HIPPI Network Architecture 47

Introduction to HIPPI Networking 47
Network Architecture 47

Switched Network Topology 48
I-Field 48
Framing Protocol 50

HIPPI Network Model 50
HIPPI Network Configuration 51
HIPPI Performance 52

7. Using the Sun HIPPI Network Utilities 55

Changing the Default MAC Address 55
Using the Sun HIPPI Device Driver Utilities 57

Displaying Sun HIPPI Statistics (hippistat)58

Contents v

vi Sun Enterprise 10000 Dynamic Reconfiguration User’s Guide • May 1999

Figures

FIGURE 2-1 HIPPI PCI Card 17
FIGURE 2-2 Aligning SC Type Fiber-Optic Cable Connectors 19
FIGURE 2-3 Cleaning the End of a Fiber-Optic Cable 20
FIGURE 6-1 I-Field 49
FIGURE 6-2 HIPPI Architectural Model 51
FIGURE 6-3 Basic HIPPI Point-to-point Configuration 51
FIGURE 6-4 HIPPI Network Configuration Using a Switch 52

Figures vii

viii Sun Enterprise 10000 Dynamic Reconfiguration User’s Guide • May 1999

Preface

The SunHIPPI 1.0 User’s Installation Guide provides instructions for the Sun™ HIPPI
adapter supported by the Sun HIPPI software. This manual also describes how to
install and configure the Sun HIPPI software.

The instructions in this manual are designed for a system administrator with
experience installing similar software and hardware.

How This Book Is Organized

The SunHIPPI 1.0 User’s Installation Guide is organized as follows:
Chapter 1 describes the Sun HIPPI implementation of the HIPPI protocols and

includes a list of the specifications to which it conforms.
Chapter 2 provides detailed instructions on how to install your Sun HIPPI PCI card

in your machine and describes how to connect the HIPPI cable.
Chapter 3 describes how to install the Sun HIPPI device driver and utilities on

machines running a Solaris™ 2.6 or 7 environment.
Chapter 4 describes the configurable network parameters and provides general

advice on how to obtain the best performance from your network.
Chapter 5 tells you how to detect and resolve problems with your HIPPI network.
Chapter 6 provides an overview of the HIPPI network model and describes how

HIPPI networks operate.
Chapter 7 describes the network utilities delivered with Sun HIPPI and tells you

how to use them to recover network statistics.
Appendix A contains a list of common questions and their responses.

ix

Appendix B describes how to create applications that run over Sun HIPPI, using the
DLPI interface for a Solaris environment.

Using UNIX Commands

This document does not contain information on basic UNIX commands and
procedures such as shutting down the system, booting the system, and configuring
devices.

See one or more of the following for this information:

■ Solaris Handbook for Sun Peripherals

■ AnswerBook online documentation for the Solaris software environment

■ Other software documentation that you received with your system

Typographic Conventions

TABLEP-1 Typographic Conventions

Typeface Meaning Examples

AaBbCc123 The names of commands, files,

and directories; on-screen
computer output

AaBbCc123 What you type, when

contrasted with on-screen
computer output

AaBbCc123 Book titles, new words or terms,

words to be emphasized

Command-line variable; replace
with a real name or value

x SunHIPPI 1.0 User’s Installation Guide • March 1999

Edit your .login file.
Use ls -a to list all files.

% You have mail.

% su
Password:

Read Chapter 6 in the User’s Guide.
These are called class options.
You must be superuser to do this.

To delete a file, type rm filename.

Shell Prompts

TABLEP-2 Shell Prompts

Shell Prompt

C shell machine_name%
C shell superuser machine_name#
Bourne shell and Korn shell $
Bourne shell and Korn shell superuser #

Related Documentation

TABLEP-3 Related Documentation

Application Title

Programming HIPPI Character Device Interface User’s Guide and Reference Manual

Sun Documentation on the Web

The docs.sun.comsmweb site enables you to access Sun technical documentation
on the Web. You can browse the docs.sun.com archive or search for a specific book
title or subject at:

http://docs.sun.com

xi

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments
and suggestions. You can email your comments to us at:

[e-mail]
Please include the part number of your document in the subject line of your email.

xii SunHIPPI 1.0 User’s Installation Guide • March 1999

CHAPTER

1

Sun HIPPI Overview

This chapter describes the Sun HIPPI (High Performance Parallel Interface)
implementation of the HIPPI protocols, including a list of the ANSI/HIPPI
standards to which it conforms. See Chapter 6 “HIPPI Network Architecture” for
more information on HIPPI architecture.

1.1 Feature Summary

The Sun HIPPI PCI Adapter 1.0 is a combination of hardware and software that adds
HIPPI networking support to your system.

Sun HIPPI is a high-speed networking product that provides significantly greater
bandwidth (up to 80 times) compared to 10-megabit Ethernet networks. It is
designed for SPARC™ system architectures running the Solaris 2.6 or Solaris 7
operating environment.

Sun HIPPI does the following:

■ Provides connection to multimode fiber networks

■ Supports data transfer rates of up to 100 MBps or 800 Mbps

■ Provides full support for existing SunOS™ 5.x operating system network services

and utilities

■ Provides power-up self test and system diagnostic tests

■ Supports up to four Sun HIPPI PCI cards installed in one machine

1-13

1.2 HIPPI Conformance

Sun HIPPI conforms to the following standards and specifications:

■ ANSI X3.183-1991 - Physical sublayer

■ ANSI X3.222-1993 - Framing protocol

■ ANSI X3.218-1993 - Link encapsulation

■ PCI specification, revision 2.1, part number 802-2387-02

■ RFC 1374 - IP and ARP on HIPPI

1-14 SunHIPPI 1.0 User’s Installation Guide • March 1999

CHAPTER

2

Installing the Sun HIPPI Adapter

This chapter tells you where to find step-by-step procedures for installing PCI cards.
It describes the convention used to assign device names to Sun HIPPI PCI cards, and
tells you how to connect fiber-optic cables.

Caution – For your personal safety and to protect your machine, observe the

following precautions when you install a PCI card in a SPARC workstation or server.

Before opening your machine, always ensure that the power switch is off
(O position). When the power is off, the green light on the front of the machine is
unlit and the fan in the power supply is not running. Always take care to protect
your equipment from the effects of static electricity.

Be sure to wear a wrist strap when performing any of these procedures.

2.1 Device Instances and Device Names

You can install a Sun HIPPI PCI card in any available PCI slot. Sun HIPPI supports
up to four Sun HIPPI PCI cards installed in one machine.

Sun HIPPI PCI cards are assigned device names of the form hipipinst, where the
instance number inst is determined by the number and relative positions of the cards
installed. When you install a Sun HIPPI card in your machine for the first time, it
has instance number 0 and a device name hipip0. If multiple cards are installed, the
device name hipip0 is associated with the card in the lowest numbered slot, the
device name hipip1 is associated with the card in the next higher numbered slot,
and so on.

Refer to the hardware installation manual that came with your system for detailed
instructions on how to identify the PCI slots in your machine.

2-15

Note – For a machine running the Solaris environment, if a Sun HIPPI PCI card is

moved from its initial slot to a different one, the operating system will find the
device in the new slot and assume that it is a new instance of the device. As a result,
the operating system will assign the next instance number to it and there will appear
to be two devices installed in the machine.

2.2 Inventory Items

Before proceeding with the installation, make sure you have received the following
items:

■ One Sun HIPPI PCI adapter

■ Disposable grounding wrist strap

■ CD-ROM containing Sun HIPPI software

■ 15-meter cable

■ SunHIPPI 1.0 User ’s Installation Guide

Contact your sales representative if any of these items are missing.

2.3 Installing Sun HIPPI PCI Cards

Caution – The Sun HIPPI PCI card is sensitive to static electricity. Always use the

wrist strap supplied with Sun HIPPI when handling the card and ensure that the
wrist strap is properly grounded. Handle the Sun HIPPI PCI card by the edges, and
avoid touching any of the components.

1. Confirm that your system supports 33-Mhz PCI operation, which is required for
this HIPPI PCI card.

2. Attach a properly grounded antistatic strap to your wrist.

3. Remove the PCI card from the antistatic bag.

Caution – Handle circuit cards only while wearing a properly grounded wrist

strap. This prevents potential damage to the card from static electricity.

2-16 SunHIPPI 1.0 User’s Installation Guide • March 1999

4. Remove covers and boards as required to access the PCI slots in your system.

Refer to the hardware installation manual that came with your system for detailed
instructions on how to access the PCI slots in your machine.

5. Select a PCI slot and remove the lock-down screw securing the PCI cover plate.

6. Remove the cover plate.

7. If used, confirm that the riser card in your system is 5 volts.

Riser cards have etches noting the voltages. Also, riser cards are keyed to prevent
damage.

8. Install the PCI card into the selected slot.

Refer to the hardware installation manual that came with your system for detailed
instructions on how to install a PCI card in your machine.

9. Confirm that the card is firmly installed into the PCI connector then secure the
card with the lock-down screw.

10. Replace all covers and boards as required.

Note – There are no user-configurable jumpers or switches on the Sun HIPPI PCI

card. Altering any of the components on the card can affect its operation adversely
and will render any product warranty void.

FIGURE 2-1 HIPPI PCI Card

Chapter 2 Installing the Sun HIPPI Adapter 2-17

2.4 Connecting Fiber-Optic Cables

Fiber-optic cable is fragile and should not be subjected to mechanical stress or
impact. Always observe the following precautions when handling fiber-optic cable
and connectors:

■ Fiber-optic cable connectors consist of a ceramic or steel ferrule through which

the optical fiber passes. Do not touch the tip of the ferrule, as marring or
depositing oil or dirt on its delicate surface will destroy its ability to transmit
light.

■ Use the protective caps provided on the fiber-optic cable connectors and optic

data links whenever the cable is not connected.

■ Fiber-optic cable has a limited turn radius. Do not bend it in a way that could

damage the fiber or cause signal loss.

1. Unpack the cable, remove the plastic protective caps from each end, and remove
the cap from the transceiver unit on the card.

2. Make sure the fiber-optic cable is properly oriented with its connector on the Sun HIPPI card.

Most fiber-optic cables have raised keys on one side of the connectors. There are also
keyway notches on the inside of the connector on the card; the fiber-optic cable
should be oriented so that the keys on the cable connectors line up with the keyway
notches on the card (

FIGURE 2-2).

Caution – Some cables do not possess raised keys to help you properly orient the

connection. When installing the cables, verify the source on one end of the cable
connects to the destination on the other end of the cable.

2-18 SunHIPPI 1.0 User’s Installation Guide • March 1999

Keys

Port A

FIGURE 2-2 Aligning SC Type Fiber-Optic Cable Connectors

3. Once you have verified that the fiber-optic cable and the connector on the Sun
HIPPI card are properly oriented (see caution statement), insert the cable into the
card connector.

You should hear a distinctive click sound, indicating that the cable is properly mated
with the card connector.

Port B

A B

2.5 Cleaning the Fiber-Optic Cable

Fiber-optic cable connectors can be cleaned if they become contaminated with dirt,
dust or oil, which can cause signal noise on the network.

1. Gently wipe the end of the ferrule with an alcohol-moistened cotton swab.

Chapter 2 Installing the Sun HIPPI Adapter 2-19

FIGURE 2-3 Cleaning the End of a Fiber-Optic Cable

2. Blow clean, dry compressed air around the end of the connector and around the
ferrule to dislodge loose dust and grit.

3. Clean the adapter by moistening the end of a pipe cleaner in alcohol and running
the pipe cleaner though the adapter.

Repeat with a dry pipe cleaner.

4. Blow the adapter with clean, dry compressed air again to finish drying the clean adapter.

2-20 SunHIPPI 1.0 User’s Installation Guide • March 1999

CHAPTER

3

Installing the Sun HIPPI Software

This chapter tells you how to install the Sun HIPPI device drivers and utilities in a
Solaris 2.6 or Solaris 7 operating environment. It includes instructions on how to
check your installation and how to remove the Sun HIPPI software, if necessary.

TABLE3-1 Installation Requirements

Requirements Description

Hardware and
Software Platforms

Disk Space 2300 KBytes of disk space to install Sun HIPPI in a Solaris

Host names and IP
Addresses

SPARC system architectures (32 Mbytes RAM minimum) running a
Solaris 2.6 or Solaris 7 operating environment.

environment.
A unique host name and IP address for each Sun HIPPI device

installed in your machine. If you are installing more than one
interface in a single machine, each interface must be connected to a
different subnet of a network.

3.1 Declaring IP Addresses for Sun HIPPI

The files on your NIS/NIS+ server must be updated before installing the Sun HIPPI
software.

● Update the files on your NIS/NIS+ server to assign IP addresses and host names

for the Sun HIPPI interfaces that you are going to configure.

If you are not using an NIS/NIS+ name service, update the /etc/inet/hosts file
on each machine in the network to add the IP addresses and host names of the hosts
attached to the HIPPI network. See the hosts(4M) man page for additional
information.

3-21