Datatek HP-UX User Manual
379 Campus Drive, Suite 100
TM
I
NSTALLATION AND ADMINISTRATION
G
FOR
UIDE
HP-UX®
Somerset, NJ 08873
fax: 732.667.1091
phone: 732.667.1080
email: sales@datatekcorp.com
http://www.datatekcorp.com
R
ELEASE
I
SSUE 2
1.0.22
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
TABLE OF CONTENTS
1 INTRODUCTION .............................................................................................4
1.1
What is IP-CommKit? .....................................................................................4
2 DOCUMENTATION.........................................................................................5
3 INSTALLATION AND CONFIGURATION ......................................................6
3.1
Overview .........................................................................................................6
3.2
IP Addresses...................................................................................................6
3.3
UTM Installation..............................................................................................8
3.4
BNS Node Configuration..............................................................................10
3.5
Software Installation ....................................................................................14
3.5.1 Prerequisites............................................................................................................ 14
3.5.2 Removing CommKit Host Interface Software ...................................................... 14
3.5.3 Installing IP-CommKit Software............................................................................. 15
3.5.4 Registration ............................................................................................................. 18
3.6
Customize the Control Tables .....................................................................21
3.6.1 dkiptab...................................................................................................................... 21
3.6.2 dkitrc and dkitcfg .................................................................................................... 21
3.6.3 dksrvtab ................................................................................................................... 22
4 CONTROL TABLES .....................................................................................23
5 ADMINISTRATION .......................................................................................24
5.1
Files That Grow ............................................................................................ 24
5.2
dkitrc Script File ..........................................................................................24
5.3
Special Device Files .....................................................................................24
5.4
Printer Administration..................................................................................25
6 TROUBLESHOOTING ..................................................................................26
6.1
Overview .......................................................................................................26
6.2
Procedures....................................................................................................26
10/13/11
Datatek Applications Inc.
2
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
6.2.1 Check that the UTM is in service ........................................................................... 26
6.2.2 Check that the CPM is in service........................................................................... 27
6.2.3 Check the Mode Switch on the UTM ..................................................................... 29
6.2.4 Ping the UTM from the host ................................................................................... 30
6.2.5 Check /var/opt/dk/dkipdlog .................................................................................... 30
6.2.6 Check /var/opt/dk/log/dkdaemonlog ..................................................................... 32
6.2.7 Check /var/opt/dk/dksrvlog .................................................................................... 34
6.3
Stopping and Starting ..................................................................................37
7 COMPATIBILITY...........................................................................................38
8 MANUAL PAGES .........................................................................................39
9 END-USER LICENSE AGREEMENT FOR SOFTWARE .............................40
9.1
SOFTWARE LICENSE ..................................................................................40
9.2
INTELLECTUAL PROPERTY RIGHTS..........................................................40
9.3
SOFTWARE SUPPORT.................................................................................41
9.4
EXPORT RESTRICTIONS .............................................................................41
9.5
9.6
9.7
9.8
LIMITED WARRANTY ...................................................................................41
NO OTHER WARRANTIES ...........................................................................41
SPECIAL PROVISIONS.................................................................................42
LIMITATION OF LIABILITY ........................................................................... 42
10/13/11
Datatek Applications Inc.
3
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
1 1
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
1 I N T R O D U C T I O N
1.1 W
HAT IS
IP-C
OMMKIT
?
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. No need to recompile your applications.
H o s t a n d N od e I n t e rfa c e s
C om m K i t
H os t In ter fa c e
BE FO RE ...
B EF O RE ...
O S H o s t
C om pu ter
F IBE R
M OD U L E
F I B E R O PT IC CA B L E
L I M IT E D DI S T A N C E
S E P AR AT ION
C PM H S
B NS - 2 00 0
o r
B NS - 2 00 0 V CS
IP -C o m m K it
H os t In ter fa c e
1 0 / 1 0 0 Ba s e TIP1 0 / 1 0 0 Ba s e T
AF TE R.. .
A FT E R.. .
O S H o s t
C om pu ter
S T AN D AR D
L AN
M OD U L E
U TM
A NY W H E RE
B NS - 2 00 0
o r
B NS - 2 00 0 V CS
IP-CommKit is a trademark of Alcatel-Lucent, Inc., licensed to Datatek Applications, Inc., a company
independent of Alcatel-Lucent, Inc.
Datakit is a registered trademark of Alcatel-Lucent, Inc., licensed to Datatek Applications, Inc., a company
independent of Alcatel-Lucent, Inc.
10/13/11
Datatek Applications Inc.
4
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
2 D O C U M E N T A T I O N
Since IP-CommKit behaves like a CommKit 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 HP computers
running HP-UX, IP-CommKit 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 HP computers.
HP-UX and HP are registered trademarks of Hewlett Packard, Inc. Systems Division.
10/13/11
Datatek Applications Inc.
5
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
3 I N S T A L L A T I O N A N D C O N F I G U R A T I O N
3.1 O
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:
• Obtain an IP address for the UTM and determine the appropriate subnet mask. Also
• 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.
VERVIEW
determine the host IP address and, if needed, a gateway IP address.
• Install the IP-CommKit software on the host computer
• Customize the dkiptab and, if needed, dkitcfg and the other control tables.
The following sections describe each step in detail.
3.2 IP A
This section assumes a basic knowledge of IP networks. If you don’t have this knowledge, we
recommend that you learn a little about them. We recommend Internetworking with TCP/IP, by
Douglas E. Comer. Otherwise, enlist the help of your IP network administrator.
10/13/11
DDRESSES
Datatek Applications Inc.
6
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
Each UTM requires an IP address, as does the host computer. You should obtain IP addresses
for UTMs 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, take a look at the file /etc/rc.config.d/netconf with pg, vi, or whatever you like to use to
look at text files. It is a shell script provided by HP that configures the LAN interfaces on your
machine at boot time. This file contains good comments from the HP developers, but the
important lines are the assignments to array variables with the name IP_ADDRESS and
SUBNET_MASK. Here is a sample of the relevant lines:
INTERFACE_NAME[0]=lan0
IP_ADDRESS[0]=135.17.59.216
SUBNET_MASK[0]=255.255.255.0
This host has one LAN interface named lan0, and its assigned IP address is 135.17.59.216.
To configure the UTM, you also need the subnet mask for the IP subnet to which it attaches.
Most often, an IP subnet corresponds to a LAN segment. For example, all interfaces attached to
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, you can find out the subnet
mask from the /etc/rc.config.d/netconf file. In the previous example, the subnet mask is
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
10/13/11
Datatek Applications Inc.
7
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
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 I
Consult the UTM User’s 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.
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
NSTALLATION
UTM to the host.
Enter the following commands on the UTM console port.
<TRK-UNIV> login passwd=initial
<TRK-UNIV> rm
10/13/11
Datatek Applications Inc.
8
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
<TRK-UNIV> trk type=IPDSU
<TRK-UNIV> trk modtype=CPM
<TRK-UNIV> lo ipaddr=utm_ip_address submask=utm_subnet_mask
<TRK-UNIV> ga ipaddr=gateway_ip_address
<TRK-UNIV> 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:
<TRK-UNIV> vfy mod
The output should be similar to the report below.
Current Configuration:
DK Board Type ==> TN1009 (CPM-HS) w/Serial# 136.
Service State ==> Out of Service.
Operating Mode ==> Simplex.
Trunk Type ==> IP-DSU Compatible Trunk on 10BaseT Network Port.
10/13/11
Datatek Applications Inc.
9
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
IP-DSU Loopback Status ==> Loopbacks are not enabled.
IP-DSU Data Encryption Status ==> Disabled.
Actual IP-DSU Service State ==> Not Connected.
Local MAC Address ==> 0.19.5.84.49.56
Local IP Address ==> utm_ip_address
Subnet Mask ==> subnet_mask
Gateway IP Address ==> gateway_ip_address
IP-DSU Destination IP Address ==> host_ip_address
SNMP Trap Manager ==> 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.
<TRK-UNIV> rs
The UTM has many useful console commands that are not described here. See section 4 of the
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 telnet to the UTM from the host on which you
installed the IP-CommKit software.
3.4 BNS N
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.
ODE CONFIGURATION
10/13/11
Datatek Applications Inc.
10
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
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. If you find
this confusing, you can use the setuname(1M) command to make the system name and node
name the same.
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. <Enter> and <Delete> refer to the enter and delete keys on your keyboard.
10/13/11
Datatek Applications Inc.
11
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
CC0> 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)]: <Enter>
PASSWORD [up to 8 chars, none: +(none)]: <Enter>
ROUND ROBIN SERVICE [per_port, per_module, none: +(none)]: <Enter>
GROUP [up to 8 chars]: <Delete>
Next, enter an address. An address is bound to one or more groups. In this 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.
CC0> enter address
LEVEL [network, area, exchange, local, speedcall: +(local)]: <Enter>
TYPE [numeric, mnemonic, both: +(mnemonic)]: <Enter>
MNEMONIC ADDRESS [up to 8 chars]: nodename
PAD SUPPORT [yes, no: +(no)]: <Enter>
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)]:
10/13/11
Datatek Applications Inc.
12
I P - C o m m K i t I n s t a l l a t i o n a n d A d m i n i s t r a t i o n G u i d e
f o r H P - U X – I s s u e 2 – R e l e a s e 1 . 0 . 2 2
<Enter>
INITIAL SERVICE STATE [in, out: +(out)]: in
LEVEL [network, area, exchange, local, speedcall: +(local)]: <Delete>
Next, enter the cpm. In reality, the cpm 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. If you want to use more channels, you must modify the dkitcfg file. See section
3.6.2
CC0> enter cpm
MODULE ADDRESS: mod_address
COMMENT [up to 60 chars double quoted, or none: +(none)]:
"appropriate comment"
HARDWARE TYPE [422, hs: +(hs)]: <Enter>
NUMBER OF CHANNELS [3-512: +(32)]: num_channels
CALL SCREENING PROFILE ID [up to 8 chars, none: +(none)]: <Enter>
CONNECT-TIME BILLING [on, off: +(off)]: <Enter>
SINGLE OR MULTIPLE GROUPS [single, multiple: +(single)]: <Enter>
GROUP [up to 8 chars]: nodename
ENDPOINT NUMBER OR RANGE [0000-9999, none: +(none)]: <Enter>
MODULE ADDRESS: <Delete>
10/13/11
Datatek Applications Inc.
13
Loading...