To use document tracking with an SQL back end, you must use the HPE document tracking library, which is included in the HPE IDOL Server installer. You can store this library in any accessible location, and then configure the location in HPE IDOL Server.
You must then configure your HPE 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.
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.
Open the HPE IDOL Server configuration file in a text editor.
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
In a stand-alone DIH, set the DocumentTracking
parameter to True
in the [Server]
section of the DIH configuration file.
Create a [DocumentTracking]
configuration section.
In this [DocumentTracking]
section, set the Backend
parameter to Library
.
Set LibraryPath
to the absolute path to your document tracking library. In the default HPE 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).
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.
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
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
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.
Save and close the configuration file. Restart HPE IDOL Server for your changes to take effect.
|