How to create a new ActiveMQ KahaDB for use with AFX in RSA Identity Governance & Lifecycle

RSA Product Set: RSA Identity Governance & Lifecycle
RSA Version/Condition: 7.0.x, 7.1.x, 7.2.x

KahaDB is a file-based persistence database used by ActiveMQ. There may be times when the ActiveMQ KahaDB database used by AFX is corrupt and needs to be recreated. Symptoms include:

• AFX connectors remain in a Deployed state.
• ActiveMQ will not start.
• Error messages referencing kahadb are in the activemq.log file.

We have seen the KahaDB database become corrupted when the system on which the AFX server is running, runs out of disk space. This RSA Knowledge Base Article explains how to create a new KahaDB database to replace the corrupted database.
 

Perform the following task when there are no AFX transactions actively being processed as removing the messaging queue (KahaDB persistent database) will purge any pending items. To ensure there are no active AFX transactions being processed, the first step is to shut down AFX.

1. Login as the afx user.
2. Stop AFX.
3. Navigate to the directory where the ActiveMQ KahaDB database exists.
4. Remove the existing KahaDB database.
5. Restart AFX. This will create a new KahaDB database.

afx stop
cd $AFX_HOME/activemq/data
mv kahadb kahadb.old
afx start