yuuvis® RAD core-service installieren

yuuvis® RAD 10.x

Der Dienst yuuvis® RAD core-service ist über den Microservice 'dmssidecar' in yuuvis® RAD eingebunden.

Stellen Sie vor der Installation sicher, dass die Systemvoraussetzungen erfüllt sind.

Für eine Installation auf einem Microsoft SQL Server High Availability Cluster muss die Datenbank-Instanz für die Installationszeit aus dem Cluster herausgenommen und danach wieder integriert werden. Dies kann im laufenden Betrieb des Clusters durchgeführt werden. Spätere Updates können ohne dieses Vorgehen durchgeführt werden.

Schritte für die Installation von yuuvis® RAD core-service:

Installationsverzeichnis \yuuvis_rad_core-service\ in das Dateisystem des Rechners kopieren, auf dem yuuvis® RAD core-service installiert werden soll.
yuuvis_rad_core-service_setup-<Version>.exe aus dem Installationsverzeichnis ausführen.

Der Installationsassistent wird gestartet. Folgen Sie den Schritten des Installationsassistenten.

Geben Sie folgende Parameter an:

Technischer Dienstname /

Dienstanzeigename

Technischer Dienstname und Dienstanzeigename für die Dienststeuerung

Datenbanktyp

MSSQL
PostgreSQL

Oracle Datenbanken werden nur für bestehende Installationen weiterhin unterstützt.

Datenbankparameter

Server	IP-Adresse
Port	Port des Datenbankservers
Instanz	Optional: Instanzname
Name	Datenbankname Erlaubte Zeichen: A-Z, a-z, 0-9, _, @, # Datenbanknamen dürfen nicht mit Ziffern beginnen.
Benutzer	Name des Datenbankbenutzers Der Benutzer benötigt die Rolle 'db_owner'.
Passwort	Passwort des Datenbankbenutzers Das Passwort wird in den Credential Store eingetragen.

Datenbankstruktur

Ja - die Datenbankstruktur mit Basiskonfigurationen wird erstellt

Nein - die Datenbankstruktur liegt bereits vor

Datenverzeichnis

Verzeichnisse für die Cache-, Work- und Archivbereiche angeben.

Die Verzeichnisse können über yuuvis® RAD management-studio konfiguriert werden.

Sidecar-URL

IP-Adresse und Port vom Microservice 'dmssidecar'. Standartport: 7301

Wenn die Datenbankstruktur mit Basiskonfigurationen nicht erstellt wird, dann wird die Sidecar-URL aus den bestehenden Daten übernommen.

Sidecar-Dienst-Systembenutzer

Der angezeigt API-Schlüssel des Systembenutzers muss notiert und bei der Installation von yuuvis® RAD service-manager angegeben werden.

Zugriffe aus yuuvis® RAD service-manager auf yuuvis® RAD core-service erfolgen im Kontext des Systembenutzers, der bei diesen Zugriffen über alle Rechte verfügt.

Lizenzschlüssel

Auf Anfrage erhalten Sie einen Lizenzschlüssel. Wenn Sie den Lizenzschlüssel eingeben, dann wird die Lizenz über den Lizenzservice abgerufen und aktiviert.

Lizenzen können nachträglich eingebunden und aktiviert werden.

Ohne Lizenz wird eine PROVISIONAL-Lizenz aktiviert.

Datenbankinitialisierung starten
Die Datenbankinitialisierung erstellt die Datenbanktabellen für yuuvis® RAD.
Falls keine Datenbankverbindung besteht und die Datenbankinitialisierung nicht durchgeführt werden kann, muss die Installation erneut ausgeführt werden.

Passen Sie vor dem Dienststart die Dienstparametern an:

yuuvis_rad_core-servicew.exe aus dem Verzeichnis \bin\ ausführen.

Dienstparameter:

Log On > Account	Konto für die Dienstanmeldung yuuvis® RAD core-service benötigt ein administratives Konto.
Logging > Level	Optional: Protokollierungslevel für die Dienstprotokollierung
Logging > Path	Optional: Pfad für Dienstprotokolle
Logging > Stdout	Optional: Umleitung der Standardausgabe in eine Datei
Logging > Stderror	Optional: Umleitung der Standardfehlerausgabe in eine Datei
Java > Java Options	-Djboss.as.management.blocking.timeout Wert angeben: 12000
Java > Java Options	Optional: -Djboss.server.log.dir und -Dorg.jboss.boot.log.file anpassen
Java > Initial memory pool Java > Maximum memory pool	Arbeitsspeicher zuweisen

Starten Sie den Dienst yuuvis® RAD core-service.

Systembenutzer

Optionale Einstellungen zum Systembenutzer und dem Zugriff über den Sidecar-Dienst auf yuuvis® RAD core-service sind möglich.

