Configuring the resources of a KCM Server

You can add, modify or remove the resources that are configured for the KCM installation with the ConfigureKCM.exe tool:

  • It is always possible to add resources.

  • It is always possible to modify a resource that is not yet used by the KCM installation.

  • Except for Tomcat, it is possible to modify a resource that is in use by the KCM installation. Do note that the affected components should always be restarted afterwards.

  • It is only possible to remove a resource when it is not yet used by the KCM installation.

  • The mandatory resources (services account, internal ports start point, private ports start point, internal certificate) cannot be changed with the ConfigureKCM.exe tool, except for the internal certificate that can be modified but not removed.

The ConfigureKCM.exe tool can make multiple changes at the same time.

You can find the ConfigureKCM.exe tool in the <deploy root>/KCM/Programs/<version>/Management folder.

Parameters

The ConfigureKCM.exe tool has the following parameters:

Parameter Required/Optional Description
Java!Home Optional. When omitted, configuration doesn't change. Not permitted when Remove!Java is true. New value for the installation folder of the Java installation.
Tomcat!Version Optional. When omitted, configuration doesn't change. Not permitted when Remove!Tomcat is true. New value for the version number of the Tomcat installation.
Services!Password Required Password of the KCM services account.
Remove!Webservices Optional. Defaults to false when omitted. Boolean flag. Indicates whether the configuration of the web services account should be removed.
Remove!PublicContractManagerPort Optional. Defaults to false when omitted. Boolean flag. Indicates whether the configuration of the Contract Manager port should be removed.
Remove!PublicControlCenterPort Optional. Defaults to false when omitted. Boolean flag. Indicates whether the configuration of KCM Control Center should be removed.
Remove!Java Optional. Defaults to false when omitted. Boolean flag. Indicates whether the configuration of the Java installation should be removed.
Remove!Tomcat Optional. Defaults to false when omitted. Boolean flag. Indicates whether the configuration of the Tomcat installation should be removed.
Remove!PublicCertificate Optional. Defaults to false when omitted. Boolean flag. Indicates whether the configuration of the public certificate should be removed.
InternalCertificate!KeystoreFile Optional. When omitted, configuration doesn't change. New value for the location of the internal SSL certificate file.
InternalCertificate!KeystorePassword Required when InternalCertificate!KeystoreFile has a value. Not permitted otherwise. New value for the password of the internal SSL certificate file.
InternalCertificate!Thumbprint Required when InternalCertificate!KeystoreFile has a value. Not permitted otherwise. New value for the thumbprint of the internal SSL certificate in the Windows certificate store.
Webserver!ServiceUser Optional. When omitted, configuration doesn't change. Not permitted when Remove!Webservices is true. New value for the name of the KCM web services user account.
Webserver!ServicePassword Required when Webserver!ServiceUser has a value. Not permitted otherwise. New value for the password the KCM web services user account.
PublicCertificate!KeystoreFile Optional. When omitted, configuration doesn't change. Not permitted when Remove!PublicCertificate is true. New value for the location of the public SSL certificate file.
PublicCertificate!KeystorePassword Required when PublicCertificate!KeystoreFile has a value. Not permitted otherwise. New value for the password the public SSL certificate file.
PublicPorts!ContractManager Optional. When omitted, configuration doesn't change. Not permitted when Remove!PublicContractManagerPort is true. New value for the port of the Contract Manager.
PublicPorts!ControlCenter Optional. When omitted, configuration doesn't change. Not permitted when Remove!PublicControlCenterPort is true. New value for the port of KCM Control Center.