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:
app_server_root/profiles/dm_profile_root/bin
where
dm_profile_root is
the Deployment Manager profile directory, typically dmgr01.
You
must start the client from this directory or else subsequent commands
that you enter might fail.
- Start the Forums Jython script interpreter.
- Use the following command
to access the Forums configuration file:
execfile("forumsAdmin.py")
If you are prompted to specify
a service to connect to, enter 1 to select
the first node in the list. Most commands can run on any node. If
the command specifies a file by using a local file path, select the
node where the file is stored.
- Check out the Forums configuration
files by using the following command:
ForumsConfigService.checkOutConfig("working_directory",
"cell_name")
ForumsConfigService.checkOutConfig("/opt/my_temp_dir",
"ForumServerNode01Cell")
- 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.
The following table displays information about the TrashAutoPurgeJob
property and the type of data that you can specify.
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.