Schritt 0: Datenbank einrichten #
Bevor der Web-Service verwendet werden kann, ist eine korrekt konfigurierte Datenbank erforderlich. Stellen Sie sicher, dass:
- Die Datenbank angelegt wurde (z. B. MySQL oder MSSQL).
- Sie die Zugangsdaten (Host, Benutzername, Passwort und Datenbankname) zur Hand haben.
Schritt 1: Web-Service herunterladen #
- Laden Sie die neueste Version des Web-Services von der offiziellen RiverBird-Website herunter: => https://riverbird.de/downloads <=
- Entpacken Sie die heruntergeladene Datei in ein Verzeichnis Ihrer Wahl.
- Führen Sie die Setup-Datei aus, um den Installationsprozess zu starten.
Schritt 2: Web-Service einrichten #
Hinweis zur SSL-Konfiguration: #
Der Web-Service kann auch ohne SSL-Zertifikat getestet werden. Da sich jedoch die URL bei späterer Umstellung auf HTTPS ändert, müssen Agents neu ausgerollt werden. Es wird daher dringend empfohlen, von Anfang an ein SSL-Zertifikat zu verwenden.
Vorgehen: #
- Extern erreichbare URL angeben:
- Geben Sie die öffentliche URL ein, unter der der Web-Service erreichbar sein soll.
- Diese URL sollte mit einem Präfix versehen werden, z. B.:
/RWS
für den RiverBird Web-Service./CWS
für den c-entron Web-Service./RSO
für Riversuite Online.
- Beispiel:
https://ihredomain.de/RWS
- Datenbank angeben:
- Geben Sie die Zugangsdaten der Datenbank ein:
- Host
- Benutzername
- Geben Sie die Zugangsdaten der Datenbank ein:
- Zugangsdaten hinterlegen:
-
- Passwort
- Datenbankname
- Verbindung testen: Verwenden Sie die entsprechende Schaltfläche, um sicherzustellen, dass der Web-Service erfolgreich eine Verbindung zur Datenbank herstellen kann
-
- Einstellungen speichern und Dienste starten:
- Speichern Sie die Konfiguration.
- Starten Sie die benötigten Dienste, um den Web-Service in Betrieb zu nehmen.
Abb. 1
Hinweis: Die URL des Web-Service muss immer mit einem Präfix (z.B. /RWS für Riverbird Web-Service) versehen sein. Damit wird es später wesentlich leichter andere Web-Services, wie den c-entron Web-Service (z.B. /CWS für c-entron Web-Service) zu betreiben. Auch für die Installation von Riversuite Online wird von Anfang an ein solcher Präfix (/RSO für Riversuite Online) verwendet.
Schritt 3: Hardware-ID generieren #
Selbst wenn Sie den Web-Service nur für Testzwecke verwenden, ist eine Lizenz erforderlich. Um diese zu aktivieren:
- Starten Sie den Web-Service.
- Gehen Sie in der Web-Oberfläche zu der Option Hardware-ID anzeigen.
- Kopieren Sie die angezeigte Hardware-ID und senden Sie diese per E-Mail an: [email protected]
Hinweis: Die Aktivierung erfolgt erst, nachdem die Hardware-ID in unserem Lizenztool hinterlegt wurde.
Abb. 2
Wichtige Hinweise: #
- SSL-Voraussetzungen: Stellen Sie sicher, dass ein gültiges SSL-Zertifikat für Ihre Domain vorliegt. Dies erhöht die Sicherheit und ist bei produktivem Einsatz unverzichtbar.
- Präfix-Konventionen: Durch die Verwendung von Präfixen in der URL wird die gleichzeitige Nutzung mehrerer Web-Services auf derselben Domain deutlich vereinfacht.
- Unterstützung: Bei Problemen während der Installation oder Konfiguration können Sie sich jederzeit an unseren Support wenden: [email protected]