yuuvis® RAD core-service installieren
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.
-
Geben Sie folgende Parameter an:
- MSSQL
- PostgreSQL
- 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.
Der Installationsassistent wird gestartet. Folgen Sie den Schritten des Installationsassistenten.
Technischer Dienstname / Dienstanzeigename |
Technischer Dienstname und Dienstanzeigename für die Dienststeuerung | ||||||||||||
Datenbanktyp |
Oracle Datenbanken werden nur für bestehende Installationen weiterhin unterstützt. |
||||||||||||
Datenbankparameter |
|
||||||||||||
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. |
||||||||||||
E-Mail-Parameter |
Optional: Parameter für das Senden administrativer E-Mails. Die Parameter können über yuuvis® RAD management-studio angegeben und geändert 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. |
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>
<!-- <password>DB_Password</password> -->
<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.