Legen Sie dazu im Installations-Verzeichnis \standalone\configuration\ eine Datei install-LocalPreferences.properties mit folgendem Inhalt an:

CheckSystemUserAccessFromSidecarOnly=true/false

Geprüft wird, ob sich ein Systembenutzer nur über den Sidecar-Dienst anmelden kann. Default: true.

AdditionalSystemUserAccessHosts=Host1/IP-adress,Host2/IP-adress

Weitere Hosts/IP-Adressen, die sich mit dem Systembenutzer anmelden können. Einträge sind nur dann notwendig, wenn der Sidecar-Dienst mehr als eine Adresse hat, oder wenn Fremddienste, die den Sidecar-Dienst verwenden, nicht auf dem Host des Sidecar-Diensts laufen. Mehre Adressen werden durch das Komma getrennt. Default: kein Eintrag.

Timeout

yuuvis® RAD core-service wird mit einem Default-Timeout von 30 Sekunden installiert. Für die Verarbeitung großer Dateien und in stark ausgelasteten Netzwerken kann der Timeout hochgesetzt werden.

Legen Sie dazu im Installations-Verzeichnis \standalone\configuration\ eine Datei install-LocalPreferences.properties mit folgendem Inhalt an:

com.os.ecm.messaging.LocalSidecarPreferences.SocketTimeout=<Wert_in_Milisekunden>

Log-Dateien

Log-Dateien werden von yuuvis® RAD core-service als Standard in folgendem Verzeichnis angelegt:

<core-service-data>\logs\core-service.log

<core-service-data>\logs\bmp.log für die Protokollierung der Ausführung der Prozess-Skripte.

<core-service-data>\logs\core-service-security.log für die Protokollierung von Änderungen am Schema, am Sicherheitssystem und von Benutzeranmeldungen.

Sicherheitslogs müssen aktiviert werden: Hauptmenü > System > Einstellungen > Core-Service > Global > Server > Sicherheitslogs aktivieren.

Credential Store

Datenbank-Passwort ändern

Um das im Credential Store gespeicherte Passwort für den Zugriff auf die Datenbank zu ändern, führen Sie folgende Schritte aus:

Starten Sie die Eingabeaufforderung im Verzeichnis \tools\ der yuuvis® RAD core-service-Installation.

Das Verzeichnis enthält die Batch-Datei change-db-pwd.bat.
Geben Sie Folgendes ein: change-db-pwd DB_Password
Starten Sie yuuvis® RAD core-service neu.

Aktualisierung bestehender Installationen

Das Passwort für den Zugriff auf die Datenbank wird ab der Version 8.12 bei Neuinstallationen im Credential Store eingetragen.

Die Aktualisierung einer bestehenden Installation überträgt das Passwort nicht in den Credential Store.

Um das Passwort in den Credential Store einzutragen, führen Sie folgende Schritte aus:

Credential Store anlegen:
- Starten Sie die Eingabeaufforderung im Verzeichnis \bin\ der yuuvis® RAD core-service-Installation.
- Geben Sie Folgendes ein:
```
elytron-tool.bat credential-store --create --
location=../standalone/configuration/dbcredstore.cs --password "CredentialStoreAccessPW"
```
Passwort in den Credential Store eintragen:
- Starten Sie die Eingabeaufforderung im Verzeichnis \bin\ der yuuvis® RAD core-service-Installation.
- Geben Sie Folgendes ein:
```
elytron-tool.bat credential-store --
location=../standalone/configuration/dbcredstore.cs --password "CredentialStoreAccessPW" --add=databasePW --
secret="DB_Password"
```
Anpassen der Konfigurationsdatei jas-app.xml aus dem Verzeichnis \standalone\configuration\ der yuuvis® RAD core-service-Installation:
- Fügen Sie den Credential Store im Abschnitt <subsystem xmlns= "urn:wildfly:elytron"...> ein:
- Ersetzen Sie im Abschnitt <datasource jndi-name="java:/JASDB" ...> das Passwort durch einen Verweis auf den Credential Store:
```
<datasource jndi-name="java:/JASDB" ...>
    ...
    <security>
        <user-name>sa</user-name>
        
        <credential-reference store="dbcredstore" alias="databasePW" />
    </security>
```
- Löschen Sie das Passwort aus der Datei und starten Sie yuuvis® RAD core-service neu.

Deinstallation von yuuvis® RAD core-service

Bei der Installation von yuuvis® RAD core-service wird ein Deinstallations-Programm im Installationsverzeichnis erstellt, das yuuvis® RAD core-service deinstalliert.

Update

Informationen zur Aktualisierung von Komponenten erhalten Sie über die Release Informationen.