Query Manipulation Server 25.4
Query Manipulation Server Help

# The QMS Configuration File

QMS is configured by editing its configuration file. This is in the same directory as the QMS executable, and by default is named `qms.cfg`. You can edit the configuration file with a text editor.

The configuration file contains settings that determine the basic details that the QMS needs to run. It includes location and port details for QMS, logging details, and details of the servers that QMS connects to. For information about the configuration parameters, refer to the QMS Reference.

The QMS configuration file is divided into several sections, which represent different features that you can configure.

## [AuthorizationRoles] Section

The `[AuthorizationRoles]` defines roles that enable a particular set of actions for particular clients, SSL identities, and GSS principals. You must create a subsection for each authorization role that you define in the `[AuthorizationRoles]` configuration section.

For example:

    [AuthorizationRoles]
    0=AdminRole
    1=UserRole

    [AdminRole]
    StandardRoles=Admin,Index,ServiceControl
    Clients=localhost
    SSLIdentities=admin.example.com

    [UserRole]
    StandardRoles=Query,ServiceStatus
    SSLIdentities=admin.example.com,userserver.example.com

## [IDOL] Section

The `[IDOL]` configuration section contains settings that allow QMS to contact the DAH, Proxy component, or Content component that contains the data index. For example:

    [IDOL]
    Host=localhost
    Port=9100

## [LanguageTypes] Section

The `[LanguageTypes]` configuration section determines the language processing settings that QMS uses.

QMS retrieves most language settings from the Content component.

To use the `OutputEncoding` parameter in your query actions, you must set LanguageDirectory. OpenText generally recommends that you do not override other language settings in QMS, to ensure that your components use the same language model.

If you do need to change the other language settings in QMS, you can set any parameters in the QMS configuration file that are available in the Content component `[LanguageTypes]` configuration. For more information, refer to the Content Component Help.

    [LanguageTypes]
    LanguageDirectory=../common/langfiles

## [Logging] Section

The `[Logging]` section lists the log streams that you set up to create separate log files for different log message types (action and application). It also contains a subsection for each of the listed log streams, in which you configure the settings that determine how to log each stream. For example:

    [Logging]
    LogDirectory=./logs
    LogTime=True
    LogEcho=True
    LogLevel=normal
    LogMaxSizeKBs=1024
    LogExpireAction=compress

    0=ACTION_LOG_STREAM
    1=APP_LOG_STREAM

    [ACTION_LOG_STREAM]
    LogFile=action.log
    LogTypeCSVs=query

    [APP_LOG_STREAM]
    LogFile=application.log
    LogTypeCSVs=application

## [PromotionAgentStore] Section

The `[PromotionAgentStore]` configuration section contains settings that allow QMS to contact the Promotion Agentstore component. For example:

    [PromotionAgentStore]
    Host=localhost
    Port=20050

## [Server] Section

The `[Server]` configuration section contains general settings for QMS. For example:

    [Server]
    Port=16000
    DefaultLanguage=ENGLISH
    DefaultLanguageType=GenericUTF8
    AllowedQueryParameters=Text,MatchResults
    EngineTimeout=180
    MaxResultsLimit=5000

NOTE: QMS obtains language settings from the Content component on startup. However, if this is not possible because of the security settings of your Content ACI port, or if you want to use sentence breaking libraries for query text processing, you can use the DefaultLanguageType parameter in the `[Server]` section of the QMS configuration file to set the default language type from within QMS itself. For more information, refer to the Query Manipulation Server Reference.

You can also list the languages that you use and define some generic parameters in the `[LanguageTypes]` section in the QMS configuration file. For more information on how to configure language types, refer to the Content Component Help.

## [Service] Section

The `[Service]` configuration section contains settings that determine which machines can use and control the QMS service. For example:

    [Service]
    ServicePort=16002

## [SSLOptionN] Section

The `[SSLOptionN]` configuration section contains settings that allow QMS to receive SSL connections from clients. For example:

    [Server]
    SSLConfig=SSLOptions1
    ...

    [SSLOptions1] //SSL options for incoming connections
    SSLMethod=TLSV1.2
    SSLCertificate=host1.crt
    SSLPrivateKey=host1.key
    SSLCACertificate=trusted.crt

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

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 Query Manipulation Server 25.4

Topic Title: The QMS Configuration File