Appendix A: Configuration files - Appendix A: Configuration files - Perceptive Content - iConvert for Perceptive Content Product Guide - Perceptive-Content/iConvert-for-Perceptive-Content-Product-Guide/Foundation-26.1/iConvert-for-Perceptive-Content-Product-Guide/Appendix-A-Configuration-files - Foundation 26.1 - Foundation 26.1

iConvert for Perceptive Content Product Guide

Platform
Perceptive Content
Product
iConvert for Perceptive Content Product Guide
Release
Foundation 26.1
License
ft:lastPublication
2026-04-16T22:10:40.294616
ft:locale
en-US

inserverConvert.ini

The following table provides definitions and sample data for the settings in the inserverConvert.ini configuration file. This table displays the INI settings under group headings in brackets, for example, [General]; in the order the groups appear in the INI file. Each setting offers two or more options, which are defined in the table below along with a description of each setting and its options. Use this table as a guide when customizing the file.

Section Setting Options Description
General num.workers Any positive integer

Specifies the number of worker threads in the main pool.

The default is 15.

General throttle.threshold Any positive integer

Specifies the maximum number of inserts iConvert allows before committing the open transaction.

The default is 1000.

General retry.attempts Any positive integer

Specifies the number of times iConvert attempts the insert.

The default is 3.

Logging debug.level.file 0 through 6

Specifies the level iConvert uses to log errors for troubleshooting.

0 = Logging is off.

1 = The least verbose logging.

6 = The most verbose logging.

The default is 0.

Logging socket.level.file 0, 1

Specifies whether to log communication between Perceptive Content Server and iConvert.

1 = iConvert logs communication.

0 = iConvert does not log communication.

The default is 0.

Logging status.log.interval  

Specifies how often, in seconds, iConvert refreshes the ConvertResult.html log file.

The default is 10.

ODBC src.dbms SQLServer, Oracle, PostgreSQL Specifies the source DBMS the customer is converting from.
ODBC src.dsn Any valid database name Specifies the source database name.
ODBC src.user.id Any valid user ID Specifies the user ID for the source ODBC connection.
ODBC src.user.password A valid password

Specifies the password that is consumed by the application for encryption in the src.user.password.encrypted setting. This value is encrypted and removed from the setting after running the insererConvert -encrypt-config command.

The default is imagenow.

ODBC src.user.password.encrypted   Specifies the encrypted password for the source database that is maintained by the application.
ODBC dest.dbms SQLServer, SQLServerUnicode, Oracle, PostgreSQL Specifies the destination DBMS to which the customer is converting.
ODBC dest.dsn Any valid database name Specifies the destination database name.
ODBC dest.user.id Any valid user ID Specifies the user ID for the destination ODBC connection.
ODBC dest.user.password A valid password

Specifies the password that is consumed by the application for encryption in the dest.user.password.encrypted setting. This value is encrypted and removed from the setting after running the inserverConvert -encrypt-config command.

The default is imagenow.

ODBC dest.user.password.encrypted   Specifies the encrypted password for the destination database that is maintained by the application.
Email smtp.server.url Any valid SMTP server URL

Specifies the URL of the SMTP server with which the system communicates.

Examples

smtp://<hostname>:<port> for plaintext communication

smtps://<hostname>:<port> for using SMTP with implicit TLS.

Email smtp.validate.certificates  

Specifies if the system should validate certificates when communicating to the SMTP server.

The default is TRUE.

Email smtp.user.starttls  

Specifies if the system should use STARTTLS when communicating with the SMTP server.

The default is FALSE.

Email smtp.username   Specifies the username the system uses for authenticating to the SMTP server if basic authentication is enabled.
Email smtp.password   Specifies the password the system uses for authenticating to the SMTP server if basic authentication is enabled.
Email smtp.server   Specifies the SMTP server iConvert uses to email convertresult.htm.
Note: This setting is deprecated in favor of smtp.server.url.
Email smtp.port Any existing port number Specifies the port number of the SMTP server.
Note: This setting is deprecated in favor of smtp.server.url.
Email email.to Any email address Specifies the email address to which iConvert sends emails containing the convertresult.htm log file.
Email email.from Any email address Specifies the email address from which iConvert sends emails containing the convertresult.htm log file.