Reallocating and load balancing users according to mail domain

Use the NewsEmailDigestService.loadBalanceEmailDigest() command to manually reallocate and load balance users in the different email tranches (or groups of email addresses) used by the email digest.

Before you begin

To run administrative commands, you must use the wsadmin client. See Starting the wsadmin client for details.

About this task

A scheduled task runs every month to load balance the users in the email address groups used by the email digest. This task ensures that users are spread across the groups in a uniform way according to their mail domain. The task is configured in the news-config.xml file and looks as follows. Note that the default settings should not be modified.
<task serverName="unsupported" 
   startby="" 
   mbeanMethodName="" 
   targetName="ScheduledTaskService" 
   type="internal" 
   scope="cluster" 
   enabled="true" 
   interval="0 0 22 1 * ?" 
   description="Job to spread users in tranche" 
   name="PersonSpreadTranche"  > 
</task>
By default, the task runs on the first day of every month at 10:00 p.m. If you do not want to wait for the next scheduled task, you can run the task manually using the NewsEmailDigestService.loadBalanceEmailDigest() MBean command.

Procedure

To reallocate and load balance users in the existing email address groups used by the email digest, complete the following steps.
  1. Start the wsadmin client from the following directory of the system on which you installed the Deployment Manager:
    app_server_root\profiles\dm_profile_root\bin
    where app_server_root is the WebSphere® Application Server installation directory and dm_profile_root is the Deployment Manager profile directory, typically dmgr01.

    You must start the client from this directory or subsequent commands that you enter do not execute correctly.

  2. Start the Jython script interpreter for the News repository.
    1. Use the following command to access the News configuration file:
      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, you must pick the node where the file is stored.
  3. Enter the following command:
    NewsEmailDigestService.loadBalanceEmailDigest()

    Reallocates and load balances the users in the email address groups used by the email digest according to mail domain. This command does not take any parameters.

    The command returns the number of users who have been reallocated to different email address groups for load balancing purposes.

    For example:
    wsadmin> NewsEmailDigestService.loadBalanceEmailDigest()
    1603