8.3 Relocating the Event Cache File

Every driver that is configured in Identity Manager has an associated event cache file. Events are cached in a TAO file before a driver processes them. By default, the TAO files are placed in the dib directory.

Identity Manager allows you to place the TAO files anywhere in the file system. Distributing the file I/O across multiple file systems improves the I/O throughput. Each driver can have an optional single-valued server readable attribute DirXML-CacheLocation. The value of this attribute is an absolute path to the TAO files in the file system. When the engine is restarted, it looks for the DirXML-CacheLocation attribute and the associated TAO files.

You can change the location of the TAO file by using the dxcmd utility:

Run dxcmd > login > Driver Operations > (Select the Driver) > 14. Cache Operations > 10. Get Cache Path/11. Set Cache Path

NOTE:You can change the location of the cache file only when the driver is in a disabled state, otherwise it throws an INVALID_REQUEST exception. If the path does not exist, it throws a BAD_FILE_NAME exception.

To relocate the TAO file:

  1. Shut down the driver on which you want to set a new TAO file location.

  2. Take note of the system time.

    You might need this data to force resynchronization of objects if any events are missed during the TAO file relocation.

  3. Move the driver's TAO file to the new location and disable the driver.

  4. Set the new TAO file location by using the dxcmd utility.

  5. Enable the driver by deselecting the Do not automatically synchronize option.

  6. Start the driver.

  7. Use the Synchronize option to force resynchronization of objects from the time noted in Step 2.