Secure Agent Services

Back Next

Creating a custom user-platform.yaml file

You can create a custom

user-platform.yaml

file with the required properties and their custom values to override the properties in the

platform.yaml

file on the Secure Agent.

You must have the same level of access permissions as the

platform.yaml

file to create and edit the

user-platform.yaml

file.

To create a custom

user-platform.yaml

file, perform the following steps:

Create a file named

user-platform.yaml

in the following directory:

<Secure Agent installation directory>\apps\process-engine\conf

Copy the properties that you want to customize from the

platform.yaml

file that is available in the following directory to the

user-platform.yaml

file and override the values, as required:

<Secure Agent installation directory>\apps\process-engine\<latest_process_engine_version>\conf

For example, consider that you need to override the values of the

cacheExpiryMillis

and

lockTimeoutMillis

properties.

These properties are available in the IDs section in the default

platform.yaml

file as shown in the following sample:

serviceHosts:
    ids:
        context: /identity-service/api/v1/
        agentContext : /identity-service/agent/api/v1/
        cache:
           enabled: true
           maxCacheItems: 2500
           cacheExpiryMillis: 60000
           lockTimeoutMillis: 30000
           refreshAheadEnabled: true
           queueCapacity: 500
           corePoolSize: 1
           maxPoolSize: 5
           keepAliveSec: 120
           timeToRefreshSec: 15
           evictOnLoadMiss: false
        clientPool:
           socketTimeout : 60000
           connectionTimeout : 60000
           poolMaxTotal : 40
           poolMaxPerRoute : 30
        hystrix:
           executionTimeoutInMilliseconds : 60000
           fallbackEnabled: false

Copy these properties from the

platform.yaml

file and update the values in the

user-platform.yaml

file as shown in the following sample:

serviceHosts:
    ids:
        context: /identity-service/api/v1/
        agentContext : /identity-service/agent/api/v1/
        cache:
           cacheExpiryMillis: 200000
           lockTimeoutMillis: 150000

You must ensure that you follow the same hierarchy and syntax as the default

platform.yaml

file.

Save the

user-platform.yaml

file.

Restart the Process Server for the changes to take effect.

When the Process Server is up and running, the properties specified in the

user-platform.yaml

file override the properties in the

platform.yaml

file.