tm installation and administration guide for aix
Contents
1. 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 IP DSU Loopback Status gt Loopbacks are not enabled IP DSU Data Encryption Status gt Disabled Actual IP DSU Service State gt Not Connected MAC Address gt 0 19 5 84 49 56 ocal IP Address gt utm_ip_address Subnet Mask gt subnet_mask Gateway IP Address gt gateway_ip_address IP DSU Destination IP Address gt host_ip_address SNMP Trap Manager gt Not defined Specifically check that the Service State is In Service If it s not enter the following command on the UTM console lt TRK UNIV gt rs 6 2 2 CHECK THAT THE CPM S IN SERVICE Enter the following command on the BNS node console CCO gt dstat mod mod address In this command mod_ address is the slot number where you installed the UTM The output should be similar to the report below 00 12 18 13 43 46 NOD 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 M dstat module mod_address KKKKKKKKKKKKKKKKKKKKKKKKKKKKKK MODULE 19 KKKKKKKKKKKKKKKKKKKKKKKKKKKKKK MODULE TYPE SERVICE STATE HARDWARE ERROR COUNT SERIAL NUMBER cpmhs in service 136 LAST HARDWAR ONLINE ENABLED CABLE yes yes connected yes Specifically check that the SERVICE STATE is in service If2. CCO gt enter cpm MODULE ADDRESS mod_address COMMENT up to 60 chars double quoted or none none appropriate comment gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 HARDWARE TYPE 422 hs hs lt Enter gt NUMBER OF CHANNELS 3 512 32 num_channels CALL SCREENING PROFILE ID up to 8 chars none none lt Enter gt CONNECT TIME BILLING on off off lt Enter gt SINGLE OR MULTIPLE GROUPS single multiple single lt Enter gt GROUP up to 8 chars nodename ENDPOINT NUMBER OR RANGE 0000 9999 none none lt Enter gt E ADDRESS lt Delete gt Finally restore the cpm to service CCO gt restore cpm MODULE ADDRESS mod_address 3 5 SOFTWARE INSTALLATION 3 5 1 PREREQUISITES Before installing any software on your computer verify that it is running a release of its operating system that supports IP Commkit See the IP Commkit Release Notes for a list of supported operating system releases Do not attempt to install the IP Commkit software if your computer is running an operating system release that is not supported gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 3 5 2 REMOVING COMMKIT HOST INTERFACE SOFTWARE
3. If you are upgrading a computer from the CommKit Host Interface to IP CommKit you must remove the Commkit Host Interface software before installing the IP CommKit For IBM computers CBM of America supplies the host interface software under the name Powerkit Consult the documentation provided by CBM of America for instructions on removing the Powerkit software package 3 5 3 INSTALLING IP COMMKIT SOFTWARE Use the following procedure to install the IP CommKit software The IP Commkit software is delivered electronically or on CD as multiple files in tape archive tar format The file is named ipckax tar or ipckax32 tar First log in as root on the host where you wish to install the software If you have a CD enter the following commands to mount it and expand the tar file gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 mkdir cdrom mount r v cdrfs dev cd0 cdrom mkdir tmp ipcommkit cd tmp ipcommkit Retrieve the tar file from the CD For AIX R4 3 hosts tar xf cdrom aix_4 3 ipckax tar For AIX R5 2 hosts running a 32 bit kernel tar xf cdrom aix 5 2 ipckax32 tar For all AIX hosts umount cdrom If you received the tar file electronically the procedure is similar Copy the tar file to the machine on which you are installing the software For example suppose that you copied the tar file to tmp To expand the ta
4. If you find this confusing you can use the setuname 1M command to make the system name and node name the same gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 If you want to use a name that s different from the host s nodename you must modify the dkitcfg file See section 3 6 2 Now enter a group A group binds together a collection of like modules under one name In this simple example there is only one UTM so the group has only one member In more complex configurations you can put up to eight UTMs in one group and distribute incoming calls between these modules using round robin service The following dialogue shows the procedure for entering a group on the BNS node console Text that you type exactly is shown in bold and text that you modify for your installation is shown in bold italics lt Enter gt and lt Delete gt refer to the enter and delete keys on your keyboard CCO gt enter group GROUP up to 8 chars nodename TYPE local trunk local local DIRECTION originate receive 2way 2way DEVICE OR HOST up to 8 chars standard lt Enter gt PASSWORD up to 8 chars none none lt Enter gt ROUND ROBIN SERVICE per_port per_module none none lt Enter gt GROUP up to 8 chars lt Delete gt Next enter an address An address is bound to one or more groups In th
5. UTM User s Manual for a complete description Once you have done the initial configuration of the UTM through the console port you can access all console commands through the LAN port via telnet For example you should be able to te net to the UTM from the host on which you installed the IP CommKit software 3 4 BNS NoDE CONFIGURATION If you are upgrading a CPM HS module to a UTM you don t need to make any changes to the BNS node configuration You can simply remove the CPM HS module and its I O distribution board and install the UTM and its I O distribution board in the same slot The UTM appears as a CPM HS module to the controller in the BNS node If this is a new installation you must configure the UTM in the BNS node s controller database The following procedure describes a simple configuration It consists of entering a group an address and a cpm in the controller database Before you begin pick a name that you will use as this host s address in the BNS network In configurations using a single dkserver it s convenient to make this address and the group name the same as the host s nodename By default dkserver announces itself to the BNS node by the host s nodename To determine this name enter the following command on the host uname n This prints the host s nodename Note that the uname 1M command with no flags is equivalent to uname s This prints the system name which can be different from the nodename
6. agreement is licensed to you under the terms of that license agreement By installing copying downloading accessing or otherwise using the SOFTWARE you agree to be bound by the terms of this LICENSE If you do not agree to the terms of this LICENSE Manufacturer is unwilling to license the SOFTWARE to you In such event you may not use or copy the SOFTWARE and you should promptly contact Manufacturer for instructions on return of the unused product s for a refund 9 1 SOFTWARE LICENSE You may only install and use one copy of the SOFTWARE on one host computer unless otherwise licensed by Manufacturer The SOFTWARE may not be installed accessed displayed run shared or used concurrently on or from different computers including a workstation terminal or other digital electronic device Devices Notwithstanding the foregoing and except as otherwise provided below any number of Devices may access or otherwise utilize the services of the SOFTWARE You may not reverse engineer decompile or disassemble the SOFTWARE except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation The SOFTWARE is licensed as a single product Its component parts may not be separated for use on more than one host computer You may not rent lease or lend the SOFTWARE in any manner You may permanently transfer all of your rights under this LICENSE provided you retain no copies you transfer all of t
7. gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 Dec 18 14 8867 usr sbin dkdaemon Startup Complete Dec 18 14 i 8867 dkhsstart Unit 0 512 Chans Ver 4 Rbuf 1024 NurpB 4 Dec 18 14 55 startstr dkhs Unit ACTIVE Dec 18 14 startstr dkhs Unit Down Retrying Dec 18 14 startstr dkhs Unit Down Retrying Dec 18 14 startstr dkhs Unit Down Retrying Dec 18 14 startstr dkhs Unit Down Retrying Dec 18 14 startstr dkhs Unit Down Retrying Dec 18 14 startstr dkhs Unit Down Retrying Dec 18 14 startstr dkhs Unit 7 Down Retrying Dec 18 14 55 startstr dknp Unit 0 ACTIVE Dec 18 14 55 startstr dkxmx Unit 0 ACTIVE Dec 18 14 lt 0 0 dkxqt mux driver is active Dec 18 14 ERVER 0 2 dino Started by UID 0 By default dkdaemon tries to start all eight logical interfaces Only one logical interface is used on the host computer where this log file was generated This is Unit 0 and dkdaemon reports that it is ACTIVE dkdaemon reports that the remaining logical interfaces are Down On your host you should check that all logical interfaces that you specified in the dkiptab are active If the messages that you see dont look similar to any of the examples above consult the dkdaemon 1M manual page This describes all messages that are written to the log file Once dkdaemon start
8. ANYWHERE IP Commkit is a trademark of Lucent Technologies Inc licensed to Datatek Applications Inc a company independent of Lucent Technologies Inc Datakit is a registered trademark of Lucent Technologies Inc licensed to Datatek Applications Inc a company independent of Lucent Technologies Inc gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 2 DOCUMENTATION Since IP CommkKit behaves like a CommkKit Host Interface you can use the CommKit Host Interface documentation to find answers to most questions Specifically use the CommKit Host Interface for NCR PCI Computers Installation and Administration Guide This document follows the same general outline i e it has the same major sections in the same order Where there are changes or additions for IP Commkit they are described in the appropriate section of this document While NCR computers running MP RAS are very different from IBM computers running AIX releases IP CommKKit is built from source code that was ported from the release of the Commkit Host Interface that ran on NCR computers As a result much of the information in the Commkit Host Interface for NCR PCI Computers Installation and Administration Guide applies to IP CommKit running on IBM computers AIX is a registered trademark of IBM gt 11 28 05 Datatek Applications Inc IP CommKit Installation and
9. Administration Guide for AIX Release 1 0 22 3 INSTALLATION AND CONFIGURATION 3 1 OVERVIEW This section describes the procedures for connecting a host computer to a Lucent Technologies BNS 2000 or BNS 2000 VCS network using IP Commkit This section supercedes the Installation and Configuration section of the Commkit Host Interface for NCR PCI Computers Installation and Administration Guide This section references procedures in the UTM User s Manual Have it handy before you begin This section assumes that your host computer is already connected to a LAN If it s not you should follow the procedures supplied with your computer for connecting it to a LAN Installation and configuration of IP Commkit consists of the following steps e Obtain an IP address for the UTM and determine the appropriate subnet mask Also determine the host IP address and if needed a gateway IP address Install the UTM and I O distribution board in the BNS node Configure the UTM through its console port Configure the UTM in the BNS node s controller database Install the IP CommKit software on the host computer Register the IP Commkit software Customize the dkiptab and if needed dkitcfg and the other control tables The following sections describe each step in detail gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 3 2 IP ADDRESSES This section a
10. SOFTWARE AND THE ACCOMPANYING WRITTEN MATERIALS THIS LIMITED gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS YOU MAY HAVE OTHERS WHICH VARY FROM STATE JURISDICTION TO STATE JURISDICTION 9 7 SPECIAL PROVISIONS The SOFTWARE and documentation are provided with RESTRICTED RIGHTS Use duplication or disclosure by the United States Government is subject to restrictions as set forth in subparagraph c 1 ii of the Rights in Technical Data and Software clause at DFARS 252 227 7013 or subparagraphs c 1 and 2 of the Commercial Software Restricted Rights at 48 CFR 52 227 19 as applicable Manufacturer is Datatek Applications Inc 379 Campus Drive Suite 100 Somerset NJ 08873 If you acquired the SOFTWARE in the United States of America this Software License are governed by the laws of the State of New Jersey excluding its choice of laws provisions If you acquired the SOFTWARE outside the United States of America local law may apply This LICENSE constitutes the entire understanding and agreement between you and the Manufacturer in relation to the SOFTWARE and supersedes any and all prior or other communications statements documents agreements or other information between the parties with respect to the subject matter hereof 9 8 LIMITATION OF LIABILITY To the maximum extent permitted by applicable law in
11. no event shall Manufacturer or its suppliers be liable for any damages whatsoever including without limitation special incidental consequential or indirect damages for personal injury loss of business profits business interruption loss of business information or any other pecuniary loss arising out of the use of or inability to use this product even if Manufacturer has been advised of the possibility of such damages In any case Manufacturer s and its suppliers entire liability under any provision of this License shall be limited to the amount actually paid by you for the SOFTWARE Because some states jurisdictions do not allow the exclusion or limitation of liability for consequential or incidental damages the above limitation may not apply to you Copyright 2001 2006 Datatek Applications Inc All Rights Reserved Printed in USA gt 11 28 05 Datatek Applications Inc
12. to a LAN segment For example all interfaces attached to gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 the same 10Base T hub are on the same LAN segment and almost always have the same subnet mask If the host and UTM connect to the same subnet then you can find out the subnet mask from the output of the ifconfig command In the previous example the netmask field in the report shows that the subnet mask assigned to e0 is ffffff00 The subnet mask reported by ifconfig can t be used directly to configure the UTM The value ffffff 00 is an 8 digit hexadecimal representation of a 32 bit mask Unfortunately the UTM expects this value in the Internet dot representation To perform the conversion divide the 8 digit value into four 2 digit fields and convert each field to decimal Concatenate the four decimal fields placing a dot between field For example ffffff00 converts to 255 255 255 0 If the host and UTM do not attach to the same subnet your IP network administrator must provide you with an appropriate subnet mask for the UTM In addition the administrator must provide you with the IP address of a gateway router This gateway must reside on the same subnet as the UTM and must know how to route packets from the UTM to the host computer Again you need the gateway address in numeric form 3 3 UTM INSTALLATION Consult the UTM User s
13. ANTY Manufacturer warrants that a the SOFTWARE will perform substantially in accordance with the accompanying written materials for a period of ninety 90 days from the date of shipment from Datatek Applications Inc Software support is limited to the hours of 9 AM to 5 PM ET Monday through Friday excluding Datatek observed holidays Other coverage and extended warranty may be purchased at additional cost Any implied warranties on the SOFTWARE are limited to ninety 90 days Some states jurisdictions do not allow limitations on duration of an implied warranty so the above limitation may not apply to you Manufacturer s and its suppliers entire liability and your exclusive remedy shall be at Manufacturer s option either a return of the price paid or b repair or replacement of the SOFTWARE that does not meet this Limited Warranty and which is returned to Manufacturer with a copy of your receipt This Limited Warranty is void if failure of the SOFTWARE has resulted from accident abuse or misapplication Any replacement SOFTWARE will be warranted for the remainder of the original warranty period or thirty 30 days whichever is longer 9 6 NO OTHER WARRANTIES TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW MANUFACTURER AND ITS SUPPLIERS DISCLAIM ALL OTHER WARRANTIES EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT WITH REGARD TO THE
14. ANUAL PAGES 9 END USER LICENSE AGREEMENT FOR SOFTWARE 9 1 SOFTWARE LICENSE 9 2 INTELLECTUAL PROPERTY RIGHTS 9 3 SOFTWARE SUPPORT 9 4 EXPORT RESTRICTIONS 9 5 LIMITED WARRANTY 9 6 NO OTHER WARRANTIES 9 7 SPECIAL PROVISIONS 9 8 LIMITATION OF LIABILITY gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 1 INTRODUCTION 1 1 WHATIS IP CoMMKIT 2 IP CommKit is a new twist on the Commkit Host Interface for BNS 2000 and BNS 2000 VCS a k a Datakit II VCS Where the Commkit Host Interface uses a fiber optic cable to connect the host computer to the BNS node IP CommKit uses a 10Base T LAN Instead of a fiber interface card in the host computer IP CommKit uses the host s standard LAN interface card In the BNS node use of IP Commkit requires replacement of the CPM Module with a Universal Trunk Module UTM All of these changes are invisible to the host applications and the BNS network Host applications and Commkit features behave identically There is no need to recompile your applications Host and Node Interfaces E C om m Kit Host Interface pene BEFORE OS Host FIBER FIBER OPTIC CABLE Computer MODULE i poe iceu i ENS 2000 LIMITED DISTANCE HS BNS 2000 VCS SEPARATION IP CommkKit Host Interface ssss 10 100BaseT 10 100Base Lem STANDARD E BNS 2000 OS Host LAN F 4 IP E a Computer MODULE i
15. DKIPDLOG Enter the following command on the host computer tail var opt dk log dkipdlog gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 This displays the end of the log file created by dkipd 1M The last two lines of the output should be similar to the report below Dec 18 12 08 54 8626 Connectivity from host_ip_address to utm_ip_address established Dec 18 12 09 19 8626 UTM module utm_ip_address restored to service Here the host_ip_address is the IP address assigned to the host computer and the utm_ip_address is the IP address assigned to the UTM Note that dkipa will use the name associated with the address if possible If your host connects to several UTMs you should see these two messages repeated for each UTM IP address If you see the first line Connectivity from but not the second UTM module it indicates that the CPM is out of service Go back to the procedure for checking that the CPM is in service If the output on your host is different compare it to the following output examples that are associated with common problems usr sbin dkipd Error in configuration file etc opt dk dkiptab Line 38 0 dino 135 17 59 203 Can t resolve address 135 17 59 203 This output is typical of an error in dkiptab the configuration file for dkipd You may have forgotten to customize the file for y
16. Datai bor j NSTALLATION AND ADMINISTRATION GUIDE FOR AIX RELEASE 1 0 22 379 Campus Drive Suite 100 Somerset NJ 08873 fax 732 667 1091 phone 732 667 1080 email sales datatekcorp com http www datatekcorp com IP CommKit Installation and Administration Guide for AIX Release 1 0 22 TABLE OF CONTENTS 1 INTRODUCTION 1 1 What is IP CommKit msi mccain noa aa caca acea acia aia aaa kk kk AA aa aa ia ada nada ada sua ti 4 2 DOCUMENTATION 3 INSTALLATION AND CONFIGURATION 3 1 Overview 3 2 IP Addresses 3 3 UTM Installation 3 4 BNS Node Configuration 3 5 Software Installation 3 5 1 Prerequisites 3 5 2 Removing CommKit Host Interface Software 3 5 3 Installing IP CommKit Software 3 5 4 Registration 3 6 Customize the Control Tables 3 6 1 dkiptab 3 6 2 dkitrc and dkitcfg 3 6 3 dksrvtab 4 CONTROL TABLES 5 ADMINISTRATION 5 1 Files That Grow 5 2 dkitrc Script File 5 3 Special Device Files 5 4 Printer Administration 6 TROUBLESHOOTING 6 1 Overview 6 2 Procedures 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 6 2 1 Check that the UTM is in service 6 2 2 Check that the CPM is in service 6 2 3 Check the Mode Switch on the UTM 6 2 4 Ping the UTM from the host 6 2 5 Check var opt dk log dkipdlog 6 2 6 Check var opt dk log dkdaemonlog 6 2 7 Check var opt dk dksrvlog 6 3 Stopping and Starting 7 COMPATIBILITY 8 M
17. IP CommKit Installation and Administration Guide for AIX Release 1 0 22 AT422 2222 MS5A YVE3 While e mail is the best way to obtain a software key we can also give you one over the telephone Here are our names and numbers Dan Conklin Jacquie Kupper Senior Product Manager Senior Release Coordinator 732 667 1080 ext 162 732 667 1080 ext 149 With the software certificate number and software key you can register the IP CommkKit software on your host Log in a root and run the following command usr sbin dkregister The command will prompt you for the software certificate number and the software key then validate the values that you enter If they are correct it will save the registration information on the host s disk You will need to register your IP CommKit software on this host again when you install maintenance releases It s now a good time to customize your control tables If you had just re registered your IP Commkit software and do not need to customize your control tables start IP Commkit again See section 6 3 for details gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 3 6 CUSTOMIZE THE CONTROL TABLES 3 6 1 DKIPTAB IP CommKit must be stopped before you update this table See section 6 3 for details The dkiptab is a new control file for IP CommKit that tells the IP CommKit software the IP addresses assigne
18. Manual Section 3 for instructions on how to install the UTM and I O distribution board in the BNS node After you have installed the UTM and I O distribution board in the BNS node you must configure the UTM The initial configuration of the UTM must be done through its console port You can access the UTM console port in a variety of ways For example you can connect a dumb terminal directly to the console port on the I O distribution board You can also connect the console port into the BNS network through a SAM or TY module and then access the console through a terminal or host that is connected to the network Section 3 of the UTM User s Manual shows how to make connections to the UTM s console port gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 To configure the UTM you need an IP address and subnet mask that you will assign to the UTM as well as the IP address assigned to the host LAN interface If the UTM and host are not on the same subnet you will also need the IP address of a gateway that can forward packets from the UTM to the host Enter the following commands on the UTM console port lt TRK UNIV gt login passwd initial lt TRK UNIV gt lt TRK UNIV gt trk type IPDSU lt TRK UNIV gt trk modtype CPM lt TRK UNIV gt lo ipaddr utm_ip_address submask utm_subnet_mask lt TRK UNIV gt ga ipaddr gateway_ip address lt T
19. RK UNIV gt trk dest host ip address Here the IP addresses and subnet mask are shown in bold Italics You would replace these names with numbers when you enter the commands Enter the following command to check the configuration 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 lt TRK UNIV gt vfy mod The output should be similar to the report below Current Configuration DK Board Type gt TN1009 CPM HS w Serial 136 Service State gt Out of Service Operating Mode gt Simplex Trunk Type gt IP DSU Compatible Trunk on 10BaseT Network Port IP DSU Loopback Status gt Loopbacks are not enabled IP DSU Data Encryption Status gt Disabled Actual IP DSU Service State gt Not Connected Local MAC Address gt 0 19 5 84 49 56 Local IP Address gt utm ip address Subnet Mask gt subnet_mask Gateway IP Address gt gateway ip address IP DSU Destination IP Address gt host ip address SNMP Trap Manager gt Not defined Check the address and subnet mask fields that you entered If they are correct enter the following command to restore the UTM to service lt TRK UNIV gt rs gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 The UTM has many useful console commands that are not described here See section 4 of the
20. VING Some hosts run several dkserver processes The last line should be repeated for each dkserver process You might see an error message similar to the one below in the log file Dec 19 17 00 59 515 0 000 ERROR dkmgr Unable to create server server_name dk_errno 3 The indicates that the address server_name has not been entered on the BNS node or that the address is not in service Enter the following command on the BNS node to check the address CCO gt ver addr all server name The report should be similar to the one below gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 00 12 19 17 16 42 NODE node_name verify address all server_name MNEMONIC ADDRESS server_name X 121 NANP ADDRESS LEVEL local SERVICE STATE in PAD SUPPORT no ECTORY none URITY none GROUP group_name If the report indicates that the address has not been entered enter it using the instructions in the BNS Node Configuration section of this document If the report shows that the address is out of service restore the address with the following command CCO gt res addr local server name When dkserver starts it tells the BNS node that it is ready to accept incoming calls You can confirm this by entering the follow command on the BNS node console CCO gt disp conn mod mod address gt 11 28 05 Datatek Applicatio
21. ce number 16384 This device is used exclusively by dkipd to initialize the driver when it starts up 5 4 PRINTER ADMINISTRATION There are several figures in this section that show fibers connecting hosts to CPM HS boards in the switches With IP Commkit the hosts are connected to UTMs in the switches through IP networks gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 6 TROUBLESHOOTING 6 1 OVERVIEW This section describes troubleshooting procedures for IP Commkit It supercedes the Troubleshooting section of the Commkit Host Interface for NCR PCI Computers Installation and Administration Guide 6 2 PROCEDURES You are most likely to have difficulty with IP Commkit right after installation The following sections describe procedures for troubleshooting the most common problems encountered after installation If you are having difficulty start with the first procedure and work towards the end Resist the temptation to skip procedures that seem obvious 6 2 1 CHECK THAT THE UTM IS IN SERVICE Enter the following command on the UTM console port lt TRK UNIV gt vfy mod The output should be similar to the report below Current Configuration DK Board Type gt TN1009 CPM HS w Serial 136 Service State gt In Service Operating Mode gt Simplex Trunk Type gt IP DSU Compatible Trunk on 10BaseT Network Port gt
22. d to the UTM and the host LAN interfaces Even if you are upgrading a computer from the Commkit Host Interface to IP Commkit you still must enter the dkiptab before IP Commkit will operate While the installation scripts create a dkiptab file in the appropriate directory it contains only comments Fortunately the dkiptab is very easy to enter with your favorite text editor See the manual page dkiptab 4 for the file format and examples 3 6 2 DKITRC AND DKITCFG etc dkitre is a shell script that starts and stops the IP CommkKit software on the host computer The installation scripts configure inittab 4 so that etc dkitre is run automatically when the run level of the host computer changes i e at startup and shutdown Specifically the IP CommKit software starts when the host enters run level 2 and stops when the host enters either run level 0 or 1 The operation of dkitrc is controlled by etc opt dk dkitcfg The dkitrc and dkitcfg scripts for IP CommKit are different from the scripts used in some versions of Commkit Host Interface software If you are upgrading a computer from the Commkit Host Interface to IP Commkit and you customized the configuration in dkitre script you will need to customize the dkitcfg script supplied with the IP Commkit software The most common reason for customizing the dkitcfg script is to change the number of channels available per interface from the default value of 64 The dkitcfg script itself contai
23. he SOFTWARE including all component parts the media and printed materials any upgrades this LICENSE and if applicable the Certificate s of Authenticity and the recipient agrees to the terms of this LICENSE If the SOFTWARE is an upgrade any transfer must also include all prior versions of the SOFTWARE Without prejudice to any other rights Manufacturer may terminate this LICENSE if you fail to comply with the terms and conditions of this LICENSE In such event you must destroy all copies of the SOFTWARE and all of its component parts 9 2 INTELLECTUAL PROPERTY RIGHTS The SOFTWARE is licensed not sold to you The SOFTWARE is protected by copyright laws and international copyright treaties as well as other intellectual property laws and treaties You may not copy the printed materials accompanying the SOFTWARE All title and intellectual property rights in and to the content which may be accessed through use of the SOFTWARE is the property of the respective content owner and may be protected by applicable copyright or other intellectual property laws and treaties This LICENSE grants you no rights to use such content All rights not expressly granted under this LICENSE are reserved Manufacturer and its licensors if any gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 9 3 SOFTWARE SUPPORT SOFTWARE support is provided by Manufacturer or its affiliates o
24. is simple example there is one group with one UTM in the group We use the same name for the group and address in this example although it s not required CCO gt enter address gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 network area exchange local speedcall local lt Enter gt PE numeric mnemonic both mnemonic lt Enter gt MNEMONIC ADDRESS up to 8 chars nodename PAD SUPPORT yes no no lt Enter gt DIRECTORY ENTRY up to 30 chars double quoted none none appropriate description of host GROUP S up to 4 groups separated by commas none none nodename ORIGINATING GROUP NAME SECURITY PATTERN S comma separated pattern list same_as none none lt Enter gt INITIAL SERVICE EL network area exchange local speedcall local lt Delete gt Next enter the cpm In reality the com is a UTM but the BNS controller can t tell the difference In the dialog below you must use values for mod_address and num_channels that are correct for your configuration Use the slot number where you installed the UTM for the mod_address By default dkdaemon 1M sets the number of channels per UTM to 64 so use this value for num_channels lf you want to use more channels you must modify the dkitcfg file See section 3 6 2
25. it s not enter the following command on the node console CCO gt rs cpm mod address gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 6 2 3 CHECK THE MODE SWITCH ON THE UTM Verify the Mode switch on the faceplate of the UTM module is in the enabl position The Mode switch supports three positions Enabl Diag and Disab The Mode switch must be in the Enabl position for the UTM to function properly Reset Mode Enabl Switch p lJ Diag Disab Lp e Fault Lp Off Line Lp On Line Datatek TN 2524 UTM MTT TITI DSPQOOYAXX gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 6 2 4 PING THE UTM FROM THE HOST On the host computer enter the following command ping utm ip address In this command utm_ip_address is the IP address that you assigned to the UTM module The output should be similar to the report below utm ip address utm ip address utm ip address utm ip address The ping command will continue to print until you kill it If you don t get this output check that you are using the correct UTM IP address If you are you should enlist the aid of you IP network administrator Don t proceed until you can ping the UTM from the host 6 2 5 CHECK VAR OPT DK LOG
26. n and Administration Guide for AIX Release 1 0 22 If you received your software on a CD the software certificate number is printed on the label If the software was delivered electronically the software certificate number is included in the e mail message In either case you must save the software certificate number since it serves as your proof of purchase After installing the IP CommKit software on your host computer contact us to obtain a software key To generate your software key we need your software certificate number and the nodename of the host on which the software is installed To determine the nodename enter the following command on the host uname n This prints the host s nodename The best way to contact us is to send an e mail message to the following address ipcommkit datatekcorp com In addition to your software certificate number and your host s nodename please include your name your company s name your e mail address and telephone number Also include the revision number of the IP CommKit software This will help us to contact you when maintenance releases are available This documentation applies only to revisions starting with 1 0 12 0 Datatek will send you a reply with a software key that is generated from your software certificate number and your host s nodename For example here is the software key for Datatek s development machine gt 11 28 05 Datatek Applications Inc
27. ns Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 The report should be similar to the one below 00 12 19 17 46 20 NODE node_name M display connections mod mod_address MODULE 1 9 CH PT CU T PKT CNT STATE TO MOD CH PT CU T PKT CNT BOAR LC LC 295 ACTIVE group_name 89 SERVING Note that channel 2 is in the SERVING state 6 3 STOPPING AND STARTING Some configuration changes require stopping and starting the IP CommKit software to make the changes effective Specifically changes to etc opt dk dkiptab require stopping and starting You can always do this by rebooting the host computer However this can be disruptive and time consuming A more convenient method is to log in as root then enter the follow commands sh etc dkitre stop gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 sh etc dkitre start gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 7 COMPATIBILITY This section of the Commkit Host Interface for NCR PCI Computers Installation and Administration Guide describes the differences between UNIX System V Release 3 SVR3 and Release 4 SVR4 versions IP Commkit for AIX was derived from the SRV4 version so the information in this section also applies t
28. ns instructions for making modifications It should not be necessary to make any modifications to the dkitre script 3 6 3 DKSRVTAB If you are upgrading your computer from the Commkit Host Interface to IP Commkit it s likely that the tables used by dkserver see srviab 4 have already been customized No changes to these tables are needed to use IP Commkit gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 If you are installing IP Commkit on a computer that has never run the Commkit Host Interface software the installation script installs a default set of server tables usr sbin dkcust is a script that can automatically customize these default tables To use dkcust you should know the area and exchange assigned to the BNS node in which you install the UTM This information can be obtained by entering the verify node command on the BNS node console Ask your BNS node administrator if you need assistance To use dkcust simply run it and answer the questions gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 4 CONTROL TABLES The control tables used for the Commkit Host Interface are identical to those used for IP Commkit Refer to Control Tables section of the Commkit Host Interface for NCR PCI Computers Installation and Administration Guide for a detailed descripti
29. o IP CommKit However it s only useful if you are porting a Commkit Host Interface application that ran under SRV3 to IP Commkit UNIX is a registered trademark in the United States and other countries licensed exclusively through X Open Company Ltd gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 8 MANUAL PAGES Most of the manual pages for the Commkit Host Interface are identical to those for IP CommKit The following man pages have been eliminated ATDIAG DKCFG DKDIAG DKMAP DKREGISTER DKUNLOCK DKVFY PCDIAG These pages described commands that were used for copy protection or fiber interface hardware configuration and diagnostics These commands are not needed for IP Commkit The following manual pages have been added or revised for IP CommkKit DKIPD DKIPTAB DKITRC Use the man command to obtain copies of these pages gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 9 END USER LICENSE AGREEMENT FOR SOFTWARE This License Agreement License is a legal contract between you and the manufacturer Manufacturer of the software product s you acquired identified as SOFTWARE The SOFTWARE may include printed materials that accompany the SOFTWARE Any software provided along with the SOFTWARE that is associated with a separate end user license
30. on of the control tables IP CommKit has one additional control table dkiptab This file is read by dkipd when it starts to find the IP addresses assigned to the UTM and host LAN interfaces See the manual page dkiptab 4 for the file format and examples gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 5 ADMINISTRATION All of the topics discussed in the Administration section of the Commkit Host Interface for NCR PCI Computers Installation and Administration Guide apply to IP Commkit as well There are few minor changes and additions that are noted below 5 1 FILES THAT GROW dkipd creates a log file in var opt dk log dkipdlog This file will grow continuously although at a very slow rate compared to other log files and should be cleaned out periodically by the system administrator 5 2 DKITRC SCRIPT FILE In addition to starting dkdaemon and dkserver dkitrc starts dkipd 5 3 SPECIAL DEVICE FILES The minor devices for the diagnostic channels dev dk diag0 etc are not created for IP Commkit These devices were used for managing hardware diagnostics for the fiber interface board that is part of the Commkit Host Interface IP Commkit uses the LAN interface on your host computer and thus relies on the hardware diagnostics supplied with the LAN interface IP Commkit has one additional special device file dev dk dkip tied to minor devi
31. ou application or you may have made a typing error In the output above there was an error typing in the IP address of the UTM module Note that the error message indicates the line number where the error was detected gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 Dec 18 14 26 38 8810 Received keep alive message from unknown address 135 17 59 203 This output is typical when the UTM IP address you configured in dkiptab does not match the UTM IP address you configured through the UTM console If the messages that you see don t look similar to any of the examples above consult the dkipa 1M manual page This describes all messages that are written to the log file The primary responsibility for dkipd is to establish communications with the UTM You can confirm that dkipd and the UTM have established communications by issuing the vfy command on the UTM console The report should contain the following line Actual IP DSU Service State gt Peer Connectivity Established 6 2 6 CHECK VAR OPT DK LOG DKDAEMONLOG Enter the following command on the host computer tail 17 var opt dk log dkdaemonlog This displays the log file created by dkdaemon 1M The output should look similar to the following report Dec 18 14 55 09 8866 usr sbin dkdaemon Started Log Level 5 Dec 18 14 55 09 8867 acct_start Accounting Disabled
32. r file enter the following commands mkdir tmp ipcommkit cd tmp ipcommkit For AIX R4 3 hosts tar xf tmp ipckax tar For AIX R5 2 32 bit hosts tar xf tmp ipckax32 tar gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 To install the software enter the following command installp a d tmp ipcommkit ipcommkit If you want to install the IP CommKit manual pages enter one more command installp a d tmp ipcommkit ipcommkitShare Your host is now configured to start the IP CommKit software automatically at boot time You can reboot your host but you will need to register your copy of the software and configure your control tables before you can use IP Commkit Refer to those procedures later in this document To reboot your host enter the following commands ed shutdown F r 3 5 4 REGISTRATION Starting with revision 1 0 12 the IP CommKit software is copy protected You must obtain a software key and register your copy of the software before you can use IP Commkit Here is how the registration process works When you purchase IP Commkit we provide you with a software certificate number For example here is the software certificate number for the IP CommKit software running on one of Datatek s development machines 20AX523 000603 5F AH gt 11 28 05 Datatek Applications Inc IP CommKit Installatio
33. r subsidiaries separate from the host computer on which it may be installed SOFTWARE support is limited to the warranty period stated below unless either a separate contract has been consummated between you and the manufacturer or the manufacturer has agreed in writing at the time of purchase by you of the software to an extension of the warranty Should you have any questions concerning this LICENSE or if you desire to contact Manufacturer for any other reason please refer to the address provided in the documentation for the SOFTWARE 9 4 EXPORT RESTRICTIONS You agree that you will not export or re export the SOFTWARE to any country person or entity subject to U S export restrictions You specifically agree not to export or re export the SOFTWARE i to any country to which the U S has embargoed or restricted the export of goods or services which as of March 1998 include but are not necessarily limited to Cuba Iran Iraq Libya North Korea Sudan and Syria or to any national of any such country wherever located who intends to transmit or transport the products back to such country ii to any person or entity who you know or have reason to know will utilize the SOFTWARE or portion thereof in the design development or production of nuclear chemical or biological weapons or iii to any person or entity who has been prohibited from participating in U S export transactions by any federal agency of the U S government 9 5 LIMITED WARR
34. s the host computer establishes communications with the BNS node controller You can confirm this by running the following command on the BNS node console gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 CCO gt disp conn mod mod address Here mod_address is the slot number where you installed the UTM The output should look similar to the report below 00 12 19 17 46 20 NODE node_name M display connections mod mod_address MODULE 19 CH PT CU TM GROUP PKT CNT STATE PKT CNT BOARD CS LCH PT LCH PT DLCI Note that channel 1 is in the ACTIVE state 6 2 7 CHECK VAR OPT DK DKSRVLOG Enter the following command on the host computer tail var opt dk log dksrvlog TO MOD CH PT CU TM GROUP gt 11 28 05 Datatek Applications Inc IP CommKit Installation and Administration Guide for AIX Release 1 0 22 This displays the log file generated by dkserver 1M The last few lines of the output should look similar to the following report Dec 18 14 55 11 8893 0 000 SERVER dino is INI files etc opt dk srvtab etc opt dk dkuidtab loglv1l 6 Dec 18 14 55 11 8893 0 000 dkmgr SERVER dino is ACTIVE and SERVING The host file where this log file was generated is named dino and it runs a single dkserver process The last line of the log file indicates that dkserver is ACTIVE and SER
35. ssumes a basic knowledge of IP networks If you don t have this knowledge we recommend that you learn a little about them We recommend nternetworking with TCP IP by Douglas E Comer Otherwise enlist the help of your IP network administrator Each UTM module requires an IP address as does the host computer You should obtain IP addresses for the UTM modules from your IP network administrator This document assumes that the host computer is already connected to a LAN and thus already has an IP address assigned to it If your host connects to several LANs it will have several IP addresses assigned to it one for each LAN You should find out the addresses assigned to the LAN that the host will use for communicating with the UTM You need the host s IP addresses in numeric form for configuring the UTM To obtain this enter the following command on the host computer ifconfig a The command should produce output similar to the following 100 flags 4049 lt UP LOOPBACK RUNNING MULTICAST gt mtu 8232 inet 127 0 0 1 netmask ff000000 le0 flags 4043 lt UP BROADCAST RUNNING MULTICAST gt mtu 1500 inet 135 17 59 166 netmask ffffff00 broadcast 135 17 59 255 In this example the host has one LAN interface labeled e0 The inet field in the report shows that the IP address assigned to e0 is 135 17 59 166 To configure the UTM you also need the subnet mask for the IP subnets to which it attaches Most often an IP subnet corresponds
Download Pdf Manuals
Related Search