FYB Connect Troubleshooting Guide

New
  • Published on Dec 3, 2025
  • 2 minute(s) read
  • AM
 Prev Next

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

Property Definition
Client ID The client ID for the registered module on EntraAD
Tenant ID The organization tenant's unique identifier on EntraAD
Redirect URL The FYBConnect URL followed by /{modulename}/. E.g. https://example.com.au/fybconnect/3652cm/
Certificate Name The 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

  4. In the requestLimits element add maxAllowedContentLength="51200"
    2025-05-21_11-39-01.png

  5. 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