Server-URL nachträglich ändern (Appterix Server & EMPlatform)
Die Server-URL wird standardmäßig während der Erstinstallation der Serverkomponenten festgelegt. Wenn sich die Adresse Ihres Servers ändert und Sie die hinterlegte URL nachträglich anpassen müssen, erfolgt dies über eine Neuinstallation der Komponenten unter Beibehaltung der bestehenden Datenbanken.
Wichtiger Hinweis: Planen Sie für diese Umstellung ein kurzes Wartungsfenster ein, da die Dienste während der De- und Neuinstallation vorübergehend nicht erreichbar sind.
1. Vorbereitung und Datensicherung
Stellen Sie vor Beginn der Arbeiten sicher, dass Ihr System auf dem neuesten Stand ist und alle Daten vollständig gesichert wurden:
- Versionsstand prüfen: Überprüfen Sie, ob Sie die aktuellste Appterix Version der Serverkomponenten verwenden, und führen Sie vorab gegebenenfalls ein Update durch.
- Installationsdateien bereithalten: Sichern Sie die Installationsdateien (Installer) der aktuell installierten Version, da Sie für die Neuinstallation exakt dieselbe Version benötigen.
- Datenbanken sichern: Erstellen Sie ein vollständiges Backup der Datenbanken für die EMPlatform sowie den Appterix Server.
2. Deinstallation der bestehenden Komponenten
Entfernen Sie zunächst die vorhandenen Dienste vom System (die Datenbanken selbst bleiben dabei erhalten):
- Deinstallieren Sie über die Windows-Systemsteuerung bzw. die Einstellungen Ihres Windows Servers folgende Komponenten:
- EMPlatform
- EM AD Sync Service
- Appterix Server
- System neu starten: Führen Sie nach Abschluss der Deinstallation zwingend einen Neustart des Windows Servers durch, um alle Dateisperren und Dienste sauber zu beenden.
3. Neuinstallation und Hinterlegen der neuen Server-URL
Nach dem Neustart richten Sie die Komponenten mit der neuen URL wieder ein und verknüpfen sie mit den vorhandenen Datenbanken:
- Installationsassistent starten: Führen Sie den Installationswizard des Appterix Servers mit exakt derselben Version aus, die unmittelbar vor der Deinstallation installiert war.
- Bestehende Datenbanken einbinden: Geben Sie im Verlauf des Assistenten die Namen Ihrer bereits vorhandenen Datenbanken an.
- Achtung: Entfernen Sie bei den Datenbanken jeweils den Haken bei der Option „Neu erstellen“, damit die bestehenden Daten übernommen und nicht überschrieben werden.
- Neue Server-URL eintragen: Hinterlegen Sie im entsprechenden Konfigurationsschritt die neue Server-URL. Es wird dringend empfohlen, hier den vollständigen Domänennamen (FQDN – Fully Qualified Domain Name) zu verwenden.
4. Nachbereitung und Funktionsprüfung
Prüfen Sie nach erfolgreicher Installation, ob alle Zertifikate und Schnittstellen korrekt mit der neuen Adresse arbeiten:
- SSL-Zertifikat im IIS prüfen: Öffnen Sie den Internet Information Services (IIS) Manager und kontrollieren Sie in den Bindungen (Bindings) der Website, ob das hinterlegte SSL-Zertifikat zur neuen Server-URL passt. Tauschen Sie das Zertifikat bei Bedarf aus.
- AD Sync Service überprüfen: Melden Sie sich an der EMPlatform an und testen Sie, ob die Integrationen des AD Sync Service wie gewohnt funktionieren. Falls Verbindungsprobleme auftreten, öffnen Sie das EM AD Sync Service Control Panel und aktualisieren Sie dort die Verbindungseinstellungen auf die neue Server-URL.
- Appterix Agent: Stellen Sie sicher, dass die Verbindung zwischen Agent und Serverkomponente über die neue hergestellt werden kann. Hierfür kann eine Installation des MSI Paket mit der Angabe der neuen Agent Verbindungsdaten (Server-URL, Client-ID, Client-Secret) aus den Allgemeinen Einstellungen im Bereich Einstellungen der Appterix-Verwaltungsoberfläche vorgenommen werden.