Starting External Purge for an IIM installation

You can start an external purge by running a command for installation using IBM Installation Manager.


  1. If you have a cluster installation, make sure that you are not running External Purge on another node of the cluster. If you are running External Purge on more than one node, it will cause database locks. For more information, see Monitoring External Purge for an IIM installation.
    Note: In a cluster environment, set the jdbc.document_dir property to the same folder on each node. For nodes on different servers, set the document_dir property to a folder that each node has access to.
    Important: It is the customer's responsibility to keep exactly one of these external purge processes running in the cluster. If you need to shut down the hardware that is running External Purge, you must run it on a different node.
  2. Disable the default Purge service. Click Deployment > Schedules, search for PurgeService, and then clear the Enabled checkbox for PurgeService.
    Note: If you have customized the Schedule_PurgeService business process, you need to add your customized code to the new Schedule_PurgeService business process. The new Schedule_PurgeService business process includes a warning message about running External Purge while the scheduled new purge is enabled.
  3. Turn off the "Important Schedules are Disabled" email notifications by adding the following line to the file. This removes the Purge Service SQL query for the schedule.

    resourceMonitor.ScheduleMonitor.propertyValue.1=SELECT STATUS, SERVICENAME FROM SCHEDULE WHERE SERVICENAME IN ('BackupService','IndexBusinessProcessService','AssociateBPsToDocs'


  4. Do one of the following:
    • In Windows, do one of the following:
      • Run the command startExternalPurgeWindowsService.cmd from the INSTALL_DIR\bin directory.
      • Run the Windows service. Click Control Panel > Administrative Tools > Services, right-click IBM Sterling B2B Integrator External Purge at BASE_PORT, and click Start.
    • In UNIX, run the command start from the INSTALL_DIR/bin directory.