Overview

This guide provides step-by-step instructions for resetting the AppManager integration for KerioConnect. The procedure should be applied when clicking “Register in AppManager” from KerioConnect WebUI leads to GFI AppManager’s dashboard, instead of the “registration wizard”, or the “Register in AppManager” button has disappeared completely. 

Steps to Reset AppManager Integration

Note: For macOS installations, a dedicated article is available here: Resetting GFI Agent Integration with KerioConnect on macOS. 

Note: if you are using the pre-built virtual appliance, please check Can I register and manage KerioConnect virtual appliance with AppManager? article.

1. Stop Kerio Connect Service:
   • Starting or Stopping the Kerio Connect Server on Windows

   • Stopping and Starting the Kerio Connect Service on macOS and Linux

     Note: In any of the next steps, if you notice any item missing in your installation, for instance, not finding any '.CloudAdmin' account in Step # 3, please simply proceed to the next step, as it's likely that your GFIAgent installation is already broken, hence the missing piece. 
      

2. Stop GFIAgent Service:
   • Similar to the above step, make sure the GFIAgent service is also stopped. 
     Note: Please ensure that the service is not set to "Automatic restart" or similar causing it to restart automatically upon restart, it should stay stopped throughout the process. Additionally, if you face issues in stopping the service, you can alternatively try killing the associated process. 
   • Guidance for stopping can be found in the article for Disabling GFIAgent on Kerio Connect Server. If you disable the GFI agent during the process, make sure to re-enable it after step 5. For example, for MacOS the command would be sudo launchctl load -w /Library/LaunchDaemons/gfiagent.plist 
      
3. Modify the 'mailserver.cfg' File:
   • Navigate to the Kerio Connect installation folder:
     • Windows: C:\Program Files\Kerio\MailServer
     • macOS: /usr/local/kerio/mailserver
     • Linux: /opt/kerio/mailserver
   • Find and open the mailserver.cfg file.
   • In the "AppManager" table, locate the variables "ApplianceId" and "RegistrationUrl". Empty their values
   • Within the "SpecialAccount" table, find the node with the value ".CloudAdmin". Remove the entire <listitem> node that encompasses it (highlighted in the below image).
     
     Note: Be careful while editing this file. Incorrect changes can affect the application's functionality. 
   • Save the changes
      
4. Restart Kerio Connect Service:
   • Once the above changes are made, start the Kerio Connect service again.
      
5. Remove Agent Appliance Folder:
   • Windows: Delete the C:\Program Files\GFIAgent\appliances\<appliance_ID> folder
   • macOS: Delete the /var/gfiagent/appliances/<appliance_ID> folder
   • Linux: Stop the agent (systemctl stop gfiagent) then delete the gfiagent directory: rm -rf /var/gfiagent/appliances/<connect_appliance_id>
6. Run the Agent Installer:
   • Windows
     • Find the GFIAgentInstaller.exe in the C:\Program Files\GFIAgent\ folder.
     • Execute the installer with the following command (Run CMD as Administrator):
       GFIAgentInstaller.exe kerio-connect "C:\Program Files\Kerio\\" "https://appmanager.gfi.com/1.2.latest/windows-amd64/"
     • Important: Replace C:\Program Files\Kerio\ with the installation folder path of your Kerio Connect if different. The path must end with a double "\".
   • macOS

     • Execute the installer with the following command in macOS Terminal:
       Intel machines: 
       sudo /usr/local/kerio/GFIAgent/GFIAgentInstaller kerio-connect /usr/local/gfiagent "https://appmanager.gfi.com/1.2.latest/darwin-amd64/"

       Apple-Silicone machines:

       sudo /usr/local/kerio/GFIAgent/GFIAgentInstaller kerio-connect /usr/local/kerio/ "https://appmanager.gfi.com/1.2.latest/darwin-arm64/" 

   • Linux

     • Start gfiagent service: 

       sudo systemctl start gfiagent.service

     • Run the command to install the GFIAgent:
       sudo /usr/local/gfiagent/GFIAgentSetup kerio-connect /opt/kerio/ "https://appmanager.gfi.com/1.2.latest/linux-amd64/"

Make sure that the GFIAgent Service is started

• Windows: Check the Task manager for the GFIAgent Service
• macOS: Check the Activity Monitor for the GFIAgent service

Summary

The guide provides detailed steps for resetting the AppManager integration for KerioConnect. This involves stopping the Kerio Connect and GFIAgent services, modifying the 'mailserver.cfg' file to clear certain configuration values, and removing the Agent Appliance folder specific to the operating system. The process concludes with reinstalling the GFIAgent using platform-specific commands and ensuring that the service is running properly.

FAQ

1. What should I do if the "Register in AppManager" button is missing in KerioConnect?
   Follow the reset procedure outlined in the guide which includes stopping services, modifying the 'mailserver.cfg' file, deleting the Agent Appliance folder, and reinstalling the GFIAgent.
2. How do I modify the 'mailserver.cfg' file during the reset process?
   Navigate to the installation folder of Kerio Connect, open the 'mailserver.cfg' file, locate the "AppManager" and "SpecialAccount" tables, and empty the values for "ApplianceId" and "RegistrationUrl", and remove the ".CloudAdmin" listitem node. Save the changes carefully to avoid affecting the application's functionality.
3. How do I reinstall the GFIAgent on different operating systems after resetting the integration?
   For Windows, run `GFIAgentInstaller.exe` with the specified command from an administrator CMD prompt. On macOS, use the Terminal with the appropriate command for Intel or Apple-Silicone machines. For Linux, use the command provided to start the service and install the GFIAgent. Make sure to replace paths as necessary depending on your installation directory.

Related Articles

• Resolving "Signature not yet current" error leading to Appliance Showing as Offline in AppManager