Open topic with navigation

# Configure IDOL Components

To use document tracking with an SQL back end, you must use the HPE document tracking library, which is included in the IDOL Server installer. You can store this library in any accessible location, and then configure the location in IDOL Server.

You must then configure your IDOL Server components to use the SQL document tracking back end. The DIH, Content component, Connector Framework Server (CFS), and CFS Connectors support document tracking.

After configuration, an IDOL component automatically adds itself to the `Source` table on startup.

Note: If you retire an IDOL component, HPE recommends that you leave the entry in the `Source` table, because existing records might refer to the source of the retired component.

To configure IDOL Server for document tracking

1. Open the IDOL Server configuration file in a text editor.

2. If you are using DIH in a unified IDOL configuration, turn on document tracking for the DIH by setting the `DocumentTracking` parameter to `True` in the `[DistributionSettings]` section.

       [DistributionSettings]
       DocumentTracking=True

   Note: In a stand-alone DIH, set the `DocumentTracking` parameter to `True` in the `[Server]` section of the DIH configuration file.

3. Create a `[DocumentTracking]` configuration section.

4. In this `[DocumentTracking]` section, set the `Backend` parameter to `Library`.

5. Set `LibraryPath` to the absolute path to your document tracking library. In the default IDOL Server installation, the library is located in `InstallPath/IDOL/modules/`, and the library name is `dt_odbc.dll` (on Windows), or `libdt_odbc.so` (on UNIX).

6. Set `ConnectionString` to the connection string to use, with subparameters set for your setup. For example:

       ConnectionString=DSN=MyDSN

   Set the parameters consistent with your environment. On Linux, the connection string cannot contain spaces.

   On Linux, you can set the `Driver` subparameter to the path to your SQL ODBC driver shared object. HPE recommends that you use the ANSI version of libraries.

   Tip: On Linux, if you use a DSN in your connection string, and you see `File not Found` errors in your IDOL logs, try specifying the driver explicitly in the `ConnectionString` configuration parameter:

       ConnectionString=Driver=/freetds/inst/lib/libtdsodbc.so;DSN=mydsn

7. Set any other configuration parameters for document tracking. For more information, refer to the IDOL Server Reference. For example:

       [DocumentTracking]
       MaxEventsPerFile=500
       TimeoutSeconds=20
       UIDFieldName=UID

   Note: Connectors generate the document ID strings, and add them to the `UIDFieldName` field, so you must not use a field that already exists for another purpose.

8. Save and close the configuration file. Restart IDOL Server for your changes to take effect.

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close We welcome your comments! To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm