Ambiance

Installationsanleitung

PK3701 290-0 - 02/2023

Original document

DE
 Installationsanleitung

dormakaba Canada, Inc.

7301 Decarie Blvd.
Montreal, Quebec H4P 2G7
T: +1 514 735 5410

www.dormakaba.com

Copyright © dormakaba 2023

Alle Rechte vorbehalten.

Dieses Dokument darf ohne vorherige schriftliche Genehmigung von dormakaba Canada weder ganz noch teilweise
vervielfältigt oder anderweitig verwendet werden.

Alle Namen und Logos von Produkten und Dienstleistungen Dritter sind Eigentum der jeweiligen Inhaber.

Technische Änderungen vorbehalten.

02/2023 Ambiance 2
Installationsanleitung Inhaltsübersicht

Inhalt
1 Informationen zu diesem Dokument 5
1.1 Gültigkeit 5
1.2 Zielgruppe 5
1.3 Zweck und Ziel 5
1.4 Ergänzende Dokumente 5

2 Willkommen 6
3 Anforderungen 7
3.1 Systemanforderungen 7
3.2 Netzwerkanforderungen 8
3.2.1 Bereitstellung auf einer virtuellen Maschine 8
3.2.2 Kommunikationsschnittstellen 8
3.3 Geräteanforderungen 8
3.3.1 Kodiergeräte 9
3.3.2 Programmiergeräte 9
3.3.3 Schlösser 9

3.3.4 Aufzugssteuerungen 9
3.3.5 ZigBee-Gateways 10
3.4 Schnittstellenanforderungen 10
3.5 Schnittstellen und Geräte für die Online-Kommunikation 10
3.6 Unterstützung der Online-Kommunikation nach Schlossmodell 11
3.7 Datenschutz-Grundverordnung (DSGVO) 11
4 Checkliste vor der Installation 12
4.1 Anforderungen 12
4.2 Empfehlungen 13
5 Verwendung einer vorhandenen SQL Server-Instanz vorbereiten 14
5.1 Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren 17
6 Installation des Ambiance-Servers 24
6.1 Installationssprache wählen 24
6.2 Seite „Willkommen“ 25
6.3 Seite „Lizenzvereinbarung“ 26
6.4 Seite „Zielort wählen“ 27
6.5 Seite „Auswahl von IP-Adresse/Servername“ 28
6.6 Seite „Set-up-Typ“ 29
6.7 Seite „SQL-Datenbankserver“ 30

02/2023 Ambiance 3
Installationsanleitung Inhaltsübersicht

6.8 Seite „Status des Set-ups“ 31

6.9 Seite „Set-up-Typ“ 32
6.10 SSL-Zertifikat auswählen 33
6.11 Seite „Passwort“ 34
6.12 Installation abgeschlossen 35
7 Installation des Ambiance-Clients 36
7.1 Installationssprache wählen 37

7.2 Seite „Willkommen“ 38

7.3 Seite „Lizenzvereinbarung“ 39
7.4 Seite „Zielort wählen“ 40
7.5 Auf der Seite „Name/IP-Adresse des Ambiance-Servers“: 41
7.6 Seite „Status des Set-ups“ 42
7.7 Seite „Installation abgeschlossen“ 43
8 Checkliste nach der Installation 44
9 Ambiance-Upgrades 45
9.1 Wenn Sie ein Upgrade von Version 2.7.1 durchführen ... 45
10 Erste Schritte mit Ambiance 46

10.1 Denken Sie daran ... 46

A Anhang A: Service Manager 47
A.1 Installation/Erneuerung des SSL-Zertifikats nach der Installation 47
A.1.1 Server 47
A.1.2 Client 48
A.2 IP-Adresse des Servers ändern 48
A.2.1 Server 48
A.2.2 Client 49
A.3 Watchdog aktivieren/deaktivieren 50
B Anhang B: Polling Service 51

02/2023 Ambiance 4
 Installationsanleitung 1  Informationen zu diesem Dokument

1 Informationen zu diesem Dokument

1.1 Gültigkeit
Dieses Dokument beschreibt das folgende Produkt:
Produktbezeichnung: Ambiance

Version: 2.9

1.2 Zielgruppe
Dieses Dokument richtet sich an IT-Spezialisten, die alle Aufgaben im Zusammenhang mit der Installation des
Ambiance-Servers und des Ambiance-Clients verantworten.

1.3 Zweck und Ziel

Dieses Dokument enthält Informationen und Anleitungen zur Unterstützung aller Aufgaben im Zusammenhang mit der
Installation von Ambiance. Das Dokument enthält außerdem die Anforderungen sowie Checklisten für vor der
Installation auszuführende Aufgaben.

1.4 Ergänzende Dokumente

Ambiance-Benutzerhandbuch v 290-0 PK3722-DE
Versionshinweise zu Ambiance v 29x-x PK3702

02/2023 Ambiance 5
Installationsanleitung 2  Willkommen

2 Willkommen
Mit Ambiance™ bringt dormakaba eine neue Software für die Zugangskontrolle auf den Markt. Sie gilt als
Softwarelösung der nächsten Generation für die Zutrittskontrolle im Hotel- und Gastgewerbe. Ambiance macht das
Zutrittsmanagement leichter und flexibler.
Die Anwendung lässt sich nahtlos in jede IT-Infrastruktur integrieren. Sie ist eine benutzerfreundliche und effiziente
Lösung für das Zutrittsmanagement und die Zutrittskontrolle sowie zur Erfassung von System- und Schlossdaten.
Ambiance ist ein integriertes und konfigurierbares Zutrittsmanagementsystem und ermöglicht neben einem
umfassenden Reporting die Verwaltung von Gastzimmern, Zugangspunkten und Gemeinschaftsbereichen in einer
sicheren und kontrollierten Umgebung.

02/2023 Ambiance 6
Installationsanleitung 3  Anforderungen

3 Anforderungen
In diesem Abschnitt werden die minimalen System-, Netzwerk-, Geräte- und Schnittstellenanforderungen für die
Installation und Nutzung von Ambiance aufgeführt. Je nach Konfiguration und Nutzung am Standort sind
gegebenenfalls zusätzliche Ressourcen erforderlich.

3.1 Systemanforderungen
Die Mindestanforderungen für den Ambiance-Server basieren auf der Anzahl der Zugangspunkte. Weitere Hinweise sind
am Ende der Tabelle aufgeführt. 1

Ambiance benötigt einen eigenen Server.

Server Workstation

