Installation

ROOMS kann als klassische Windows-Installation oder containerisiert mit Docker Compose beziehungsweise Kubernetes bereitgestellt werden. Beim hier dokumentierten Stand 4.30.8 benötigt Docker noch getrennte Windows- und Linux-Container-Hosts. Für eine Neuinstallation auf einem einzelnen Windows-Server ist deshalb MSI mit IIS der einfachere Standardweg. Docker Compose ist interessant, wenn die gemischte Container-Infrastruktur bereits vorhanden ist: Versionen, Mounts und Neustartverhalten lassen sich damit reproduzierbar verwalten und ein zentraler Reverse Proxy übernimmt DNS-Namen und TLS-Zertifikate.

Bereitstellungsvarianten

• Windows-Installation mit MSI und IIS: Wählen Sie diesen Weg für einen einzelnen Windows-Server oder wenn keine gemischte Windows-/Linux-Container-Infrastruktur betrieben werden soll. Das MSI installiert die ausgewählten Legacy- und RoomsPro-Komponenten. Die nachfolgende Reihenfolge beschreibt diesen Weg.
• Docker Compose bei vorhandener Container-Infrastruktur: Private Images aus ghcr.io stellen Legacy Website, Legacy Service, RoomsPro API und RoomsPro Worker bereit. Nginx terminiert HTTPS und leitet zwei öffentliche Hostnamen an die passenden Container weiter. Für 4.30.x sind zwei Container-Hosts oder VMs erforderlich. Folgen Sie der vollständigen Anleitung Docker Compose unter Windows.
• Kubernetes: Für grössere Installationen gelten derselbe Baukasten- und Migrationsablauf sowie dieselbe Trennung auf Windows- und Linux-Nodes. Hinweise finden Sie am Ende der Docker-Anleitung.

Verwenden Sie innerhalb einer Umgebung für alle Komponenten dieselbe ROOMS-Version. Datenbank, Konfiguration, Lizenzen und öffentliche URLs müssen auf dieselbe Umgebung abgestimmt sein.

Windows-Neuinstallation mit MSI und IIS

Empfohlene Reihenfolge:

1. Systemanforderungen und Service-Account vorbereiten
2. Datenbank bereitstellen
3. Datenbankberechtigungen vergeben
4. 3V ROOMS installieren
5. Config.bat, Konfiguration und Lizenzen einrichten
6. IIS konfigurieren
7. Datenbankmigrationen ausführen
8. Temporäre Migrationsrechte entfernen
9. Dienste und Websites starten und einen Smoke Test durchführen.

Für alle Windows-Komponenten wird derselbe dedizierte ROOMS-Service-Account verwendet. Mindestens auf einer Maschine muss die RoomsPro API installiert sein, da sie die Befehle db status und db migrate bereitstellt.

Bei der Container-Bereitstellung werden diese Befehle über einen einmaligen Container beziehungsweise Kubernetes Job mit dem Image rooms-api ausgeführt. Details finden Sie unter Docker: Datenbankmigrationen.