Cleaning up the Audit Trail Database

The audit trail database stores all process information on every piece of work that has been performed via the Stardust Process Engine. It also stores the model information, on the base of which processes are instantiated and their activities performed.

The administrator has full control over the database, so that both, the audit trail and the model information, can be deleted. This should never be done after the model has gone into production! Deleting the audit trail means deleting all the log entries defined in the Stardust runtime environment.

Invoking the Clean up Operation

To clean up the audit trail, you can use one of the options in the Administrative Actions section of the Administration perspective launch panel.

Cleaning up the Audit Trail Database

Choose Cleanup Audit Trail Database.

Cleanup Audit Trail Database
Figure: Cleanup Audit Trail Database

Note that you need to close all open views before proceeding for audit trail database cleanup operation. If any views are open an error is displayed.


Figure: Error - Close all Open Views

Once you closed all the open views, click Cleanup Audit Trail Database link. A dialog to confirm the deletion get displayed.
 


Figure: Performing a Cleanup of the Audit Trail Database

The Retain Users and Departments option gives choice to keep the users and their departments. Deselecting the Retain Users and Departments checkbox would delete all the users and departments from audit trail.

After the completion of cleanup operation, you are logged out of the Stardust Portal.

Cleaning up the Audit Trail and Model Database

To clean up the audit trail and the model database, choose Cleanup Audit Trail And Model Database.

Cleanup Audit Trail and Model Database
Figure: Cleanup Audit Trail and Model Database

Note that you need to close all open views before proceeding for audit trail and model database cleanup operation. If any views are open an error is displayed.


Figure: Performing a Cleanup of the Audit Trail and Model Database

After the completion of cleanup operation, you are logged out of the Stardust Portal.

Configuration recommended for Cleanup Operations

The cleanup of an audit trail database may take some time and requires a significant amount of rollback space in the database. In case the data should be cleaned up in your environment, it is recommended to perform this cleanup via the command line by creating a new schema and performing a new deployment of the model as this is the simplest and quickest way. Please refer to the chapter The Sysconsole Command of the Stardust Online Documentation - Operation Guide The Sysconsole Command for detailed information on the appropriate commands provided by Stardust.

Should the cleanup be performed in the Administration Perspective, please take care of the right settings for the transactions. Please note that in that case the settings remain for the whole productive operation on the application server and the database. The transaction time (for the database or the application server) should be increased for the operation. Inside the database there could exist limits as well. Here the number of objects to be deleted could be set as a limitation for the cleanup command. Please find the according hints for these settings in the documentation of the specific database you are using.