Klein ≤500 Zugangspunkte Mittel 500–3.000 Groß ≥3.000 Zugangspunkte nicht zutreffend

Zugangspunkte

CPU 2 GHz/64-bit/4 Core 2 GHz/64-bit/8 Core 2 GHz/64-bit/16 Core 2 GHz/64-bit/Dual Core

RAM 16 GB oder mehr 16 GB oder mehr 32 GB oder mehr 8 GB

30 GB 60 GB 100 GB 50 MB

Laufwerk Freier
Speicher 2

Netzwerk-karte Gigabit-Ethernet – Gigabit-Ethernet – Gigabit-Ethernet – 1 Gbit/Sekunde Gigabit-Ethernet –

1 Gbit/Sekunde 1 Gbit/Sekunde 1 Gbit/Sekunde

USB 2.0 Port Zur Verbindung des Kodiergeräts Zur Verbindung des Zur Verbindung des Kodiergeräts Zur Verbindung des
erforderlich Kodiergeräts erforderlich erforderlich Kodiergeräts
erforderlich

n Microsoft Windows Server n Microsoft Windows Server n Microsoft Windows Server n Microsoft Windows
Betriebs- 2022/2019/2016 2022/2019/2016 2022/2019/2016 8.1 Pro/Enterprise
system 3 n Microsoft Windows 10 n Microsoft Windows
Pro/Enterprise 4 10 Pro/Enterprise
n Microsoft Windows 11 n Microsoft Windows
Pro/Enterprise 5 11 Pro/Enterprise 5

n SQL Server Express n SQL Server Express n SQL Server Express nicht zutreffend
Datenbank 6
2019/2017/2014 2019/2017/2014 2019/2017/2014
n SQL Server 2019/2016/2014 n SQL Server 2019/2016/2014 n SQL Server 2019/2016/2014
(empfohlen) (empfohlen)

n Google Chrome (aktuellste n Google Chrome (aktuellste n Google Chrome (aktuellste n Google Chrome
Webbrowser 7
Version) Version) Version) (aktuellste Version)
n Microsoft Edge (aktuellste n Microsoft Edge (aktuellste n Microsoft Edge (aktuellste n Microsoft Edge
Version) Version) Version) (aktuellste Version)

1 Zusätzlich empfohlene Hardware für den Ambiance-Server: Sicherung mit USV, integrierte HD-Grafikkarte, Tastatur/Maus.
2 Je nach den Einstellungen für die Datenbanksicherung und -archivierung kann zusätzlicher freier Speicherplatz erforderlich sein.
3 Ambiance is localized for all supported operating systems. Languages: English, German, Spanish, French, Italian, Japanese, Polish, Brazilian Portuguese,
Russian, and Chinese.
4 Die Online-Kommunikation wird von Windows 10 Pro/Enterprise nicht unterstützt.
5 a) Die Online-Kommunikation wird von Windows 11 Pro/Enterprise nicht unterstützt. b) Zum Ausführen von Windows 11 ist TPM (Trusted Platform Module)
2.0 erforderlich.
6 a) WICHTIG: Aufgrund der Einschränkungen von SQL Server Express empfiehlt dormakaba, bei mittleren und großen Implementierungen SQL Server
Standard zu verwenden. Details dazu finden Sie in der Dokumentation von Microsoft. b) Microsoft meldet Probleme, die eine erfolgreiche Installation von
SQL Server auf einem Domänencontroller verhindern. Vermeiden Sie, SQL Server auf einem Domänencontroller zu installieren.
7 Empfohlene Auflösung für den Webbrowser: 1366 x 768 oder höher.

02/2023 Ambiance 7
 Installationsanleitung 3.2  Netzwerkanforderungen

3.2 Netzwerkanforderungen
Das IT-Team am Standort ist für die Einrichtung und Aufrechterhaltung einer sicheren Netzwerkumgebung (Ethernet
oder WLAN) verantwortlich, in der der Ambiance-Server, die Workstations und integrierte Schnittstellen eingesetzt und
genutzt werden.

3.2.1 Bereitstellung auf einer virtuellen Maschine

Wenn Ambiance auf einer Cloud-VM (virtuelle Maschine) bereitgestellt wird, ist ein VPN (Virtual Private Network)
erforderlich, um die Kommunikation zwischen dem Standort und der Cloud-VM zu sichern.

3.2.2 Kommunikationsschnittstellen
In der folgenden Tabelle sind die Standardeinstellungen der Ports für den Ambiance-Server aufgeführt. Wenn eine
Firewall im Einsatz ist, sind möglicherweise Konfigurationsänderungen erforderlich, um die Ports für den Ambiance-
Server zugänglich zu machen.

Port Protokoll Beschreibung

80 HTTP Web-Benutzeroberfläche von Ambiance

8083/443 HTTPS Web-Benutzeroberfläche von Ambiance

28000 TCP KODIERGERÄT– KABA RFID (TCP/IP)

5120/5121 HTTP/S PMS – LGS REST API (5120 für HTTP/5121 für HTTPS)

8265 TCP PMS – Oracle FIAS

80/443 HTTP/S PMS – LGS SOAP API (80 für HTT P/443 für HTTPS)

9898 HTTP PMS – BART (konfigurierbar in PMS.BART.Service.Host.exe.Config)

8264 TCP PMS – SAFLOK IRS

9090 HTTP PMS – LGS REST API (KF2)

5020/5021 TCP PMS – SkyTouch (5020 für HTTP/5021 für HTTPS)

27700 27701 TCP ONLINE – Gateway I, Control 4

28002 TCP ONLINE – Gateway II, RAC5-MFC/XT

23211 TCP ONLINE – INNCOM

3.3 Geräteanforderungen
In diesem Abschnitt werden die eingebetteten Geräte samt der neuesten unterstützten Firmware-Versionen aufgeführt,
die für die Verwendung von Ambiance erforderlich sind.
Ambiance ist abwärtskompatibel zu allen vorherigen Firmware-Versionen.

02/2023 Ambiance 8
 Installationsanleitung 3.3.1  Kodiergeräte

3.3.1 Kodiergeräte
In der folgenden Tabelle sind die von Ambiance unterstützten Kodiergeräte und die neuesten unterstützten Firmware-
Versionen aufgelistet.

KABA RFID 1.012

DORMAKABA RFID ENCODER - GEN II 2.009

3.3.2 Programmiergeräte
In der folgenden Tabelle sind die von Ambiance unterstützten Programmiergeräte und die neuesten unterstützten
Firmware-Versionen aufgelistet.

HH6 2.38

