Installation and configuration

Run the LIME Tapir Service [version].msi Windows Installer package. The Lundalogik Tapir Windows service is automatically installed but has to be started manually after configuration. All files are installed to Program Files (x86)\Lundalogik\Tapir.

The server has an XML configuration file named Tapir.Service.exe.config which can look like this:

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="lundalogik.dataaccess" type="Lundalogik.DataAccess.Configuration.DataAccessConfiguration, Lundalogik.DataAccess"/>
    <section name="lundalogik.tapir" type="Tapir.Service.Configuration.TapirConfigurationSection, Tapir.Service" />
  </configSections>
  <lundalogik.dataaccess xmlns="lundalogik.dataaccess">
    <databases>
      <database accessMethod="WebService" name="Lime">
        <webServiceOptions binding="BasicHttp" address="http://myserver:8081/DataService/" />
      </database>
    </databases>
  </lundalogik.dataaccess>
  <lundalogik.tapir>
    <diagnostics>
      <debugLogging enabled="true" />
    </diagnostics>		
    <cache enabled="true" expiryIntervalMinutes="15" />
    <numberTransforms>
      <numberTransform searchFor="[^\d\+]" replaceWith="" />
    </numberTransforms>
  </lundalogik.tapir>
</configuration>

The lundalogik.dataaccess section specifies one or more connections to Lime CRM databases. These connections need to have a unique name (Lime in the example above) that must correspond to the actual Lime CRM database name in order for generated Lime links to work in the client.

The lundalogik.tapir section specifies all settings related to the Tapir server.

debugLogging

When enabled, a verbose log file named debuglog.txt is created in the ProgramData\Lundalogik\Tapir folder which can contain very useful information when troubleshooting problems.

cache

When enabled, phone number lookup results are cached for expiryIntervalMinutes minutes which can reduce the number of queries sent to Lime CRM Web Service. Default is enabled with an expiry interval of 15 minutes.

numberTransforms

Specifies one or more text transformations that are to be applied to phone numbers that are passed to Lime CRM Web Service. The searchFor attribute specifies a regular expression to search for and the replaceWith specifies a replacement string, which can be empty.

Run the 'LIME Tapir Client [version].msi' Windows Installer package. All files are installed to Program Files (x86)\Lundalogik\Tapir for 32-bit installations and in Program Files\Lundalogik\Tapir for 64-bit installations. A shortcut to launch the client is created in the Start menu.

The Tapir client supports a number of configurable settings:

Start automatically with Windows

Whether or not to automatically start the application with Windows.

Service URL

Provides functionality for testing the connection to the Tapir web service and also to manually specify a server address if DNS auto-configuration has not been setup.

Enable verbose logging

Enables debug logging.

In order to simplify setup of Tapir clients it is possible to set things up so that the correct Tapir service URL is automatically detected and used by the client. This is done by adding a DNS record of type SRV on the following format:

_tapir._tcp.<domain name>

The record should have the following parameters:

Target

<server name>

Port

58241

To check that the DNS record has been correctly added the nslookup tool can be used:

C:\>nslookup -type=SRV _tapir._tcp.lundalogik.local
Server:  laban.lundalogik.local
Address:  192.168.100.53

_tapir._tcp.lundalogik.local    SRV service location:
          priority       = 0
          weight         = 100
          port           = 58241
          svr hostname   = limemain.lundalogik.local
limemain.lundalogik.local  internet address = 192.168.100.12