Server Installation Debian Package

First install the package dependencies:

sudo apt-get update && 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 

Then the package can be installed using the following command:

sudo dpkg -i pathfinder-server_X.X.X.deb

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.

In order to change the database configuration later you can access the wizard using sudo pathfinder-server -c.

The current status of the Pathfinder Server Service can be checked using sudo systemctl status pathfinder-server.service. To view an ongoing log 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.

Updating the package

In order 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 -r pathfinder-server

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.

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

You may need to reboot.