Config file properties

The Coach Installer now has a config.ps1 file that can be customized to meet the needs of Qualtrak partners for easier and efficient Coach install process.

The properties in the config.ps1 file should only be used where needed. Where they are not used, they will be ignored during the install.

Microsoft Powershell coding notation is used for editing the config.ps1 script file.

General

General Coach Installer properties.

Install Path

The install path for Coach Installer. Some development work outstanding so please do not change Default Value!

Property Name

$installPath

Value

Single quoted string with standard Windows path notation e.g. c:\.

Default Value

Depending on system type:

  • 'C:\Program Files' [x86]
  • 'C:\Program Files (x86)' [x64]

SSL

Whether SSL should be enabled or not.

Property Name

$isSSL

Value

Boolean value: $true or $false.

Default Value

$true

Coach System Administrator Username

Sets the Coach System Administrator username. This is only required for a first-time installation. Where Coach is being upgraded the System Admininstrator Username value will be ignored.

Property Name

$sysAdminUsername

Value

Single quoted string.

Default Value

'sys.admin'

Scheduler Trigger Time

The time of day that the Coach Scheduler Service will run. Accepts 24 hour clock time.

Property Name

$schedulerTriggerTime

Value

Single quoted string that represents time form '00:00' to '23:59'. Please make sure to use leading zero time format e.g. 01:30!

Default Value

'02:00'

Install Instrumentation

Whether Coach Instrumentation will be installed. Don’t use Coach Instrumentation property in config.ps1, if it is not needed!

Property Name

$installInstrumentation

Value

Boolean value: $true or $false.

Default Value

Instead of default value don’t use this property in config.ps1!

IIS

Internet Information Services (IIS) specific properties.

Application Pool Name

The name of IIS Application Pool that Coach will be added to.

Property Name

$appPoolName

Value

Single quoted string.

Default Value

'ASP.NET 4.0'

IIS Web Site Name

The IIS Web Site Name that Coach Web Application will be part of.

Property Name

$iisWebSiteName

Value

Single quoted string.

Default Value

'Default Web Site'

Web Application Name

The Coach Web Application Name, that will be then used for main Coach URL, e.g. if name is set to “test”, URL will be: https://example.com/test. This can be left as Default Value Coach but can be modified to fit with branding requirements.

Property Name

$appName

Value

Single quoted string.

Default Value

Coach

Database

The Coach SQL Server Database properties.

Database Instance Name

The SQL Server Database Instance or Server name for where Coach database will be installed. Use this property if the Instance name is not changing, but if the Instance name does need to be changed then use Qualtrak Coach Installer parameter -DbSrv with instance/server name.

Property Name:

$dbInstanceName

Value

Single quoted string. Any valid SQL Server named instance or server name.

Default Value

.\SQLEXPRESS

Database Login Name (User)

The SQL Server Database Login name (Db User) needed for Coach database and scripts to run and install properly. The Login name must have sysadmin role in SQL Server Server Roles. Use this property if the same login name is used for all deployments, otherwise use Qualtrak Coach Installer parameter -DbUsr with login name. This value is only persisted here in config.ps1 as it is only needed for installation session. If persisting to config.ps1 is a problem then use Qualtrak Coach Installer parameter -DbUsr instead.

Property Name

$dbLoginName

Value

Single quoted string.

Default Value

sa

web.config

The ASP.NET web.config properties currently for <appSettings>, <machineKey> and <authentication>.

Authentication Route

Used to mark that Coach integration Authentication Route will be through a URL query string. It will add to the Coach web.config in <appSettings> element new setting with key AuthenticationRoute with value url. Don’t use Authentication Route property in config.ps1, if it is not needed!

Property Name

$authenticationRoute

Value

Single quoted string.

Default Value

Instead of default value don’t use this property in config.ps1!

Machine Validation Key

Sets the custom Machine Validation SHA1 Key to Coach web.config <machineKey> element. Don’t use Machine Validation Key property in config.ps1, if it is not needed!

