HiPath TAPI 170 TSP

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
TAPI 170 general configuration

HiPath TAPI 170 is a Telephony Service Provider software, which enables Microsoft TAPI based software applications to control or monitor terminals connected to HiPath platforms.


  • Third party TAPI service provider.
  • Full compatibility with the latest Microsoft TAPI 2.2/3.1 standard.
  • Designed to run on a Microsoft Windows 2008 based network server.
  • Telephone functionality available on every client PC via the TAPI 2.2/3.1 client/server architecture.
  • No additional TSP client software required.
  • Support of CSTA III protocol.
  • Support of several physical interfaces.
  • Permanent interface monitoring for high service reliability.
  • Automatic garbage collection releases seized resources after time out.
  • Developer Guide for TAPI implementation available.

-> Feature description in detail

Software versions

Latest Version (effective July 2014) is:

HiPath TAPI 120 V2 R1.70.0

This version supports 32-bit and 64-bit Microsoft Windows operation systems.

TAPI 170 general configuration

HiPath TAPI 170 is a server based third party TAPI service provider based on Microsoft´s remote TAPI concept. TAPI 170 is capable to monitor and control multiple devices via CSTA interface of the HiPath platform.

The CTI Link between the HiPath TAPI 170 Server PC and the HiPath platform is logically done by the CSTA III protocol. No physical connection is required between computer and phone. Hipath Platform and the HiPath TAPI 170 PC are connected to an Ethernet based LAN with TCP/IP protocol.

For connection of TAPI 170 (CTI Server) to OpenScape Office LX/MX only LAN interface is required.

Supported networking scenarios

HiPath TAPI 170 can be operated either in combination with a single OpenScape Office Platform (single node) or in combination with multi-node systems.

Operation in mixed 32 and 64-bit environment

Within a customer network different Windows operating systems can be used. The released constellations of 32 and 64-bit Windows operating systems, related to HiPath TAPI 170 V2 are shown in the tables below.

Scenario Server operating system TAPI 170 TSP variant Client operating system TAPI Client application Released
1 32-bit 32-bit 32-bit 32-bit yes
2 32-bit 32-bit 64bit 32-bit no
3 32-bit 32-bit 64bit 64-bit no
4 64-bit 64-bit 32-bit 32-bit yes
5 64-bit 64-bit 64bit 32-bit yes
6 64-bit 64-bit 64bit 64-bit yes


A TAPI Client PC with 64-bit operating system can operate either 32-bit or 64-bit TAPI applications (e.g. scenario 5 and 6).

A 64-bit TAPI 170 server can be operated together with a 32-bit remote client (scenario 4). The other way around (32-bit server, 64-bit client) it is not possible.

Prerequisites / Requirements

Platform/Phone Requirements

Supported systems

It is recommended to use the “Preferred Software Version” for the given products. The preferred software versions offer higher levels of functionality. However, the TAPI software might also operate with older software version with the caveat that recently added interoperability or advanced features may not be possible when using these versions. In cases, if a defect is found when using a backward compatible version, it may be necessary to update to the preferred version.

Supported phones

Not Supported phones

  • Standard H.323 phones
  • SIP Phones

PC Requirements

PC Hardware

In general the PC hardware equipment must meet the requirements of the Windows operating system. For each TAPI line configured 200 KB of additional RAM has to be provided.

TAPI 170 SW is not released for operation on virtual machines, even if one of the operating systems mentioned below are operated within the virtual machine.

PC Software

TAPI 170 is still functional with Windows Operating systems for which Microsoft has finished their support. But in case of TAPI 170 problem with these Operating Systems, UNIFY will not give any support.

Server operating systems:

  • Microsoft Windows 2008 Server, (32 & 64 -bit)
  • Microsoft Windows 2008 R2 Server, (64 -bit)

Terminal Server operating systems

  • Microsoft Windows 2008 Terminal Server, (32 & 64 -bit)
  • Microsoft Windows 2008 R2 Server, (64 -bit)

  • Citrix MetaFrame XP Feature Release 3 with SP3 (32-bit)
  • Citrix Terminal Server XEN APPS (32-bit)

Client operating systems (for remote TAPI):

  • Microsoft Windows Vista SP2 (32-bit) Home and Home Premium Edition are excluded
  • Microsoft Windows 7 (32 & 64-bit) Starter and Home Premium Edition are excluded

Not supported operating systems / servers

  • Microsoft Home Server
  • Micosoft Small Business Server


HiPath platform max. no of TAPI clients

OpenScape Office LX/MX


The maximum value of TAPI clients per platform does not represent the max number of monitor point available within a HiPath platform.

