Skip to main content

FYB Connect Troubleshooting Guide

Raise a support ticket

OVERVIEW​

The following guide lists some of the common FYB Connect issues you may experience along with the possible cause and resolution.

FYB CONNECT​

UPDATING ENTRA SETTING FOR MODULES​

If the Entra Application settings have changed for a module, follow the steps below to update its settings.

  1. Navigate to the FYB Connect installation path and open the affected module's folder

    2025-06-10_8-30-13.png

  2. Open the appsettings.Production.json file

    2025-06-10_8-32-56.png

  3. Within the MsalConfig section, update the required properties.

    2025-06-10_8-36-03.png

    PropertyDefinition
    Client IDThe client ID for the registered module on EntraAD
    Tenant IDThe organization tenant's unique identifier on EntraAD
    Redirect URLThe FYBConnect URL followed by /{modulename}/. E.g. https://example.com.au/fybconnect/3652cm/
    Certificate NameThe friendly name of the nominated certificate (.pfx) installed on the machine.

UNABLE TO TRANSFER LARGE FILES TO THE CONTENT MANAGER SERVIECE API​

Note

The maximum size is 2 GB. See Uploading Large Files to IIS / NET. Core / ASP.NET for more information.

File over 2GB that are skipped during transfer are logged to the module's transaction log files.

The default document size that can be uploaded using the CM Service API is 4MB. To increase this:

  1. Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)
  2. Open the Web.config file as an Administrator
  3. In the httpRuntime element, add maxRequestLength="51200" and executionTimeout="7200" This value will allow for document uploads up to 50MB. Increase this value as required.

2025-05-28_14-38-26.png

  1. In the requestLimits element add maxAllowedContentLength="51200"

    2025-05-21_11-39-01.png

  2. Save the changes.

CONFIGURED CONNECTION ISN'T APPEARING​

DESCRIPTION​

A configured connection is not appearing for the user

CAUSE​

The user may have multiple datasets configured and currently has a different dataset selected

RESOLUTION​

Change the current dataset and check the connections

2025-06-10_15-13-13.png

CONTAINERS NOT BEING CREATED FOR SPECIFIC CONTAINER RECORD TYPES​

DESCRIPTION​

Sub containers aren't being created for certain Record Types. The error below is thrown in the log file: Unable to create sub container Exception: This record does not use an explicit schedule.

CAUSE​

The Allow retention rules to be applied option might be disabled on the Record Type in CM.

RESOLUTION​

Enable the Allow retention rules to be applied

2025-08-04_15-56-12.png

FAILED TO LOAD MODULE SCRIPT​

DESCRIPTION​

After installing FYB Connect, you might encounter a white screen when navigating to FYB Connect with the error below thrown in the browser's DEV TOOLS:

image.png

CAUSE​

The incorrect domain value was supplied during install which will corrupt this file as well as FYB Connect's routing: \FYBConnect\GatewayService\wwwroot\index.html

image.png

RESOLUTION​

Re-Install FYB Connect and ensure the right domain is used in the specified format. E.g. https://example.com.au