SAP® CMIS Connection

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

The service is compatible with SAP® S/4HANA CLOUD, PUBLIC EDITION, and all subsequent versions as well as SAP® Basis release 752.

The service does not currently permit a general CMIS connection; it instead allows for a special SAP® connection according to the SAP® specifications.

Installation

The 'repositorymanager-cmis' service is installed via enaio® service-manager.

The cmisobjdef.xml object definition file in the working directory of the 'repositorymanager-cmis' service is included as part of the installation. Default: ${enaio.data.path}/rm-cmis.

This object definition must be imported via enaio® editor. An additional cabinet is required for each repository. The internal name of object types may not be changed.

Licensing

The 'repositorymanager-cmis' service requires the 'CMI' license. This license must also be integrated into the 'license' service.

Configuration

The rmcmis-prod.yml configuration file is installed by enaio® service-manager in the \config directory during the installation.

Parameters of the configuration file:

Parameter	Type	Description	Sample value
repositorymanager-cmis.working-dir	String	Working directory Default: ${enaio.data.path}/rm-cmis	C:/rm-cmis
repositorymanager-cmis.auth.username	String	User name of the CMIS client	user
repositorymanager-cmis.auth.password	String	Password for the user name	secret
repositorymanager-cmis.enaio.repository-mappings	Map	Mapping of enaio® cabinets to repositories. enaio® cabinets are identified by their name.	'[CMIS Repository]': Rep0_1,Rep0_2 '[CMIS Repository One]': Rep1_1,Rep1_2
repositorymanager-cmis.enaio.object-definition-folder	String	Directory to which the object definition is copied. Default: ${repositorymanager-cmis.working-dir}/obj-def	C:/rm-cmis/obj-def
virus-scan.host	String	An optional antivirus scanner can be integrated. At the moment, only ClamAV is supported.	localhost
virus-scan.port	Integer	Port of the virus scanner. Default port (ClamAV): 3310	3310
virus-scan.platform	String	Platform on which the antivirus scanner is installed. Values: windows or unix	windows
management.trusted.ipPattern	String	Access to services and management endpoints can be secured via IP filters. A configuration for the 'repositorymanager-cmis' service has priority over the corresponding configuration for the services. The default setting permits access by all IP addresses: management.trusted.ipPattern: .*	.*
monitoring.trace.enabled	Boolean	Activation of the metrics log. The services.metrics.log metrics log is also created in the \logs directory of enaio® service-manager. Default: false	true

Encryption of Configuration Values

The configuration values in the rmcmis-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.

Health Check

A health check can be accessed while the service is running via the following URLs:

http://<service-manager>:8090/manage/health

The license, the connection to the 'dms' service, and the object definition are checked. The result will be displayed.

Antivirus Protection

An optional antivirus scanner can be integrated.

At the moment, only ClamAV is supported. ClamAV is an open-source software licensed under the GNU General Public License V2. As such, commercial use and redistribution are permitted.

• Download the ClamAV ZIP archive from the vendor’s website.

• Unzip the archive to a directory.

• Open the command prompt as an admin from the directory and run the following command: clamd.exe --inst.

• Check whether the service is installed and start the service.