VFC to WFE Metadata Integrator Troubleshooting Guide


AVAILABLE IN 9.7.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.

Configuration

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

Log files

The VFC to WFE Metadata Integrator offers extensive log configuration functionality, which can be amended to provide more information when troubleshooting.

The Integrator writes its log to the following file:

INSTALLDIR/Logs/log_YYYYMMDD.log

where INSTALLDIR is the installation directory of the Integrator, and YYYYMMDD represents the current date. The log file path is configured in the Serilog section of the appsettings.Production.json file.

We recommend you do not change the log file path.

A new log file is created both at set time intervals and when the log file size exceeds the value configured in the appsettings.Production file. The default configuration defines the time interval as every day, and the log file size as 100 MB.

The previous log file gets added to a .tar.gz file. The location where the archived log files are saved can be configured in the Internal section of the appsettings.Production file. By default, they are saved in a folder called Archived that is placed within the Logs folder. By omitting the parameter to configure the archived folder path, the archived log files are placed in the Logs folder, next to the active log file.

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.

If you require more detailed logging for troubleshooting, you can change the logging settings for the Integrator by editing the appsettings.Production configuration file.


Section

Parameter

Description

Default value

Serilog

MinimumLevel

Log level setting of the application.

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


Related information

Serilog Configuration Guide

Troubleshooting steps

  • 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

Log 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

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.