yuuvis® RAD core-service installieren

yuuvis® RAD 9.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:

  1. Installationsverzeichnis \yuuvis_rad_core-service\ in das Dateisystem des Rechners kopieren, auf dem yuuvis® RAD core-service installiert werden soll.

  2. yuuvis_rad_core-service_setup-<Version>.exe aus dem Installationsverzeichnis ausführen.
  3. Der Installationsassistent wird gestartet. Folgen Sie den Schritten des Installationsassistenten.

  4. Geben Sie folgende Parameter an:

  5. 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.

    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.

  6. 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.

  7. 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

  8. 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>
              <!-- <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.