3.3.3 Schlösser
In der folgenden Tabelle sind die von Ambiance unterstützten Schlösser und die neuesten unterstützten Firmware-
Versionen aufgelistet.

Boot Main Quantum BLE ZigBee AVR

Pixel 08.03.21.4 08.03.21.4 02.06.19.1 1.2.2.0 1.10x/5.13x/6.05x

Quantum 10.14.20.4 10.14.20.4 02.06.19.1 1.2.2.0 1.10x/5.13x/6.05x

MT4 08.03.21.4 08.03.21.4 02.06.19.1 1.2.2.0 1.10x/5.13x/6.05x

Sicherer 11.05.21.1 11.05.21.1 k. A. 1.2.2.0 k. A.

Wandleser

NFC-Wandleser 02.17.21.3 02.17.21.3 k. A. 1.2.2.0 k. A.

RCU4 08.03.21.4 08.03.21.4 02.06.19.1 1.2.2.0 1.10x/5.13x/6.05x

RT 06.14.18.2 06.14.18.2 k. A. 1.2.2.0 1.10x/5.13x

RT+ 02.23.22.4 02.23.22.4 k. A. 1.2.2.0 1.10x/5.13x/6.050

Saffire LX 02.23.22.4 02.23.22.4 k. A. 1.2.2.0 5.13x/6.050

Confidant 09.03.19.2 09.03.19.2 k. A. 1.2.2.0 1.10x/5.13x

Confidant NFC 02.23.22.4 02.23.22.4 k. A. 1.2.2.0 1.10x/5.13x/6.050

RAC5 XT/Lite 03.31.21.4 03.31.21.4 k. A. 1.2.2.0 k. A.

3.3.4 Aufzugssteuerungen
In der folgenden Tabelle sind die von Ambiance unterstützten Aufzugssteuerungen und die neuesten unterstützten
Firmware-Versionen aufgelistet.

Boot Main Quantum BLE ZigBee

Legacy-MFC k. A. 0.017 k. A. k. A. k. A.

EMCC k. A. 20090929 k. A. k. A. k. A.

MCC 8/12 k. A. 0.031398 k. A. k. A. k. A.

ECU/RCU4 08.03.21.4 08.03.21.4 02.06.19.1 1.2.2.0 1.10x

RAC5-MFC 03.31.21.4 03.31.21.4 k. A. 1.2.2.0 k. A.

02/2023 Ambiance 9
 Installationsanleitung 3.3.5  ZigBee-Gateways

3.3.5 ZigBee-Gateways
In der folgenden Tabelle sind die von Ambiance unterstützten ZigBee-Gateways und die neuesten unterstützten
Firmware-Versionen aufgelistet.

Boot Main Quantum BLE ZigBee

Gateway I 0.221 0.221 k. A. k. A. 1.10x/5.13x

Gateway II 0.019 0.019 k. A. k. A. 6.05x

3.4 Schnittstellenanforderungen
Ambiance unterstützt Folgendes:
n Aurora-SDK – v1.0.19 bis v1.0.22
n Aurora-Software – v1.0.19 bis v1.0.22
n MATRIX – v3.6.1

3.5 Schnittstellen und Geräte für die Online-Kommunikation

In der folgenden Tabelle sind die von Ambiance unterstützten Online-Gateway-Kombinationen aufgelistet. Das
Gateway-I-Gerät ist beispielsweise mit anderen Gateway-I-Geräten, den Aufzugssteuerungen RAC5 und MFC und einer
Schnittstelle eines Drittanbieters kompatibel.

Gateway-I-Gerät Gateway-II-Gerät
Rx-Link unterstützt RAC5-MFC/XT
unterstützt unterstützt
Gateway-I-Gerät ü Nicht unterstützt Nicht unterstützt ü

Gateway-II-Gerät Nicht unterstützt ü ü ü

Rx-Link Nicht unterstützt ü ü ü

RAC5-MFC ü ü ü ü

RAC5 XT ü ü ü ü

Legacy-MFC ü Nicht unterstützt Nicht unterstützt Nicht unterstützt

Schnittstelle eines Drittanbieters (schließen sich gegenseitig aus)

      INNCOM® ü ü ü ü

      Interel® ü Nicht unterstützt Nicht unterstützt Nicht unterstützt

      Telkonet® ü Nicht unterstützt Nicht unterstützt Nicht unterstützt

      Control4® ü Nicht unterstützt Nicht unterstützt Nicht unterstützt

02/2023 Ambiance 10
Installationsanleitung 3.6  Unterstützung der Online-Kommunikation nach Schlossmodell

3.6 Unterstützung der Online-Kommunikation nach Schlossmodell

Gateway II/Rx-Link
Gateway I/Legacy-Schnittstellen von
Schlossmodell ZigBee Gen II ZigBee Gen II
Drittanbietern (ZigBee Gen I)
Phase 1 Phase 2
Pixel ü ü ü

MT4 ü ü ü

RCU4 ü ü ü

RT ü ü Nicht
unterstützt

RT+ ü ü ü

Saffire LX ü ü ü

Confidant ü ü Nicht
unterstützt

Confidant NFC ü ü ü

3.7 Datenschutz-Grundverordnung (DSGVO)

Die Datenschutzerklärung von dormakaba finden Sie auf dem Server an folgender Stelle: \Ambiance Server\GDPR. Wir
empfehlen unseren Kunden, eine Kopie der Erklärung auszudrucken und sie in ihren Geschäftsräumen als Referenz
bereitzuhalten.

02/2023 Ambiance 11
Installationsanleitung 4  Checkliste vor der Installation

4 Checkliste vor der Installation

4.1 Anforderungen
1 ¨ Server/Client. Prüfen Sie, ob alle Systemanforderungen erfüllt sind.

2 ¨ Server. Überprüfen Sie, ob die Einstellungen für Datum/Uhrzeit und Zeitzone korrekt sind. (Der
Ambiance-Server und die an den Zugangspunkten installierten Schlösser müssen für die
gleiche Zeitzone konfiguriert sein.)

3 ¨ WICHTIG! Server/Client. Prüfen Sie, ob alle Windows-Updates installiert wurden.

4 ¨ Server. Überprüfen Sie, ob Windows PowerShell 4.0 installiert ist.

5 ¨ Server. Stellen Sie sicher, dass die folgenden Programme NICHT installiert sind:

6 ¨ SQL Server (nur, wenn keine Verbindung zu einer vorhandenen SQL-Instanz hergestellt wird)

7 ¨ Redis

