Upgrading the P4 Plan server - Linux

You must have superuser permissions to upgrade the P4 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 P4 Plan Server version for Linux

Wget

Run the following command:

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

2. Back up the database and stop the service

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

Copy 
$ cd [dir]

If you do not know where the P4 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 P4 Plan at this point.

If your server directory name is "HansoftServer" or "HelixPlanServer" you should rename it to "P4PlanServer" and reconfigure the service. For example:

Copy 
sudo HansoftServer/HPMServer -RemoveService
sudo mv HansoftServer P4PlanServer
sudo P4PlanServer/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 NewP4PlanServer.zip

Select [A]ll to replace all old files.

We assume that the binaries are in the P4PlanServer directory. If you changed the directory name, we recommend removing the service, renaming the directory to P4PlanServer, 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 P4 Plan client and make sure you are prompted to upgrade to a new version.