Installation

enaio® repository-manager • 11.0 »

Requirements

The complete installation of enaio® is required.

enaio® repository-manager provides the 'ArchiveLink' interfaces in accordance with the S/4-BC-AL 7.40 integration scenario.

This interface is supported by SAP® from version ERP 6.x and with S/4HANA from version 1503. ArchiveLink is not available for S/4HANA - public cloud.

enaio® repository-manager provides the 'ArchiveLink' interfaces in accordance with the BC-ILM 3.1 integration scenario.

This interface is supported by SAP® from version ERP 6.0 EhP 8 and with S/4HANA from version 1503.

Installation

When using os_service-manager_setup.exe located in the \Backend\Service-Manager\ directory for the installation, the services are installed and updated.

Enable the 'repository-manager' service during the installation. The 'dms' and 'license' services are also required.

The Service Manager Update located in the \Backend\ directory can also be used for updates.

Assignments between content repositories and enaio® document types and their fields are checked when the 'repository-manager' service is started: Endpoint 'manage/health/dmsObjectModel'. If there are errors, then the service is running, but it is shown as 'down' in the enaio® services-admin.

Communication with SAP® generally requires the import of a certificate for data consistency and security, the corresponding adaptation of the configuration file repositorymanager-prod.yml, the integration of the certificate in enaio® service-manager and corresponding adjustments to the SAP® SSL configuration.

Default Settings

enaio® repository-manager is installed with the following default settings. Customizations, if necessary, should be performed before starting the services. 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, only do so in the servicewatcher-sw.yml file. You will need to restart enaio® service-manager afterward.
Working directory

By default, the working directory is created by enaio® 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 enaio® service-manager in the \config directory during the installation. You can generally use the enaio® repository-manager interfaces to specify the mandatory parameters. Optional parameters can be entered in the configuration file using a text editor.

A configuration file with all parameters is available for download.

Parameters of the configuration file:

Parameter Type Description Sample value
repository-manager.working-dir String Working directory ${enaio.data.path}\rm\working-dir
repository-manager.repositories.a-link String

The value is specified via the configuration interface.

Comma-separated list of the a-link repositories.

An individual entry consists of the enaio® cabinet name, pipe character, SAP® repository name, pipe character.

 SAP_OSI_RT|RT|,SAP_OSD_D1|D1|,TestTT|TT|
repository-manager.repositories.ilm-link String

The value is specified via the configuration interface.

Comma-separated list of the ILM collections.

An individual entry consists of the enaio® cabinet name, pipe character, ILM collection name, pipe character.

 ILM Collection|ILM|
repository-manager.propagate-retention Boolean

true: Retention times are assigned to the documents.

Default: false

 true
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.cntType2docType String

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

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

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

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

 TIF
repository-manager.admin.password String

The value is changed via the configuration interface.

Password for the administrator. Default: optimal

 $2a$10$a74KZCLNMiqlt5vq5dKPXORm70
enaio.dms.username String

By default, the technical user from the application-blue.yml file from enaio® service-manager is used to access the DMS service.

If another technical user should be used, then specify them here.

sap

Default: root

The technical user requires full access rights to the objects.
enaio.dms.password String User password for the DMS service login if another technical user is specified as the default user. secret
repository‑manager.http‑calls.short‑calls.
connect-timeout		 Integer

Timeout in seconds for the connection with enaio® server

Default: 30

  
repository‑manager.http‑calls.short‑calls.
write-timeout		 Integer

Timeout in seconds for writing data

Default: 120

  
repository‑manager.http‑calls.short‑calls.
read-timeout		 Integer

Timeout in seconds for reading data

Default: 60

  
repository‑manager.http‑calls.long‑calls.
connect-timeout		 Integer

Timeout in seconds for calling up the object definition

Default: 180

  
repository‑manager.http‑calls.long‑calls.
read-timeout		 Integer

Timeout in seconds for reading the object definition

Default: 3600

  
repository-manager.set-archivable Boolean Documents in enaio® receive the 'Approved for archiving' property. Default: false true/false
management.trusted.ipPattern String

Access to services and management endpoints can be secured via IP filters.

A configuration for the enaio® repository-manager has priority over the corresponding configuration for the services.

The default setting permits access by all IP addresses:

management.trusted.ipPattern: .*

(127\.0\.0\.1)|(10\.10\.7\.139)|(10\.10\.4\.*)

If SSL is enabled for the 'dms' service, the following entry must be added to the repositorymanager-prod.yml configuration file:

enaio.host: <hostname/IP-address>

hostname/IP-address: The host name (FQDN) or the IP address is specified, depending on the certificate.

Encryption of Configuration Values

The configuration values in the repositorymanager-prod.yml file located in the \config\ directory of enaio® service-manager can be encrypted:

  • Open the command prompt as the administrator and change to the \service-manager\tools\encryption\ directory.

  • Run the following command: encode.bat "value" -W.

    The encrypted value is displayed in round brackets with 'ENC' before it: ENC(encryptedvalue).

  • Copy the encrypted value with the leading 'ENC' and with the round brackets and enter it into the configuration file.

  • Save the configuration and restart the service, if necessary.

Connections via enaio® gateway

The communication between enaio® and enaio® repository-manager can be secured via enaio® gateway:

Connection Direct connection enaio® gateway connection
ArchiveLink <repository-manager-IP>:8100/cs/contentserver <gateway-IP>:80/repositorymanager/cs/contentserver
ILM <repository-manager-IP>:8100/cs/ilm <gateway-IP>:80/repositorymanager/cs/ilm
GUI <repository-manager-IP>:8100 <gateway-IP>:80/repositorymanager
KGS GUI <repository-manager-IP>:8100/cs/  

KGS-GUI – Connection via enaio® gateway

The following modifications to the ...\os_gateway\config\application-prod.yml configuration file of enaio® gateway are required for this connection:

  • proxy.services.endpoints.endpoint

    proxy:
      services:
        endpoints:
          - endpoint:
              name: cs
              url: http://localhost:8010/cs

    Modify the URL, if necessary: Address and port of enaio® repository-manager.

  • ossecurity.exposedEndpoints

    ossecurity:
      exposedEndpoints: '/osweb/**,/cs/**'

  • ossecurity.unauthenticated.routes

    ossecurity:
      unauthenticated:
        routes: '/cs,/repositorymanager'