8 ¨ RabbitMQ

9 ¨ Web Server IIS

10 ¨ Server. Achten Sie darauf, dass Sie einen Aktivierungsschlüssel für Ambiance 2.9 haben.

11 ¨ Deaktivieren Sie die USB-Energiespareinstellungen von Windows (um sicherzustellen, dass

über USB angeschlossene Kodiergeräte ordnungsgemäß funktionieren).

12 ¨ Server/Client. Stellen Sie sicher, dass das Betriebssystem hochgefahren und aktiviert ist.

13 ¨ Server/Client. Führen Sie die Installation als lokaler Administrator durch.

14 ¨ Bereiten Sie gegebenenfalls die Verbindung zu einer vorhandenen SQL Server-Instanz vor.

15 ¨ Server. Achten Sie darauf, dass die Antivirensoftware deaktiviert ist, bevor Sie mit der
Serverinstallation fortfahren.

16 ¨ Server. Wenn die Sprache der Benutzeroberfläche von der Sprache des Serverbetriebssystems
abweicht, muss das zur Sprache der Benutzeroberfläche passende Sprachpaket von
Microsoft Windows installiert werden. Andernfalls werden in Ambiance-Berichten die
entsprechenden Informationen nicht angezeigt.

02/2023 Ambiance 12
Installationsanleitung 4.2  Empfehlungen

4.2 Empfehlungen
1 ¨ WICHTIG! Installieren Sie den Ambiance-Server an einem sicheren physischen Ort.

2 ¨ WICHTIG! Achten Sie darauf, dass die SQL Server-Edition den organisatorischen Anforderungen
entspricht.

3 ¨ Server. Bei der Bereitstellung auf einer Cloud-VM ist für die sichere Kommunikation zwischen
Standort und Cloud-VM die Einrichtung eines VPN erforderlich.

4 ¨ Server. Stellen Sie sicher, dass der Server, auf dem SQL Server installiert ist, kein
Domänencontroller ist.

5 ¨ Server. Wenn möglich, deaktivieren Sie Windows Defender für die Dauer der Installation.

6 ¨ Server. Konfigurieren Sie den Ambiance-Server mit einer statischen IP-Adresse.

7 ¨ Stellen Sie sicher, dass Sie das Windows-Installationsprogramm zur Verfügung haben.

02/2023 Ambiance 13
Installationsanleitung 5  Verwendung einer vorhandenen SQL Server-Instanz vorbereiten

5 Verwendung einer vorhandenen SQL

Server-Instanz vorbereiten
Wenn Sie eine Verbindung zu einer vorhandenen SQL Server-Datenbank (lokal oder Fernzugriff) herstellen möchten,
müssen Sie dies vor Beginn der Installation vorbereiten.
1. Navigieren Sie im Ambiance-Installationspaket zum Ordner AMBIANCE_PREREQUIS und kopieren Sie die Master-
Datenbankdatei (Ambiance.mdf) auf den Remote-Computer, auf dem Microsoft SQL Server installiert ist.
Empfohlener Pfad: C:\Programme\Microsoft SQL Server\MSSQLX.SQLEXPRESS\MSSQL\DATA\ -> X ist der Name der
SQL-Instanz.
2. Datenbank anfügen:
a. Verbinden Sie sich im Objekt-Explorer von SQL Server Management Studio mit einer Instanz der Datenbank-
Engine von SQL Server und erweitern Sie durch Klicken diese Instanzansicht.
b. Klicken Sie mit der rechten Maustaste auf Datenbanken und wählen Sie dann Anfügen.
c. Klicken Sie im Dialogfeld „Datenbanken anfügen“ auf Hinzufügen.
d. Wählen Sie im Dialogfeld „Datenbankdateien suchen“ den Speicherort, an den die Datei „Ambiance.mdf“ zuvor
kopiert wurde, und wählen Sie Ambiance.mdf.
e. Klicken Sie auf OK.

02/2023 Ambiance 14
Installationsanleitung 5  Verwendung einer vorhandenen SQL Server-Instanz vorbereiten

3. Klicken Sie mit der rechten Maustaste auf den Server und wählen Sie Eigenschaften.

4. Wählen Sie unter Verbindungen die Option Remoteverbindungen mit diesem Server zulassen und klicken Sie dann auf
OK.
5. Öffnen Sie den SQL Server Configuration Manager.
6. Klicken Sie mit der rechten Maustaste auf TCP/IP und wählen Sie Eigenschaften.

02/2023 Ambiance 15
Installationsanleitung 5  Verwendung einer vorhandenen SQL Server-Instanz vorbereiten

7. Wählen Sie im Dialogfenster „Eigenschaften von TCP/IP“ die Registerkarte IP-Adressen und blättern Sie zu IPAII.
8. Lassen Sie das Feld Dynamische TCP-Ports leer und legen Sie den TCP-Port auf 1433 fest. (Port 1433 ist die
Standardinstanz, die SQL Server verwendet.)

9. Klicken Sie auf Übernehmen > OK.

Wenn Sie eine Firewall verwenden, fahren Sie mit dem nächsten Abschnitt fort, um den Zugriff für die Datenbank-Engine
zu ermöglichen.

02/2023 Ambiance 16
Installationsanleitung 5.1  Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

5.1 Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

Wenn die Firewall aktiviert ist, müssen Sie eine Ausnahme für den Port 1433 hinzufügen, um den TCP/IP-Datenverkehr
auf Port 1433 und UDP-Datenverkehr auf Port 1434 zuzulassen.
1. Navigieren Sie zu Programme > Verwaltung und wählen Sie Windows-Firewall mit erweiterter Sicherheit.
2. Wählen Sie Eingehende Regeln.
3. Wählen Sie unter Aktionen die Option Neue Regel.

4. Wählen Sie unter „Regeltyp“ Port aus und klicken Sie dann auf Weiter.

02/2023 Ambiance 17
Installationsanleitung 5.1  Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

5. Wählen Sie unter „Protokolle und Ports“ TCP aus und geben Sie 1433 unter Bestimmte lokale Ports ein. Klicken Sie
dann auf Weiter.

02/2023 Ambiance 18
Installationsanleitung 5.1  Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

6. Wählen Sie unter „Aktion“ die Option Verbindung zulassen (um die Aktion festzulegen, die durchgeführt werden soll,
wenn eine Verbindung die in der Regel angegebenen Bedingungen erfüllt).

02/2023 Ambiance 19
Installationsanleitung 5.1  Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

7. Wählen Sie unter „Profile“ die Profile aus, für die die Regel gelten soll, und klicken Sie dann auf Weiter.

