Purging forum trash on a schedule 

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.


Before starting

To edit configuration files, use the IBM WAS wsadmin client. See Starting the wsadmin client for details.


About this task

The trash purge job is scheduled to run periodically to permanently remove content deleted from a forum from the trash. Forums uses the WAS scheduling service for purging trash from Forums. For more information about the scheduler, see Scheduling tasks.


Procedure

To configure the TrashAutoPurgeJob task...

  1. From the dmgr host:

      cd $DMGR_PROFILE/bin
      ./wsadmin.sh -jython
      execfile("forumsAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

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

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

      where:

      • <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          Note: AIX and Linux only: The directory must grant write permissions or the command will not run successfully.

      • <cell_name> is the name of the WAS cell hosting the IBM Connections application. 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")

  • To view the current configuration settings, use the following command:

      ForumsConfigService.showConfig()

      Note: After updating any of the configuration settings, you can use this command again to display your updates.

  • To change display 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 with which you want to set that property.

      The following table displays information about the TrashAutoPurgeJob property and the type of data that you can enter for it.

      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 is left in the database as being soft-deleted. 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 forum purge trash task runs.

      When you change the interval property, the new schedule is registered the next time that Forums is started on any server in the Forums cluster (if there is one).

      For example: 

        ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.interval", "0 0/15 * * * ?")


  • After making changes, check the configuration files back in, and do so during the same wsadmin session in which you checked them out for the changes to take effect. See Apply property changes in Forums for information about how to save and apply your changes.


    Parent topic

    Manage forum trash

    Related concepts
    Scheduling tasks


    Related tasks


    Manage Forums scheduled tasks
    Apply property changes in Forums
    Moving forums to the trash
    Delete topics from forums

    Related reference
    SearchService commands


       

     

    });

    +

    Search Tips   |   Advanced Search