Troubleshooting PMS

Refer to the troubleshooting information for your selected protocol.

If the Server was recently installed, upgraded or restarted, wait two to three minutes before attempting PMS operations.

IRS and PRS

When using the IRS/PRS protocol, take the following steps to troubleshoot the PMS:

  1. Go to System Settings > PMS > IRS/PRS and enable either the IRS or PRS protocol.
  2. Modify the port number (if needed).
  3. Make sure that the following services are running:
    • Ambiance PMS Agent
    • Ambiance PMS IRSPRS
    • Ambiance PMS IRSPRS Agent
  4. Go to C:\ProgramData\dormaKaba\Ambiance\logs\IRS and verify activity in the logs. The logs contain any error generated and also keys strings received and sent out.
  5. IRS requests come in two different types:
    • Standard key names (5 Characters)
    • Extended default (15 Characters)
    • To set the key name size you must use Notepad to modify the Kaba.PMS.IRS.SocketService.Host.exe.config file found here C:\Program Files\dormakaba\Ambiance Server\Services\PMS.IRS\

         <!-- 15 characters: true or positive number -->

          <!-- 5 characters: false, 0 or negative number -->

          <add key="IRS.Protocol.LongRoomNumber" value="true" />

  6. (IRS only) By default, PMS login credentials are required. You can either go to Staff Management to configure PMS login credentials or go to System Settings > Security > PMS to disable the requirement to use PMS authentication.
  7. (PMSs that require CHECKSUM) Go to C:\Program Files\dormakaba\Ambiance Server\Services\PMS.IRS\ and edit the Kaba.PMS.IRS.SocketService.Host.exe.config file
    <add key="EnableChecksum" value="1" />

FIAS

The only modifications that may be needed for FIAS are the port number and enabling shared-with registrations.

  1. Verify the following services are running
    • Ambiance PMS Agent
    • Ambiance PMS FIAS
  2. Go to C:\ProgramData\dormaKaba\Ambiance\logs\FIAS\ and verify activity in the logs. The logs contain any error generated and also keys strings received and sent out.
  3. The following settings can be modified in the FIAS configuration file:
The values should not be changed unless requested by the PMS company.

<add key="FIAS.Options.FieldList.KR"value="GNKCKTRNWS$2DADTG#GAGDKOSITIK#" />

<add key="FIAS.Options.FieldList.KD" value="GNKCRNWSG#DATI" />

<add key="FIAS.Options.FieldList.KM" value="GNWSKCRNROKOGDG#SIUODT" />

<add key="FIAS.Options.FieldList.KA" value="WSKCASG#CT$3" /> <!-- Add option to skip KA for certain Record (Default 0 do not skip)-->

<!--<add key="FIAS.Options.SkipAnswer.<RecordId>" value="<0,1>"/>-->

<add key="FIAS.Options.SkipAnswer.KR" value="0" />

<add key="FIAS.Options.SkipAnswer.KD" value="0" />

<add key="FIAS.Options.SkipAnswer.KM" value="0" /> <!--DefaultCheckOutTime hh:mm --> <add key="FIAS.Options.DefaultCheckOutTime" value="" />

<add key="FIAS.Options.DefaultGuestStayDays" value="0" />

<add key="FIAS.Options.CheckOutMinutesToAdd" value="0" />

<add key="FIAS.Options.IntefaceFamily" value="DL" />

<add key="FIAS.Options.VendorSystemVersion" value="1.01" />

LGS SOAP API

SOAP 1.1 is the default configuration after installation. When using the Web Service protocol, take the following steps to troubleshoot the PMS:

After an upgrade, reconfigure the LGS SOAP API configuration file settings with the same parameters prior to the upgrade.
  1. Go to System Settings > PMS > Web Service and verify:
    • Port number is 80 for HTTP and 443 for HTTPS.
    • Shared-with registrations is enabled.
  2. Make sure that the following services are running:
    • Ambiance PMS Agent
    • Ambiance PMS WS
  3. Go to Staff Management and verify that PMS login credentials are defined for at least one Operator. The credentials are set on the Operator Info tab.
  4. Go to C:\ProgramData\dormaKaba\Ambiance\logs\WS\ and verify activity in the logs. The logs contain any error generated and also keys strings received and sent out.

LGS REST API (KF2)

The LGS REST API (KF2) protocol requires that you generate a certificate.

  1. Go to System Settings > PMS > Select LGS REST API (KF2).
  2. Click Generate New Certificate.
    • Minimum logging is enabled by default. To increase logging, open the log4net.config file, change all instances of WARN to ALL, then restart the service.
    • The default port configuration should be retained unless otherwise requested by the PMS company.

For Agylisis and other PMS companies that require a CHECKSUM, Ambiance version 2.0.1.4 (or greater) is required.

For Maestro PMS, the room name must remain long.