02/2023 Ambiance 20
Installationsanleitung 5.1  Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

8. Geben Sie unter „Name“ den Namen der neuen Regel an und klicken Sie dann auf Fertigstellen.

02/2023 Ambiance 21
Installationsanleitung 5.1  Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

Sie sehen nun die erstellte Regel in der Liste der eingehenden Regeln.

02/2023 Ambiance 22
Installationsanleitung 5.1  Windows-Firewall für den Zugriff durch die Datenbank-Engine konfigurieren

9. Wiederholen Sie zum Hinzufügen des UDP-Ports 1434 die gleichen Schritte.

02/2023 Ambiance 23
Installationsanleitung 6  Installation des Ambiance-Servers

6 Installation des Ambiance-Servers

In diesem Kapitel wird die Erstinstallation erläutert. Wenn Sie ein Upgrade durchführen, lesen Sie das Kapitel Server-
Upgrades.
So installieren Sie den Ambiance-Server:
1. Öffnen Sie im Ordner dormakaba/Ambiance den Ordner SERVER.
2. Doppelklicken Sie auf AmbianceServer.exe. Der Installationsassistent öffnet sich und bereitet die Installation vor. Je
nach Server werden bei der Installation gegebenenfalls die folgenden Schritte ausgeführt:
n Wenn Microsoft .NET Framework 4.8 nicht installiert ist, erscheint die Aufforderung, dem Programm zu erlauben,

Änderungen am Computer vorzunehmen. Klicken Sie auf JA, um mit der Installation fortzufahren.
n Wenn der Microsoft OLE DB-Treiber für SQL Server nicht installiert ist, klicken Sie auf Installieren, um mit der

Installation fortzufahren.
3. Folgen Sie den Anweisungen für jede der folgenden Assistentenseiten. Wenn ein Neustart erforderlich ist, bestätigen
Sie, um mit der Installation fortzufahren.

6.1 Installationssprache wählen

Auf der Seite „Installationssprache wählen“:

1. Wählen Sie Deutsch.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 24
Installationsanleitung 6.2  Seite „Willkommen“

6.2 Seite „Willkommen“

Klicken Sie auf der Seite „Willkommen“ auf Weiter.

02/2023 Ambiance 25
Installationsanleitung 6.3  Seite „Lizenzvereinbarung“

6.3 Seite „Lizenzvereinbarung“

Auf der Seite „Lizenzvereinbarung“:

1. Akzeptieren Sie die Bedingungen der Lizenzvereinbarung.
Sie können die Vereinbarung ausdrucken.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 26
Installationsanleitung 6.4  Seite „Zielort wählen“

6.4 Seite „Zielort wählen“

Auf der Seite „Zielort wählen“:

1. Wählen Sie aus, wo die Ambiance-Server-Dateien installiert werden sollen:
n Übernehmen Sie den Standard-Zielordner (empfohlen).
n Klicken Sie auf Ändern und navigieren Sie zu einem Ordner auf dem Server.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 27
Installationsanleitung 6.5  Seite „Auswahl von IP-Adresse/Servername“

6.5 Seite „Auswahl von IP-Adresse/Servername“

Auf der Seite „Auswahl von IP-Adresse/Servername“:

1. Wählen Sie die IP-Adresse oder den Hostnamen aus, die/der für die Installation verwendet werden soll.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 28
Installationsanleitung 6.6  Seite „Set-up-Typ“

6.6 Seite „Set-up-Typ“

Diese Seite wird nur angezeigt, wenn das Installationsprogramm eine vorhandene Instanz von SQL Server erkennt.

Auf der Seite „Set-up-Typ“:

Wählen Sie aus, ob Sie eine neue Instanz von SQL Server installieren oder eine Verbindung zu einer vorhandenen
Datenbankinstanz von SQL Server/Server Express lokal oder über Fernzugriff herstellen möchten. Wenn Sie eine neue
Instanz installieren, wird SQL Server Express 2019 installiert. Jede Instanz, zu der Sie eine Verbindung herstellen, muss
eine unterstützte Version sein (siehe Anforderungen).
n Wenn Sie eine neue Instanz installieren, klicken Sie auf Weiter und fahren Sie auf der Seite Status des Set-ups fort.
n Wenn Sie eine Verbindung zu einer bestehenden Instanz herstellen, klicken Sie auf Weiter und fahren Sie mit der Seite
SQL-Datenbankserver fort.

02/2023 Ambiance 29
Installationsanleitung 6.7  Seite „SQL-Datenbankserver“

6.7 Seite „SQL-Datenbankserver“

Auf der Seite „SQL-Datenbankserver“:

1. Klicken Sie auf Durchsuchen, navigieren Sie zur richtigen SQL-Instanz und wählen Sie diese aus.
2. Geben Sie gültige Anmeldeinformationen für SQL Server an.
3. Klicken Sie auf Weiter.
Wenn an die ausgewählte Instanz keine Datenbank angehängt ist, wird die Meldung angezeigt, dass die
Verwendung einer vorhandenen SQL Server-Instanz vorbereitet werden soll. Anweisungen dazu finden Sie im
vorherigen Kapitel.

02/2023 Ambiance 30
Installationsanleitung 6.8  Seite „Status des Set-ups“

6.8 Seite „Status des Set-ups“

Auf der Seite „Status des Set-ups“ wird der Status der Installation angezeigt. Wenn Sie dazu aufgefordert werden,
klicken Sie auf Weiter.
Die folgenden Anwendungen von Drittanbietern werden installiert:
n Microsoft .NET Framework 4.8
n Microsoft SQL Server Express 2019 (wenn ausgewählt)
n Redis Server
n Redis Desktop Manager
n Erlang-Software
n RabbitMQ
n VC++ Redistributable 2013, 2015
n MongoDB

02/2023 Ambiance 31
Installationsanleitung 6.9  Seite „Set-up-Typ“

6.9 Seite „Set-up-Typ“

Auf der Seite „Set-up-Typ“:

1. Wählen Sie aus, ob ein SSL-Zertifikat (Secure Sockets Layer) installiert werden soll.
dormakaba empfiehlt dringend, ein SSL-Zertifikat zu installieren, um das HTTPS-Protokoll zu aktivieren. Die
Sicherheit liegt in Ihrer Verantwortung. Wenn Sie sich für die Installation eines SSL-Zertifikats nach der
Installation entscheiden, müssen Sie den Ambiance-Server deinstallieren und im sicheren Modus neu
installieren. Der Vorgang hat keinen Einfluss auf die Ambiance-Datenbank. dormakaba empfiehlt jedoch, vor der
Deinstallation vorsichtshalber eine Sicherung der Ambiance-Datenbank durchzuführen. Der Serverpfad muss
von HTTP:// auf HTTPS:// geändert werden.

