Use response files to provide inputs during unattended installation. A response file contains the information necessary to answer the prompts during the installation. You can do multiple installations without having to resupply the same information.

Each answer to a prompt is stored as a value for a variable identified in the response file. Refer to the following tables for an overview of settings and default values of a response file.

The following table includes settings for the installation process itself. Any setting that is not specified or commented out, is set to the default value.

Section

Name

Default

Description

<InstallationSettings>

InstallFolder

C:\Program Files\Thermo\ChromeleonLink

The path to the installation directory.

ServicePort

8082

The port number that the service listens to. The setup also creates an inbound Firewall exception for this port.

ServiceAccount

Local System

The username of the Windows account used to start the service.

ServicePassword

The password of the Windows account used to start the service.

HttpsCertificatePath

The path to a new pfx certificate file that is imported during installation.

HttpsCertificatePassword

The password for the new pfx certificate file.

HttpsCertificateSubject

This setting should be set if a pre-installed certificate is used during web API installation, instead of importing a new HTTPS certificate.

HttpsCertificateStore

My

The name of the Windows Certificate store to use for the SSL certificate.

HttpsCertificateLocation

LocalMachine

The location of the Windows Certificate store to use for the SSL certificate.

HttpsCertificateAllowInvalid

false

Set this to "true" to allow an untrusted (self-signed) SSL certificate to be used.

You can modify any value in the appsettings.json file in the installation directory of the web API. The name of each setting corresponds to the Json path of the value in the appsettings.json file. The json file can be found in the WebAPI folder of the installation directory. All of these settings are just examples.

Section

Name

Default

Description

<WebServiceSettings>

UseDbCache

true

Set this to "false" to disable caching data (not recommended).

CmLinkSettings.ReadyCheckWarningsLegacyMode

false

Enable the legacy mode for ready check warnings, that is, ignore all warnings that have a source URL.

CmLinkSettings.AllowUnencryptedCredentials

false

Allow sending credentials over an unencrypted connection (HTTP). If this is disabled, the service rejects any request that contains credentials in plain text.

CmLinkSettings.RequireAuthorization

false

Request Chromeleon user credentials for every request. If false, only the credentials from SdkAppSettings are used.

Kestrel.Endpoints.Default.Url

Change the service endpoint to listen to. This setting is automatically set to the correct value if the ServicePort setting is set.

Set the username and password of the Chromeleon user account used by the SDK. If the Chromeleon user-mode is enabled and these settings are invalid, the setup fails. The settings must be set even if the RequireAuthorization setting is enabled. When Chromeleon user-mode is disabled, the settings are ignored.

Section

Name

Default

Description

<SdkAppSettings>

SDKUSERNAME

The Chromeleon username the service will use.

SDKPASSWORD

The Chromeleon password the service will use.

Figure Response file example
Response file example