Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Status
colourGreen
titleAvailable in 9.7.X 7 and above

Overview

Troubleshooting information aims to provide resolutions to specific issues that can occur while using or configuring the VFC to WFE Metadata Integrator.

Table of Contents

Configuration

See the VFC to WFE Metadata Integrator Configuration Guide for more information on the configuration process.

...

You can configure the archived log file compression level and the number of archived log files that are kept. When the maximum number of archived log files is reached, the oldest archive file is removed.

Refer to the Configuration Guide for more information on logging configuration.

...

Section

Parameter

Description

Default value

Serilog

MinimumLevel

Log level setting of the application.

Note
Only increase the log level temporarily when you are doing troubleshooting. Leaving the log level on Debug/Verbose level can have an adverse effect on system performance which could lead to data loss in critical situations.

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

Error

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

Error

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

Error

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

Error

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

Error

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

Error

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

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.