Problem Description
During the process of (re)installation of GFIagent on a KerioControl appliance, users may encounter issues that prevent the successful completion of the (re)installation. This problem typically manifests through errors indicating that certain processes cannot be found or files cannot be copied due to a read-only file system.
Identification of the Issue
To identify the issue, please review the GFI Agent logs that can be found in the logs section in the WebUI. The logs would have records showing messages similar to the below:
-
Missing Process Error
The error message: `No running process found with pid file /var/gfiagent/tailscaled.pid: open /var/gfiagent/tailscaled.pid: no such file or directory' indicates that the installation process is attempting to locate a process by its PID file but is unable to find the expected file. This suggests that either the process has not been started as expected or that the file has been removed or is inaccessible. -
Read-Only File System Error
The error `Unable to copy /usr/local/gfiagent/GFIAgentInstaller.new to /usr/local/gfiagent/GFIAgentInstaller: open /usr/local/gfiagent/GFIAgentInstaller: read-only file system` reveals that the file system is mounted as read-only, which prevents the installer from copying necessary files to their destination paths. This is a common issue when the file system is protected to prevent unwarranted changes.
The conclusion drawn from these errors is that the agent reinstallation process has not been completed fully due to the file system being in a read-only state, which hinders the necessary modifications for the installation.
Recommended Solution
To resolve these issues and ensure the successful reinstallation of the agent, follow the recommended steps below:
-
Remount the File System with Write Permissions:Before proceeding with the reinstallation process, ensure that the file system is remounted with write permissions to allow modifications. This can be achieved by connecting to the console via SSH and executing the following command:
mount -o rw,remount
This command remounts the root file system (`/`) with read-write (`rw`) permissions, allowing files to be modified, created, or deleted as needed during the installation process. - Retry the Installation Process: After remounting the file system with the appropriate permissions, retry the agent installation process from the beginning. Ensure to follow all the steps carefully, starting with the command mentioned above immediately after SSHing into the console.
By following these steps, users should be able to overcome the encountered errors and complete the agent reinstallation process successfully.