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:

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.
Run yuuvis_rad_core-service_setup-<version>.exe from the installation directory.

The installation wizard will start. Follow the steps described by the installation wizard.

Specify the following parameters:

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.

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.

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

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