Purging forum trash on a schedule
Configure the schedule for purging Forums trash.
Before you begin
To run administrative commands, you must use the wsadmin client. For more information, see Starting the wsadmin client.
About this task
Edit settings in the forum-config.xml file to configure the Forums trash purge schedule. You can define the interval at which the task runs by configuring the interval property, which uses a Cron schedule.
The trash purge job is scheduled to run periodically to permanently remove content that is deleted from a forum from the trash. The Forums application uses the WebSphere® Application Server scheduling service for purging trash from Forums. For more information about the scheduler, see Scheduling tasks.Procedure
To configure the TrashAutoPurgeJob task, complete the
following steps.
- Start the wsadmin client from the following
directory on the system where you installed the Deployment Manager:
where dm_profile_root is the Deployment Manager profile directory, typically dmgr01.app_server_root/profiles/dm_profile_root/bin
You must start the client from this directory or else subsequent commands that you enter might fail.
- Start the Forums Jython script interpreter.
- To view the current configuration settings, use the following
command:
ForumsConfigService.showConfig()
Note: After you update configuration settings, you can use this command again to display your updates. - To change configuration settings for Forums, use the following
command:
ForumsConfigService.updateConfig("property", "value")
where:- property is one of the editable Forums configuration properties.
- value is the new value that you want to specify for the property.
Table 1. TrashAutoPurgeJob properties Property Description task.TrashAutoPurgeJob.enabled Enables or disables the forum purge trash task. This property accepts the following values: true or false.
For example:ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.enabled", "true")
task.TrashAutoPurgeJob.trashRetentionInDays Specifies the number of days that deleted content remains in the database. The value must be set to 1 or greater. If the value is less than 1, the trash is not purged by this job. The default value is 90. For example:ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.trashRetentionInDays", "120")
task.TrashAutoPurgeJob.interval Specifies the interval at which the purge trash task runs. When you change the interval property, the new schedule is registered the next time that Forums is started.
For example:ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.interval", "0 0/15 * * * ?")
- Check the configuration files back in during the same wsadmin session in which you checked them out. For information about how to save and apply your changes, see Applying property changes in Forums.