Running Connector
To start the connector, run the abbyy.timeline.dbms.client.jar file in the <Installation folder> using the command line parameters described below.
Where <Installation folder> is the folder where the ZIP archive with the connector files had been extracted.
- For connecting to the Microsoft SQL Server or PostgreSQL execute:
java -Dlog4j2.formatMsgNoLookups=true -jar abbyy.timeline.dbms.client.jar –ServerUrl <Server Url> --Token <Token> --AcceptEula - For connecting to the Apache Hive execute:
java -Dlog4j2.formatMsgNoLookups=true -cp "*" abbyy.timeline.dbms.client.Program –ServerUrl <Server Url> --Token <Token> --DriverClassName <ClassName> --AcceptEula
Note. JDBC driver must be in the folder next to the connector.
Where:
- -Dlog4j2.formatMsgNoLookups=true - Option to prevent exposure to the CVE-2021-44228 vulnerability.
Important. Add this option if you are using Apache Hive driver that bundles Log4j as a logging provider. The JVM flag -Dlog4j2.formatMsgNoLookups=true fixes the vulnerability. It has been implemented in log4j in the 2.10.0 version and later. If your Hive driver bundles a log4j version older than 2.10.0, please update the driver. - Server URL - URL to the ABBYY Timeline server.
Important. The forward slash character '/' cannot be used at the end of Server URL. For example, https://my.timelinepi.com - Token - Token from configuration page you obtained in step 5 'Configuring ABBYY Timeline Repository' section.
- DriverClassName - Class name for external JDBC driver. That parameter is required for example for Hortonworks Data Platform 2.6.5.
- AcceptEula - The End-User License Agreement (EULA) must be accepted before the connector starts. You can find the EULA in the connector’s folder: ./EULA.pdf.
Note. When loading large tables, the connector sends data to ABBYY Timeline in parts of 10,000 rows each. After all the parts are fully uploaded, the data is displayed in the ABBYY Timeline repository table.
22.09.2023 8:59:47