Tuning External Purge for a Certified Container installation

About this task

You can tune external purge using the configuration properties in the .Values.setupCfg section of values.yaml.

Add the following configuration properties to values.yaml.

Note: Prepend PROPERTY_archivethread_ to any of the below property names before adding to values.yaml. For example, to update the corePoolSize add this to .Values.setupCfg section PROPERTY_archivethread_purge_corePoolSize=2.
Option Description

purge_corePoolSize

Minimum number of threads. The default is 1.

purge_maxPoolSize

Maximum number of threads. To scale External Purge for a higher load, increase the values for the purge_maxPoolSize and purge_batchSize properties. The default is 30.

purge_keepAliveTime

The External Purge JVM uses a pool of threads to distribute work. This value is the time in milliseconds that the threads will be kept alive if they become idle. If the workload is sporadic, you might need to use a larger value to keep the threads alive longer. The default is 10000.

purge_maxQueueDepth

The maximum depth of the in-memory queue. The maximum number of threads consumes a full batch each from this queue. The value must be kept sufficiently high so that enough work exists there for all the threads. A deep queue means fewer round-trips to the database for finding purge candidates. The default is 200000.

purge_debug

Indicates if the debug mode is active. The default is false.

purge_scavengerSleepTime

Amount of time the purge candidate scavenger sleeps between polls, in milliseconds. The default is 10000.

purge_batchMode

Indicates if you must wait to commit before reaching the batch count defined by the purge_batchsize parameter.

Valid values:

  • true - (default) Wait to commit before reaching the batch count. You can commit before reaching the batch count if the depth of the queue is 0.
  • false - Do not wait to commit before reaching the batch count.

purge_batchSize

Batch size. The number of purge candidates per thread before a commit happens. The default is 100.

purge_dbPool

A new database pool that is used by just External Purge. When you create this pool, it references the purge_maxPoolSize property to create the number of threads needed for External Purge. When this pool is used, the database pool specified in Sterling B2B Integrator for all operations is not used in External Purge.

purge_taskListCapacity

Can be used to set the capacity of the deferred delete file requests.

purge_numberDeleteThreads

Can be used to set the number of threads allocated for processing deferred delete file requests.

GENERATE_PURGE_DOCDISK_LIST

Set to true if a list of documents for purge needs to be generated, else false.

PURGE_DOCS_ON_DISK

Set to true if the documents need to be purged, else false.

PURGE_DOCDISK_LIST_FILENAME

Set to file name for the purge documents list file.