Changing Forums configuration property values

Configuration settings control how and when various Forums operations take place.

Before you begin

To run administrative commands, you must use the wsadmin client. For more information, see Starting the wsadmin client.

About this task

Configure Forums by using Jython scripts that are accessed by the wsadmin client. These scripts use the AdminConfig object in the wsadmin client to interact with the Forums configuration file. After you change Forums configuration settings, you must synchronize the nodes and restart the Forums application server.

Procedure

To change Forums configuration settings, 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 HCL 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. Optional: To view a list of the valid Forums configuration settings and their current values, use the following command:

    ForumsConfigService.showConfig()

  4. To change a Forums configuration setting, use the following command:

    ForumsConfigService.updateConfig("property", "value")

    where property is one of the editable Forums configuration properties and value is the new value of the property. For a complete list of editable properties, see Forums configuration properties.

    For example:

    ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.trashRetentionInDays", "120")

  5. Optional: After you update the Forums properties with new values, use the ForumsConfigService.showConfig() command to display the list of properties and their updated values.
  6. Optional: Repeat step 3 for each property that you want to change.

What to do next

Check in the configuration files during the same wsadmin session in which they were checked out. For more information, see Applying property changes.