enaio® repository-manager

enaio® • 11.10 »

enaio® repository-manager has been updated and must be reinstalled and reconfigured.

Previously, enaio® repository-manager consisted of the 'repositorymanager' service, which used KGS components and also included the ArchiveLink and ILM connection.

With the new version, KGS components are no longer used and the ArchiveLink and ILM connections are split into two separate services.

  • 'repositorymanager-ilm' service for the ILM connection

  • 'repositorymanager-ilm' service for the ArchiveLink connection

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

The services are installed via enaio® service-manager. They must be configured via the rmilm-prod.yml and rmalink-prod.yml files.

If the services are installed, they must be fully configured before use.

SAP® CMIS Integration

The new 'repositorymanager-cmis' service provides the 'CMIS' interface for the SAP® connection in the project.

The service does not currently enable a general CMIS connection, but a specific SAP® connection in accordance with the SAP® specifications.

ArchiveLink and ILM Migration

For updating installations with the 'repositorymanager' service, enaio® service-manager continues to offer the 'repositorymanager' service for installation in addition to the new 'repositorymanager-ilm' and 'repositorymanager-archivelink' services.

This option does not uninstall the existing 'repositorymanager' service. This means that the configuration file repositorymanager-prod.yml is retained and access to the KGS administration page is possible. Data from these configurations is required for the configuration of the new services.

After the migration, the 'repositorymanager' service must be deactivated via the servicewatcher-sw.yml file from the \config directory of enaio® service-manager: instances: 0

The following instructions assume that the object definition asobjdef_GenericCRweb.xml is used in the existing installation.

Migrating the Connection to ArchiveLink

For the ArchiveLink connection, install the 'repositorymanager-archivelink' service via enaio® service-manager. The configuration file rmalink-prod.yml is installed in the \config directory.

The following parameters must be specified:

  • Registry

    repositorymanager-al:
      enaio:
        cabinet:
          repositories:
            '[Generic CR Web]': RS

    • Copy the repository name from the previous configuration file repositorymanager-prod.yml:

    repository-manager:
      repositories:
        a-link: "Generic CR Web |RS|"

  • Default parameters

    The following values of default parameters must be adopted if they are specified in the repositorymanager-prod.yml and thus overwrite the default values. They are assigned to the new default parameters.

    Parameter name
    repositorymanager-prod.yml    		 Parameter name
    rmalink-prod.yml
    repository-manager.set-archivable repositorymanager-al.enaio.set-archivable
    repository-manager.components.text repositorymanager-al.enaio.components.text
    repository-manager.components.scanned repositorymanager-al.enaio.components.scanned
    repository-manager.propagate-retention repositorymanager-al.retention.enabled
    repository-manager.barcode.cntType2docType repositorymanager-al.barcode.cnt-type-doc-type
    repository-manager.barcode.default-docType repositorymanager-al.barcode.default-doc-type
    repository-manager.barcode.default-protection repositorymanager-al.barcode.default-protection
    repository-manager.barcode.default-protocol-version repositorymanager-al.barcode.default-protocol-version
    repository-manager.barcode.processing-limit repositorymanager-al.barcode.limit

  • Barcode processing

    If barcode processing is activated, the following parameters are required in the rmalink-prod.yml. file.

    • repositorymanager-al.barcode.interval

      The value corresponds to the 'BarcodeTimer' value of the KGS configuration. A value greater than 0 activates barcode processing.

      In the KGS configuration, the value is specified in seconds. For the 'repositorymanager-al.barcode.interval' parameter, enter the value in minutes.

      Example: KGS BarcodeTimer 1800 corresponds to a value of 30.

    • repositorymanager-al.enaio.barcode.sap.connections

      The data for the SAP® connections to the repository can be found in the KGS SAP Connector configuration: Main > KGS SAP Connector > Actions: Edit > Configuration Values.

      Example:

      • Corresponding configuration 'repositorymanager-al.enaio.barcode.sap.connections'

      repositorymanager-al:
        enaio:
          barcode:
            sap:
              connections:
                - name: OSH
                  contRep: RS
                  ashost: 10.10.4.7
                  sysnr: 00
                  client: 800
                  user: RISTIC
                  passwd: password
                  lang: en

    • servicewatcher-sw.yml

      Adapt the servicewatcher-sw.yml file from the \config directory of enaio® service-manager:

      applications:
      - name: rmalink
        type: microservice
        profiles: prod,cloud,blue
        instances: 1
        memory: 512M
        port: 8092
        path: .
        arch: x64
        jdk: jdk17
        options:
        - -Dloader.path="C:/enaio/service-manager/data/rm-alink/lib"

    • Enter the path to the \data\rm-alink\lib directory as an absolute path according to your installation.

  • File compression

    If file compression is activated, then activate the compression via the following parameters in rmalink-prod.yml:

    • repositorymanager-al.compression.limit

      Size in MB from which files are compressed. The default value 0.0 deactivates compression.

    • repositorymanager-al.compression.content-types

      Mime type of the files that are compressed. If all files are to be compressed, the parameter is not required.

  • SAP® connection configuration

    In the SAP® GUI, open the existing connection via the 'OAC0' transaction and carry out the following steps.

    • Port Number: Enter the port of the 'repositorymanager-archivelink' service. Default: 8092

    • HTTP Script: Enter the following: api/enaio/al

      You can text the connection via the scales button.

    • Send the certificate to the 'repositorymanager-archivelink' service using the letter button.

    • Activate the certificate in enaio® service-manager via the endpoint /api/enaio/certificate/activate from the 'repositorymanager-archivelink' service using a 'PUT request'. Parameters: contRep and cn

Migrating the Connection to ILM

For the ILM connection, install the 'repositorymanager-ilm' service via enaio® service-manager. The configuration file rmilm-prod.yml is installed in the \config directory.

The following parameters must be specified:

  • repositorymanager-ilm.auth.username / repositorymanager-ilm.auth.password

    User name and password from the KGS ILM configuration.

  • repositorymanager-ilm.enaio.cabinet.ilm-name

    Name of the enaio® folder type in which ILM data is saved. Default: SAPILM Collection

  • repositorymanager-ilm.retention.enabled

    If retention times were deactivated with the previous parameter repository-manager.propagate-retention: false, then also deactivate the retention times using the new parameter. Default: true.

  • SAP® connection configuration

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

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

    • Password: In the 'Logon & Security' area, enter the password that was transferred from the KGS ILM configuration to rmilm-prod.yml.