Installation

yuuvis® RAD repository-manager • 10.x »

Requirements

As a prerequisite, yuuvis® RAD and all of its components must have been installed.

yuuvis® RAD repository-manager provides the 'ArchiveLink' interfaces according to the S/4-BC-AL 7.40 integration scenario.

This interface is supported by SAP ERP 6.x and higher and S/4HANA from version 1503 onwards. ArchiveLink is not available for S/4HANA Public Cloud.

yuuvis® RAD repository-manager provides the 'ILM' interfaces according to the BC-ILM 3.1 integration scenario.

This interface is supported by SAP ERP 6.0 EhP 8 and higher as well as S/4HANA from version 1503 onwards.

The Visual C++ Redistributable Package for Visual Studio is required. The package must be installed before installing the 'repository-manger' service.

Installation

You will receive the following data to install yuuvis® RAD repository-manager:

  • 'repository-manger' service

  • RMTypes.zip

    Schema provided via yuuvis® RAD designer as part of the active schema.

'repository-manager' Service

The 'repository-manager' service is installed using yuuvis® RAD service-manager.

After installation, yuuvis® RAD repository-manager must be enabled via the servicewatcher-sw.yml configuration file from the \config directory by assigning the instances parameter the value 1:

name: repositorymanager
type: microservice
profiles: prod,cloud,mq
instances: 1
arch: x64
memory: 768M
port: 8010
path: "${appBase}/repositorymanager/repositorymanager-app.jar"

Once completed, yuuvis® RAD service-manager needs to be restarted.

For the communication between yuuvis® RAD core-service and yuuvis® RAD repository-manager, you usually have to increase the memory allocation for the 'dmssidecar' microservice from 512 MB (default) to 1024 MB via the servicewatcher-sw.yml configuration file.

Default Settings

yuuvis® RAD repository-manager is installed using central settings. Customizations, if necessary, should be performed before starting the service. Remember that YML files have a specific syntax.

Port 8010 is the default port for 'repository-manager' services. If you need to change the port, do so in the servicewatcher-sw.yml file. You will need to restart yuuvis® RAD service-manager afterward.
Working directory

By default, the working directory is created by yuuvis® RAD service-manager in the \rm\working-dir subdirectory of the data directory.

You can use the working-dir parameter of the repositorymanager-prod.yml configuration file to customize it.

The repositorymanager-prod.yml Configuration File

The repositorymanager-prod.yml configuration file is installed by yuuvis® RAD service-manager in the \config directory during installation. Use a text editor to enter the parameters in the configuration file.

A template is copied to the \service-manager\rm\config-example directory during installation.

Parameters of the repositorymanager-prod.yml configuration file:

Parameter Type Description Sample value
repository-manager.propagate-retention Boolean

true: retention periods are assigned to the documents.

Default: true

 true
repository-manager.working-dir String Working directory ${yuuvis.data.path}\rm\working-dir
repository-manager.barcode.default-docType String

Default SAP document type, if there is no barcode mapping for the yuuvis® RAD content type.

 TIF
repository-manager.barcode.cntType2docType String

List of entries for mapping the barcode document type, separated by pipe characters.

Entries consist of yuuvis® RAD content type, equals sign, SAP document type.

 Image/TIFF=FAX|application/pdf=PDF
repository-manager.barcode.repository-config String

List of entries separated with the pipe character. The entries are SAP repositories that support barcode documents.

If all SAP repositories support barcode documents, no entry is necessary.

 YT|YR
repository-manager.barcode.work-folder String Directory where KGS stores data in the barcode scenario. ${repository-manager.embedded-tomcat}\webapps\cs\work\contentserver\barcode
repository-manager.logger.path String

Path to the directory for logs

 ${repository-manager.working-dir}\logs
repository-manager.logger.max-history Integer

Maximum retention time for the logs in days.

 7
repository-manager.components.text String

List of formats for the document type for text documents

 text/plain
repository-manager.components.scanned String

List of formats for the document type for scanned documents

 image/tiff
repository-manager.barcode.default-protection   Barcode: document protection, if not provided by SAP rcud
repository-manager.barcode.default-protocol-version   Barcode: version number of the ArchiveLink log, if not provided by SAP 0046
dms.username String Name of the technical user

A technical user 'system' is created with the installation of yuuvis® RAD service-manager and does not need to be configured further.

You can specify another user with a password.

The technical user requires full access rights to the objects.
dms.password String Password of the technical user The password of a technical user should be encrypted.
dms.uri String

IP address and port used by yuuvis® RAD repository-manager to connect to yuuvis® RAD core-service:

'dmssidecar' service or yuuvis® RAD core-service

 http://127.0.0.1:7301
dms.use-sidecar Boolean true: connection via 'dmssidecar' service false
repository-manager.http-calls.connect-timeout Integer Timeout in seconds for the connection to yuuvis® RAD core-service Default: 30
repository-manager.http-calls.read-timeout Integer Timeout in seconds for reading data Default: 60
repository-manager.http-calls.write-timeout Integer Timeout in seconds for writing data Default: 120