Functional Boundary Conditions

  • Server PCs with multiple network interface cards or Load Balancing must not be used.
  • Only Microsoft Windows clients are allowed.
  • All client PCs and the server must be members of one and the same domain.
  • LAN refer to the usage of Ethernet technology.
  • The TAPI feature range depends on the underlying CSTA feature set
  • HiPath platform monitor points are not exclusively for HiPath TAPI 170, but are available for all connected applications.
  • Maximum numbers of monitor point depend on HiPath platform model
  • Terminal Server environment
    • Terminal Server / Metaframe Server and HiPath TAPI 170 V2.0 have to be installed on the same server HW so that every user can only monitor his/her own line.
    • In a Terminal Server Farm architecture, every server needs its own HiPath TAPI 170 V2.0.
    • Licensing has to be done on every server separately - every line needs a separate license.
    • The maximum number of HiPath TAPI 170 V2.0 instances is four.

  • Operation in 64-bit operating system environments
    • Supported OS: Currently TAPI 170 TSP is released for Windows 7 64-bit Windows 2008 64-bit and Windows 2008 R2. It is not intended to support older 64-bit Windows operating systems.
    • Networking: The release of HiPath 5000 RSM at the time of TAPI 170 V2R1.64 SW release is limited on 32-bit Windows operating systems. This has the effect, that TAPI 170 can be used for networked systems with HiPath 5000 RSM only in the 32-bit version.
    • Simultaneous operation of HiPath TAPI 170 64 bit and Microsoft Office 32 bit is not possible. In this case Microsoft Office 64 Bit has to be used or the applications have to be operated on different servers.


Many documents in various languages are available for HiPath TAPI 170. As there are:

  • Featuredescriptions
  • Datasheets
  • Administration manuals

The documents can be obtained from following sources:

Software Delivery

HiPath TAPI 170 software is shipped on a CD labelled "HiPath TAPI 120/ 170 V2 Service Provider" which is included in serveral order positions.

For service purposes the software can also be downloaded from the Software Supply Server of the manufacturer. software patches for dedicated problem corrections can be retrieved from the Knowledge Base within the Partner Portal (Partner Portal login required)of the manufacturer. Access to the two methods mentioned above is only granted by the manufacturer to registered partners on a contractual base.


For HiPath TAPI 170 TSP, the number of useable TAPI lines is licensed. Licenses are linked to the MAC addresses on the first Ethernet LAN card on the PC where the HiPath TAPI 170 TSP is installed. In multinode scenarios in connection with HiPath 5000 RSM, the MAC address of the first HiPath node is used to license the TAPI lines.

Central License Server (CLS) of the HiPath License Management (HLM) is used to generate the appropiate license keys in a file. The license file generated by CLS is copied into HiPath TAPI 170 TSP using its configuration menue. Afterwards the licenses can be assigned to the TAPI lines. CLA and CLM components of HLM are not reqiured.

For testing purposes, HiPath TAPI 170 TSP can be operated without a license for two hours. To do this, enter the text "DEMOMODE" instead of a license key. Three freely configurable lines will be available for testing. The testing period can be reset by restarting the PC. You can switch from test version to full version at any time by entering the license key.

Reuse of existing licenses after change from 32 to 64-bit

Existing TAPI 170 user licenses can be reused after upgrade of the operating system from 32 to 64-bit. Three constellations have to be considered for the license handling

  • Installation on the same computer HW with the same MAC address.

In this case the existing license data can be reused 1:1.

  • Installation on other computer HW with the same MAC address. (in case of reuse of the network interface card)

In this case the existing license data can be reused 1:1.

  • Installation on other computer HW with different MAC address.

Within this scenario the existing license keys have to be shifted to the new MAC address and a new license string has to be generated by the Central License Server. To do so the “Rehost” function of the Central License Server has to be applied.

Backward compatibility

Functions of HiPath TAPI 170 V2.0 are functional backward compatible to previous versions incl. the support of the license dongle of CTI TAPI 3P V2.0/V2.1. The compatibility does not apply for the support of "old" Microsoft operating systems and also not for the 64-bit variant.

Migration from TAPI 170 TSP V2 32-bit to TAPI 170 TSP V2 64-bit

HiPath TAPI 170 TSP V2 64-bit is functionally backward compatible with HiPath TAPI 170 TSP V2 32-bit. In case of replacement of the 32-bit TAPI 170 TSP the deviations within the supported scenarios of TAPI 170 TSP 64-bit in combination with HiPath 5000 RSM have to be considered.

Feature description in detail

HiPath TAPI 170 software provides in general the following features of the TAPI interface:

  • Outgoing connection setup, incoming call acceptance, call cleardown
  • Call status/caller ID display
  • Call logging
  • Call pickup (group), consultation hold, toggling, call transfer, conference
  • Speed transfer, call redirect, call hold
  • Tone dialing (DTMF) during call
  • Call charge information
  • Write to display
  • Set/query hookswitch status
  • Volume setting for handset, speaker and headset
  • Lamp mode setting
  • Dynamic line generation by the application
  • Call center features:
    • Query/set/cancel message waiting indicator
    • Query/set/cancel call forwarding and do not disturb
    • Additional information on forwarded/redirected/ transferred calls
    • Playback of music on hold (MOH) and recorded announcements (RCA)
    • Trunk and UCD monitoring
    • Call status timer
    • Unique caller ID (domain-wide)
    • Call data exchange between TAPI applications (domain wide)
  • Central call detail recording (CDR)
  • Support for ACD proxy request handler
  • Telephone data service (TDS)
  • Heartbeat/loopback

Deviations can occur if the underlying CSTA III Interface of the HiPath Platform does not support some features


External Links