Parameters
Parameter |
Required / Optional |
Description |
---|---|---|
Instance!Number | Required |
Numeric ID from 1 to 99 for KCM instance to be started.
For Docker deployment, it is always set to 1.
|
Instance!DatabaseType | Optional | The type of the database to be used by the KCM Repository of the instance. Specify SQLServer or Oracle. |
Instance!DatabaseMode | Optional |
Allowed values:
If omitted, defaults to Check. |
Instance!DatabaseConnectionString | Optional |
The ODBC connection string to be used by the KCM Repository server to connect to the database. Make sure that the database exists on the database server and is empty. Do not specify user name or password in this connection string. The database user account is configured using
the specific parameters described below.
For SQL Server database, consider the following:
|
Instance!DatabaseUser |
Optional:
|
The database user account that KCM Repository server will use to connect to the database. Required to connect to Oracle database or to SQL Server database using SQL Server authentication. Make sure the account has the required roles and privileges, as described in the KCM Repository database section of this guide. |
Instance!DatabasePassword | Optional.
Required for Oracle database user and for SQL Server connection using SQL Server authentication. |
The database password that
KCM Repository
server will use to connect to its database.
The password cannot contain double quotes.
|
Instance!LicenseFile | Optional. Mutually exclusive with Instance!LicenseServerUrl. |
The location of the .xml file with the license information. |
Instance!LicenseServerUrl | Optional. Mutually exclusive with Instance!LicenseFile. |
The URL to the KTA license server API, for example, https://<machine name>/TotalAgility/Services/Sdk/LicenseClient. |
Instance!LicenseServerApiKey | Optional. Required when Instance!LicenseServerUrl has a value. |
The API key for the license server access. |
Instance!LicenseServerIgnoreCertificate | Optional. Defaults to false when omitted. |
A boolean flag that determines whether the certificate of the license server should be verified (true) or ignored (false). |
Instance!ExampleProject | Required when Instance!DatabaseMode=New. Not permitted to be specified otherwise. |
Boolean flag that specifies if the "InstallationTest" example project should be imported in the KCM Repository database. |
Instance!DatabaseLoadFrom | Optional.
Only allowed when Instance!DatabaseMode=New |
Repository dump file to load into the repository database while starting the instance. When omitted, no database dump will be loaded. See the Dump and load the Repository database section in the Kofax Communications Manager Repository Administrator's Guide for more information on creating database dump files. |
Instance!ImportConfigurationFile | Optional |
Path to exported configuration file that will be loaded automatically when a KCM instance is installed. See the Export functionality and initialization of new components topic for more information. If omitted, default initial configuration will be applied. |
Instance!ImportInfrastructure |
Required if Instance!ImportConfigurationFile value was specified. |
Boolean flag that specifies whether the exported configuration should be loaded with or without infrastructure. See the Export functionality and initialization of new components topic for more information. |
Instance!ContinueInstallationOnFailedDatabaseCheck | Optional |
If set to True, it indicates that execution should continue even when the database access check returns a negative result. This might result in a failure later, when the database connection cannot be established. |
Security!TLSVersions | Optional. Only permitted when there are no other running KCM instances. | The versions of the TLS protocol that are supported by all KCM instances. Possible values are:
When omitted, defaults to TLS _11_12_13. TLS 1.3 requires support in Java, and support in .NET on the server OS. If you choose to use TLS_13 only, make sure that these requirements are met. |
Registration!Partner | Optional |
Partner that will be specified when the new KCM instance is registered on the Contract Manager. This information is stored in the KCM Repository database. Partner information will be used for verification when the database is connected to another KCM instance. |
Registration!Customer | Optional |
Customer that will be specified when the new KCM instance is registered on the Contract Manager. This information is stored in the KCM Repository database. Customer information will be used for verification when the database is connected to another KCM instance. |
Registration!ContractManagerRegistrationPort |
Required if the Contract Manager is installed remotely. Otherwise, must be omitted. |
The registration port of the Contract Manager. |
Registration!ContractManagerLocation | Optional |
Specifies the Contract Manager location when registering the new KCM instance: • If set to Local, the instance will be registered on the Contract Manager on the local server. • If set to Remote, the instance will be registered on the Contract Manager on a remote server. • If set to None, the instance will not be registered on the Contract Manager. |
Registration!ContractManagerHost | Required when the Contract Manager is remote or when a configuration with infrastructure is imported. Not permitted otherwise. |
The host of the Contract Manager on which the instance will be registered. Specify server name or IP address. |
Registration!UseExampleWebApp | Optional |
A boolean flag that indicates whether an example web application will be created for this KCM instance. |
Registration!ExampleWebAppName | Required if Registration!UseExampleWebApp was set to True. |
The name of the example web application that will be created for the instance. Do not use "ccm" as the name of your example web application. For more information, refer to the Known Issues section of KCM 5.8 Release Notes. |
Instance!DesignerAdministratorAccountPassword | Optional |
The password for the KCM Designer Administrator account. For this password to be accepted by KCM Repository server, it must meet the following requirements:
If omitted, or if the specified password does not meet the requirements, a default password will be generated. This default password will only be available in the output console. To change it, refer to the
Change your password topic in
KCM Designer Help.
|
Registration!NewContract |
Required if the registration was changed and Registration!ContractManagerLocation is not None. Optional otherwise, with default False. |
Boolean flag that specifies whether to create a new contract:
If the registration process detects that the contract already exists, registration will fail.
The registration will fail if the contract does not exist, or if the contract exists and is already associated
with another active
KCM
instance.
|
Registration!Force | Optional |
This parameter is only relevant when Registration!NewContract=False. Boolean flag that specifies whether to overwrite an association between the existing contract and KCM instance:
|
Services!Password | Required if either Instance!DatabaseUser or Instance!LicenseServerApiKey has a value. |
The password for the KCM service account. |
If you plan to configure the KCM instance by importing a configuration with infrastructure, this will also include KCM instance registration. In this scenario, the Registration!Partner, Registration!Customer, Registration!ContractManagerLocation, and Registration!ContractManagerHost parameters override the settings from the configuration file.