installerConfig.json

The installerConfig.json file is utilized for configuring the initial environment settings of the agent being installed. It must be placed in the same directory as the .msi installer file.

Configuration Options

• ServerAddress: The cluster's address (without schema and port). IPv6 is also supported; however, it requires internal verification.

• ServerUseSsl: Determines if SSL is used (true by default). When enabled, port 443 is used; otherwise, port 80 is used. The agent does not switch to an insecure channel if SSL fails.

• Language: Sets the agent's initial language. Options include ar, de, es, fr, he, it, pl, pt, th, zh. Default is en.

• VisualStyle: Chooses between Light or Dark mode, with Dark mode set as the default.

• KeycloakClientId: The ClientId in Keycloak, typically agent by default. It is recommended not to change this unless necessary.

• KeycloakAuthType: Specifies the authentication method. Default is mTLS. Options include:

  • mTLS: Authentication via user certificate.

  • PasswordGrant: User password grant flow for authentication.

Authentication Configuration Details

For mTLS:

• KeycloakUsername: Generally, agent with email agent@gv.com (default). Changing this is usually unnecessary.

• KeycloakCertificateContent: The user's certificate in PEM format (excluding the BEGIN/END certificate lines).

• KeycloakKeyContent: The user's private key in PEM format (excluding the BEGIN/END private key lines).

For PasswordGrant:

• KeycloakUsername: Same as above.

• KeycloakUserPassword: The encrypted password corresponding to KeycloakUsername. Use GVClient.Tools.SetupHelper for encryption.

• KeycloakClientSecret: The encrypted client secret for the Keycloak client. Use GVClient.Tools.SetupHelper for encryption.

Example Configuration

For typical customer installations, altering the ServerAddress, Language, and VisualStyle is often sufficient:

{
  "ServerAddress": "123.example.abc.com",
  "Language": "en",
  "VisualStyle": "Dark"
}

Remember to adjust the configuration according to the specific requirements of the installation environment.