Installation Webservice

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.

Installation Datenbank

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: #

1. 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
2. Datenbank angeben:
   • Geben Sie die Zugangsdaten der Datenbank ein:
     • Host
     • Benutzername
3. 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
4. Einstellungen speichern und Dienste starten:
   • Speichern Sie die Konfiguration.
   • Starten Sie die benötigten Dienste, um den Web-Service in Betrieb zu nehmen.

SSL Zertifikat ersetzen

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:

1. Starten Sie den Web-Service.
2. Gehen Sie in der Web-Oberfläche zu der Option Hardware-ID anzeigen.
3. 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]