Access the News configuration file 

To make configuration changes to the News component in IBM Connections, first access the News configuration file.


Before starting

To access configuration files, use the wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin command-line tool.


Procedure

To change News configuration settings...

  1. From the dmgr host:

      cd $DMGR_PROFILE/bin
      ./wsadmin.sh -jython
      execfile("newsAdmin.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 News cell-level configuration file using the following command:

      NewsCellConfig.checkOutConfig("<working_dir>", "<cellName>")

      where:

      • <working_dir> is the temporary directory to which you want to check out the cell-level configuration file. This directory must exist on the server where you are running wsadmin.

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

      • <cellName> is the name of the cell that the home page node belongs to. This argument is required. It is also case-sensitive, so type it with care. If you do not know the cell name, type the following command in the wsadmin command processor to determine it:

          print AdminControl.getCell()

      For example:

      NewsCellConfig.checkOutConfig("d:/temp", "NewsServerNode01Cell")

      The command displays this message:

      News Cell Level configuration file successfully checked out.

  • Navigate to the temporary directory in which you saved the news-config.xml file, and then open the file in a text editor and update the following parameters as required.

      Table 1. News configuration parameters
      Parameter Description
      databaseCleanup storyLifetimeInDays Specifies the interval at which news stories are deleted from the News repository. For more information, see Configure database clean-up for the News repository.
      dataSynchronization frequencyInHours Specifies the interval at which data is synchronized between the News repository and the IBM Connections application databases. For more information, see Synchronize News data with other applications.
      NewsDataCleanup task Defines the interval at which the databaseCleanup task runs. There is also a configuration parameter to enable or disable this task from running.

      Do not disable this setting. If you disable it, you run the risk of rapidly reaching your file system storage limit as the database increases in size. Disabling this setting can also result in poor data access performance.
      For more information about this task, see Configure database clean-up for the News repository.

      Note: The following parameters are also present in the news-config.xml file, but their default settings must not be changed.

      Table 2. Additional parameters

      Parameter Description
      EmailDigestDelivery A batch job that runs each hour to collect and post the news as daily and weekly emails. This setting must not be changed.

      Depending on their email notification settings, a daily or weekly email digest is posted to IBM Connections users with the most relevant news. The emails are sent instantly when they are posted as notifications in IBM Connections.

      MetricsCollector Used to update the statistics and metrics that are displayed for the Home page and News applications. The metrics collector is a batch process that runs every night.
      NewsCheckUpdatedPersons Used internally to discover how often a person status changes in the system, for example, when a user is marked as active or inactive.
      PersonSpreadTranche A scheduled task that load balances the users in the existing tranches that are used by the email digest so that users are spread in a uniform way according to their mail domain.

      You can run this task manually using the NewsEmailDigestService.loadBalanceEmailDigest() command. For more information, see Reallocating and load balancing users according to mail domain.


  • You must check the configuration file back in after making changes, and it must be checked in during the same wsadmin session in which it was checked out for the changes to take effect. See Apply property changes in the News repository for details.


    Parent topic

    Administer the News repository


    Related tasks


    Configure database clean-up for the News repository
    Synchronize News data with other applications
    IBM Connections configuration property values
    Reallocating and load balancing users according to mail domain

    +

    Search Tips   |   Advanced Search