Copying Modified Process Engine-Related JVM Property Values to BPM Properties Files

After upgrading, you must copy any previously specified Process Engine-related JVM property values that you have set to non-default values, to the appropriate BPM properties files.

Prior to version 4.3 of ActiveMatrix BPM, properties on the Java Virtual Machine (JVM) could be used to configure aspects of the Process Engine. Those configurations are now specified by properties in either the bx.properties or pvm.properties file, in the CONFIG_HOME\bpm\bpm_app_name\configuration folder.
Note: JVM properties that are related to application- or signal-level locking are still specified on the node in ActiveMatrix Administrator.

Therefore, if your system is using any Process Engine-related JVM property that you have set to a non-default value, you should note its value and compare it to the default value of the corresponding property in the appropriate BPM property file after upgrading. If you want to use your previous value instead of the new default, manually update that property value in the property file.

Use the following steps to determine the current values of the JVM properties, and modify those values in the BPM properties files (you can do this post-upgrade, as the installer does not remove any previously specified JVM properties during the upgrade, but the system no longer references Process Engine-related JVM properties):

Procedure

  1. Log in to ActiveMatrix Administrator.
  2. Select Infrastructure > Nodes.
  3. In the Nodes list, select BPMNode.
  4. In the lower pane, select the Configuration tab.
  5. Select the JVM Configuration link.
  6. For each Process Engine-related JVM property listed in the Properties section (with the exception of the locking properties noted above), if you have set a non-default value, update the equivalent property in the BPM properties file with that value.
    Note that some of the property names in the bx.properties and pvm.properties files don't match exactly the names used for the JVM properties. Use the following table to determine what properties are used in the bx.properties and pvm.properties files for the JVM properties that were used in your system.
    JVM Property Equivalent bx.properties and pvm.properties Property
    com.tibco.bx.allow.null.msgpart allowNullMessagePart (pvm.properties)
    com.tibco.bx.arrayDelimiter arrayDelimiter (bx.properties)
    com.tibco.bx.autoDelete autoDeleteProcesses (bx.properties)
    com.tibco.bx.autoDeleteFailedProcesses autoDeleteFailedProcesses (bx.properties)
    com.tibco.bx.bg.globalSignalProcessor.interval globalSignalProcessorInterval (pvm.properties)
    com.tibco.bx.bg.globalSignalProcessor.numMsgs globalSignalProcessorNumMessages (pvm.properties)
    com.tibco.bx.bg.requestQueueCleanup.batchCount requestQueueCleanupBatchCount (pvm.properties)
    com.tibco.bx.bg.requestQueueCleanup.batchSize requestQueueCleanupBatchSize (pvm.properties)
    com.tibco.bx.bg.requestQueueCleanup.interval requestQueueCleanupInterval (pvm.properties)
    com.tibco.bx.bg.workItemCleanup.batchCount workItemCleanupBatchCount (pvm.properties)
    com.tibco.bx.bg.workItemCleanup.batchSize workItemCleanupBatchSize (pvm.properties)
    com.tibco.bx.bg.workItemCleanup.interval workItemCleanupInterval (pvm.properties)
    com.tibco.bx.blob.compress blobCompress (pvm.properties)
    com.tibco.pvm.bx.blob.compress.bufferSize blobCompressBufferSize (pvm.properties)
    com.tibco.bx.blob.compress.threshold blobCompressThreshold (pvm.properties)
    com.tibco.bx.bpel.bg.moduleCleanup.interval bpelMaintenanceModuleCleanupInterval (pvm.properties)
    com.tibco.bx.bpel.bg.pendingMsgProcessor.interval bpelInMemoryRecoveryInterval (pvm.properties)
    com.tibco.bx.bpel.bg.pendingMsgProcessor.numMsgs bpelPendingMessageProcessorNumMessages (pvm.properties)
    com.tibco.bx.bpel.bg.unclaimedMsgProcessor.interval bpelUnclaimedPendingMsgProcessorInterval (pvm.properties)
    com.tibco.bx.bpel.bg.unclaimedMsgProcessor.numMsgs bpelUnclaimedPendingMsgProcessorNumMsgs (pvm.properties)
    com.tibco.bx.bpel.maintenance.purgeProcess.interval bpelMaintenancePurgeProcessInterval (pvm.properties)
    com.tibco.bx.engine.checkParms checkParms (bx.properties)
    com.tibco.bx.engine.clearInMemoryTrackers clearInMemoryTrackers (bx.properties)
    com.tibco.bx.engine.recovery.failure.threshold recoveryFailureThreshold (pvm.properties)
    Note: A minimum value of 120 is recommended for this property.
    com.tibco.bx.engine.threadPool.size inMemoryThreadPoolSize (pvm.properties)
    com.tibco.bx.filterByOrgs filterByOrgsError (bx.properties)
    com.tibco.bx.groupRQ.batchSize requestQueueBatchSize (pvm.properties)
    com.tibco.bx.groupRQ.fillLevel requestQueueFillLevel (pvm.properties)
    com.tibco.bx.groupRQ.idleSleep requestQueueIdleSleep (pvm.properties)
    com.tibco.bx.groupRQ.lowWaterLevel requestQueueLowLevel (pvm.properties)
    com.tibco.bx.lockOperation Still used as a JVM property
    com.tibco.bx.lockOperation.ModuleName Still used as a JVM property
    com.tibco.bx.lockOperation.ModuleName.PortType.OperationName Still used as a JVM property
    com.tibco.bx.lockPerOperation Still used as a JVM property
    com.tibco.bx.lockPerSignal Still used as a JVM property
    com.tibco.bx.lockSignal Still used as a JVM property
    com.tibco.bx.lockSignal.SignalAppName.SignalAppVersion Still used as a JVM property
    com.tibco.bx.lockSignal.SignalAppName.SignalAppVersion.signalName Still used as a JVM property
    com.tibco.bx.management.queryMaxResultSize queryMaxResultSize (bx.properties)
    com.tibco.bx.maxCancelChildrenBatchSize maxCancelChildrenBatchSize (bx.properties)
    com.tibco.bx.maxGlobalSignalListenerCount maxGlobalSignalListenerCount (bx.properties)
    com.tibco.bx.maxSubProcessCallDepth maxSubProcessCallDepth (bx.properties)
    com.tibco.bx.maxTasksPerInstance maxTasksPerInstance (bx.properties)
    com.tibco.bx.showExtendedPriorities showExtendedPriorities (bx.properties)
    com.tibco.bx.suspendOnError suspendOnError (bx.properties)
    com.tibco.pvm.deleteRequestQueueItem requestQueueCleanupInline (pvm.properties)
    com.tibco.pvm.deleteWorkItem workItemCleanupInline (pvm.properties)
    com.tibco.pvm.sequence.cacheSize.Link sequenceCacheSizeInstLink (pvm.properties)
    com.tibco.pvm.sequence.cacheSize.instProcess sequenceCacheSizeInstProcess (pvm.properties)
    com.tibco.pvm.sequence.cacheSize.instProcessIm sequenceCacheSizeInstProcessIm (pvm.properties)
    com.tibco.pvm.sequence.cacheSize.Task sequenceCacheSizeInstProcessTask (pvm.properties)
    com.tibco.pvm.txVerification.enable txVerificationEnable (pvm.properties)
    com.tibco.pvm.txVerification.retryInterval txVerificationRetryInterval (pvm.properties)
    com.tibco.pvm.txVerification.timeout txVerificationTimeout (pvm.properties)
    com.tibco.pvm.txVerification.warn txVerificationWarn (pvm.properties)

    For more information about the available properties, see "Process Instance Properties (bx.properties)" and "Process Engine Properties (pvm.properties)" in TIBCO ActiveMatrix BPM Administration.

  7. Optional: Remove the no longer needed JVM properties (except the locking-related properties), as the system no longer references them in ActiveMatrix BPM version 4.3 and later.