Service Manager

The Service Manager provides convenient access to post-installation configuration options and troubleshooting. The following actions are available:

  • install/renew SSL certificate after installation
  • change server IP address
  • open configuration files
  • collect Support information
  • open Event Viewer
  • open Windows services

Open the Service Manager

Access the Service Manager on the server from the default location: 

C:\Program Files\dormakaba\Ambiance Server\Services\Service Manager\ServiceManager.exe

Access the Service Manager on the workstation from the default location: 

C:\Program Files (x86)\dormakaba\Ambiance Client\Services\Service Manager\ServiceManager.exe

Install / renew SSL certificate after installation

Use the Service Manager to install or renew an SSL certificate on the Ambiance server after installation. Each Ambiance workstation must be updated to use the HTTPS protocol.

Server

  1. On the Ambiance server, open the Service Manager.
  1. Click Install SSL Certificate.
  2. Disregard the warning message and click Yes to proceed.
  1. If applicable, specify the password for the certificate.
  2. Click Select File.
  3. Navigate to and select the certificate (.pfx).
  4. When notified the certificate was installed successfully, click OK.

Client

The following steps must be performed on each Ambiance workstation.

  1. Open the Service Manager.

  1. Select the AmbianceClient service and click to stop the service.
  2. Click Open Config files.
  3. Change “WebAPIUrl” and “signalrURL” values to point to https:
  • From:
    <add key="WebAPIUrl" value="http://<Ambiance Server IP>/WebAPI/" />
    <add key="signalrURL" value="http://<
    Ambiance Server IP>/
    WebAPI/signalr/" />
  • To:
    <add key="WebAPIUrl" value="https://< Ambiance Server IP>/WebAPI/" />
    <add key="signalrURL" value="https://< Ambiance Server IP>/
    WebAPI/signalr/"/>
  1. Save and close the configuration file.
  2. Click to restart the Ambiance Client service.

Change server IP address / name

Use the Service Manager to change the Ambiance server IP address after installation. Changing the IP address requires that the Ambiance client be uninstalled and reinstalled on each workstation.

Server

  1. On the Ambiance server, open the Service Manager.
  1. Click Change Server IP/Name.
  2. Disregard the warning and click Yes to proceed.
  1. Specify the new IP address or name, then click Apply.
  1. Restart the Ambiance Server.

Client

The following steps must be performed on each Ambiance workstation.

  1. Open the Service Manager.
  1. Select the AmbianceClient service and click to stop the service.
  2. Click Open config files.
  3. Change “WebAPIUrl” and “signalrURL” values to point to the new IP address.
  • From:

    <add key="WebAPIUrl" value="https://<Ambiance Server IP>/WebAPI/" />

    <add key="signalrURL" value="https://<
    Ambiance Server IP>/

    WebAPI/signalr/" />
  • To:

    <add key="WebAPIUrl" value="https://< Ambiance NewServer IP>/WebAPI/" />

    <add key="signalrURL" value="https://< Ambiance NewServer IP>/

    WebAPI/signalr/"/>
  1. Save and close the configuration file.
  2. Click to restart the Ambiance Client service.

Open configuration files

To open configuration files, select the services for which you want to view the corresponding configuration files, then click Open config files. Each configuration file opens in a separate window.

Disable/enable Watchdog

The Service Manager includes a Watchdog feature that performs regular healthchecks on the server. The Watchdog is enabled by default. To disable / enable Watchdog, open Service Manager and click the appropriate button.

Collect support information

Prior to contacting dormakaba for support, collect information about your Ambiance system. Collect information on the server and workstation.

  1. Open the Service Manager, then click Collect Support Info.

  1. Select the type of support information that you want to collect.
  2. Click Collect.
  3. Specify a file name, then click Save.

Open Event Viewer

To open Windows Event Viewer app, click Event Viewer .

Open Windows services

To open Windows Services app, click Windows Services.