2. Klicken Sie auf Weiter.

Wenn Sie kein SSL-Zertifikat installieren möchten, wird eine Warnung angezeigt. Wenn Sie mit der Installation
fortfahren, fahren Sie mit "Installation des Ambiance-Servers" on page 24 fort.

02/2023 Ambiance 32
Installationsanleitung 6.10  SSL-Zertifikat auswählen

6.10 SSL-Zertifikat auswählen

Im Datei-Explorer:
1. Suchen Sie das zu installierende SSL-Zertifikat und wählen Sie es aus.
2. Klicken Sie auf Öffnen.

02/2023 Ambiance 33
Installationsanleitung 6.11  Seite „Passwort“

6.11 Seite „Passwort“

Auf der Seite „Passwort“:

1. Geben Sie das Passwort für das gewählte SSL-Zertifikat an.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 34
Installationsanleitung 6.12  Installation abgeschlossen

6.12 Installation abgeschlossen

Wenn die Benachrichtigung, dass die Installation abgeschlossen ist, angezeigt wird, klicken Sie auf Fertigstellen.

Nachdem der Ambiance-Server installiert, aktualisiert oder neu gestartet wurde, warten Sie zwei bis
drei Minuten, bevor Sie Ambiance verwenden.

02/2023 Ambiance 35
Installationsanleitung 7  Installation des Ambiance-Clients

7 Installation des Ambiance-Clients

In diesem Kapitel wird die Installation des Ambiance-Clients erläutert. Sie müssen den Client auf jeder Workstation
installieren, auf der ein USB-Kodiergerät und/oder ein Programmiergerät erforderlich ist.
So installieren Sie den Ambiance-Client:
1. Öffnen Sie einen unterstützten Browser und rufen Sie die IP-Adresse des Ambiance-Servers auf.
2. Melden Sie sich an.
3. Navigieren Sie zum Gerätemanagement.

4. Klicken Sie in der Symbolleiste auf das entsprechende Symbol, um den Ambiance-Client zu installieren.

5. Klicken Sie auf Herunterladen.

6. Suchen Sie die Datei Ambiance.exe und öffnen Sie sie. Der Installationsassistent öffnet sich und bereitet die
Installation vor. Je nach Computer wird bei der Installation gegebenenfalls der folgende Schritt ausgeführt:
n Der Assistent sucht nach Microsoft .NET Framework 4.8 und installiert es, wenn es nicht gefunden wurde.

7. Folgen Sie den Anweisungen für jede der folgenden Assistentenseiten.

02/2023 Ambiance 36
 Installationsanleitung 7.1  Installationssprache wählen

7.1 Installationssprache wählen

Auf der Seite „Installationssprache wählen“:

1. Wählen Sie Deutsch.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 37
Installationsanleitung 7.2  Seite „Willkommen“ 

7.2 Seite „Willkommen“   

Auf der Seite „Willkommen“:

n Klicken Sie auf Weiter.

02/2023 Ambiance 38
Installationsanleitung 7.3  Seite „Lizenzvereinbarung“ 

7.3 Seite „Lizenzvereinbarung“ 

Auf der Seite „Lizenzvereinbarung“:

1. Akzeptieren Sie die Bedingungen der Lizenzvereinbarung.
Sie können die Vereinbarung ausdrucken.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 39
Installationsanleitung 7.4  Seite „Zielort wählen“ 

7.4 Seite „Zielort wählen“ 

Auf der Seite „Zielort wählen“:

1. Wählen Sie aus, wo die Ambiance-Client-Dateien installiert werden sollen:
n Übernehmen Sie den Standard-Zielordner (empfohlen).
n Klicken Sie auf Ändern und navigieren Sie zu einem Ordner auf dem Server.
2. Klicken Sie auf Weiter.

02/2023 Ambiance 40
Installationsanleitung 7.5  Auf der Seite „Name/IP-Adresse des Ambiance-Servers“:

7.5 Auf der Seite „Name/IP-Adresse des Ambiance-Servers“:

Diese Seite wird nicht angezeigt, wenn der Ambiance-Client über die Ambiance-Benutzeroberfläche
heruntergeladen und installiert wird. Stattdessen wird während des Installationsvorgangs automatisch die IP-
Adresse oder der Hostname erkannt.

Auf der Seite Name/IP-Adresse des Ambiance-Servers:

1. Geben Sie die IP-Adresse oder den Hostnamen des Ambiance-Servers an.
2. Wählen Sie das Kontrollkästchen HTTPS verwenden aus, wenn der Ambiance-Server SSL-fähig ist.
3. Klicken Sie auf Weiter.
Wenn nach der Installation ein SSL-Zertifikat auf dem Ambiance-Server installiert wurde, muss der Client
deinstalliert und auf allen Workstations neu installiert oder neu konfiguriert werden, damit er mit dem Server
kommunizieren kann.

02/2023 Ambiance 41
Installationsanleitung 7.6  Seite „Status des Set-ups“

7.6 Seite „Status des Set-ups“

Auf der Seite „Status des Set-ups“ wird der Status der Installation angezeigt. Wenn Sie dazu aufgefordert werden,
klicken Sie auf Weiter.

02/2023 Ambiance 42
Installationsanleitung 7.7  Seite „Installation abgeschlossen“

7.7 Seite „Installation abgeschlossen“

Wenn die Benachrichtigung, dass die Installation erfolgreich war, angezeigt wird, klicken Sie auf Fertigstellen.

02/2023 Ambiance 43
Installationsanleitung 8  Checkliste nach der Installation

8 Checkliste nach der Installation

1 ¨ Server. Aktivieren Sie, wenn nötig, Windows Defender erneut.

2 ¨ Server. Aktivieren Sie das Produkt. Öffnen Sie Ambiance in einem unterstützen Browser und
geben Sie einen gültigen Aktivierungsschlüssel für Ambiance2.9 ein.

3 ¨ Server oder Client. Ändern Sie die Standardpasswörter. Melden Sie sich bei Ambiance mit dem
folgenden Konto an: Benutzername=admin01, Passwort=Admin@01. Ändern Sie das
Standardpasswort. Wiederholen Sie die Schritte für das Konto: Benutzername=admin02,
Passwort=Admin@02.

