Installation Guide
Installation Guide
CSTA V1
10-2009
This device has been manufactured in accordance with our certified en-
vironmental management system (ISO 14001). This process ensures
that energy consumption and the use of primary raw materials are kept
to a minimum, thus reducing waste production.
ca4000_shortivz.fm
HiPath 4000 CSTA V1
Brief Overview
1 Important Notices
2 Product Overview
3 Planning for Installation of HiPath 4000 CSTA
4 Installing HiPath 4000 CSTA
5 Using HiPath 4000 CSTA
6 Performing Problem Determination
B Administration on HiPath 4000
Glossary
Index
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide X-1
cstaTOC.fm
Contents
Contents 0
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 0-1
cstaTOC.fm
Contents
A31003-G9310-I200-1-76D1, 08-2010
0-2 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
cstahis2.fm
History of Changes 0
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 0-3
csta0012.fm
Safety
1 Important Notices
1.1 Safety
The following information is included in this publication for the use and safety of installation and
maintenance personnel.
DANGER
! Do not take chances with your life. Follow these safety guidelines carefully.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 1-1
csta0012.fm
Safety
● Do not work alone. Work with another person who knows the locations of the power-off
switches, especially if you are working with exposed electrical circuits.
● Follow the instructions in the manual carefully, especially when working with circuits that
are powered. Disconnect power when instructed to do so in the procedures.
● Disconnect all power before working near power supplies unless otherwise instructed by a
maintenance procedure.
● Disconnect all power before installing changes in machine circuits unless otherwise in-
structed by a maintenance procedure.
● High voltages capable of causing shock are used in this equipment. Be extremely careful
when measuring high voltages and when servicing cards, panels, and boards while the
system is powered on.
● Do not wear jewelry or other metal objects.
● When possible, work with one hand so that a circuit is not created. Keep the other hand in
your pocket or behind your back.
● Use caution when installing or modifying telephone lines. Never install telephone wiring
during an electrical storm.
● Never install a telephone jack where it can get wet unless the jack is specifically designed
for wet conditions.
● Never touch uninsulated telephone wires or terminals unless the telephone line has been
disconnected at the network interface.
● Avoid using a telephone (other than the cordless type) during an electrical storm due to the
remote risk of shock from lightning.
A31003-G9310-I200-1-76D1, 08-2010
1-2 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0012.fm
Safety
● The surface of a mirror is conductive. Do not touch powered circuits with a mirror. To do so
can cause personal injury and machine damage.
● Do not store combustible gases or flammable materials in cabinets near the site.
1.1.2.3 Emergencies
● Be familiar with first aid for electrical shock. This includes resuscitation methods, heartbeat
restoration, and burn treatment.
● Use caution if an accident occurs. Disconnect the power before touching the victim.
● If you do not know how to disconnect the power, use a nonconductive object, such as a
wooden rod, to push or pull the victim away from electrical contact.
● Administer resuscitation if the person is not breathing.
● If you are trained and certified, administer cardiac compression if the heart is not beating.
● Call a rescue group, an ambulance, or a hospital immediately.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 1-3
csta0012.fm
Documentation Feedback
1.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 1-5
csta0022.fm
2 Product Overview
HiPath 4000 CSTA is a Siemens Business Communications product that allows you to integrate
telephony and data processing equipment to take advantage of business applications that can
be supported only by linking these two resources. Specifically, HiPath 4000 CSTA allows you
to link the Siemens HiPath 4000 Communication Server (CS) with telephony applications re-
siding in computer system environments that support the CSTA protocol. CSTA is an interna-
tional standard for computer-controlled telephony set forth by an international standards orga-
nization called the European Computer Manufacturers Association (ECMA).
HiPath 4000 CSTA V1 is the successor of HiPath CAP Inside V1. This middleware is available
as “stand alone” variant (installable on PC) – supporting HiPath4000 V5 (and smaller), and as
second variant is integrated into the OpenScape 4000 V6. See the following picture for better
understanding:
APPLICATION APPLICATION
CSTA ASN.1 / XML CSTA ASN.1 / XML
HP 4K V6 HP4K V5 / V4
Senario 1 Senario 2
The HiPath 4000 CSTA stand alone variant - server program, which is installed on a PC system,
performs the protocol conversion that allows the HiPath 4000 to communicate with computer
system environments that support the CSTA protocol. In this document, the PC system on
which HiPath 4000 CSTA server program resides is referred to as the CSTA CTI server.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 2-1
csta0022.fm
The application connectivity link is a proprietary protocol that connects the CSTA CTI server to
the HiPath 4000. The physical connection of the CSTA CTI server to the HiPath 4000 is a TCP/
IP LAN connection.
Connectivity link
Agent Workstation
Figure 2-1 Overview of Hipath CTI system
Figure 2-1 shows how HiPath 4000 CSTA allows communication between the HiPath 4000 and
the CSTA CTI server. In this document, the use of HiPath 4000 Communication Server (CS)
refer to all models except where noted.
A31003-G9310-I200-1-76D1, 08-2010
2-2 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0022.fm
viding first party control. An example of first party control is when an application residing inside
a desktop computer allows the user to control the HiPath 4000 telephony through the CTI ap-
plication. The application may present a list of names to the user, allowing the user to highlight
any name on the list in order to place a call. In this case, the application acts as an agent for
the user, issues the command to make a call, receives the HiPath 4000 response, and forwards
the called number to the HiPath 4000 for processing. In this way, the application performs sev-
eral actions for the user in response to a single action from the user.
If the application resides on a server and provides telephony control for a number of users such
as a workgroup or department, the CTI application is said to provide third party control. In third
party control, the application resides in a server connected to a LAN. The clients may send their
telephony requests directly to the server, using their personal computer applications. The serv-
er interprets the requests and issues the appropriate commands to the HiPath 4000. The CTI
application residing in the server acts as the agent for all LAN clients.
LAN Environment
The LAN environment that complements the HiPath 4000 system to enable CTI consists of one
or more client computers attached to a CTI server. The clients are able to use the CTI server
to exchange information with the HiPath 4000. The CTI server exchanges information with the
HiPath 4000 by using the Siemens proprietary CTI protocol.
The CTI server consists of two major telephony software modules: HiPath 4000 CSTA and
CSTA application software.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 2-3
csta0022.fm
PBX
CSTA CTI server Agent
workstation
NIC
CSTA
CTI link software application workstation
Agent
workstation
Windows operating system
Figure 2-2 Typical CTI LAN Environment with CSTA Application in the Server
Figure 2-2 on page 2-4 shows a typical LAN CTI environment with the CSTA applications in the
CSTA CTI server.
A31003-G9310-I200-1-76D1, 08-2010
2-4 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0022.fm
The main goal of HiPath 4000 CSTA is to allow applications using the CSTA (Computer- Sup-
ported Telecommunications Applications) protocol to connect to HiPath4000 switches. CSTA
refers to the standards of the European Computer Manufacturing Association (ECMA) for Com-
puter-Telephony Integration (CTI). HiPath 4000 CSTA supports the CSTA Phase III ASN.1 pro-
tocol.
The translation between the CSTA and the ACL protocols happens in the Connectivity Adapters
(CA) called CA4000 in case of HiPath4000.
There can be multiple numbers of CA's in one HiPath 4000 CSTA installation, one Connectivity
Adapter can connect to one switch, but using multiple link pairs it's possible to have more Con-
nectivity Adapters to use the same switch.
Maximum 4 applications can connect to a CA at the same time.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 2-5
csta0032.fm
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 3-1
csta0032.fm
Siemens
Planning Task Customer Personnel
Defining your business requirements *
Defining the effect of your business applications requirements on the HiPath 4000 *
Preparing your site and personnel for HiPath 4000 CSTA installation *
Scheduling your installation activities *
Scheduling Siemens installation activities *
Ordering all prerequisite hardware and software to be installed in the HiPath 4000 and the *
CTI server
Contacting your LAN supplier to ensure the LAN equipment (CTI server) will be installed *
before installation of HiPath 4000 CSTA
Contacting your network services provider if you require public network services *
A31003-G9310-I200-1-76D1, 08-2010
3-2 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0032.fm
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 3-3
csta0032.fm
A31003-G9310-I200-1-76D1, 08-2010
3-4 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0032.fm
Ordering Equipment
Please note that the order numbers listed in the following tables may change. Refer
I to the most recent version of the Siemens Ordering Notes from your Siemens rep-
resentative for the current order numbers.
Table 3-5 CTI Server Hardware and Memory Required for the HiPath 4000 CSTA product
(TCP/IP Connection)
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 3-5
csta0032.fm
Ordering Equipment
A31003-G9310-I200-1-76D1, 08-2010
3-6 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-1
csta0042.fm
4.3 Preparing for the HiPath 4000 (V5 or older) Hardware Installation
This chapter corresponds only to the HiPath 4000 V5 (or older version)!
The HiPath 4000 system has integrated Ethernet server buses, which can be used to connect
the HiPath 4000 CSTA Server via an Ethernet TCP/IP connection. A TCP/IP connection is a
logical data connection between two addresses, each consisting of a port number (for the TCP)
and a logical IP address. With this type of configuration, a number of different logical destina-
tions can be reached via one physical address, the TCP port number. The transmission control
protocol ensures that the transmitted data pakets reach the logical Internet Protocol destination
address in the correct sequence and without loss. If an error occurs, the entire connection is
terminated.
The below diagram shows the possible ways to connect to Siemens Hipath 4000:
PBX
CSTA CTI server
ACL
WAML
Interface
ACL
PBX
CSTA CTI server
SL200
Interface
ACL
ATL
Although it is possible to configure the CSTA CTI Server using only one LAN card, it is not rec-
ommended.
A31003-G9310-I200-1-76D1, 08-2010
4-2 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
4.3.1.2 IP-Addresses
Servers connected to the Atlantic LAN are accessed via IP addresses (IP network numbers
plus server numbers). The IP network number of the Atlantic LAN is ’192.0.2’, which defines a
Class C internet address. All the servers connected to the Atlantic LAN use this network num-
ber.
The IP addresses of the Hicom components are fixed, as follows:
CC-A: 192.0.2.1
CC-B: 192.0.2.2
ADS/ADP: 192.0.2.3
The following address ranges are reserved for the external applications:
ext. ACD-Server: 192.0.2.10 - 192.0.2.19 (default: 192.0.2.16)
HiPath CAP: 192.0.2.23 - 192.0.2.29 (default: 192.0.2.25)
If more than one HiPath HiPath 4000 CSTA is connected to the same Atlantic LAN, each server
must be given a unique IP address. The default address for the first HiPath 4000 CSTA server
is 192.0.2.25; for each additional server, the address is incremented by 1 (192.0.2.26,
192.0.2.27, etc.). Maximal 5 servers can be connected.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-3
csta0042.fm
The WAML board and the SL200 board cannot be configured at the same time.
!
A31003-G9310-I200-1-76D1, 08-2010
4-4 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
The maximum number of permitted Monitored Devices. Any attempt by the application to
set more monitoring points than permitted by the maximum number of monitored devices
will be rejected.
3. Call processing timers must be set
AMO: CTIME, customer-specific cp timers, switching unit
Administrating the call processing timers, which are evaluated by the "MakeCall" event.
4. Physical ports for TCP/IP data communication must be configured
AMO: CPTP, communication parameters for tcp/ip-connection
Type: DVAVERB
5. Application interface parameters must be set (transport address)
AMO: CPTP, communication parameters for tcp/ip-connection
Type: APPL
6. ACL Manager parameters must be configured
AMO: ACMSM, acl manager communication parameter
APPLTYP=ACLAPPL
7. Sub-application parameters must be configured
AMO: XAPPL, DVA - application ACL
8. amo applications administration
AMO: APC
Some of the parameters set with AMOs must also match the corresponding values set in the
configuration of HiPath CAP.
In particular, these are:
Password (ACMSM)
Send/receive block size (ACMSM)
P address of gateway (CPTP)
ACL-C events generated (XAPPL)
Sub-application ID (XAPPL)
In HiPath 4000 "monoprocessor" system (only one CPU for ADS and SWU func-
I tions), the ACM is activated and then resident in the SWU!
In case of a “dualprocessor system” the ACM should be activated in the ADS!
For AMOs used on the HiPath 4000 refer to Appendix A, “Administration on HiPath/
Hicom”
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-5
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
4-6 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
When UnixWare is finished rebooting and all UnixWare services have started, go to UBA again
and select the 'Routes' menu point. Click on the 'New Route' icon (top right in right-hand frame).
Select the 'Default' checkbox, and fill in the Gateway value provided by your System Adminis-
trator and type in 3 for Metric. The Netmask value can normally be left blank, consult your
SysAdmin if it needs to be entered. Then 'Add' the Route, wait for the Route to appear in the
table, and reboot UnixWare.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-7
csta0042.fm
After the LAN Configuration for the the SL200 are set via the 'LAN Cards' and 'Routes' options
and UnixWare is rebooted, then following steps need to be followed:
1. Select the 'Firewall' option under the LAN Configuration After a few seconds the Firewall
settings will come up in the right hand frame.
2. In the 'New Firewall Entry' box 'Host' will be selected by default. Click on the 'Address' radio
button.
3. Fill in the IP address of the machine you wish to access HiPath 4000 CSTA from.
A31003-G9310-I200-1-76D1, 08-2010
4-8 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
4. Under the 'Access' area, make sure that only the ADP menu point is checked.
5. Click on the 'Add' Button.
6. After a few seconds a new line will be added to the Host / Net table at the top of the right-
hand frame.
7. If additional workstations need to be added, then the 'New FireWall Entry' icon the top right
hand corner can be selected, and steps 2-6 need to be repeated for each additional work-
station. Once the machine is added to the list it should be immediately available for use
with HiPath 4000 CSTA.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-9
csta0042.fm
For AMOs used on the HiPath 4000 refer to Appendix A, “Administration on HiPath/
I Hicom”
A31003-G9310-I200-1-76D1, 08-2010
4-10 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
Installing and Configuring the Ethernet Card (TCP/IP) in the CTI Server (only under Microsoft
4.5 Installing and Configuring the Ethernet Card (TCP/IP) in the CTI
Server (only under Microsoft operating sytsmes)
The customer should install the Ethernet card in the CTI server using the procedures accom-
panying the card. During the Ethernet card installation, record the following values in Table 4-
1 for later use:
Parameter Value
I/O Base Address (Card Port number)
Interrupt Request Level (Card Interrupt number)
IP Address of HiPath 4000 CSTA network interface card* (NIC).
*The 3COM Etherlink III ISA/adapter card is the NIC board tested.
1. The name of this screen depends upon the card you are installing.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-11
csta0042.fm
Installing and Configuring the Ethernet Card (TCP/IP) in the CTI Server (only under Microsoft
A31003-G9310-I200-1-76D1, 08-2010
4-12 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
Installing and Configuring the Ethernet Card (TCP/IP) in the CTI Server (only under Microsoft
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-13
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
4-14 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-15
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
4-16 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
Licensing
4.8 Licensing
HiPath 4000 CSTA uses HiPath License Management ("Single System Licensing" mode) for li-
censing.
HiPath License Management CLC is integrated into the installer of HiPath 4000 CSTA, but as
in the case of "Single System Licensing" no configuration is necessary, the change is not visi-
ble.
The CLA and CLM components of the HiPath License Management should be installed sepa-
rately! (For more information please see: Licensing_Guideline_V5.pdf Chapter Single System
Licensing (CSC))
Licenses for HiPath 4000 CSTA are "user clients" allowing a single application of a certain in-
stallation to connect to a CA and monitor specific numers of devices.
The licenses are bound to the MAC address of installation PC.
Three license modes are available and tese differ in the number of possible monitor points. The
three modes are: “no license”, “100 clients”, and “unlimited”. For the two last modes a licens is
required which is checked at the connection of the CTI application. The maximum number of
the allowed monitor points in the different modes:
The application identifies itself with an Application-ID. These coudl be the following: CAP-Call-
Rec,CAP-CallCenter or CAP-CommCtrl.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-17
csta0042.fm
Licensing
Licensing can be set through the web based configuration interface on the application config-
uration dialog in the “license type” option. When the license mode is changed the application
connection is automatically closed by the HiPath 4000 CSTA and the CTI application has to re-
connect.
The lciense mode is stored also in the configuration file of the corresponding CB-Driver, the
config option is the following:
LICENSE_TYPE_<applicatio id>=<license mode>
Where <application id> is a digit from 1 to 4, and the<license mode> is either “no license”,
“100_clients” or “unlimited”.
A31003-G9310-I200-1-76D1, 08-2010
4-18 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
Restriction: The WEB based administration interface can be accessed only from one client. If
the administration interface is used from another clients parallel, then it can cause maulfunction
of the software.!
Use the following steps to configure the HiPath 4000 CSTA Administration program in the CSTA
Server:
1. Click in order the following: Start, Programs, Siemens, (OpenScape/HiPath 4000)
CSTAand CBAdmin.
The Admin screen.
Remark: If you want to reach the Admin interface of the HiPath 4000 CSTA from a client
PC, then start a browser (eg.: MS iexplorer) with the address
http://<IP of the CSTA server>:8080/CBAdmin/
2. Install and configure a new PBX link. (See Section 5.2, “Installing, configuring and remov-
ing a PBX connection”).
3. Check the bottom of the Admin screen to determine if the CBDriver is connected. If the
CBDriver is disconnected, refer to Table 6-4 on page 6-8.
When the Admin screen appears initially, select a Connectivity Adapter and choose the
Display menuitem in Status menu. The PBX Link should indicate Established. However,
the Application 1 Link will indicate N until the CSTA application is configured in the Admin
and the application is activated with the appropriate parameters.
If the PBX Link is N or you do not obtain the Admin screen, refer to Section 6.4, “Commu-
nications Link Problems”, on page 6-6 for assistance in resolving the problem.
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-19
csta0042.fm
4. From the start page choose a Connectivity Adapter and click Configuration.
The Configuration page shown in Figure 4-2 appears.
A31003-G9310-I200-1-76D1, 08-2010
4-20 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-21
csta0042.fm
9. Choose under the Configured applications Add new application button and the follow-
ing page appears:
A31003-G9310-I200-1-76D1, 08-2010
4-22 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-23
csta0042.fm
i) Please do not navigate awawayay from this page until a new page with the changes
and with the message “Application successfully added” does not appear!
10. Proceed to Section 4.10, “Installing the CSTA Application Software (Customer)”.
The TCP port number of the HiPath 4000 CSTA driver used to communicate
I with the CSTA application defaults. If the CSTA application must use a TCP port
number other than 1040, a conflict will arise. Refer to Section 5.3.2.2, “Configu-
ration Application Connection”, on page 5-11 for information on changing the
TCP port number of the HiPath 4000 CSTA driver.
2. If you changed the TCP port number, repeat the following steps in Section 4.9, “Verifying
the CSTA Server Administration Program”, on page 4-19, steps 1, 3, and 8 through 11e.
3. After installing and configuring the CSTA application software, proceed to Section 4.11, “In-
stalling pcANYWHERE32 8.0 Remote Connectivity Software”.
A31003-G9310-I200-1-76D1, 08-2010
4-24 HiPath 4000 CSTA V1, Installation and Problem Determination Guide
csta0042.fm
A31003-G9310-I200-1-76D1, 08-2010
HiPath 4000 CSTA V1, Installation and Problem Determination Guide 4-25