Introduction

This Installation Guide contains important information related to the GCON4 MFL installation. In this document, you will find the steps needed to install the product automatically. For detailed information on new enhancements and fixed bugs, please check the Release Notes.

Before installing GCON4 MFL version 7.0.x, ensure you have the following software installed:

  • Unit4 ERP 7.0.0

Note The tool has been adjusted to be compatible only with updates 4 through 16 (released on September 9-2025).

To provide optimal support and ensure the best performance of the GCON4 MFL tool, we will now only offer support for versions recently released by UNIT4 ERP and deployed within the respective maintenance windows.

This measure ensures that all necessary updates and patches are applied within established timelines, minimizing potential issues and ensuring the compatibility and stability of our services.

Before starting the installation

Before starting the installation, ensure the Backoffice Data Source you plan to use is fully set up. This includes:

  • Setting up the Business Server.
  • Ensuring the paths for the AGRESSO_EXE, AGRESSO_REPORT, and AGRESSO_STYLESHEET environment variables are correct.
  • Ensuring your Data Sources are correctly configured.
  • If you are migrating from previous GCON4 MFL versions such as 5.x.x or 6.0.x, please contact our Customer Support Team. They will guide you through this process.

ACT Components

The MFL.ACT.dll is located in the following folders

7.0.0.X. Compatible with ERP 7 Updates 13 - 16

7.0.0.12 Compatible with ERP 7 Update 12

7.0.0.5. Compatible with ERP 7 Updates 4 - 11

Prerequisites

PowerShell Version

You have to use the PowerShell Version 3 or higher.

installation package

User Access Rights

Log in to the PowerShell console as an administrator.

run powuershell

If you receive the following error message: File cannot be loaded because running scripts is disabled on this system

type: set-executionpolicy remotesigned

select Yes to all and press the Enter key.

powershell command

Installation

Go to MFL website and download the Installation package.

download webpage

These 2 buttons allow to download the latest Zip package and open the documentation's webpage .

customization buttons

File Layout

Unzip the downloaded file, inside the folder you will find the installation package which contains the folder for install and uninstall.

installation package

Powershell Script

Enter at the Install folder where you will find the powershell script needed to run InstallMFL.ps1

installation script

Now you can run the InstallMFL.ps1 script from the folder you unzipped GCON4 MFL with the command:

.\InstallMFL.ps1

install

While the script is running, it loads the files and executes all the scripts from the directory structure.

The script will ask you to enter the name of the data source.

database name

After this the installation will be executed automatically

installation

Logging

A log is created in the directory every time when a PowerShell is run:

Example: FullLog-20230506-102153.log

EULA

See the software license terms Software License terms

Don't forget to grant permissions for the GCON4 MFL menu entries in WEB:


menu access


Masterfile access management is described in the section Configuration, from the Reference Manual.

When should I re-install GCON4 MFL?

  1. When MFL menu titles are missing: After applying an update to the UNIT4 ERP system, GCON4 MFL titles are likely to be affected. This is because, to ensure the multilingual functionality of MFL, titles must be integrated into the ERP tables, which may be impacted during the upgrade. Therefore, it is crucial to reinstall GCON4 MFL after each UNIT4 ERP update to restore the proper functioning of titles in multiple languages.

  2. When refreshing the database or using a copy of the database that did not have MFL installed

Note for Unit4 Cloud customers

To request the reinstallation of GCON4 MFL, please create a CS in the Unit4 portal community.unit4.com

Steps

To request the re-installation of the GCON4 MFL version 7.0.x in your PREV, ACPT and PROD environments under, please follow these steps:

Open a new CS in the Community4U platform https://community.unit4.com/

1.Go to Support4U

2.Go to request something-> Cloud -> Software updates & Installations -> Localization/Add-on Installation

3.Complete the form with the following information:

Localization/Add-on name: GCON4 MFL
Version: *Check the latest version in the Release notes*

4.Text for special requirements:

“Good day. We request your assistance with the re-installation of the GCON4 MFL v.7.0.x.xxxx in the (PREV, TEST, ACPT or PROD) environment due to indicate the reason. Please assign our request to Cloud engineers trained in the installation of the MFL 7.0. The customer's contact for the notification is enter your company main contact (name + email address) Thank you so much.”