yuuvis® RAD repository-manager 5 Migration

yuuvis® RAD repository-manager • 10.x »

Version 5 of yuuvis® RAD repository-manager is available from yuuvis® RAD 10.12. With the new version, KGS components are no longer used and the ArchiveLink and ILM connections are split into two separate services: 'rmalink' and 'rmilm'.

Version 4 of yuuvis® RAD repository-manager can still be used. It will only be necessary to update to version 5 with a subsequent version of yuuvis® RAD.

The 'rmalink' and 'rmilm' services are also installed; however, they are not activated. The 'repository-manger' service remains activated so that access to the KGS administration is possible and data from the existing configuration can be viewed and transferred: http://<service-manager-IP>:<Port>/cs/.

After configuring the new services, they must be activated via the servicewatcher-sw.yml file located in the \config directory of yuuvis® RAD service-manager using the instances parameter and the previous 'repository-manger' service must be deactivated.

If only the ArchiveLink connection or only the ILM connection is used, then only the corresponding service needs to be configured and activated.

Migration of the ArchiveLink Connection

The 'rmalink' service requires the rmalink-prod.yml configuration file. This file needs to be created in the \config directory of yuuvis® RAD service-manager.

A template for the configuration is available for download.

Parameters of the rmalink-prod.yml configuration file:

Parameter Value
repositorymanager-al.rad.repositories

Comma-separated list of SAP repositories.

The repository names are taken from the KGS configuration:

Main > tia® Content Server.

repositorymanager-al.rad.use-sidecar

Connection via the 'dmssidecar' service.

Copy the value from the repositorymanager-prod.yml file.

You need values for the following parameters for the value false.
repositorymanager-al.rad.api-uri

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

Default port for yuuvis® RAD core-service: 8080.
repositorymanager-al.rad.username User name for access to yuuvis® RAD core-service
repositorymanager-al.rad.password Password for access to yuuvis® RAD core-service

The following parameters need to be specified if they are specified in the repositorymanager-prod.yml file and thus overwrite default values.

Parameter rmalink-prod.yml Parameter repositorymanager-prod.yml Default
repository-manager.propagate-retention

repositorymanager-al.retention.enabled

 true
repository-manager.barcode.cntType2docType

repositorymanager-al.barcode.cnt-type-doc-type

 Image/TIFF=FAX|application/pdf=PDF
repository-manager.barcode.default-docType

repositorymanager-al.barcode.default-doc-type

 TIF
repository-manager.barcode.default-protection repositorymanager-al.barcode.default-protection "rcud"
repository-manager.barcode.default-protocol-version repositorymanager-al.barcode.default-protocol-version "0047"
repository-manager.barcode.processing-limit repositorymanager-al.barcode.limit 1000

The following parameters are required if the barcode scenario is activated. The values are taken from the KGS configuration.

Parameter Value
repositorymanager-al.barcode.interval

Barcode processing interval (in minutes).

The default value 0 deactivates barcode processing.

The value is specified in seconds in the KGS barcode configuration:
Main > KGS SAP Connector > Edit Configuration > Barcode
Here, however, the value must be specified in minutes.
repositorymanager-al.rad.barcode.sap.connections

List of SAP® connections to the repository.

Example:

repositorymanager-al:
  rad:
    barcode:
      sap:
        connections:
          - name: OSH
            contRep: IR
            ashost: 10.12.4.7
            sysnr: 00
            client: 800
            user: user
            passwd: secret
            lang: en

Adopt the values from the KGS configuration:
Main > KGS SAP Connector > Actions: Edit > Configuration Values

The following parameters are required if compression is activated. Adopt the values from the KGS configuration: Main > KGS SAP Connector > Edit Configuration > Components

Parameter Value
repositorymanager-al.compression.limit

Compression for objects that exceed the specified size in MB.

The value 0.0 deactivates compression.
repositorymanager-al.compression.content-types

If compression is activated, it can be restricted to content types.

Example: [application/pdf, image/png]

servicewatcher-sw.yml

The servicewatcher-sw.yml file located in the \config directory of yuuvis® RAD service-manager must also be customized.

applications:
- name: rmalink
  type: microservice
  profiles: prod,cloud,red
  instances: 1
  memory: 512M
  port: 8092
  path: ${appBase}/rmalink/rmalink-app.jar
  options:
  - -Dloader.path=${enaio.data.path}/rm-alink/lib

SAP® ArchiveLink Connection Configuration

The 'rmalink' service must be activated and started before the SAP® connection configuration.

Open the existing connection via transaction 'OAC0' in the SAP® GUI and carry out the following steps.

  • Port Number: Enter the port of the 'rmalink' service. Default: 8092.

  • HTTP Script: Enter the following: api/rad/al.

    You can test the connection using the balance button.

  • Send the certificate to the 'rmalink' service using the letter button.

  • Use 'PUT request' to activate the certificate in yuuvis® RAD service-manager via the /api/rad/certificate/activate endpoint from the 'rmalink' service. Parameter: contRep and cn

Migration of the ILM Connection

The 'rmilm' service requires the rmilm-prod.yml configuration file. This file needs to be created in the \config directory of yuuvis® RAD service-manager.

A template for the configuration is available for download.

Parameters of the rmilm-prod.yml configuration file. Adopt the values from the KGS configuration:

Main > KGS SAP Connector > Edit Configuration > ILM

Parameter Value
repositorymanager-ilm.auth.username

User name of the ILM client
repositorymanager-ilm.auth.password

Password for the user name
repositorymanager-ilm.retention.enabled

ILM documents with a deletion lock have their retention times set in yuuvis® RAD.

Default: true

The parameter is only required if retention times are deactivated in the repositorymanager-prod.yml file via the repository-manager.propagate-retention parameter.
repositorymanager-ilm.rad.dms.use-sidecar

Connection via the 'dmssidecar' service.

You need values for the following parameters for the value false.
repositorymanager-ilm.rad.dms.api-url

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

Default port for yuuvis® RAD core-service: 8080.
repositorymanager-ilm.rad.dms.username User name for access to yuuvis® RAD core-service
repositorymanager-ilm.rad.dms.password Password for access to yuuvis® RAD core-service

Sample configuration:

repositorymanager-ilm:
  auth:
    username: user
    password: secret
  rad:
    dms:
      use-sidecar: false
      api-uri: http://10.10.104.38:8080
      username: user
      password: secret
  retention:
    enabled: false

SAP® ILM Connection Configuration

The 'rmilm' service must be activated and started before the SAP® connection configuration.

Open the existing connection via transaction 'SM59 > HTTP Connections to External Server' in the SAP® GUI and carry out the following steps.

  • Port: Enter the port of the 'rmilm' service in the 'Technical Settings' area. Default: 8094.

  • Password: Enter the password that was adopted from the KGS ILM configuration to rmilm-prod.yml in the 'Logon & Security' area.

  • Test the connection.