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.
  1. 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.

  2. Start the Forums Jython script interpreter.
    1. 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.

    2. Check out the Forums configuration files by using the following command:

      ForumsConfigService.checkOutConfig("working_directory", "cell_name")

      where:
      • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you modify them.
        Note: AIX® and Linux only: The directory must grant write permissions or the command fails.
      • cell_name is the name of the WebSphere® Application Server cell that hosts the IBM® Connections applications. This argument is required. It is also case-sensitive, so type it with care. If you do not know the cell name, you can determine it by typing the following command in the wsadmin command processor:

        print AdminControl.getCell()

      For example:

      ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "ForumServerNode01Cell")

  3. 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.
  4. 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 * * * ?")
  5. 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.