| Status | ||||
|---|---|---|---|---|
|
Overview
Troubleshooting information aims to provide resolutions to specific issues that can occur while using or configuring the VFC to WFE Metadata Integrator.
...
Section | Parameter | Description | Default value | ||
|---|---|---|---|---|---|
Serilog | MinimumLevel | Log level setting of the application.
| Information | ||
Serilog | fileSizeLimitBytes | Maximum size of a log file in bytes. If a file reaches the file size limit, the next log message is written into the next file. | 104857600 |
...
- Verify that the appsettings.Production.json file has been created.
- Verify that the Log folder and a log file in it have been created.
- Verify that the configured parameters in the WFE, VFC, Secrets, and DataMapping sections of the appsettings.Production.json file are accurate.
- If the appsettings.Production.json file was modified, restart the Integrator service.
Troubleshooting examples
Missing appsettings.Production.json | |
|---|---|
ErrorLog message | Unhandled exception. System.IO.FileNotFoundException: The configuration file 'appsettings.Production.json' was not found and is not optional. The expected physical path was 'C:\Program Files (x86)\VFC Integrator\appsettings.Production.json'. |
Cause | The appsettings.Production.json file is not present in the installation folder of the Integrator. |
Solution | The appsettings.Production.json configuration file must be present in the installation folder of the Integrator. Rerun the installation process or add the file to the folder manually. |
Invalid JSON in appsettings.Production.json |
|---|
Log message | Unhandled exception. System.IO.InvalidDataException: Failed to load configuration from file 'C:\Program Files (x86)\VFC Integrator\appsettings.Production.json'. ---> System.FormatException: Could not parse the JSON file. |
Cause | Empty or corrupted appsettings.Production.json file. |
Solution | Check the appsettings.Production.json configuration file contains valid configuration details. |
Invalid JSON in appsettings.Production.json |
|---|
Log message | Unhandled exception. System.ArgumentNullException: Value cannot be null. (Parameter 'uriString') |
Cause | Empty or corrupt appsettings.Production.json file. |
Solution | Check the appsettings.Production.json configuration file contains valid configuration details. |
Missing VFC API user name | |
|---|---|
Log message | Appsettings Config Error |
:VFC API Username shouldn't be empty | |
Cause | The VFC API user name value is empty. |
Solution | Enter a valid user name in the appsettings.Production file. |
Missing VFC API password | |
|---|---|
Log message | Appsettings Config Error |
:VFC API Password shouldn't be empty | |
Cause | The VFC API password value is empty. |
Solution | Enter a valid password in the appsettings.Production file. |
Invalid WfeApiKey values |
|---|
Error
Log message | System.Net.Http.HttpRequestException: WfeApiKey Id or Value not valid |
Cause | The values for WfeApiKey contain invalid data. |
Solution | Check the values in the WfeApiKey parameter of the appsettings.Production file match the details of the External API key created for the WFE tenant. |
Parent organization does not exist |
|---|
Log message | Check if organisation with name 'Your VFC integration Organization name' exists. |
Cause | The WFE parent organization configured in the appsettings.Production file does not exist with the name specified in the ParentOrganizationName parameter. |
Solution | Create the parent organization or check that the name is correctly configured. |
Parent group does not exist |
|---|
Log message | The provided parent group 'Your VFC integration Group name' doesn’t exist. |
Cause | The WFE parent group configured in the appsettings.Production file does not exist with the name specified in the ParentGroupName parameter. |
Solution | Create the parent group or check that the name is correctly configured. |
Invalid VFC database connection string |
|---|
Log message | Can not connect to the VFC database with the configured connection string. Check configuration value of 'Vfc.MediaRepositoryDbConnectionString' |
Cause | The VFC database connection string configured in the appsettings.Production file is incorrect. |
Solution | Enter valid connection details to the VFC database in the MediaRepositoryDbConnectionString parameter of the appsettings.Production file. |
Invalid VFC Media Repository address |
|---|
Log message | System.Net.Http.HttpRequestException: No such host is known. (yourvfcmediarepositoryserver:443) |
Cause | The address to the VFC Media Repository server configured in the appsettings.Production file is incorrect. |
Solution | Enter the correct address of the VFC Media Repository server in the MediaRepositoryServerUrl parameter of the appsettings.Production file. |
Untrusted root authentication error |
|---|
Log message | Can't reach the VFC Provisioning API v3 at '/verba/ws-provisioning-3' please check the ConnectionStrings and Secrets configuration values. System.Net.Http.HttpRequestException: The SSL connection could not be established, see inner exception. ---> System.Security.Authentication.AuthenticationException: The remote certificate is invalid because of errors in the certificate chain: UntrustedRoot |
Cause | The VFC Media Repository server certificate installed on the server running the Integrator is invalid or is missing. |
Solution | Ensure that a valid certificate is installed on the server, and that the date and time of the server is correct. |