Property Name

$machineValidationKey

Value

Single quoted SHA1 string.

Default Value

Instead of default value don’t use this property in config.ps1!

Machine Decription Key

Sets the custom Machine Decryption AES Key to Coach web.config <machineKey> element. Don’t use Machine Validation Key property in config.ps1, if it is not needed!

Property Name

$machineDecryptionKey

Value

Single quoted AES string.

Default Value

Instead of default value don’t use this property in config.ps1!

Authentication Forms Name

Sets the custom Forms Name attribute to Coach web.config <forms> element. Don’t use Authentication Forms Name property in config.ps1, if it is not needed!

Property Name

$formsName

Value

Single quoted string.

Default Value

Instead of default value don’t use this property in config.ps1!

Authentication Forms Domain

Sets the custom Forms Domain attribute to Coach web.config <forms> element. Don’t use Authentication Forms Domain property in config.ps1, if it is not needed!

Property Name

$formsDomain

Value

Single quoted string.

Default Value

Instead of default value don’t use this property in config.ps1!

Windows Authentication

Enables Windows Authentication in Coach. If Windows Authentication is not needed don’t include any of its properties in config.ps1.

Windows Authentication

Enables Windows Authentication in Coach. This also requires the Active Directory Group Name property to be set. Don’t use Windows Authentication property in config.ps1, if it is not needed!

Property Name

$isWindowsAuth

Value

Boolean value: $true or $false.

Default Value

Instead of default value don’t use this property in config.ps1!

Active Directory Group Name

Sets the custom Active Directory group name. Don’t use Active Directory Group Name property in config.ps1, if it is not needed!

Property Name

$activeDirectoryGroupName

Value

Single quoted string.

Default Value

Instead of default value don’t use this property in config.ps1!

Recorder

Recorder specific properties for IP address and database connection details.

Recorder IP Address

The IP address of the Recorder that Coach will integrate with. Use this property if the same Recorder IP address is used for all deployments. If not, then use Qualtrak Coach Installer parameter -RecorderIP with valid IP address.

Property Name

$recorderIpAddress

Value

Single quoted string as valid IP address.

Default Value

localhost

Recorder Database Instance Name

The Database instance name that the Recorder uses for persisting recordings.

Property Name

$dbRecorderInstance

Value

Single quoted string.

Default Value

'.\SQLEXPRESS'

Recorder Database Login Name

The Database login (user) name that the Recorder uses for persisting recordings.

Property Name

$dbRecorderLoginName

Value

Single quoted string.

Recorder Database Login Password

The Database login (user) password that the Recorder uses for persisting recordings.

Property Name

$dbRecorderPasswd

Value

Single quoted string.

HA (High Availability)

HA specific properties currently for File sharing and Caching. Applicable only for Coach App Installer and its config file: config.app.ps1.

Those properties are included in config.app.ps1, but commented out by default.

To setup HA:

  • Fileshare: it is required to set values for File share Username, Password and Path. If not. it will not be applied!
  • Caching: it is required to set values for Caching Mode, IP and Port. If not, it will not be applied!

File share Username

The File share username used for Coach attachments folder on server.

Property Name

$fileShareUsername

Value

Single quoted string.

File share Password

The File share password used for Coach attachments folder on server.

Property Name

$fileSharePassword

Value

Single quoted string.

File share Path

The File share path used for Coach attachments folder on server.

Property Name

$fileSharePath

Value

Single quoted string.

Caching Mode

The ASP.NET caching mode, currently only supported is StateServer in future there will be support for SqlServer caching mode.

Property Name

$cachingMode

Value

Single quoted string. Currently only supported is StateServer.

Default Value

'StateServer'

Caching IP

The ASP.NET caching IP address.

Property Name

$cachingIp

Value

Single quoted string. Valid IP address or DNS name.

Caching Port

The ASP.NET caching IP address Port.

Property Name

$cachingPort

Value

Integer value. Greater than zero (0).

Default Value

42424