Accessing the News configuration fileAdded by IBM on February 2, 2011 | Version 1 (Original)
|To make configuration changes to the News component in IBM® Lotus® Connections, you must first access the News configuration file.
To make configuration changes to the News component in IBM® Lotus® Connections, you must first access the News configuration file.
Before you begin
To access configuration files, you must use the wsadmin client. See Starting the wsadmin client
for information about how to start the wsadmin command-line tool.
To change News configuration settings, complete the following steps.
- Start the wsadmin client from the following directory of the system on which you installed the deployment manager:
You must start the client from this directory or subsequent commands that you enter do not execute correctly.
- Start the News Jython script interpreter.
- Use the following command to access the News configuration file:
If you are asked to select a server, you can select any server.
- Check out the News cell-level configuration file using the following command:
- <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:
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
|databaseCleanup storyLifetimeInDays||Specifies the interval at which news stories are deleted from the News repository. For more information, see Configuring database clean-up for the News repository.|
|dataSynchronization frequencyInHours||Specifies the interval at which data is synchronized between the News repository and the Lotus Connections application databases. For more information, see Synchronizing 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 Configuring database clean-up for the News repository.
The following parameters are also present in the news-config.xml
file, but their default settings must not be changed.
Table 2. Additional parameters
|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 Lotus Connections users with the most relevant news. The emails are sent instantly when they are posted as notifications in Lotus 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 Applying property changes in the News repository for details.
Parent topic: Administering the News repository
Configuring database clean-up for the News repository
Synchronizing News data with other applications
Lotus Connections configuration property values
Reallocating and load balancing users according to mail domain