Invantive Data Hub reads three kinds of configuration before it does anything: an application configuration file, the [[Settings]] files which define the databases, and the licence.
## Application Configuration File
The product refuses to start without an application configuration file in the configuration folder, normally `%USERPROFILE%\Invantive`. The failure is:
```
itgencuy002: The application configuration file must be present in either '…\Invantive'
as 'appsettings.Development.json' or 'appsettings.json'.
```
and the program ends with [[Invantive Data Hub/Exit Code|exit code]] 9.
The file which is required is the one belonging to the environment: with `ASPNETCORE_ENVIRONMENT` set to `Development` the file has to be `appsettings.Development.json`, and `appsettings.json` on its own does not satisfy the check. Without that variable, `appsettings.json` applies.
The file holds one section, `DataHub`, with the settings for Elastic APM under it:
```json
{ "Logging": { "LogLevel": { "Default": "Warning" } }
, "DataHub":
{ "ElasticApm":
{ "Enabled": false
, "Description": "Invantive Data Hub appsettings configuration"
}
}
}
```
`Description` must be present: a section which does not bind leaves the description at its initial value, upon which the start ends with `itgeneay003`, "Elastic APM configuration not loaded". Monitoring itself is switched on with `Enabled`, which then also requires `ServerUrl` and `SecretToken`.
## Licence
The licence is held per product installation and is stored encrypted, so it cannot be placed in a file by hand. Without a licence the product opens its agreement menu:
```
1. Enter Invantive license key L. Load Invantive license key from file
2. Acknowledge agreement T. Load trial license
4. Show agreement text 5. Save agreement to file 6. Show details
E. Exit menu C. Exit application
```
Answer `1` and paste the licence key, or `T` for a trial licence. `/licensekey` on the command line supplies a key for one run without storing it; see [[Invantive Data Hub/Command Line Arguments|Command Line Arguments]].
A run which has no console to answer with reports `itgencmm002`, "No answer received to question", and then `itgenlic681` with exit code 7. An unattended task therefore has to be run once by hand first, so that the key and the agreement are stored.
## What the Start-up Reports
Before the first statement runs, the product reports the script file, the log file, the licence, the operating system user and machine, the .NET release, the Invantive installation identification and session identification, the current folder, the three settings files it uses, and the database it is connecting to.
That output is not neutral material. It names the licence contract code and the licensee (`itgendhb066`, `itgendhb067`), and the name, e-mail address and telephone number of the user (`itgendhb227` to `itgendhb229`). A log file of a run therefore contains personal data and is kept and shared accordingly.
The three personal lines are read from the global user settings, so they follow whoever the profile belongs to. The operating system log-on code and the machine name (`itgendhb033`, `itgendhb034`) come straight from the operating system and cannot be set anywhere in the product.
## User Identity
Name, e-mail address, telephone number and gender are held once per user in `user.settings` in the configuration folder, and are shared by every Invantive product on the device.
Since the conversion to JSON there are two files, `user.settings` and `user.settings.json`, and the JSON file decides. Changing only the XML has no effect. The names of the fields differ slightly between the two: the telephone number is `PersonPhoneWork` in the XML and `PersonPhoneWorkNumber` in the JSON.
The product asks for these values once, in the "Personalize your salutation" window which appears after a licence key is registered. The e-mail address there is fixed to the address the licence was issued to and cannot be changed in that window.