Installing yuuvis® RAD core-service

yuuvis® RAD 10.x »

The yuuvis® RAD core-service service is integrated into yuuvis® RAD via the 'dmssidecar' microservice.

Ensure that the System Requirements are fulfilled before installation.

The database instance for the installation time needs to be removed from the cluster and then reintegrated for installation on a Microsoft SQL Server High Availability Cluster. This can be performed in live operation of the cluster. Subsequent updates can be carried out without this procedure.

To install yuuvis® RAD core-service, follow these steps:

  1. Copy the \yuuvis_rad_core-service\ installation directory to the file system of the computer on which you want to install yuuvis® RAD core-service.

  2. Run yuuvis_rad_core-service_setup-<version>.exe from the installation directory.
  3. The installation wizard will start. Follow the steps described by the installation wizard.

  4. Specify the following parameters:

  5. Technical service name/

    service display name

    Technical service name and service display name for service control
    Database type
    • MSSQL
    • PostgreSQL

    Continued support for Oracle databases will only be available for existing installations.

    Database parameters
    Server IP address
    Port Port of the database server
    Instance Optional: Name of the instance
    Name

    Database name

    Permitted characters: A–Z, a–z, 0–9, _, @, #

    Database names cannot start with a number.

    User

    Name of the database user

    The user needs the 'db_owner' role.

    Password

    Password of the database user

    The password is entered into the credential store.

    Database structure

    Yes – the database structure with basic configurations is created

    No – the database structure already exists

    Data directory

    Specify directories for the cache, work, and archive areas.

    The directories can be configured via yuuvis® RAD management-studio.

    Sidecar URL

    IP address and port of the 'dmssidecar' microservice. Default port: 7301

    If the database structure with basic configurations is not created, the sidecar URL is imported from the existing data.

    Sidecar service system user

    The displayed API key of the system user needs to be written down and entered when installing yuuvis® RAD service-manager.

    Access from yuuvis® RAD service-manager to yuuvis® RAD core-service is made in the context of the system user with full access rights for this.

    License key

    You can request and receive a license key. If you enter the license key, the license will be retrieved and activated via the license service.

    Licenses can be subsequently integrated and activated.

    Without a license, a PROVISIONAL license is activated.

  6. Start database initialization

    The database initialization creates the database tables for yuuvis® RAD.

    If there is no database connection and the database cannot be initialized, the installation process must be run again.

  7. Change the service parameters before you start the service:

    Run yuuvis_rad_core-servicew.exe from the \bin\ directory.

    Service parameters:

    Log On > Account

    Account for login to the service

    yuuvis® RAD core-service requires an administrative account.

    Logging > Level Optional: Logging level for service logging
    Logging > Path Optional: Path for service logs
    Logging > Stdout Optional: Redirect the standard output to a file
    Logging > Stderror Optional: Redirect the standard error output to a file
    Java > Java options -Djboss.as.management.blocking.timeout

    Specify value: 12000

    Java > Java options Optional: Adapt -Djboss.server.log.dir and -Dorg.jboss.boot.log.file

    Java > Initial memory pool

    Java > Maximum memory pool

    Assign working memory

  8. Start the yuuvis® RAD core-service service.

System User

Optional settings for the system user and access via the sidecar service to yuuvis® RAD core-service are possible.

To do so, create a install-LocalPreferences.properties file with the following content in the \standalone\configuration\ installation directory:

CheckSystemUserAccessFromSidecarOnly=true/false

Checks whether a system user can log in via the sidecar service only. Default: true.

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

Additional hosts/IP addresses that can log in with the system user. Entries are only necessary if the sidecar service has more than one address, or if third-party services that use the sidecar service are not running on the host for the sidecar service. Multiple addresses are separated using a comma. Default: no entry.

Timeout

yuuvis® RAD core-service is installed with a default timeout of 30 seconds. The timeout can be increased for processing large files and in busy networks.

To do so, create a install-LocalPreferences.properties file with the following content in the \standalone\configuration\ installation directory:

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

Log Files

Log files are generated by yuuvis® RAD core-service in the following directory by default:

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

Execution of the process scripts is logged in the <core-service-data>\logs\bmp.log.

Changes to the schema, the security system, and user logins are logged in the <core-service-data>\logs\core-service-security.log.

Security logs must be enabled: Main menu > System > Settings > Core service > Global > Server > Enable security logs.

Credential Store

Changing the Database Password

Perform the following steps to change the password stored in the credential store for accessing the database:

  • Start the command prompt in the \tools\ directory of the yuuvis® RAD core-service installation.

    The directory contains the batch file change-db-pwd.bat.

  • Enter the following: change-db-pwd DB_Password.

  • Restart yuuvis® RAD core-service.

Updating Existing Installations

The password for accessing the database for new installations is entered in the credential store from version 8.12 onwards.

Updating an existing installation does not transfer the password to the credential store.

Perform the following steps to enter the password into the credential store:

  • Create the credential store:

    • Start the command prompt in the yuuvis® RAD core-service \bin\ directory.

    • Enter the following:

      elytron-tool.bat credential-store --create --
      location=../standalone/configuration/dbcredstore.cs --password "CredentialStoreAccessPW"

  • Enter the password in the credential store:

    • Start the command prompt in the yuuvis® RAD core-service \bin\ directory.

    • Enter the following:

      elytron-tool.bat credential-store --
      location=../standalone/configuration/dbcredstore.cs --password "CredentialStoreAccessPW" --add=databasePW --
      secret="DB_Password"

  • Customize the jas-app.xml configuration file from the \standalone\configuration\ directory of the yuuvis® RAD core-service installation:

    • Insert the credential store in the <subsystem xmlns= "urn:wildfly:elytron"...> section:
    • In the <datasource jndi-name="java:/JASDB" ...> section, replace the password with a reference to the credential store:
      <datasource jndi-name="java:/JASDB" ...>
          ...
          <security>
              <user-name>sa</user-name>
              <!-- <password>DB_Password</password> -->
              <credential-reference store="dbcredstore" alias="databasePW" />
          </security>
    • Delete the password from the file and restart yuuvis® RAD core-service.

Uninstalling yuuvis® RAD core-service

When you install yuuvis® RAD core-service, an uninstallation program is created in the installation directory that uninstalls yuuvis® RAD core-service.

Updates

For information on updating components, see Release Information.