Installing yuuvis® RAD core-service
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.
- Launch yuuvis_rad_core-service_setup-<Version>.exe from the installation directory.
-
Specify the following parameters:
- MSSQL
- PostgreSQL
- 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.
The installation wizard will start. Follow the steps described by the installation wizard.
Technical service name/ service display name |
Technical service name and service display name for service control | ||||||||||||
Database type |
Continued support for Oracle databases will only be available for existing installations. |
||||||||||||
Database parameters |
|
||||||||||||
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. |
||||||||||||
E-mail parameters |
Optional: parameters for sending administrative e-mails. The parameters can be specified and modified 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. |
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 directories by default:
<install>\logs\core-service.log
<install>\logs\bmp.log for logging the execution of the process scripts.
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.