4 ¨ Server (nur Online-Installationen). Stellen Sie sicher, dass die Firmware-Versionen von
Gateways und Zugangspunkten auf die neuesten Versionen gemäß „Geräteanforderungen“ 
aktualisiert sind.

5 ¨ Microsoft Edge. Fügen Sie die IP-Adresse des Ambiance-Servers als vertrauenswürdige Site
hinzu. Navigieren Sie zu Systemsteuerung > Netzwerk und Internet > Internetoptionen >
Sicherheit > Vertrauenswürdige Sites. Klicken Sie auf Sites und fügen Sie die IP-Adresse des
Ambiance-Servers hinzu.

6 ¨ Microsoft Edge. Wegen eines Windows-Problems ist der Edge-Browser nicht in der Lage, das
Programmiergerät zu erkennen und eine Verbindung zu ihm herzustellen. Aus diesem Grund
können ohne Eingriff die Zugangspunkte weder programmiert noch geprüft werden. Öffnen Sie
die Eingabeaufforderung und geben Sie den folgenden Befehl aus:
C:\windows\system32\CheckNetIsolation.exe LoopbackExempt –a -
n=Microsoft.MicrosoftEdge_8wekyb3d8bbwe

7 ¨ Microsoft Edge. Mit den Standardsicherheitseinstellungen im Edge-Browser von Windows 10

wird der Zugriff auf den Benutzer „localhost“ blockiert. Dadurch wird die Kommunikation mit
dem Programmiergerät bei Operationen zur Programmierung und Ereignisauswertung von
Zugangspunkten verhindert. Verwenden Sie Chrome oder führen Sie den folgenden Befehl über
die Windows-Konsole aus:
n Windows 10 Build 10158 oder höher:
CheckNetIsolationLoopbackExempt-a-n=Microsoft.MicrosoftEdge_8wekyb3d8bbwen
n Für vorherige Builds:
CheckNetIsolationLoopbackExempt-a-n=Microsoft.Windows.Spartan_cw5n1h2txyewy

8 ¨ Server (nur Online-Installationen). Aktualisieren Sie bei einer Umstellung von Saflok auf
Ambiance die Firmware über Fernzugriff mit Saflok S6000/LENS, bevor Sie auf Ambiance
umstellen.

02/2023 Ambiance 44
Installationsanleitung 9  Ambiance-Upgrades

9 Ambiance-Upgrades
Die folgenden Upgrade-Pfade werden unterstützt:
n 1.4 und höher auf 2.9. Wenn Sie ein Upgrade von Version 2.7.1 durchführen, beachten Sie den folgenden Abschnitt.
WICHTIG! Prüfen Sie vor dem Server-Upgrade, ob alle Windows-Updates
installiert wurden.

Erstellen Sie eine Sicherungskopie der Datenbank, bevor Sie ein Upgrade durchführen. Wenn Sie mit Online-
Systemen arbeiten, sollten Sie Sicherungskopien der SQL Server- und MongoDB-Datenbanken erstellen.

Nach dem Upgrade muss der Ambiance-Server neu gestartet werden.

Da der auf den Workstations installierte Ambiance-Client dieselbe Version wie der Ambiance-Server haben muss, muss
auch der Client aktualisiert werden.

9.1 Wenn Sie ein Upgrade von Version 2.7.1 durchführen ...

n Wenn ursprünglich Version 2.7.1 installiert wurde, führen Sie ein Upgrade auf 2.9 durch.
n Wenn Version 2.7.1 von einer älteren Version aktualisiert wurde, gehen Sie wie folgt vor:
1. Deinstallieren Sie den Ambiance-Server 2.7.1.10.
2. Deinstallieren Sie RabbitErlang v3.9.9 oder v3.7.14.
3. Öffnen Sie eine Eingabeaufforderung als Administrator und führen Sie den folgenden Befehl aus:
taskkill /F /IM epmd.exe
4. Starten Sie den Registrierungs-Editor.
a. Navigieren Sie zu HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall, suchen Sie nach
„RabbitErlang“ und löschen Sie den entsprechenden Registrierungsschlüssel.
b. Navigieren Sie zu HKLM\Software\Classes\Installer\Products, suchen Sie nach „RabbitErlang“ und löschen
Sie den entsprechenden Registrierungsschlüssel.
5. Löschen Sie C:\Program Files\RabbitErlang\*.*.
6. Installieren Sie Ambiance v2.9.

02/2023 Ambiance 45
Installationsanleitung 10  Erste Schritte mit Ambiance

10 Erste Schritte mit Ambiance

Der Ambiance-Workflow ist eine ausgezeichnete Ressource, die Sie als Anleitung für Ihre Implementierung nutzen
können. Dieses Dokument enthält einen Überblick über den Anwendungsablauf und die ersten Schritte in jedem Modul
zum Einrichten von Ambiance.
Das Ambiance-Benutzerhandbuch ist ein neues Dokument, die Informationen und Anweisungen für alle Operatoren von
Ambiance bietet.
n Im Abschnitt „Konfiguration des Zutrittsmanagements der Hotelanlage“ finden Sie einen einfachen Workflow und
Schritt-für-Schritt-Anweisungen für die Einrichtung von Ambiance.
n Der Abschnitt „Arbeiten mit Ambiance“ enthält Anweisungen für die tägliche Arbeit nach dem Go-live und umfasst
die Themen Fehlerbehebung und Arbeiten mit ..., die auf einige kompliziertere Situationen eingehen.
Das Benutzerhandbuch finden Sie in Ihrem Installationsordner.

10.1 Denken Sie daran ...

Navigieren Sie zu Systemeinstellungen > Datenbanksicherung und -archivierung, um regelmäßige Sicherungen
und Archivierungen für die SQL Server-Datenbank von Ambiance (und MongoDB für Online-Systeme) zu
konfigurieren. Es wird empfohlen, die Sicherungen extern an einem sicheren Ort zu speichern.

Navigieren Sie nach Abschluss der Konfiguration des Zutrittsmanagements der Hotelanlage zu
Systemeinstellungen > Backup-Karten, um Backup-Karten anzufertigen.

02/2023 Ambiance 46
 Installationsanleitung A  Anhang A: Service Manager

A Anhang A: Service Manager

Der Service Manager bietet Zugang zu den Konfigurationsoptionen, die nach der Installation verfügbar sind. Den Service
Manager finden Sie unter:
n Auf dem Ambiance-Server:
C:\Program Files\dormakaba\Ambiance Server\Services\Service Manager\ServiceManager.exe
n Auf dem Ambiance-Client:
C:\Program Files (x86)\dormakaba\Ambiance Client\Services\Service Manager\ServiceManager.exe

