Knowledge Discovery 26.3
Getting Started Guide

# Start Components from the Command Line

You can start Knowledge Discovery components from the command line. This advanced functionality allows you to adjust certain parts of the component configuration when you start up. You might want to use this method to install components as Windows services, or to start a component with a configuration file that is in a different directory or has a different name.

NOTE: On UNIX platforms, if you start components from the command line (rather than using the init script), you might need to set the `LD_LIBRARY_PATH` to include the `InstallDir/common` and `InstallDir/common/runtimes` directories, to ensure that the component can access the installed shared libraries.

You can also copy the shared libraries to the component working directory.

This section describes the command line arguments available to specify the component configuration files and ports, and arguments that are available for specific components to specify dependencies.

All command line arguments are optional. By default, the component attempts to read a configuration file in the same directory, and with the same name as the executable file (for example `content.exe` and `content.cfg`). The components attempt to read all the other values from the configuration file.

The following command line arguments are accepted by all the text processing components (Content, Category, Community, DAH, DIH, Proxy, and View).

Argument | Description | Type
--- | --- | ---
`-aciport` | The port to use to receive ACI actions. | Number
`-configfile` | The path to the configuration file to use. | FilePath
`-getconfig` | Displays the configuration that the component uses, including the expanded versions of any included configurations (see Include an External Configuration File). When you use this option, the component prints the configuration and then exits. | None
`-idolcomponent` | Specifies that the component runs under the control of a Proxy component. | None
`-install` | Installs the component as a Windows service. See Install a Component as a Service on Windows. | None
`-revokelicense` | Revokes the component license from the License Server. | None
`-serviceport` | The port to use to receive Service actions. | Number
`-uninstall` | Uninstalls the component Windows service. See Install a Component as a Service on Windows. | None
`-version` | Displays the version and build information for the component. When you use this option, the component prints the version and then exits. | None

The following command line arguments are accepted by the specified components.

Argument | Description | Type | Components
--- | --- | --- | ---
`-agentstoreport` | The ACI port to use to contact the Agent index (Agentstore component). | Number | Category, Community
`-communityhost` | The host name or IP address of the Community component. | Hostname | Category
`-communityport` | The ACI port to use to contact the Community component. | Number | Category
`-contentport` | The ACI port to use to contact the Content component. | Number | View
`-datahost` | The host name or IP address of the Data index (Content componentt). | Hostname | Category, Community
`-dataport` | The ACI port to use to contact the Data index (Content component). | Number | Category, Community
`-indexport` | The port to use to receive Index actions. | Number | Content, DIH, Proxy

The following example starts the Community component as a child component of an Proxy component. It specifies the ports to use, and the host and port for the Agent and Data indexes:

    Community.exe -idolcomponent -configfile C:\OpenText\KnowledgeDiscovery\Community.cfg -aciport 9030 -serviceport 9032 -datahost localhost -dataport 9010  -agentstoreport 9050

Copyright 2026 Open Text
Version 26.3 | Last updated July 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery 26.3

Topic Title: Start Components from the Command Line