IBM Enterprise Records, Version 5.1.+            

Configuring Hold Sweep

Before you can run Hold Sweep, you must configure it for the appropriate values. For example, you must specify the name of the Content Engine server that contains the records, and you can limit the sweep to just one file plan object store.

Restriction: If you are going to run the IBM Enterprise Records Hold Sweep tool in the Windows operating system, in order to correctly show the information in European languages (except English), you need apply the following settings using from the Command Prompt before running the tool:
  1. Set the font property to Lucida Console.
  2. Change the code page to relative Windows ANSI code page (from 1250 to 1257). For example, if you want to show French in DOS windows, run 'chcp 1252' to change the code page to 1252 (code page 1252 is Windows ANSI code page for West European Latin). For a full list of code pages, see the link to the Code Page Identifiers table at the end of this topic.

To configure Hold Sweep:

  1. In Enterprise Manager, open the P8 domain properties page. Right click the top node and select Properties
  2. Select the Properties tab.
  3. From the Subsystem Configuration menu, select Server Cache Configuration.
  4. Select the Properties tab and change the value for the [QueryPageMaxSize] property from 1000 to 150,000.
  5. Browse to and right-click the file plan object store,and select Properties.
  6. From the Properties dialog, click the Query tab.
  7. Set the Max Query Time Limit value to 0.
  8. Save the settings and exit from Enterprise Manager.
  9. From a command prompt on the machine where you installed Hold Sweep, navigate to the RecordsManagerSweep folder.
  10. Enter one of the following:
    Option Description
    UNIX ./RecordsManagerSweep.sh -HoldSweep -configure [-profile "profile name"]
    Windows RecordsManagerSweep.bat -HoldSweep -configure [-profile "profile name"]
  11. Specify the appropriate values for the following fields. Fields with an asterisk (*) are required. (You can clear existing values by clicking Reset.)
    • At the top of the configuration console window, there is a Profile: profile name label that indicates which profile you are configuring. The default profile is Profile: RMHoldSweepConfiguration.
    • Connection: Select http or https to specify the protocol for communication with the Content Engine server. The default protocol is http. For secured communication, select https.
    • CE Server Name*: Provide the name or IP address of the Content Engine server.
    • WSI Port Number*: Provide the WSI port number used by your Content Engine server. For example, the default port number for Content Engine running under a WebLogic Application Server is 7001. For Content Engine running under a WebSphere Application Server, the default is 9080.
    • Url Path: Provide the user-defined path to the URL that the tool is configured to use to communicate with the Content Engine server. For example, /wsi is the path generally used and is the default value.
    • File Plan ObjectStore Name: Provide the GUID or Name of the file plan object store (FPOS) on which you want to run Hold Sweep. If you do not provide a value, the Hold Sweep process will run on all the file plan object stores associated with the specified Content Engine server. If the name of the object store contains extended characters, use the GUID instead of the name.
    • User ID*: Provide the user name that Hold Sweep uses to log on to Content Engine for performing calculations. The user must have object store administrative rights on the FPOS, and possess Records Administrator privileges.
    • Password*: Provide the password for the User ID.
    • FIPS 140-2 Mode: Select On or Off. When in FIPS 140-2 mode, IBM Enterprise Records uses the FIPS 140-2 approved cryptographic provider(s); IBMJCEFIPS (certificate 376) and/or IBMJSSEFIPS (certificate 409) and/or IBM Crypto for C (ICC (certificate 384) for cryptography. The certificates are listed on the NIST web site at http://csrc.nist.gov/cryptval/140-1/1401val2004.htm. If you select On and the security administrator does not configure the system for FIPS 140-2 mode, IBM Enterprise Records displays an error message. The security administrator must modify the java.security file. For details, see the task Configuring IBM Enterprise Records for FIPS 140-2 mode. IBM Enterprise Records supports FIPS 140-2 encryption only on WebSphere Application Server.
    • Hold Names/GUIDs: Provide the name or GUID of up to five holds, separated by the ‘|' character. The sweep process will use only the specified holds. If no holds are provided, then Hold Sweep processes all the active holds. If you upgraded from an earlier release where you could create more than one hold with the same name, using such a hold name will process all holds with that name. If the name of the hold contains extended characters, use the GUID instead of the name.
    • Update Batch Size: Provide the number of entities to be processed as a batch using the Hold Sweep process. By default, this value has been set to 1000. For example, if this value is 1000 and there are 20,000 entities to be processed, then Hold Sweep will process all entities in 20 batches, with 1000 entities in each batch.
    • Retrieval Batch Size: Provide the number of entities to be retrieved per batch using the Hold Sweep process. By default, this value has been set to 100000. For example, if this value is 100000 and there are 1,000,000 entities to be processed, then all the entities will be retrieved in 10 batches, with 100000 entities in each batch.
    • Thread Count: Enter the number of processing threads that IBM Enterprise Records uses during the Hold Sweep process. The best practice is to specify one thread for each logical CPU on the Content Engine server. For example, enter 8 if there are eight logical CPUs on your Content Engine server. The default is 1.
    • Log File Name: Provide the name and path of the error file to be created by the Hold Sweep process or accept the default. By default, a file called HoldSweepActivity.log is created in the ../EnterpriseRecords/RecordsManagerSweep folder. If the Hold Sweep process runs without error, the error file is zero bytes.
  12. Click Configure.


Feedback

Last updated: August 2011
configure_hold_sweep.htm

© Copyright IBM Corporation 2011.
This information center is powered by Eclipse technology. (http://www.eclipse.org)