Server Installation Debian Package

First install the package dependencies:

CODE

sudo apt-get update 
Sudo apt-get install -y apt-utils
sudo apt-get install -y openssl
sudo apt-get install -y net-tools
sudo apt-get install -y apt-transport-https dirmngr gnupg ca-certificates
sudo apt-get install -y --no-install-recommends libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g
sudo apt install python3
Sudo apt install python3-pip

Then the package can be installed using the following command:

CODE

sudo dpkg -i Pathfinder.Server.Installer-X.X.X.deb (make sure the name is exactly as the .deb file)

After the installation has finished a wizard for the database configuration will open.

Enter the data of your Pathfinder database and click Next.

Select the license.ldf file (needs to have that name) and click Next.

You can choose between a self-signed localhost generated by the configuration wizard or select a certificate file using the custom option, then click on Finish button to start Pathfinder Server in the background.

To change the database configuration later you can access the wizard using: sudo pathfinder-server -c.

The status of the Pathfinder Server Service can be checked using: sudo systemctl status pathfinder-server.service.

To view an ongoing log use: sudo journalctl -fu pathfinder-server.service can be used.

The service can be manually started, stopped, and restarted using the corresponding command: sudo systemctl start|stop|restart pathfinder-server.service.

Installation directories

To find the installation folders and file locations for the pathfinder-agent, you can use either one the following commands:

whereis pathfinder-server

sudo find / -name pathfinder-server

It's common for software packages to have files in multiple locations on a Linux system. Each directory serves a different purpose:

/usr/bin: This directory typically contains executable binaries. The pathfinder-server binary located here is the main executable file that you run.
/usr/local/etc/: This directory is used for configuration files. The pathfinder-server files here are configuration files that the program uses to determine its settings and behavior.
/usr/share/: This directory is used for architecture-independent data files. The pathfinder-server files here include documentation, icons, or other data files that the program needs to function.

Updating the package

To update Pathfinder Server please install the new package using sudo dpkg -i pathfinder-server_x.x.x.deb and restart the service using sudo systemctl restart pathfinder-server.service.

Uninstalling the package

In order to uninstall Pathfinder Server please remove the package using:

sudo dpkg -P pathfinder-server

Common Problems

“The configured user limit (128) on the number of inotify instances has been reached”

Execute this code in Terminal with sudo permissions.

CODE

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

You may need to reboot.