A.1 Installation/Erneuerung des SSL-Zertifikats nach der Installation

Nutzen Sie den Service Manager, um nach der Installation ein SSL-Zertifikat auf dem Ambiance-Server zu installieren
oder zu erneuern. Jede Ambiance-Workstation muss auf das HTTPS-Protokoll aktualisiert werden..

A.1.1 Server
1. Öffnen Sie auf dem Ambiance-Server den Service Manager.

2. Klicken Sie auf SSL-Zertifikat installieren.

3. Ignorieren Sie die Warnmeldung und klicken Sie auf Ja, um fortzufahren.

4. Geben Sie gegebenenfalls das Passwort für das Zertifikat an.

5. Klicken Sie auf Datei auswählen.

02/2023 Ambiance 47
 Installationsanleitung A.1.2  Client

6. Suchen Sie das Zertifikat (.pfx) und wählen Sie es aus.

7. Wenn die Benachrichtigung, dass das Zertifikat erfolgreich installiert wurde, angezeigt wird, dann klicken Sie auf OK.

A.1.2 Client
Die folgenden Schritte sind auf jeder Ambiance-Workstation auszuführen.
1. Öffnen Sie den Service Manager.

2. Wählen Sie den Ambiance-Client-Dienst aus und klicken Sie auf , um den Dienst zu beenden.
3. Klicken Sie auf Konfigurationsdateien öffnen.
4. Ändern Sie die Werte „WebAPIUrl“ und „signalrURL“ so, dass sie auf https verweisen:
n Von:
<add key="WebAPIUrl" value="http://<Ambiance Server IP>/WebAPI/" />
<add key="signalrURL" value="http://< Ambiance Server IP>/
WebAPI/signalr/" />
n Zu:
<add key="WebAPIUrl" value="https://< Ambiance Server IP>/WebAPI/" />
<add key="signalrURL" value="https://< Ambiance Server IP>/
WebAPI/signalr/"/>
5. Speichern und schließen Sie die Konfigurationsdatei.

6. Klicken Sie auf , um den Ambiance-Client-Dienst neu zu starten.

A.2 IP-Adresse des Servers ändern

Nutzen Sie den Service Manager, um nach der Installation die IP-Adresse des Ambiance-Servers zu ändern. Zum Ändern
der IP-Adresse muss der Ambiance-Client auf jeder Workstation deinstalliert und neu installiert werden.

A.2.1 Server
1. Öffnen Sie auf dem Ambiance-Server den Service Manager.

02/2023 Ambiance 48
 Installationsanleitung A.2.2  Client

2. Klicken Sie auf Server-IP-Konfiguration.

3. Ignorieren Sie die Warnmeldung und klicken Sie auf Ja, um fortzufahren.
4. Geben Sie die neue IP-Adresse an und klicken Sie dann auf Anwenden.

5. Starten Sie den Ambiance-Server neu.

A.2.2 Client
Die folgenden Schritte sind auf jeder Ambiance-Workstation auszuführen.
1. Öffnen Sie den Service Manager.

2. Wählen Sie den Ambiance-Client-Dienst aus und klicken Sie auf , um den Dienst zu beenden.
3. Klicken Sie auf Konfigurationsdateien öffnen.
4. Ändern Sie die Werte „WebAPIUrl“ und „signalrURL“ so, dass sie auf die neue IP-Adresse verweisen:
n Von:
<add key="WebAPIUrl" value="https://<Ambiance Server IP>/WebAPI/" />
<add key="signalrURL" value="https://< Ambiance Server IP>/
WebAPI/signalr/" />
n Zu:
<add key="WebAPIUrl" value="https://< Ambiance NewServer IP>/WebAPI/" />

02/2023 Ambiance 49
Installationsanleitung A.3  Watchdog aktivieren/deaktivieren

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

WebAPI/signalr/"/>
5. Speichern und schließen Sie die Konfigurationsdatei.

6. Klicken Sie auf , um den Ambiance-Client-Dienst neu zu starten.

A.3 Watchdog aktivieren/deaktivieren

Der Service Manager verfügt über eine Watchdog-Funktion, die den Server regelmäßig überprüft. Watchdog ist
standardmäßig aktiviert. Um Watchdog zu deaktivieren/aktivieren, öffnen Sie den Service Manager und klicken Sie auf
die entsprechende Schaltfläche.

02/2023 Ambiance 50
Installationsanleitung B  Anhang B: Polling Service

B Anhang B: Polling Service

Ambiance offers a feature that polls third-party servers to detect requests for mobile keys. The feature requires an SSL
certificate. When enabled, the Certificate Manager automatically renews the certificate.
Consult the site IT Administration to configure the following polling service settings:
1. On the Ambiance server, go to: 
\dormakaba\AmbianceServer\Services\MobileKeyDeliveryService.
2. Open the file MobileKeyDeliveryService.exe.Config.
3. Specify key values for the certificate: 
n <add key="PollingServiceCertificateThumbprint" value="customValue" />
n <add key="PollingServiceCertificateIssuerName" value="customValue" />
4. Specify key values for the polling service URL:
n <add key="PollingServiceApiEndpoint" value="customValue" />
n <add key="PollingServiceSiteName" value="customValue" />
n <add key="PollingServiceRequestToken" value="/digitalKeyDetails_MPG" />
n <add key="PollingServiceResponseToken" value="/digitalKeyDetails_MPG" />
5. Specify the authentication settings for Ambiance to communicate with the polling service:
n <add key="PollingServiceMpgUserName" value="customValue" />
n <add key="PollingServiceSecurityToken" value="customValue" />
n <add key="PollingServiceIsSecurityEnabled" value="true" />
6. Enable the polling service:
n <add key="PollingServiceEnabled" value="true" />
7. Select whether to enable the automatic renewal of the SSL certificate:
n <add key="PollingCertificateManagerEnabled" value="true" />
The following key values are read from the certificate thumbprint and auto-populated:
n <add key="CertIssuedTo" value="auto_populates" />
n <add key="CertFriendlyName" value="auto_populates" />
8. Save the file.

02/2023 Ambiance 51
 Copyright © dormakaba 2023
PK3701-DE 290-0 - 02/2023

dormakaba Canada
7301 Decarie Blvd,
Montreal, Quebec H4P 2G7
Canada
T: +1 877 468-3555

www.dormakaba.com
www.dormakaba.com