Skip to content

Cosmos.ini Settings

The cosmos.ini file contains the startup information required to launch the integration products. The Actian DataConnect installer automatically updates this file.

File Location

  • Windows: C:\ProgramData\Actian\DataConnect\actian-dc-studio-<version>\
  • Linux: /var/lib/Actian/DataConnect/actian-dc-studio-<version>

File Sections

The cosmos.ini file contains the following sections:

  • [Internal]: Profiling preferences that can be customized.
  • [UserInfo]: Information pertaining to users and their system. Some entries can be customized or added to this section.
  • [ProductInfo]: Product information that must not be changed.
  • [Preferences]: User preference information, including optional customization.

Settings Reference

The following table lists the cosmos.ini file settings.

Note

The optional settings can be included in the file based on the requirement. Do not include the settings without any value.

SectionSettingDescriptionRequired
[UserInfo]VersionRuntime Engine version installed on the system. This information is also in the license file and must not be changed.
Default value: Runtime Engine installed version.		Yes
[UserInfo]InstallPathRuntime Engine installation location.
If set, the core engine code uses InstallPath as a default Java class path if the optional ClassPath entry is not set. The GUI uses InstallPath for several functions, including locating directories off of the root.
Do not enclose the path name in quotation marks.
Default value: Runtime Engine installation location.		Yes
[UserInfo]LibraryPathPath to library files. This option is used to find configuration files, including .djx files (such as for configuring metadata browsers and validators) and encoding DLLs.
The LibraryPath option must be set and generally has the same value as InstallPath.
Do not enclose the path name in quotation marks.
Default value: Runtime Engine installation location.		Yes
[UserInfo]LicenseFileComplete license file path including license file name. If this entry is not set, the GUI products prompt you to locate the file so that its path can be written to cosmos.ini.
Default value: License file path.		Yes
[UserInfo]ProfileEngineJvmArgsDefault JVM arguments can be overridden using ProfileEngineJvmArgs property in cosmos.ini.
Default arguments used are -XX:+UseG1GC -Xmx2G.
Heap size can be increased by changing the Xmx option, for example -Xmx4G. Users can also choose a different GC algorithm like -XX:+UseParallelGC.		No
[UserInfo]unloadmapsandprocessesAdd this parameter and set its value to 1 (ON) to unload maps and sub-processes during execution. Set to 0 (OFF) to not unload maps and sub-processes during execution.
This setting is only relevant when Use UnloadMapsAndProcesses setting from Cosmos.ini is selected for the Force Unload Maps and Processes (v10 Process Execution Only) property in Options > Preferences > DataConnect > Execution > Message and Logging Defaults.
For information, see Setting Logging Preferences.
Note: Map Designer and Process Designer are not available in DataConnect v14.0. These features will be available in future releases. However, the standalone Runtime Engine continues to support maps and processes from previous DataConnect versions via the command line interface.		Yes*
[UserInfo]NetworkTimeoutIndicates the number of seconds the integration products wait for various network operations to complete, such as establishing connections and receiving packets.
Default value: 5		No
[UserInfo]ConnectionPathPath to the connections directory. Do not change this setting.
Set this option if you want to override the connection file location.
Default value: Location of the connections directory.		No
[UserInfo]SourceConnectionPathAllows overriding the source connections location.No
[UserInfo]TargetConnectionPathAllows overriding the target connections location.No
[UserInfo]FactoryConnectionListAllows specifying the location of the factory-provided connection files.No
[ProductInfo]ProdTitleShortShort name for the installed product.
Do not change this setting.		Yes
[Preferences]PluginsLocation containing plug-ins (components).
Do not change this setting.		Yes
[Preferences]DMSConnectorsLocation containing DMS connectors. There is no space in the property name.
Do not change this setting.		Yes
[Preferences]SingleRecordSchemaCheckAdd this parameter and set its value to 1 (ON) to catch any schema mismatches when there is only one record type. Set to 0 (OFF) if the connector is being used with multiple record types.
This setting only applies to the ASCII (Delimited) and Unicode (Delimited) connectors, when the user has not created record recognition rules.		No
[Internal]HTTPPutMethodUsed to set the method of writing to a URL as a file.
Default value: POST or PUT		No
[Internal]HTTPMimeTypeMIME type used when writing to a URL.
Default value: xml		No
[Internal]ProfileTurns EZscript profiling on or off.
• 0: Off (default)
• 1: On		No
[Internal]ProfileOutputIf set, the profile information is written to this file.
Default value: djprof.out		No