Overview

This article concerns instances when MailEssentials is not accessible. The login page is displayed but does not allow a successful login (usually, without any error message).

Environment

• MailEssentails 20.x / 21.x
• Linux
• Mac OS
  
  

Root Cause

Unix-like systems cannot use Windows Authentication. Forms mode allows for the system to accept authentication outside of Windows mode (credentials shared over the session).

Resolution

If the system is using a Windows authentication method, Follow the steps below to switch it to Forms:

1. Change the Authentication method on the GFI Archiver server side to use Forms authentication.

2. Execute the tool

    ..\GFI\MailEssentials\mecswitchboard.exe

3. From the UI Mode tab, navigate to Security > Authentication and change to Forms mode.
   Note: Firewall should be disabled on the customer side during the testing period.

4. Execute the following commands from the terminal:

   • On Linux machines:

     systemctl stop firewalld

   • On MAC machines:

     defaults write /Library/Preferences/com.apple.alf globalstate -int 0

5. Clear Browser cache.

6. Attempt to reconnect.
   
   

Validation

The user should be able to log in successfully.