400
CommKit Host Interface Release 4.4 AT&T 3B2 RISC Computer Systems Installation and Administra- tion Guide 255-110-127 Issue 3 September 1995 1

cov - Unixwiz.net · 2014. 8. 4. · Title: cov Author: chemist Created Date: 6/3/1997 8:50:53 AM

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

  • CommKit Host InterfaceRelease 4.4AT&T 3B2 RISC ComputerSystemsInstallation and Administra-tion Guide

    255-110-127Issue 3

    September 1995

    1

  • Additional Information

    Copyright 1995 AT&T

    All Rights Reserved

    Printed in USA

    Federal Communications Commission StatementThis equipment generates, uses, and can radiate radio frequency energy and if not installed and usedin accordance with the instruction manual, may cause interference to radio communications. It hasbeen tested and found to comply with the limits for a Class A computing device pursuant to Subject Jor Part 15 of FCC rules.

    TrademarksCommKit® is a registered trademark of AT&T.Datakit® is a registered trademark of AT&T.UNIX® is a registered trademark of Novell, Incorporated in the United

    States and other countries, licensed exclusively through X/Open Company, Ltd.Polywater® is a registered trademark of American Polywater Company.Hydralube Blue® is a registered trademark of Arnco Equipment Company.Imagen is a registered trademark of Imagen Corp.PostScript is a registered trademark of Adobe Systems Inc.

    Ordering InformationAdditional copies of this document can be ordered by calling:

    U.S.A.: 1-800-432-6600 Canada: 1-800-255-1242 Other Areas: 1-317-352-8557

    or, by writing to: AT&T Customer Information CenterAttn: Customer Service RepresentativeP.O. Box 19901Indianapolis, IN 46219

    Additional Information 1-1

  • Table of Contents

    1 IntroductionGeneral 1-1Description 1-2Host Access 1-2User Features 1-2Local/Remote Login 1-2File/Directory Transfer 1-3Remote Execution 1-3

    Administrative Features 1-3Security 1-3Services 1-3Installation and Removal 1-5Configuration and Maintenance 1-5Print Spoolers 1-5uucp Services 1-5File Sharing 1-5

    Development Features 1-6Fiber Optic Link 1-6General Server 1-6High Performance Application Library 1-6Network Independent Application Library 1-6

    Document Overview 1-6Reference Documentation 1-7Glossary of Terms 1-9Display Conventions 1-9Format Conventions 1-10CommKit Host Interface Software Release/UNIXSystem Version Information 1-10

    Equipment Description 1-11Host Interface Module 1-11CPM-HS Module and Paddle Board 1-12Fiber Optic Cable 1-13Cartridge Tapes 1-14Software Certificate 1-14

    Table of Contents i

  • Table of Contents

    Customer Assistance 1-14Manual Pages 1-15

    Format 1-16

    2 Installation/RemovalPreparation 2-1Overview of Initial Installation 2-2Install the CommKit Host Interface Software 2-2

    Pre-Installation Procedures 2-3Initial Installation Procedures 2-4Non-Prompted Mode (_dkhost_parms File) 2-4General Installation 2-6Detailed Installation 2-7Upgrade Procedures 2-11

    Install the CommKit TLI Package 2-16Install Host Interface Hardware 2-17

    Procedure 2-17Install the CPM-HS Module in the Data Switch Node 2-21Route the Fiber Optic Cable 2-22

    General 2-22Tools and Hardware 2-23Conduit Installation 2-23

    Connect the Fiber Optic Cable 2-24Configure the Data Switch Control Computer

    Database 2-25Define Group Name 2-26Define Address for dkserver Service 2-27Define Address for the Listener 2-28Configure the CPM-HS Module 2-30

    Run Diagnostics on Host Interface Module 2-31Diagnostic Phases 2-32

    Verify Operation 2-34Verify the Operation of the dkdaemon Process 2-35Verify the Operation of the dkserver Process 2-36Verify Data Transfer Across the Interface 2-41Verify Terminal Login Across the Interface 2-42Verify Operation of the Remote Login Facility 2-43

    ii Table of Contents

  • Table of Contents

    Customize the Control Tables and dkitrc 2-44Where To Go From Here 2-45

    Remove the CommKit TLI Package 2-45Remove the CommKit Host Interface Software 2-46

    Non-Prompted Mode (_dkhost_parms File) 2-47Prompted Mode 2-48

    3 Control TablesIntroduction 3-1Overview of Control Tables 3-1

    Data Switch Dialstrings 3-2Examples 3-5

    dkhosts 3-7Destination Mapping 3-10

    dkgroups 3-13srvtab 3-15

    Server Table 3-16System Field 3-17.user Suffix 3-18

    Service Field 3-18– 3-19* 3-19authorize 3-19dkload 3-20do 3-20login 3-20pupu 3-20rl 3-20rx 3-21uucp 3-21whoami 3-21

    Flags Field 3-21User Field 3-24Program Field 3-26Initial Parms Field 3-26Server Table Scanning Rules 3-28Modifications to the Server Table 3-28Server Table Validation and Matching 3-28

    Group.user Facility 3-29

    Table of Contents iii

  • Table of Contents

    User ID Mapping Rules 3-30Transparent User ID Mapping 3-30Translated User ID Mapping 3-31Fixed User ID Mapping 3-31Restrictive User ID Mapping Ranges 3-32

    Trapping Incoming Calls 3-34Unauthorized Service Requests 3-35

    Spawning a TLI Application 3-36Server Table Entries Which Are Not Secure 3-38Directory Mode for /etc/opt/dk/srvtab 3-40Summary 3-41

    dkdotab 3-42dkuidtab 3-44

    4 AdministrationIntroduction 4-1Administrative Notes 4-1

    UNIX System V Release 4 4-1Files That Grow 4-3dkitrc Script File 4-4Linking of Host Interface Files 4-7Special Device Files 4-8Configuring uucp with d or g Protocol 4-10Configuring Tables for Originating Calls 4-10Configuring Tables for Receiving Calls 4-14

    Using TLI Support 4-14Configure netconfig File 4-15Configure a Listener 4-15Starting the Listener 4-17Stopping the Listener 4-17Verifying the Listener 4-18Manually Restart the Port Monitor and Listener

    Service 4-19Configure Multiple Listeners 4-19Configure Multiple TLI Interfaces 4-20Configuring RFS to Use TLI 4-21Configuring uucp to Use TLI 4-23Other TLI Applications 4-26

    iv Table of Contents

  • Table of Contents

    Changing the Hardware Configuration After theInitial Installation 4-27

    Changing the Number of Channels 4-28Troubleshooting Facilities 4-29

    Software Troubleshooting Procedures 4-29Troubleshooting the Host Interface Communication 4-32Reading Status and Statistics 4-34

    Diagnostics 4-353B2 Computer Diagnostics 4-35Data Switch Control Computer LooparoundDiagnostics 4-36Local_loop 4-36Remote_loop 4-37

    CommKit Host Interface Error Messages 4-38Console Error Messages 4-38Hardware Error Messages 4-39Software Error Messages 4-40Server Error Messages 4-41

    Outgoing Call Error Messages 4-42Printer Administration 4-50

    Sharing a Printer on a Data Switch Network 4-51Printer Configurations 4-52Configuration 1: Connection to a Local Host 4-52Configuration 2: Connection to a Data Switch Node;

    Spooling Host Using Fiber 4-53Configuration 3: Connection to a Data Switch Node;

    PDD Connections 4-54Configuration Procedures 4-55Remote Host Configuration 4-55Spooling Host Configuration Procedures 4-57Data Switch Configuration Procedures 4-62

    Troubleshooting Printer Problems 4-64Printer Problems 4-65dkdo Problems 4-66dkcat Problems 4-67

    Printer Flow Control 4-69lp Subsystem Problems 4-69

    CommKit Host Interface Exit Codes 4-69

    Table of Contents v

  • Table of Contents

    5 CompatibilityIntroduction 5-1Environment Variables Compatibility 5-1

    DKINTF 5-2DKGROUP 5-3

    User-Level Compatibility 5-3dk 5-4dkcat 5-5dkcu 5-5dkdo 5-5push and pull 5-5

    Programmer-Level Compatibility 5-7STREAMS 5-7TTY Interface 5-7Message Boundaries 5-8Header Files 5-8Library Interface Compatibility 5-9Obsolete Library Routines 5-9Supported Library Routines 5-10

    System Call Compatibility 5-15open(2) 5-15read(2) 5-16write(2) 5-16poll(2) 5-17close(2) 5-17ioctl(2) 5-18

    Examples 5-20dk_info Example 5-21dkitdial Example 5-22dk_namer Example 5-24dk_tnamer Example 5-24dk_xnamer Example 5-25dkgos Example 5-26dkleveld Example 5-27dksplice Example 5-28isdkclosed, isdkeof, and isdkleveld Example 5-29poll Example 5-32

    vi Table of Contents

  • Table of Contents

    6 Manual PagesDK 6-1DKAUTH 6-6DKCAT 6-14DKCU 6-15DKDO 6-19PULL 6-21PUSH 6-23AUTHORIZE 6-26DKDAEMON 6-29DKDEVS 6-37DKIPUMP 6-39DKITRC 6-40DKLOAD 6-41DKMAINT 6-44DKREGISTER 6-46DKSERVER 6-47DKSRVERR 6-51DKSTAT 6-54DKUNLOCK 6-59DK_FLUSH 6-60DK_INFO 6-62DK_NAMER 6-64DK_UXINFO 6-65DKDIAL 6-67DKEPOINT 6-72DKERR 6-74DKGOS 6-81DKLEVELD 6-83DKMGR 6-86DKSPLICE 6-93DKSPLWAIT 6-96DKTSPLICE 6-98DKURPCTL 6-100DKXENVIRON 6-101MAPHOST 6-102

    Table of Contents vii

  • Table of Contents

    DKACCT 6-104DKAUDIT 6-106DKDOTAB 6-109DKGROUPS 6-111DKHOSTS 6-113DKSRVLOG 6-115DKUIDTAB 6-117SRVTAB 6-118DKHS 6-127DKMX 6-130DKPE 6-131DKTLI 6-132DKTY 6-134DKUX 6-137DKXQT 6-140

    I IndexIndex I-1

    viii Table of Contents

  • Figures

    Figure 1-1: Data Network 1-1Figure 1-2: Logical Connectivity 1-4Figure 1-3: Host Interface Module 1-11Figure 1-4: CPM-HS Module and Paddle Board 1-12Figure 1-5: Fiber Optic Cable (Dual Cable Shown) 1-13Figure 2-1: Install Software – Initial Dialogue Example 2-7Figure 2-2: 3B2/500 Cabinet Backplane Slots 2-17Figure 2-3: 3B2/600 Cabinet Backplane Slots 2-18Figure 2-4: Inserting the Host Interface Board 2-19Figure 2-5: Host Interface Board Installed 2-20Figure 2-6: Typical Rear View of a Data Switch Cabinet 2-21Figure 2-7: Typical Front View of a Data Switch Cabinet 2-22Figure 2-8: Fiber Cable Connections 2-25Figure 2-9: CommKit Software Removal – srvtab as a Directory 2-49Figure 2-10: Typical Customizing Files Screen 2-50Figure 3-1: Server Table Fragment .user Example 3-29Figure 4-1: Device Number Partitioning (16 bits) 4-8Figure 4-2: verify Commands 4-31Figure 4-3: Printer Directly Attached to One Host 4-52Figure 4-4: Network-Connected Printer; Spooling Host Using dkcat 4-53Figure 4-5: Network-Connected Printer Using PDD 4-54Figure 4-6: Sample model File 4-58Figure 5-1: dk_info Example 5-21Figure 5-2: dkitdial Example 5-23Figure 5-3: dk_namer Example 5-24Figure 5-4: dk_tnamer Example 5-25Figure 5-5: dk_xnamer Example 5-25Figure 5-6: dkgos Example 5-26Figure 5-7: dkleveld Example 5-28Figure 5-8: dksplice Example 5-29Figure 5-9: isdkclosed, isdkeof, isdkleveld Example 5-31Figure 5-10: poll Example 5-33

    Table of Contents ix

  • Tables

    Table 1-1: UNIX System Documentation 1-7Table 1-2: AT&T Host Interface Documentation 1-7Table 1-3: AT&T Data Switch Documentation 1-8Table 1-4: CommKit Host Interface Software Release/UNIX System Version 1-10Table 2-1: Installation/Removal Procedures – Shell Variables 2-4Table 2-2: Diagnostic Phases 2-32Table 3-1: Server Table Flags 3-22Table 3-2: User ID Mapping Options 3-25Table 3-3: Program Arguments Specification 3-26Table 3-4: Rejection Code Examples 3-34Table 4-1: UNIX System V Release 4 – New Features 4-2Table 4-2: File Location Changes 4-3Table 4-3: Special Device Files – Example – Two Interface Boards 4-9Table 4-4: Troubleshooting Printer Problems 4-64Table 5-1: Status of Environment Variables 5-2Table 5-2: Supported Library Routines 5-11Table 5-3: Previously Supported ioctl System Calls and Current Status 5-18

    Table of Contents xi

  • 1 Introduction

    General 1-1Description 1-2Host Access 1-2User Features 1-2

    Local/Remote Login 1-2File/Directory Transfer 1-3Remote Execution 1-3

    Administrative Features 1-3Security 1-3Services 1-3Installation and Removal 1-5Configuration and Maintenance 1-5Print Spoolers 1-5uucp Services 1-5File Sharing 1-5

    Development Features 1-6Fiber Optic Link 1-6General Server 1-6High Performance Application Library 1-6Network Independent Application Library 1-6

    Document Overview 1-6Reference Documentation 1-7Glossary of Terms 1-9Display Conventions 1-9Format Conventions 1-10CommKit Host Interface Software Release/UNIX

    System Version Information 1-10

    Table of Contents i

  • Table of Contents

    Equipment Description 1-11Host Interface Module 1-11CPM-HS Module and Paddle Board 1-12Fiber Optic Cable 1-13Cartridge Tapes 1-14Software Certificate 1-14Customer Assistance 1-14

    Manual Pages 1-15Format 1-16

    ii Table of Contents

  • IntroductionGeneral

    This Installation and Administration Guide describes how to install and adminis-ter the AT&T CommKit Host Interface on the AT&T 3B2 RISC Computer System.The host interface consists of hardware and CommKit Host Interface software onyour computer system that provides the high-speed data link to an AT&T dataswitch node. Figure 1-1 shows a typical data switch network.

    Figure 1-1: Data Network

    Fiber OpticCable

    Fiber Optic Cable

    CP

    M-H

    S19

    5AC

    195A

    D3B2Computer

    MC

    A-H

    SM

    CA

    -HS

    NCR3550

    MC

    A-H

    S

    NCR3345

    MC

    A-H

    S

    NCR3450

    MC

    A-H

    S

    NCR3445

    386-

    HS

    StarServerE

    I/VM

    ED

    KH

    S

    StarServerFT 3

    86-H

    S

    6386

    Terminal Printer

    RS-232Cable

    TerminalFiber Optic Cable

    RS-232Cable

    RS-232Cable

    TY-1

    2

    CP

    M-H

    S

    TRK

    -HS

    CP

    M-H

    S

    CP

    M-H

    S

    CP

    M-H

    S

    CP

    M-H

    S

    TRK

    -HS

    CP

    M-H

    S

    CP

    M-H

    S

    CP

    M-H

    S

    Fiber Optic Cable

    Fiber Optic Cable

    Fiber Optic CableAT&T

    Data SwitchAT&T

    Data Switch

    FiberOpticCable

    FiberOpticCable

    FiberOpticCable

    FiberOpticCable

    Note: Your network may include BNS-1000, BNS-2000, Datakit VCS, and Datakit IIVCS data switches. However, the host interface must be connected to a BNS orDatakit II VCS. Throughout this document, data switch refers to the specific dataswitch to which you are connecting.

    Introduction 1-1

  • Intr

    oduc

    tion

    General

    Description

    The host interface software and hardware allow you to connect your computer toan AT&T data switch. The interface consists of:

    1 . Software installed on the computer

    2 . A host interface module installed in the computer

    3 . A CPM-HS module installed in the data switch.

    The host interface module and CPM-HS are connected with an optical fiber link.

    Host Access

    Most host computers have a limited number of RS-232 connections available;extra ports may become available in groups of 8 or 16 with the addition of portmodules. This can tie up multiple I/O module slots in the host. Using CommKitHost Interface software, you can configure up to 512 channels per fiber interfacemodule. Each channel acts as an RS-232 connection; a user can log into thesechannels from a terminal or other host, or data can be sent to an output devicesuch as a printer.

    As needs change, the number of channels the CommKit Host Interface softwaresupports can be changed with software commands.

    User Features

    The host interface offers features valuable to most users:

    Local/Remote Login

    Users can log on to their local systems or remote systems within a wide area net-work (WAN). Users are no longer locked into a single system or local area net-work (LAN).

    1-2 Introduction

  • IntroductionGeneral

    File/Directory Transfer

    Users can transfer files and directories with a single command. Unlike uutowhich only sends one file at a time, users can easily transfer an individual file ora complete directory structure (with all sub-directories and files) using a singleCommKit Host Interface software command. CommKit Host Interface softwareallows the sending and retrieving of files and directories as a single-step process.And, CommKit Host Interface software allows users to transfer directories acrossthe network with the same command.

    Remote Execution

    Users can execute commands on local or remote systems with a single command.The commands can be standard UNIX system applications, customized user pro-grams, or shell scripts.

    Administrative Features

    The host interface offers several features to help system administrators.

    Security

    CommKit Host Interface software has been designed with security in mind. Itprovides user ID security or transparent user ID mapping security, whichprevents the same user ID on one system from masquerading as another user ona remote system. User commands for file transfer honor and preserve directoryand file permissions. Additionally, administrators can include/exclude specificusers and groups from access to a host computer over the host interface.

    Services

    The CommKit Host Interface software allows the user access to listeneranddkserver services. Access to the dkserver service depends on permissions (ori-ginating group security, refer to Chapter 3) and endpoint (service) addresses.

    Introduction 1-3

  • Intr

    oduc

    tion

    General

    Figure 1-2: Logical Connectivity

    AT&T Data SwitchNetwork

    Host

    Host

    Listener Service

    dkserver Service

    default dkserver Service

    defaultListener Service

    Figure 1-1 illustrates the physical connectivity of the CommKit Host Interfacewithin a data switch network. A logical connectivity schematic is shown inFigure 1-2. To use the CommKit Host Interface services, the administrator mustunderstand the logical connections between host names, server names, andoriginating group security.

    The host name (uname) can connect to listener or other services by defining a dif-ferent server name for each service. Consider the table below:

    _ _______________________________________________________________Orig Orig Dest Dest

    Host Group Host Service Address Comment_ ________________________________________________________________ _______________________________________________________________fish nj/shore/fish bird dkserver nj/shore/bird default dkserverfish nj/shore/fish bird listener nj/shore/BIRD default listenerfish nj/shore/fish bird dkserver nj/shore/plover plover dkserverfish nj/shore/fish bird listener nj/shore/GULL GULL listener_ ________________________________________________________________ _______________________________________________________________bird nj/shore/bird fish dkserver nj/shore/fish default dkserver_ _______________________________________________________________

    _ _______________________________________________________________

    The originating group (of the calling endpoint) is used for security by thedkserver receiving the call. The name used when starting a dkserver or listeneron a receiving host must match an address configured for the CPM-HS or thehost.

    1-4 Introduction

  • IntroductionGeneral

    The CommKit Host Interface services are defined in detail in Chapter 4.

    Installation and Removal

    Administrators will find it easy to install and remove CommKit Host Interfacesoftware because it uses standard facilities and follows conventions establishedby the UNIX system.

    Configuration and Maintenance

    Administrators can reconfigure the number of virtual circuits into a host com-puter with a special dkdaemon application. New services and servers can beadded or removed quickly and easily. The administrator can also monitor thestatus of the interface and perform diagnostics on the hardware.

    Print Spoolers

    Printers can be connected to the network in a variety of ways. In some networks,administrators connect a serial printer to a data switch TY port and access theprinter from a number of hosts.

    uucp Services

    The UNIX Basic Networking Utilities (BNU) can be configured to use CommKitHost Interface software. This allows BNU commands (e.g., cu and uucp) to usethe network. BNU can be configured with one or more error detecting protocolsdepending on the network topography.

    File Sharing

    The remote file sharing (RFS) feature can be configured to use the network. Thisallows administrators to mount UNIX system files from other systems and usethese files on their own system.

    Note: RFS is not supported by the NCR UNIX System.

    Introduction 1-5

  • Intr

    oduc

    tion

    General

    Development Features

    The host interface provides the following features to software developers whowant to make their applications available over networks.

    Fiber Optic Link

    The customer has access to a reliable fiber optic link that offers high throughputand the necessary number of virtual circuits for most applications.

    General Server

    Developers can administer applications with a general purpose server, dkserver.Applications can be written with minimal network considerations. The servermanages network protocol and network security issues.

    High Performance Application Library

    The CommKit Host Interface software library, libdk.so, is delivered as adynamic shared library object module. By writing applications that use the ser-vices of libdk.so, most of the details of the interface can be hidden. These libraryfunctions are described in Chapter 5.

    Network Independent Application Library

    CommKit Host Interface software also supports Transport Layer Interface (TLI).Using this library allows development of applications that can run over othernetworks without modification.

    Document Overview

    This guide is designed for the system administrator and is organized as follows:

    Introduction.

    Installation and Removal – step-by-step hardware and software proceduresand procedures for configuring the CPM-HS on the data switch node.

    1-6 Introduction

  • IntroductionGeneral

    Control Tables – detailed description of building and editing the dkhosts,dkdotab, srvtab, and dkuidtab control tables.

    Administration – instructions for changing the hardware configurations,administering uucp and remote file sharing (RFS), a summary of networkerror messages, and printer sharing procedures.

    Compatibility – information for the current CommKit Host Interfacesoftware release operating with UNIX System V Release 4.0.

    Manual Pages.

    Reference Documentation

    Tables 1-1 through 1-3 list the UNIX system, data switch, and the host interfacedocumentation that are referenced throughout this document.

    Table 1-1: UNIX System Documentation_ ____________________________________________________

    Title ISBN_ ____________________________________________________UNIX System V Programmer’s Guide: STREAMS 013947003-4UNIX System V Programmer’s Reference Manual 013947029-8UNIX System V System Administrator’s Reference Manual 013947011-5UNIX System V System Administrator’s Guide 013947086-7UNIX System V Network User’s and Administrator’s Guide 013933813-6UNIX System V User’s Reference Manual 013947037-9_ ____________________________________________________

    _ ____________________________________________________

    Table 1-2: AT&T Host Interface Documentation________________________________________________________________

    Document Select Code________________________________________________________________255-110-105Datakit II VCS Host Interface for AT&T 6386 WGS Installation and

    Administration Guide________________________________________________________________255-110-115CommKit Host Interface Release 4.0/4.1 AT&T 386/486 Computers

    Installation and Administration Guide________________________________________________________________

    ________________________________________________________________

    Table 1-2: continued on next page

    Introduction 1-7

  • Intr

    oduc

    tion

    General

    Table 1-2: Continued________________________________________________________________

    255-110-123CommKit Host Interface Release 3.3 StarServer FT Installation andAdministration Guide________________________________________________________________

    255-110-124CommKit Host Interface Release 4.2 NCR Series 3000 Computers Installationand Administration Guide________________________________________________________________

    255-110-125CommKit Host Interface Release 4.3 StarServer FT Installation andAdministration Guide________________________________________________________________

    255-110-127CommKit Host Interface Release 4.4 AT&T 3B2 RISC Computer SystemsInstallation and Administration Guide________________________________________________________________________________________________________________________________

    700-283Datakit II VCS Internal Interface Specification________________________________________________________________

    ________________________________________________________________

    Table 1-3: AT&T Data Switch Documentation_ __________________________________________

    Title Select Code_ __________________________________________BNS-1000 Administrator’s Guide 255-180-500BNS-1000 Cabling Guide 255-180-606BNS-1000 Commands Reference 255-180-200BNS-1000 Installation Guide 255-180-100BNS-1000 Messages Reference 255-180-201BNS-2000 Node Reference 255-181-220BNS-2000 System Description 255-181-110Datakit II VCS Administrator’s Guide 255-113-500Datakit II VCS Commands Reference 255-113-200Datakit II VCS Installation Guide 255-113-100Datakit II VCS Planning Guide 255-183-120Datakit II VCS Messages Reference 255-113-201_ __________________________________________

    _ __________________________________________

    1-8 Introduction

  • IntroductionGeneral

    Glossary of Terms

    The following list of acronyms and abbreviations are used in this document:

    General Terms

    BNU Basic networking utilities SAF Service access facilityESD Electrostatic discharge ST Standard tipLAN Local area network TLI Transport layer interfaceNLPS Network layer provider service TPI Transport provider interfaceNSU Networking support utilities Tx TransmitterRFS Remote file sharing URP Universal receiver protocolRx Receiver WAN Wide area network

    Display Conventions

    This document contains sample displays that will help you understand thedescribed procedures.

    Note: The displays in this document may differ from those on your terminalscreen because of product improvements made after this document wascompleted. Your terminal screen accurately reflects the software on yourcomputer.

    In command discussions, user input and computer response examples are shownas follows:

    System generated responses and messages are displayed in constant widthtypeface with variable messages in italic typeface as shown here.

    User input displayed on screen is displayed in constant width boldtypeface as shown here.

    User input of the Delete and Enter keys are shown as follow: Delete Enter

    Simultaneous entry of the control key with another key is shown as follows: Ctrl-d

    The dollar sign is the default UNIX system prompt. The symbol # is the systemprompt for root. In some cases this symbol can indicate a comment line that youmay see when viewing files.

    Introduction 1-9

  • Intr

    oduc

    tion

    General

    The data switch control computer system prompt may be either CC>or CC0>depending on the release.

    Format Conventions

    Throughout this document UNIX and Datakit VCS commands are shown in bolditalic font; CommKit Host Interface commands, process names, program names,and control tables are shown in bold type; file and directory names are shown initalic type. References to man pages are shown in italic typeface [e.g.,dkserver(1M)].

    CommKit Host Interface Software Release/UNIXSystem Version Information

    Table 1-4 lists the current CommKit Host Interface software releases and the sup-ported UNIX system version supported for each release.

    Table 1-4: CommKit Host Interface Software Release/UNIX System Version___________________________________________________________________

    CommKit Host Interface Supported UNIX SystemSoftware Release Version___________________________________________________________________4.0v1, 4.0v2 SVR4.0 versions 1 and 2___________________________________________________________________4.0v3, 4.0v4 SVR4.0 versions 1 and 2.1; SVR4.2 version 1___________________________________________________________________4.1v1, 4.1v2, 4.1v3 SVR4.0 versions 3.0 and 3.1___________________________________________________________________4.2v1, 4.2v2, 4.2v3, 4.2v4 SVR4.0 version 3.0, MP-RAS 2.0, 2.01, 2.02, 2.03, 3.00___________________________________________________________________4.3v1, 4.3v2 SVR4.0 B22ipm10, B22ipm31, B32___________________________________________________________________4.4v1, 4.4v2, 4.4v3 SVR4.0.3, 4.0.4___________________________________________________________________

    ___________________________________________________________________

    1-10 Introduction

  • IntroductionEquipment Description

    To add your computer to the data switch network, the following are required:

    Computer System:

    • Host interface module • Cartridge Tapes

    • Ground Clips • Cable tie

    Data switch node:

    • CPM-HS module • Paddle board • Fiber optic cable

    Host Interface Module

    The host interface module – which is to be installed in the 3B2 computer – con-tains the firmware required for the 3B2 computer to interface with the dataswitch node. Refer to Figure 1-3.

    A cable tie is used to hold the cables securely to the 3B2 computer cabinet toprevent damage to the hardware and fiber optic cable. Ground clips are used toensure the host interface module is properly grounded.

    Figure 1-3: Host Interface Module

    Receive

    Transmit

    Introduction 1-11

  • Intr

    oduc

    tion

    Equipment Description

    CPM-HS Module and Paddle Board

    The CPM-HS module (Figure 1-4) is installed in one of the slots at the front of thedata switch node. The CPM-HS module faceplate has a toggle switch, a reset but-ton, and three LEDs.

    The toggle switch enables/disables the computer from the network

    The reset button resets the CPM-HS module after a fault condition occurs

    The three LEDs give the state of the CPM-HS module.

    The paddle board is installed in the same numbered slot as the CPM-HS moduleat the rear of the data switch. The paddle board has transmit and receive connec-tors for establishing a fiber optic link between the computer system and the dataswitch node. The paddle board contains a loopback/normal mode toggle switch.This switch should be left in the normal position; the loopback position is usedfor local loopback testing.

    Figure 1-4: CPM-HS Module and Paddle Board

    CPM-HS MODULE

    CONNECTOR

    RECEIVERCONNECTOR

    TRANSMITTER

    SWITCHMODE TOGGLELOOP BACK/NORMAL

    PADDLE BOARD

    TOGGLE SWITCH

    FAULT LED

    DISABLE LED

    ENABLE LED

    RESET BUTTON

    1-12 Introduction

  • IntroductionEquipment Description

    Fiber Optic Cable

    Fiber optic cable provides the connection between the computer system and thedata switch node. This thin, lightweight, flexible cable has many advantages overan RS-232 cable, such as:

    Greater bandwidth

    Less noise or crosstalk

    Can be used for longer distances

    More security.

    Figure 1-5 shows the fiber optic cable required to connect the computer to thedata switch node. This fiber optic cable requires standard tip (ST) connectors onboth ends.

    Figure 1-5: Fiber Optic Cable (Dual Cable Shown)

    62.5 MICRON FIBER

    Introduction 1-13

  • Intr

    oduc

    tion

    Equipment Description

    Cartridge Tapes

    The host interface package cartridge tapes hold the software that contains thenetwork interface commands, programs, diagnostics, and utilities that are neces-sary for the host interface to work on your computer system.

    The TLI Support software provides the UNIX system kernel support whichallows you to develop or utilize applications that rely on UNIX system TLI.Examples of applications that rely on TLI are RFS and uucp (specifically the eprotocol).

    Software Certificate

    This release of the CommKit Host Interface software is copy-protected andrequires a Software Certificate Number and Software Key before it can be used.The certificate included with your software contains your certificate number andinstructions for obtaining your personalized software key.

    Customer Assistance

    AT&T offers a complete package of support services to customers needing assis-tance with installation, administration, operation, and maintenance of AT&TData Networking products. These support services are available on either a Con-tract or a Time-and-materials basis.

    For more information on these service offerings, or to establish a service account,contact your AT&T account representative, or call 1-800-WE2-CARE during ourstandard business hours (8AM – 5PM Eastern Time, Monday through Friday,excluding holidays) and ask for the Data Networking Services Operationsdepartment.

    When you need assistance, call 1-800-WE2-CARE during the coverage periodselected when you established your service account. You will need to provideyour Service Account Number and identify the specific AT&T Data Networkingproduct for which you need assistance.

    1-14 Introduction

  • IntroductionEquipment Description

    Outside the United States, AT&T Data Networking products and support ser-vices are provided by AT&T subsidiaries and authorized value-added resellers.For more information, contact your sales representative.

    Manual Pages

    The manual pages are provided at the end of this document as a quick referenceto the CommKit Host Interface software commands.

    The manual pages are divided into four sections each consisting of entriesarranged in alphabetical order.

    _ ________________________________________________Section Classification Description_ ________________________________________________

    1 1C Communications1M Maintenance_ ________________________________________________

    3 3X Miscellaneous Routines_ ________________________________________________4 4 File Formats_ ________________________________________________7 7 Special Files_ ________________________________________________

    _ ________________________________________________

    Section 1C Application Programs – contains communication programswhich reside in the directory /opt/dk/bin.

    Section 1M System Maintenance Commands – contains system mainte-nance programs which reside in /opt/dk/sbin.

    Section 3X Subroutines – describes the binary versions residing in systemlibraries in the directory /usr/lib.

    Section 4 File Formats – describes the structure of kinds of various files:the possible contents of fields; the possible fields in each line.

    Section 7 Special Files – describes the characteristics of each system filethat refers to an input/output device. The names in this section generallyrefer to device names for the hardware, rather than to the names of thespecial files.

    Introduction 1-15

  • Intr

    oduc

    tion

    Manual Pages

    Format

    All entries are based on a common format; some entries may not contain allparts. The parts are listed below.

    NAME gives the name of the entry and briefly states its purpose.

    SYNOPSIS summarizes the use of the command being described. The con-ventions used are:

    _ ___________________________________________________________________Bold typeface Enter these strings literally as they appear.Italic Substitutable argument prototypes, program names,

    files, and directories.[ ] These brackets indicate an optional argument prototype.{ } These brackets around a series of argument prototypes

    indicate one of the arguments is mandatory. When anargument prototype is given as "name" or "file," italways refers to a file name.

    −, +, or = These symbols indicate some sort of flag argument evenif they appear in a position where a filename couldappear._ ___________________________________________________________________

    _ ___________________________________________________________________

    DESCRIPTION describes the command.

    EXAMPLE(S) gives examples of use.

    FILES gives the file names that are built into the program.

    SEE ALSO gives additional references.

    DIAGNOSTICS discusses the diagnostic indications that may be produced.Messages that are self explanatory are not listed.

    WARNINGS points out potential problems.

    BUGS gives known bugs and deficiencies.

    1-16 Introduction

  • 2 Installation/Removal

    Preparation 2-1

    Overview of Initial Installation 2-2

    Install the CommKit Host InterfaceSoftware 2-2Pre-Installation Procedures 2-3Initial Installation Procedures 2-4Non-Prompted Mode (_dkhost_parms File) 2-4General Installation 2-6Detailed Installation 2-7Upgrade Procedures 2-11

    Install the CommKit TLI Package 2-16

    Install Host Interface Hardware 2-17Procedure 2-17

    Install the CPM-HS Module in the DataSwitch Node 2-21

    Table of Contents i

  • Table of Contents

    Route the Fiber Optic Cable 2-22General 2-22Tools and Hardware 2-23Conduit Installation 2-23

    Connect the Fiber Optic Cable 2-24

    Configure the Data Switch ControlComputer Database 2-25

    Define Group Name 2-26Define Address for dkserver Service 2-27Define Address for the Listener 2-28Configure the CPM-HS Module 2-30

    Run Diagnostics on Host InterfaceModule 2-31Diagnostic Phases 2-32

    Verify Operation 2-34Verify the Operation of the dkdaemon Process 2-35Verify the Operation of the dkserver Process 2-36Verify Data Transfer Across the Interface 2-41Verify Terminal Login Across the Interface 2-42Verify Operation of the Remote Login Facility 2-43

    ii Table of Contents

  • Table of Contents

    Customize the Control Tables anddkitrc 2-44Where To Go From Here 2-45

    Remove the CommKit TLI Package 2-45

    Remove the CommKit Host InterfaceSoftware 2-46Non-Prompted Mode (_dkhost_parms File) 2-47Prompted Mode 2-48

    Table of Contents iii

  • Table of Contents

    iv Table of Contents

  • InstallationPreparation

    To add the AT&T 3B2 RISC System computer into an AT&T data switch net-work, you must install the host interface software and hardware into your com-puter, install hardware into the data switch, and make software configurationchanges for the CPM-HS module in the data switch node.

    This chapter shows you how to:

    Install the CommKit Host Interface hardware and software including TLIin your computer.

    Install and configure the CPM-HS module in the AT&T data switch node.

    Remove the CommKit TLI Support package from your computer.

    Remove the CommKit Host Interface software and hardware from yourcomputer.

    This chapter is organized so that you can move from section to section for theprocedures required to install the CommKit Host Interface. Before adding anyhardware or software:

    1 . Verify the correct UNIX System V Release is installed on your AT&T 3B2RISC System computer that supports the current CommKit Host Interfacerelease. See Release Notes for further details.

    2 . Have Datakit II VCS or BNS software loaded on your data switch node.

    3 . Have a small slotted screw driver, a phillips screw driver, and yourcomputer’s user guide available.

    4 . Have your data switch Maintenance Guide, Administrator’s Guide, andCommands Reference Manual available.

    5 . Have the following AT&T HELP telephone numbers available:

    For the CommKit Host Interface and AT&T data switch node orsupport contract information — 1-800-WE2-CARE*

    For 3B2 Computer – 1-800-543-9935

    * To establish a service arrangement and receive support on these products, pleasecontact your local SSC/CSC, your AT&T Sales Representative, or call the Data Net-working Services Operations Group at 1-800-WE2-CARE.

    Installation/Removal 2-1

  • Inst

    alla

    tion

    Overview of Initial Installation

    The procedures for initial installation of the CommKit Host Interface are as fol-lows:

    1 . Install the CommKit Host Interface software and optional TLI Supportpackage on your computer system.

    2 . Configure the CommKit Host Interface board.

    3 . Install the CommKit Host Interface board in the system.

    4 . Install the CPM-HS module in the AT&T data switch node.

    5 . Route the fiber optic cables from the computer system to the data switchnode.

    6 . Connect the fiber optic cable.

    7 . Configure the CPM-HS module in the data switch node.

    8 . Run diagnostics on the CommKit Host Interface board.

    9 . Verify the operation of the hardware and software.

    10 . Customize the control tables.

    Each of these procedures is described in detail in a major heading in this chapter.

    Install the CommKit Host Interface Software

    The CommKit Host Interface software package consists of the CommKit HostInterface software and a new version of the basic networking utilities (BNU).

    Use the command pkginfo -l commkitto determine which version you may havealready installed in your system. The PSTAMP field contains the version.

    To load the software on your computer system, you must have a sufficientnumber of free blocks and inodes in the /etc/opt, /opt, root, /tmp, /usr, and /var/optfile systems. You can determine the amount of free space on your computer sys-tem by executing the df command which shows free inodes as free files.

    2-2 Installation/Removal

  • InstallationInstall the CommKit Host Interface Software

    Approximately 8000 blocks are required in the root file system to rebuild theUNIX System kernel and various configuration files. If /tmp is a separate file sys-tem, it requires approximately 1000 blocks (which will be freed when the installa-tion has been completed). Additionally, approximately 1000 blocks must beavailable in the /usr and 8000 in the /var file systems.

    Pre-Installation Procedures

    Before installing CommKit Host Interface software, you must do the following:

    1 . Review the Software Certificate for details on registering the copy-protected CommKit software. Obtain the CommKit Host Interfacesoftware key before proceeding with the installation.

    2 . Provide the area, exchange, and host name of your system. (This isoptional and is used if you are customizing your server table. If you are,contact your data switch administrator for help with this information.)You will be prompted for this information if you wish to have customiza-tion done automatically to the control files used by dkserver (see srvtab(4))during installation.

    3 . Remove any previously installed CommKit Host Interface software fromyour computer system. (Refer to the section Remove the CommKit HostInterface Software later in this chapter.)

    4 . Install the Networking Support Utilities (nsu) package before proceedingwith the CommKit Host Interface software procedures.

    5 . Decide if you want to install the CommKit Host Interface manual pages.The manual pages take approximately 250 kbytes of disk space under the/usr directory.

    Note: The manual pages are not required for system operation.

    6 . If your base UNIX System does not support the BNU over the AT&T dataswitch network, the software installation will ask if you want to load thenew version of BNU.

    Note: Unless you have installed your own version of BNU which you prefer tokeep, we recommend you install the BNU version included with theCommKit Host Interface software.

    Installation/Removal 2-3

  • Inst

    alla

    tion

    Install the CommKit Host Interface Software

    Initial Installation Procedures

    You can install the CommKit Host Interface Software by following the systemprompts or, for a more streamlined approach, you can create a /etc/_dkhost_parmsfile (described below) specifying all installation parameters. If you use this file,you will not be prompted during installation and removal.

    Non-Prompted Mode ( _dkhost _parms File)

    If you create a file /etc/_dkhost_parms to specify the value of the installationparameters, the installation/removal programs will not prompt for them. Table2-1 lists the shell variables used by the installation/removal procedures.

    Table 2-1: Installation/Removal Procedures – Shell Variables_ ________________________________________________________________________

    Installation_ ________________________________________________________________________Variable Name Valid Value* Description_ ________________________________________________________________________CUSTOMIZE y, n Customize the server table_ ________________________________________________________________________AREA, EXCH, HOST user provided Used for server table customization_ ________________________________________________________________________MAN y, n Install online man pages_ ________________________________________________________________________REMOVE_TABLE_I y, n Remove the current version of tables during

    package installation_ ________________________________________________________________________UUCP y, n Install updated version of uucp commands_ ________________________________________________________________________REMOVE_RC_I y, n Remove the /etc/init.d/dkitrc file during pack-

    age installation

    _ ________________________________________________________________________Removal_ ________________________________________________________________________

    REMOVE_TABLE_R y, n Remove the current version of tables duringpackage removal_ ________________________________________________________________________

    REMOVE_RC_R y, n Remove the /etc/init.d/dkitrc file during pack-age removal_ ________________________________________________________________________

    _ ________________________________________________________________________

    *The installation and removal software looks only for the value y; any other value, including null,will be interpreted as n, that is, do not remove, install, or customize. Any variable not included in the_dkhost_parms file will default to n.

    2-4 Installation/Removal

  • InstallationInstall the CommKit Host Interface Software

    Note: If any of the values AREA, EXCH, and HOST are missing, nocustomization will be done.

    Using the _dkhost_parms file will eliminate Steps 2 through 8 under DetailedInstallation. If this file is used, installation consists of the following:

    1 . Perform the steps under General Installation

    2 . Perform Steps 10 through 12 under Detailed Installation

    3 . Run the dkregister command to enter the Software Certificate numberand Software Key after initial installation and before rebooting the system.

    The installation and removal software will first validate the format of the/etc/_dkhost_parms file. An example of a _dkhost_parms file is shown below:

    # Install the manual pagesMAN=y# Do not install the updated BNU programsUUCP=n# Do not remove current version of customized tables during installationREMOVE_TABLE_I=n# Do not remove current version of customized tables during removalREMOVE_TABLE_R=n# Do not remove /etc/init.d/dkitrc during installationREMOVE_RC_I=n# Do not remove /etc/init.d/dkitrc during removalREMOVE_RC_R=n# Customize the server tableCUSTOMIZE=yAREA=myareaEXCH=myexchHOST=myhost

    This is an example of a _dkhost_parms file that:

    Will install the manual pages online

    Will not install the updated uucp commands

    Will not remove the current version of the customized tables duringpackage installation or removal

    Installation/Removal 2-5

  • Inst

    alla

    tion

    Install the CommKit Host Interface Software

    Will not remove the current version of dkitrc in the /etc/init.d directoryduring package installation or removal

    Will customize the server tables (using myarea, myexch, myhost).

    The variable name must start in the first column; this must be followed by anequal sign; no spaces can be included before or after the equal sign. This must befollowed, in turn, by the value of the variable. Comment lines (starting with #)are allowed. The installation/removal procedure will be terminated if the formator content is invalid. If the /etc/_dkhost_parms file exists, the following messagewill appear:

    The installation parameter file /etc/_dkhost_parms exists.This installation will be run in NON-PROMPTED mode using thevalues specified in this file.

    Hit key within the next 30 seconds if you do not wish toinstall in NON-PROMPTED mode.

    If you hit the Delete key, the following message will appear:

    Installation will be run in PROMPTED mode.

    Do you wish to continue the installation?Enter y or n:

    Enter n if you wish to examine the _dkhost_parms file.

    General Installation

    1 . Log on as root on the console. Throughout the procedures that follow,system prompts and responses are shown in constant width typeface;user entries are shown in bold typeface.

    Note: Press the Enter key after every command you enter.

    2-6 Installation/Removal

  • InstallationInstall the CommKit Host Interface Software

    2 . Insert the cartridge tape in the drive.

    3 . Enter the pkgaddcommand to load the CommKit Host Interface softwarepackage into your computer as shown in Figure 2-1, where:

    -d is an option of pkgaddfor specifying the device option

    commkit is the name of the package being installed.

    4 . For non-prompted installation, continue with Steps 2 and 3 under Non-Prompted Mode.

    5 . For prompted installation, go to the section Detailed Installation.

    Detailed Installation

    If you are not using the /etc/_dkhost_parms file described previously, install theCommKit Host Interface Software as described below:

    1 . Follow the procedures under General Installation.

    Figure 2-1: Install Software – Initial Dialogue Example

    # pkgadd -d /dev/rSA/qtape1 commkit

    Installation in progress. Do not remove the medium.

    Processing package instance from

    CommKit Host Interface to AT&T Data Switch(u3b2v4) 4.4 v3

    Copyright (c) 1995 AT&TAll rights Reserved

    Do you wish to install the manual pages?Enter y or n: yManual pages will be installed.

    Saving file /usr/lib/libdk.so in /usr/lib/libdk.so_predk

    Installation/Removal 2-7

  • Inst

    alla

    tion

    Install the CommKit Host Interface Software

    2 . If you want to install the manual pages, enter y as shown in Figure 2-1.

    Note: The UNIX System is delivered with a BNU package which supportsCommKit, therefore, only the libdk.so file will be saved (underlibdk.so_predk) and restored to its original file name when the CommKitpackage is removed.

    3 . The system asks if you want to customize instances of Area/Exch andArea/Exch/Host in the first and last fields in the files under/etc/opt/dk/srvtab.

    The current server table, /etc/opt/dk/srvtab, contains entrieswith ’Area’, ’Exch’, and ’Host’. These occurrencesshould be changed to the local names for your machine.Would you like this customization to be done automaticallynow? (You will be prompted to supply these local names.)Enter y or n: y

    4 . If you want to customize, enter y and continue with the responses asshown on the following screen:

    Enter Area: myareaEnter Exch: myexchEnter Host: myhostIs this correct: myarea/myexch/myhost ? Enter y or n: y## Processing package information.## Processing system information.

    32 package pathnames are already properly installed.## Verifying disk space requirements.

    Installing CommKit Host Interface to AT&T Data Switch as

    2-8 Installation/Removal

  • InstallationInstall the CommKit Host Interface Software

    ## Installing part 1 of 1./dgn/DKPE/dgn/X.DKPE/etc/master.d/dkhs/etc/master.d/dkmx/etc/master.d/dkpe/etc/master.d/dkty/etc/master.d/dkux/etc/master.d/dkx/opt/dk/bin/dk/opt/dk/bin/dkauth/opt/dk/bin/dkcat/opt/dk/bin/dkcu

    •••

    [ verifying class ]## Executing postinstall script.

    5 . Enter your area, exch, host when directed to do so in the screen above,and then y if the information is correct; n if it is not. You will be promptedfor the information again if you enter n.

    6 . If you do not want to customize the files in /etc/opt/dk/srvtab at this timeenter n and the following screen will appear:

    Reminder: Don’t forget to customize the /etc/opt/dk/srvtab after installation.

    7 . If you answer y, the system will respond with the following:

    Customizing the files under /etc/opt/dk/srvtab...

    All instances of ’Area/Exch’ and ’Area/Exch/Host’ in the first andlast fields in the files under /etc/opt/dk/srvtab have been changed to:myarea/myexch and myarea/myexch/myhost respectively.

    Installation/Removal 2-9

  • Inst

    alla

    tion

    Install the CommKit Host Interface Software

    8 . Enter the Software Certification Number and Software Key whenprompted (see below). If necessary, you can defer entry duringinstallation and manually run the dkregister command later when thevalues are available. Refer to the Software Certificate and dkregister(1M)manual page for details.

    **************************************** CommKit Host Interface Registration ****************************************

    You will now be prompted to enter your Software Certificate Number andand Software Key. These values must be properly entered to unlock thecopy protected CommKit Software. Please refer to the SoftwareCertificate for details on obtaining a Software Key from theWECARE Support Center (1-800-WE2-CARE).

    You can continue without entering the values by typing "q" atthe appropriate prompt. If you bypass entry of the SoftwareCertificate Number and Software Key at this time, you mustmanually run the dkregister command before the CommKit Softwaremay be used.

    Please enter your Software Certificate Number.Certificate number (enter "q" to quit) > xxxxxx-xxxxxx-xxxx

    You entered "XXXXXX-XXXXXX-XXXX". Is this correct (y/n/q)? y

    Please enter your Software Key.Software Key (enter "q" to quit) > xxxxx-xxxx-xxxx-xxxx

    You entered "XXXXX-XXXX-XXXX-XXXX". Is this correct (y/n/q)? y

    2-10 Installation/Removal

  • InstallationInstall the CommKit Host Interface Software

    Registration Completed Successfully

    Updating /etc/ttysrchUpdating edittbl

    Installing dkpe moduleInstalling dkhs moduleInstalling dkux moduleInstalling dkty moduleInstalling dkx moduleInstalling dkmx module

    Installation of was successful.

    *** IMPORTANT NOTICE ***If installation of all desired packages is completethe machine should be rebooted in order toensure sane operation. Execute the shutdowncommand with the appropriate options and wait forthe "Console Login:" prompt.

    9 . The software installation is now complete.

    10 . Remove the cartridge tape.

    11 . If you will be installing TLI, proceed to the section Install the CommKit TLIPackage, otherwise, enter the following commands to shut down thesystem so you can install the host interface board in your computer:

    # cd /# shutdown -y -g0 -i0

    Upgrade Procedures

    If you have a version of the CommKit Host Interface software installed on yourcomputer and you want to install a later version, you must perform the follow-ing procedures.

    Installation/Removal 2-11

  • Inst

    alla

    tion

    Install the CommKit Host Interface Software

    1 . Log on as root on the console.

    Note: Press the Enter key after every command you enter.

    2 . Remove the TLI package if it is installed (refer to the section Remove theCommKit TLI Package later in this chapter).

    3 . Remove the CommKit Software (refer to the section Remove the CommKitHost Interface Software later in this chapter).

    4 . Continue with Steps 2 and 3 under General Installation.

    5 . Continue with Steps 2 and 3 under Detailed Installation.

    6 . If you want to customize instances of Area/Exch and Area/Exch/Host inthe first and last fields in the /etc/opt/dk/srvtab files, enter y as shown inStep 4 under Detailed Installation.

    7 . If you saved the customized tables (dkhosts, dkdotab), and the servicefiles under /etc/opt/dk/srvtab directory during removal of the previousrelease of the CommKit Host Interface software, the following will bedisplayed:

    Do you want to retain your current versions of files /etc/opt/dk/dkhosts,/etc/opt/dk/dkdotab, /etc/opt/dk/dkgroups, andall files under /etc/opt/dk/srvtab directory (y or n)?

    If your srvtab file is a regular file, the following is displayed instead:

    Do you want to retain your current versions of files /etc/opt/dk/dkhosts,/etc/opt/dk/dkdotab, /etc/opt/dk/dkgroups, and/etc/opt/dk/srvtab (y or n)?

    8 . If the saved files are different than the ones on the machine, the new ver-sion of control tables will be installed under the same name with the suffix_4xvX. This gives you the opportunity to compare the delivered files withyour own version of the files. These files are /etc/opt/dk/dkdotab_4xvX,/etc/opt/dk/dkhosts_4xvX, /etc/opt/dk/dkgroups_4xvX, and files with the suffix

    2-12 Installation/Removal

  • InstallationInstall the CommKit Host Interface Software

    _4xvX under /etc/opt/dk/srvtab directory. If your /etc/opt/dk/srvtab is a regu-lar file, the delivered files will be installed in the /etc/opt/dk/srvtab_4xvXdirectory.

    Note: /etc/opt/dk/dkgroups is introduced in Release 4.4v3; during anupgrade from an earlier version, the system will install a defaultdkgroups file.

    Once you have finished comparing and making changes to your files, youshould remove the suffix files (_4xvX) to insure a clean removal of thesoftware if you ever wanted to remove the interface.

    Note: The suffix _4xvX (where xvX represents the release and version number;e.g., _44v2) used for the delivered files will change for each new releaseor version of the CommKit Host Interface software.

    Note: If a control table file has not changed, the system will not create a _4xvXfile for that file. If you do not see a _4xvX version of a file, it means thatthe new control table file was identical to the old version which was,therefore, not saved.

    9 . If you saved the /etc/init.d/dkitrc file during the removal of the previousrelease of CommKit Host Interface software, the following will bedisplayed:

    Do you want to retain your current version of /etc/init.d/dkitrc (y or n)?

    If you answer y, the file /etc/init.d/dkitrc will not be overwritten and thedelivered file will be installed as /etc/init.d/dkitrc_4xvX. This allows youto compare your version with the delivered file.

    10 . The system will then respond with messages similar to the following:

    Installation/Removal 2-13

  • Inst

    alla

    tion

    Install the CommKit Host Interface Software

    ## Processing package information.## Processing system information.

    29 package pathnames are already properly installed.## Verifying disk space requirements.

    Installing CommKit Host Interface to AT&T Data Switch as

    ## Installing part 1 of 1./dgn/DKPE/dgn/X.DKPE/etc/master.d/dkhs/etc/master.d/dkmx/etc/master.d/dkpe/etc/master.d/dkty/etc/master.d/dkux/etc/master.d/dkx/opt/dk/bin/dk/opt/dk/bin/dkauth/opt/dk/bin/dkcat/opt/dk/bin/dkcu

    •••

    The following delivered control table files will be savedwith suffix "_44v2":

    /etc/opt/dk/dkhosts /etc/opt/dk/srvtab/do/etc/opt/dk/srvtab/pupu /etc/opt/dk/srvtab/rx/etc/opt/dk/srvtab/whoami

    Installing the delivered file /etc/init.d/dkitrcin /etc/init.d/dkitrc_44v2

    Reminder: Don’t forget to customize the /etc/opt/dk/srvtab after installation

    /etc/opt/dk/dkuidtab will NOT be overwritten by the install procedure.

    Note: The dkuidtab will be saved if you saved the tables during the removalprocess. Refer to the section Remove the CommKit Host Interface Softwarelater in this chapter.

    11 . Enter y when asked to retain the Software Certificate and Key values:

    2-14 Installation/Removal

  • InstallationInstall the CommKit Host Interface Software

    **************************************** CommKit Host Interface Registration ****************************************

    A valid CommKit registration record has been found on your system.Do you wish to retain the existing Software Certificate Numberand Software Key values? (YyNn)? yUpdating /etc/ttysrchUpdating edittbl

    Installing dkpe moduleInstalling dkhs moduleInstalling dkux moduleInstalling dkty moduleInstalling dkx moduleInstalling dkmx module

    Installation of was successful.

    *** IMPORTANT NOTICE ***If installation of all desired packages is completethe machine should be rebooted in order toensure sane operation. Execute the shutdowncommand with the appropriate options and wait forthe "Console Login:" prompt.

    12 . The software installation is now complete.

    13 . Remove the cartridge tape.

    14 . If you have more than one board installed or are not using the defaultnumber of channels (64) for each interface, you must customize the scriptfile, /etc/init.d/dkitrc. Refer to the section dkitrc Script File in Chapter 4.

    16 . If you are going to install TLI, proceed to the next section, otherwise, enterthe following command to reboot the system:

    # shutdown -y -i6 -g0

    Installation/Removal 2-15

  • Inst

    alla

    tion

    Install the CommKit TLI Package

    This package is optional. If you do not wish to install it, go to the next section.The CommKit Host Interface software must be installed before the TLI package.Refer to Using the TLI Package in Chapter 4 and the dktli(7) manual page.

    To install the TLI Package:

    1 . Log on as root.

    2 . Insert a cartridge tape in the drive.

    3 . Enter the pkgaddcommand to load the TLI package:

    # pkgadd -d /dev/rSA/qtape1 cktli

    -d is an option of pkgaddfor specifying the device option

    cktli is the name of the package being installed.

    4 . Once the software has been installed, remove the tape.

    5 . If you are going to install the host interface hardware, shut down the sys-tem and proceed to the next section:

    # cd /# shutdown -y -i0 -g0

    6 . If the host interface hardware is already installed, reboot the system:

    # cd /# shutdown -y -i6 -g0

    2-16 Installation/Removal

  • InstallationInstall Host Interface Hardware

    The CommKit Host Interface Software must be installed before the host interfaceboard can be installed. Read this entire section before installing the board.

    Procedure

    If the 3B2 computer is running, turn it off as described in the 3B2 Owner/OperatorManual and unplug the power cord. Install the host interface board:

    Note: The host interface board must be installed in the next available connectorslot with two vertical slots open. You cannot skip a backplane slot.

    Note: You may have to rearrange previously installed boards before installingthe host interface board. If so, refer to the documentation provided withthe boards you will be moving.

    Figure 2-2: 3B2/500 Cabinet Backplane Slots

    Filler Plates

    6

    4

    2

    1

    MEM1

    MEM0

    4

    5

    3

    BUB1BUB0

    VCACHE

    Circuit packextractor tool

    GroundClips

    GroundStrap

    Installation/Removal 2-17

  • Inst

    alla

    tion

    Install Host Interface Hardware

    1 . Refer to Figures 2-2 and 2-3 for typical 3B2 equipment.

    2 . Remove the ground strap by removing the screws holding it to the fillerplate and host interface board. Push and turn the spring-loaded screw aquarter turn as shown in Figures 2-2 and 2-3.

    Caution: Do not install the host interface board into a performance slot onthe 3B2/500 or 3B2/600. Doing so may damage both the 3B2 andthe host interface board.

    Caution: Handle the host interface board by the edges only.

    Figure 2-3: 3B2/600 Cabinet Backplane Slots

    PerformanceSlots

    I/O Slots

    11

    9

    7

    5

    3

    1

    12

    10

    8

    6

    4

    2

    VCACHE

    BUB3

    BUB2

    BUB1

    BUB0

    PWR only

    System board

    Circuit Pack Extractor Tool

    Ground clips

    Spring-load screwGround strap

    Filler plates

    3 . Remove the appropriate filler plates to install the host interface board.

    4 . If the filler plate covers two backplane slots and you need only one ofthem:

    a . Break the filler plate in half

    2-18 Installation/Removal

  • InstallationInstall Host Interface Hardware

    b . Install half over the slot not being used

    c . Save the other half for possible future use.

    Warning: Failure to replace the filler plates over the unused slots willdisrupt airflow and may cause radiation noncompliance with ClassB limits of Subpart J, Part 15 of FCC rules.

    5 . Insert the host interface board into the selected slot with the componentside up as shown in Figure 2-4.

    Figure 2-4: Inserting the Host Interface Board

    Host Interface Board

    6 . Replace the ground strap and install the ground clip as shown in Figure2-5.

    Installation/Removal 2-19

  • Inst

    alla

    tion

    Install Host Interface Hardware

    Note: Install the ground clip at the outside end of the faceplate opposite theground strap.

    Figure 2-5: Host Interface Board Installed

    Oval AccessHole

    Cable Tie

    Cable

    Ground Clip

    Transmit

    Receive

    Host InterfaceBoard

    Connect the fiber optic cable as described in the section Connect the Fiber OpticCable later in this chapter.

    2-20 Installation/Removal

  • InstallationInstall the CPM-HS Module in the Data SwitchNode

    The CPM-HS module will be installed in the data switch node. Refer to theappropriate AT&T Installation and Maintenance Guides (see Chapter 1, Table 1-3) for additional details.

    To install the CPM-HS in the node:

    1 . Face the data switch cabinet from the rear. Slide the paddle board into oneof the available backplane slots. (See Figure 2-6).

    Figure 2-6: Typical Rear View of a Data Switch Cabinet

    89

    10

    11

    12

    13

    14

    15

    E3

    01

    234567

    E5

    DATAKIT II VCS

    Paddleboard

    2 . Connect the paddle board to the chassis.

    3 . Face the cabinet from the front. Slide the CPM-HS module into the samenumber slot as the paddle board. (See Figure 2-7).

    Installation/Removal 2-21

  • Inst

    alla

    tion

    Install the CPM-HS Module in the Data Switch Node

    Figure 2-7: Typical Front View of a Data Switch Cabinet

    CPM-HS Module

    4 . Enable the CPM-HS module by moving the module faceplate switch to theENABLE position.

    Route the Fiber Optic Cable

    General

    The fiber optic cable may be run in overhead ceilings, in subfloor cable runs, andin riser shafts. Before routing the fiber optic cable, you must connect rubber capsto each end of the cable. This will protect the fiber optic cable from dirt or dustduring installation.

    2-22 Installation/Removal

  • InstallationRoute the Fiber Optic Cable

    When routing the fiber optic cable, you should keep the fiber optic cable awayfrom copper riser cables. If you are unable to do so, install an inner liner (con-duit) to keep the cables separated.

    Carlon EFT corrugated tubing (or equivalent) may be used to separate the fiberoptic cable from copper riser cables. This corrugated tubing can be used in shortlengths and can be formed into bends.

    Caution: Fiber optic cables are not intended for use in air handling ceilingareas unless installed in approved conduit.

    When installing the fiber optic cable, you should avoid tight pulls or tugs againstsharp corners of framework. If fiber optic cables are to be installed around sharpedges of cabinetry or framework, cover the edges with split tubing or similarmaterial. When lacing or securing the fiber optic cable, use flat lacing twine orcable ties; do not tie the fiber optic cable too tight because microbending lossesmay occur. Bundles of cables should not hang or protrude into the work space.Wrap the cables into loops not less than three inches in diameter, althoughshort-term handling into loops of one-inch diameter is satisfactory.

    Tools and Hardware

    Tools and hardware (such as fish wire, woven cable grips, or rope) used to installcopper wire and cable in building duct and conduit systems are satisfactory foruse in installing fiber optic cable. If woven cable grips are used with fiber opticcables, tape them to the cable jacket before pulling the cable.

    Conduit Installation

    The fiber optic cables were not designed for conduit installation, but they may beinstalled in a conduit if the following applies:

    1 . Only two fiber optic cables into a single conduit

    2 . The pull force of the fiber optic cable does not exceed 50 pounds per cable.

    Fiber optic cables should not be pulled through more than four 90-degree bends.If the conduit run contains more than four 90-degree bends, provide intermedi-ate help points. The minimum recommended conduit bend radius is 4½ inches.

    Installation/Removal 2-23

  • Inst

    alla

    tion

    Route the Fiber Optic Cable

    Caution: Never pull the cable around a sharp corner, such as a junction boxconnection.

    Warning: Do not install fiber optic cable in conduits with less than ¾-inchinside diameter.

    Pulling tension during conduit installation can be minimized by the following:

    1 . The fiber optic cable should enter the end of the conduit nearest thecurved sections.

    2 . Ducts or conduits should be free of foreign obstructions before cable ins-tallation.

    3 . The following lubricants are recommended for PVC cabling:

    — Polywater A&C — American Polywater Corp.

    — Hydralube Blue — Arnco Equipment Co.

    — Neutral soft soap

    — Talcum powder.

    Note: Do not use a petroleum-based lubricant on PVC cables.

    Connect the Fiber Optic Cable

    The length of the fiber optic cable between the node (CPM-HS module) and thecomputer system (CommKit Host Interface board) should not exceed 1 kilome-ter.

    Connect the fiber optic cable as follows (refer to Figure 2-8):

    1 . Face the data switch cabinet from the rear. The receiver (Rx) is the connec-tor at the top and the transmitter (Tx) is the bottom connector.

    2-24 Installation/Removal

  • InstallationConnect the Fiber Optic Cable

    2 . Remove the rubber caps from the fiber optic cable and the Transmitterand Receiver connectors of the Host Interface Board. Save the caps forlater use.

    3 . Connect the Transmitter side of the Host Interface board in the computerto the Rx side of the CPM-HS module in the data switch node.

    4 . Connect the Receiver side of the Host Interface board in the computer tothe Tx side of the CPM-HS module in the data switch node.

    5 . Press the ends of the cable tie together. The holes in the ends of the tieshould line up with the hole near the rear of the cabinet.

    6 . Place the screw through the tie and into the hole near the rear of thecabinet. Tighten the screw to support the cabinet.

    Figure 2-8: Fiber Cable Connections

    Tx

    Rx

    Rx

    Tx

    CPM-HS Host Interface Board

    Configure the Data Switch Control ComputerDatabase

    Once the CPM-HS module is plugged into the data switch node, the CPM-HSmodule must be configured from the data switch node console. Refer to theappropriate AT&T Commands Reference documentation (Chapter 1, Table 1-3)for more information.

    Installation/Removal 2-25

  • Inst

    alla

    tion

    Configure the Data Switch Control Computer Database

    To configure the node, you must:

    1 . Define the group name

    2 . Define the address* for the dkserver service

    3 . Define the address for the listener

    4 . Enter the CPM-HS module.

    To accomplish these steps, conduct the dialogues shown below.

    Note: Dialogues differ depending on the AT&T data switch and releasenumber. The figures show typical dialogues for R2.0 of the Datakit IIVCS and BNS data switches. Significant differences for Datakit II VCSR1.0 are described as necessary.

    Define Group Name

    Conduct the dialogue as shown below (responses based on Figure 1-2):

    CC0> enter groupGROUP [up to 8 chars]: birdTYPE [local, trunk: +(local)]: localDIRECTION [originate, receive, 2way]: 2wayDEVICE OR HOST [up to 8 chars]: birdPASSWORD [up to 8 chars, none: +(none)]: noneROUND ROBIN SERVICE [per_port, per_module, none: +(none)]: noneGROUP [up to 8 chars]: DeleteCC0>

    The entries are described below:

    group Defines the name of the computer system as known by the dataswitch. This is bird in the example shown in the screen above.(Enter Delete to end the session.)

    * The term address in the BNS and R2.0 of the Datakit II VCS data switch is the sameas the term name in R1.0 of the Datakit II VCS data switch. When using the enter ad-dresscommand to define the name, select mnemonic as the type. Refer to the exam-ples that follow.

    2-26 Installation/Removal

  • InstallationConfigure the Data Switch Control Computer Database

    type The computer system is a local connection to the data switch.Enter local.

    direction The fiber interface may be used to originate and receive callsthrough the CPM-HS module, therefore, it is 2way.

    device orhost

    We recommend assigning the same name as the name of thecomputer system.

    password Passwords are not used with the CPM-HS module.

    round robin We do not recommend using per_port. Enter either per_module(for multiple boards) or none.

    Define Address for dkserver Service

    The server name used by dkserver must match an address configured for theCPM-HS or host. (The following example is based on the example shown inChapter 1, Figure 1-2 and uses the default dkserver name.) Conduct the dialo-gue as shown in the screen below:

    CC0> enter addressLEVEL [local, area, exchange, local, speedcall: +(local)]: localTYPE [x121, mnemonic, both: +(mnemonic)]: mnemonicMNEMONIC ADDRESS [up to 8 chars]: birdPAD SUPPORT [yes, no: +(no)]: EnterDIRECTORY ENTRY [up to 30 chars double quoted, none: +(none)]:"name of the default dkserver"GROUP(S) [up to 4 groups separated by commas, none: +(none)]:birdORIGINATING GROUP NAME SECURITY PATTERN(S)[comma-separated pattern list, same_as, none: +(none)]: EnterINITIAL SERVICE STATE [in, out: +(out)]: inLEVEL [network, area, exchange, local, speedcall: +(local)]: DeleteCC0>

    Note: The command enter addressin the BNS or R2.0 of the Datakit II VCS dataswitch is analogous to the enter namecommand in R1.0 of the Datakit IIVCS.

    Installation/Removal 2-27

  • Inst

    alla

    tion

    Configure the Data Switch Control Computer Database

    level Enter local (R2.0) or Delete to end the session.

    type The addressing type is mnemonic (R2.0 and later) or standard(R1.0).

    mnemonicaddress/name

    This is the local service address (name R1.0) used by the com-puter system and it must be the same as the server name that isassigned to the dkserver.

    PAD This is not used (R2.0).

    directoryentry

    This is a 30-character description of the dkserver enclosed indouble quotes.

    group Enter the name of the data switch group used to direct calls toyour computer system.

    security pat-tern

    The originating group name security feature allows the dataswitch to restrict calls for this host to a select group of dataswitch originating groups. Since the srvtab file may also be usedto restrict incoming calls, Enter is used to disable this feature.

    service state The local service address must be in service for the computer sys-tem to originate and receive calls (R2.0).

    restore toservice

    The local service address must be in service for the computer sys-tem to originate and receive calls (R1.0).

    If you do not intend to use TLI support, go to the section, Configure the CPM-HSModule, later in this chapter. If TLI Support is to be used, continue with the nextsection, Define Address for the Listener.

    Define Address for the Listener

    The server name used by the listenermust match an address configured for theCPM-HS or host. In general, the server name for the listenerwill be the uppercase version of the host name (uname). For example (in Figure 1-2), host = bird;server name for listener = BIRD. Conduct the dialogue as shown in the followingscreen:

    2-28 Installation/Removal

  • InstallationConfigure the Data Switch Control Computer Database

    CC0> enter addressLEVEL [local, area, exchange, local, speedcall: +(local)]: localTYPE [x121, mnemonic, both: +(mnemonic)]: mnemonicMNEMONIC ADDRESS [up to 8 chars]: BIRDPAD SUPPORT [yes, no: +(no)]: EnterDIRECTORY ENTRY [up to 30 chars double quoted, none: +(none)]:"name of the listener"GROUP(S) [up to 4 groups separated by commas, none: +(none)]:birdORIGINATING GROUP NAME SECURITY PATTERN(S)[comma-separated pattern list, same_as, none: +(none)]: Enter

    INITIAL SERVICE STATE [in, out: +(out)]: in

    LEVEL [network, area, exchange, local, speedcall: +(local)]: DeleteCC0>

    level Enter local (R2.0) or Delete to end the session.

    type The addressing type is mnemonic (or standard for Datakit IIVCS R1.0 only).

    mnemonicaddress/name

    Enter the local server address (name R1.0) used by the listener.This is GULL in this example.

    PAD This is not used (R2.0).

    directoryentry

    This is a 30-character description of the listener enclosed in dou-ble quotes.

    group Enter the name of the data switch group that is used to directcalls to your computer system.

    security pat-tern

    The originating group-name security feature allows the dataswitch to restrict calls for this host to a select group of dataswitch originating groups. Since the srvtab file may also be usedto restrict incoming calls, Enter is used to disable this feature.

    service state The local service address must be in service for the computer sys-tem to originate and receive calls (R2.0).

    restore toservice

    The local service address must be in service for the computer sys-tem to originate and receive calls (R1.0).

    Installation/Removal 2-29

  • Inst

    alla

    tion

    Configure the Data Switch Control Computer Database

    Configure the CPM-HS Module

    Conduct the dialogue as shown in the screen below:

    CC0> enter cpmMODULE ADDRESS [2-127]: 6COMMENT [up to 60 chars double quoted]:"fiber interface"HARDWARE TYPE [422, hs: +(hs)]: hsNUMBER OF CHANNELS [2-512: +(32)]: 64SINGLE OR MULTIPLE GROUP(S) [single, multiple: +(single)]: multipleGROUP [up to 8 chars]: birdCHANNEL RANGE [low-high: (+2-63)]: 2-30ENDPOINT NUMBER OR RANGE [0000-9999, none: +(none)]: none105 Channels Left to Be SpecifiedGROUP [up to 8 chars]: bearCHANNEL RANGE [low-high]: 31-63ENDPOINT NUMBER OR RANGE [0000-9999, none: +(none)]: none

    MODULE ADDRESS: ReturnCC0> restore cpm 6CC0>

    address Check the data switch cabinet for the slot number of the CPM-HS module to which the host is connected. Enter that slotnumber; in this example the CPM-HS module is in slot 6.

    comment A description of the entry.

    hardwaretype

    Host’s fiber interface hardware always connects to the CPM-HS.

    number ofchannels

    The default number of channels for the CommKit Host Interfacesoftware is 64. Enter the same number as the number of chan-nels configured on your computer system. To change thenumber of channels, refer to Chapter 4.

    Single ormultiple

    Enter single, or multiple if channel groups are used.

    group Enter the name of the data switch node channel group beingused to direct calls to your computer system. Enter additionalchannel groups as required by your configuration (refer to thesection dkgroups in Chapter 3).

    2-30 Installation/Removal

  • InstallationConfigure the Data Switch Control Computer Database

    Endpoint Not used (R2.0).

    Note: The CPM-HS module must be restored to service before use.

    Run Diagnostics on Host Interface Module

    The host interface module is tested by running off-line diagnostics. Use thesediagnostics to locate hardware problems in the 3B2 computer.

    Caution: Diagnostic phases should only be run by an experienced user. Ifyou have a system failure and are not confident about runningdiagnostics, call your AT&T Service Representative or authorizeddealer.

    Diagnostics are run from the 3B2 firmware mode. You must be logged in as rooton the 3B2 to bring the system to the firmware mode. To run the diagnostics:

    1 . Go to the firmware mode by conducting the following dialog:

    # /etc/shutdown -y -i5FIRMWARE MODExxxxxxEnter name of program to execute [/etc/system]: dgmon

    Note: Enter your password (shown as xxxxxx above) when the FIRMWAREMODEprompt appears. The password will not be echoed onscreen.

    2 . Boot the system by executing the dgmon program from the hard disk.Refer to the 3B2 RISC Systems UNIX System V R4.0.3 Owner/OperatorManual.

    Installation/Removal 2-31

  • Inst

    alla

    tion

    Run Diagnostics on Host Interface Module

    3 . Run the diagnostics by entering:

    DGMON>dgn dkpe ph=1-15DGMON>

    Note: For phases 13– 15 to pass, the fiber optic cable must be connected to thedata switch node.

    4 . Quit the diagnostics mode by entering q at the DGMON>prompt above.

    If a diagnostic failure occurs, verify that the fiber optic cable is properly con-nected between the 3B2 Computer and the data switch node and that the CPM-HS module is properly inserted into the correct data switch slot and that it is inservice. If you continue to experience diagnostic failures, refer to the section Cus-tomer Assistance in Chapter 1.

    Diagnostic Phases

    Table 2-2: Diagnostic Phases____________________________________________________________________________

    Phase Type Description Phase Type Description____________________________________________________________________________1 Demand CIO Sanity Test 9 Demand Programmed I/O Byte____________________________________________________________________________2 Demand PCSR Write/Read Test 10 Demand Programmed I/O Word____________________________________________________________________________3 Demand Upper RAM Write/Read Test 11 Demand DMA Transfer Byte Test____________________________________________________________________________4 Demand Lower RAM Write/Read Test 12 Demand DMA Transfer Word Test____________________________________________________________________________5 Demand CPU Chip Select Test 13 Normal FIB Internal Loop____________________________________________________________________________6 Demand CPU DMA Internal Test 14 Demand FIB External Loop____________________________________________________________________________7 Demand CPU Timer Test 15 Normal DMA FIB External Loop____________________________________________________________________________8 Demand CPU Interrupt Controller____________________________________________________________________________

    ____________________________________________________________________________

    Table 2-2 shows the diagnostic phase descriptions for 3B2 RISC computer. Thefollowing screen shows a typical output for the diagnostic phases.

    2-32 Installation/Removal

  • InstallationRun Diagnostics on Host Interface Module

    DGMON>dgn dkpe ph=1-15>

    DKIT Phase: 1 Test: Common I/O Sanity Type: DEMANDTime Taken = 1 second*** DKIT Phase: 1 Diagnostic PASSED ***

    DKIT Phase: 2 Test: Control and Status Register Type: DEMANDTime Taken = 1 second*** DKIT Phase: 2 Diagnostic PASSED ***

    DKIT Phase: 3 Test: Upper RAM Type: DEMANDTime Taken = 2.5 minutes*** DKIT Phase: 3 Diagnostic PASSED ***

    DKIT Phase: 4 Test: Lower RAM Type: DEMANDTime Taken = 2.5 minutes*** DKIT Phase: 4 Diagnostic PASSED ***

    DKIT Phase: 5 Test: Central Processor Unit Type: DEMANDTime Taken = 1 second*** DKIT Phase: 5 Diagnostic PASSED ***

    DKIT Phase: 6 Test: Central Processor Unit Type: DEMANDTime Taken = 1 second*** DKIT Phase: 6 Diagnostic PASSED ***

    DKIT Phase: 7 Test: Central Processor Unit Type: DEMANDTime Taken = 1 second*** DKIT Phase: 7 Diagnostic PASSED ***

    DKIT Phase: 10 Test: Central Processor Unit Type: DEMANDTime Taken = 1 second*** DKIT Phase: 10 Diagnostic PASSED ***

    DKIT Phase: 9 Test: BYTE Programmed I/O Type: DEMANDTime Taken = 1 minute*** DKIT Phase: 9 Diagnostic PASSED ***

    DKIT Phase: 10 Test: WORD Programmed I/O Type: DEMANDTime Taken = 1 minute*** DKIT Phase: 10 Diagnostic PASSED ***

    DKIT Phase: 11 Test: BYTE DMA Transfer Type: DEMANDTime Taken = 1 second*** DKIT Phase: 11 Diagnostic PASSED ***

    DKIT Phase: 12 Test: WORD DMA Transfer Type: DEMANDTime Taken = 1 second*** DKIT Phase: 12 Diagnostic PASSED ***

    DKIT Phase: 13 Test: FIB Internal Loop Around Type: NORMALTime Taken = 3 secondsWARNING - THE FIBER OPTIC CABLE MUST BE CONNECTED!

    Installation/Removal 2-33

  • Inst

    alla

    tion

    Run Diagnostics on Host Interface Module

    *** DKIT Phase: 13 Diagnostic PASSED ***

    DKIT Phase: 14 Test: FIB External Loop Around Type: DEMANDTime Taken = 3 secondsWARNING - THE FIBER OPTIC CABLE MUST BE CONNECTED!*** DKIT Phase: 14 Diagnostic PASSED ***

    DKIT Phase: 15 Test: DMA - FIB External Loop Around Type: NORMALTime Taken = 5 secondsWARNING - THE FIBER OPTIC CABLE MUST BE CONNECTED!!*** DKIT Phase: 15 Diagnostic PASSED ***

    DKIT 0 (IN I/O BUS SLOT 2) DIAGNOSTICS PASSED

    Verify Operation

    Now that you have installed the CommKit Host Interface software and hardwareinto your computer and installed the hardware in the AT&T data switch nodeand configured the node, you are ready to verify that your computer can com-municate successfully with that node. You must be logged in as root on yourcomputer, and the system must be in the multi-user mode (init state 2). The fol-lowing is an overview of these step-by-step procedures:

    1 . Verify the operation of the dkdaemon process.

    2 . Verify the operation of the dkserver process.

    3 . Verify data transfer across the interface.

    4 . Verify terminal login across the interface.

    5 . Verify operation of the remote login facility.

    2-34 Installation/Removal

  • InstallationVerify Operation

    Verify the Operation of the dkdaemon Process

    To start the newly-installed interface, the interface daemon process must bestarted. The interface daemon (/opt/dk/sbin/dkdaemon) is started automaticallywhenever the system enters init state 2. See the manual page dkitrc(1M) for moredetails on what processes are started automatically at init state 2.

    If you have more than one CommKit Host Interface board installed, you can startseparate daemon processes for each interface by using the following commandwhere n is the interface board number:

    # /opt/dk/sbin/dkdaemon -i n

    If the -i option is not used with the dkdaemon command, a single daemon pro-cess services all interfaces. If the number of channels that you wish to configureis not the same for each interface, you must have separate daemon processes foreach interface.

    1 . Check to see if the daemon process is running by using the pscommand.If the process is not running, manually start the dkdaemon by enteringthe following where nChannels is the number of channels that you wish toconfigure on your interface [dkdaemon(1M)].

    # /opt/dk/sbin/dkdaemon [-c nChannels ] -i n

    Note: If you omit the -c nChannels option, the daemon will default to 64 chan-nels. In either case, the number of channels must be the same as thenumber config