Upgrading the Helix Plan server - Linux

You must have superuser permissions to upgrade the Helix Plan Server. Before upgrading, make sure you back up the database and stop the service.

1. Download the new server version

Make sure the computer you upgrading the server version on meets the current system requirements.

Web browser

Download the latest Helix Plan Server version for Linux

Wget

Run the following command:

Copy
$ wget -O NewHelixPlanServer.zip https://hansoft.com/downloads/latest-linux-server/

2. Back up the database and stop the service

Go to the location where the Helix Plan server binaries are stored:

Copy
$ cd [dir]

If you do not know where the Helix Plan Server is running, use the following command to find it:

Copy
$ ps -aux | grep HPMServer

Run the following command to back up the database and stop the service:

Copy
$ sudo ./HPMServer -BackupAndStop

This will back up all databases, reset the transaction log, and stop the server. No users can access Helix Plan at this point.

If your server directory name is "HansoftServer" you should rename it to "HelixPlanServer" and reconfigure the service:

Copy
sudo HansoftServer/HPMServer -RemoveService
sudo mv HansoftServer HelixPlanServer
sudo HelixPlanServer/HPMServer -AddService -RunAsUser hansoft -RunAsGroup hansoft
If you were using a different group name and user name before, you should do so now too by replacing the string “hansoft” in this command line with your actual values.

3. Install the new version

Unzip the package into the directory where you installed the old server and overwrite the old files.

Copy
$ unzip NewHelixPlanServer.zip

Select [A]ll to replace all old files.

We assume that the binaries are in the HelixPlanServer directory. If you changed the directory name, we recommend removing the service, renaming the directory to HelixPlanServer, and then add the service again.

4. Upgrade

Run the -Upgrade command through the HPMServer:

Copy
$ sudo ./HPMServer -Upgrade

This will fix file permissions.

5. Start the service

Run the -StartService command through the HPMServer:

Copy
$ sudo ./HPMServer -StartService

6. Validate that the server is running

  • Check the latest log file in the Log directory to make sure the server is listening on the correct port.
  • Log in to the Helix Plan client and make sure you are prompted to upgrade to a new version.