Repository-wide settings

Repository-wide settings are configured for each repository separately in the repository.cfg file.

There are a few global configuration parameters in this file while most configuration is for each repository separately. For these, the parameter names always starts with the repository name.

For more details on parameters names see https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2754019329 .

Parameters for repositories relate to a service. These parameters are documented here https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2308014099 .

Global parameters in the repository.cfg file

Repository list

The parameter repositoryfactory.repositorylist contains a list of all repository names.

Example:

repositoryfactory.repositorylist = repo001,repo002,repo003,repo004,repo005

Note: When activating Multi-Tenant-Support, the repository names include the tenant name they are linked to. See https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2753953793 .

Repository Description

With the description parameter you can give the repository a description that is visible in the status webapp.

<repo>.description=Invoices

see https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2738061313

Configuration templates

The parameter repositoryfactory.templatelist can be used to provide a list of template configurations for repositories.

Example:

repositoryfactory.templatelist = FI_REPOS, MM_REPOS

Then using the template name, parameters can be configured for it:

Example:

#===== S3-minio content service configuration (filesystem|azureblobstore|s3blobstore|kgsstore) 
FI_REPOS.contentservice.s3blobstore.connectionuser=<user>  
FI_REPOS.contentservice.s3blobstore.connectionpass=<password> 
FI_REPOS.contentservice.s3blobstore.maxconnections= 
FI_REPOS.contentservice.s3blobstore.endpoint=127.0.0.1:9000 
FI_REPOS.contentservice.s3blobstore.protocol=http 
FI_REPOS.contentservice.s3blobstore.bucketname=shared.bucket 
FI_REPOS.contentservice.s3blobstore.contrepinpath = true 
FI_REPOS.configdata.filesystem.root=C:\\tia\\config

In case multiple repositories are stored in the same S3 bucket, contrepinpath is required to be set to true. So, when setting bucketname in a template, always enable contrepinpath, too.

By the repository parameter <repository name>.template, these template can be configured for a specific repository.

Example:

FI.template = FI_REPOS
AB.template = FI_REPOS

Parameters from template can be overwritten by specifying the parameter for the repository explicitly.

Example:

Assuming the following business requirement: The S3 bucket should be set for each repository separately, so both do not write into the same bucket.

FI.contentservice.s3blobstore.bucketname=fi.bucket
AB.contentservice.s3blobstore.bucketname=ab.bucket