====== Installation and configuration ======
===== Server =====
==== Installation ====
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''.

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

<code xml>
<?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>
</code>

=== Web service 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.

=== Tapir configuration ===
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 [[http://www.regular-expressions.info/quickstart.html|regular expression]] to search for and the ''replaceWith'' specifies a replacement string, which can be empty.
  
===== Client =====
==== Installation ====
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.

==== Configuration ====
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.
  
===== Service URL auto-detection =====
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:

<code>_tapir._tcp.<domain name></code>

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:

<code>
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
</code>