This will guide you through the process of updating your existing PortusControl Centre and Server.
The Portus updates are provided via an Eclipse wizard. When you update your Control Centre (the "Base" feature), the updates are applied after the Find and Install process has finished, and the Eclipse IDE restarts.
Your Portus server will not be updated until you re-deploy the server.
It is assumed that the Portus Control Centre has already been installed, as detailed in the respective section of this installation guide.
This section describes how to update the Control Centre and also the server installation kits to a level higher than the one currently installed
There are two ways to do the update
1) If you have Internet Access -
2) If you have been provided with a .zip file containing Portus updates -
If newer versions are found, they will be presented as available, select the item(s) you wish and Click Next and you will be asked to restart eclipse.
If you followed the steps above, you now have successfully updated your Control Centre, and have downloaded the updated server installation files.
From the Portus Deployment Wizard click the "Launch Setup" button. The wizard will check for an existing version and if located, will proceed with the update.
Note: The check for an existing install may take 30+ seconds on some machines that have a large amount of data in the registry.
Once an the wizard has located the install it will display a confirmation dialog. When confirmed the wizard will begin the process of backing up configuration files, updating and restarting the server. The Windows UAC (if enabled) will prompt you for Administrator privileges a number of times during this process.
Note: The server will be unable to restart if the updated server is installed to a different disk to the previous installation. E.g. If an existing server is installed on C: and is uninstalled and reinstalled to D: it will fail. If this occurs a manual restart of the Apache server is required. The server must be stopped then started.
After the process completes return to the control center view and refresh the server.
Note: If you have changed the Portus Windows Service to start as a user other than SYSTEM, you need to run "services.msc" and re-apply this modification
Manual Backup for Failed Install
If the MSI encounters an error during the reinstall process the automated restoration of config files will not complete and a manual backup is required or the data will be lost.
Files will be backed up to the OS default temp directory. The temp directory can be located by clicking start->run and entering %temp% .
Inside this folder you will find the product license file, sampleConfig-win.xml, portusHttpd.conf and portusSSL.conf. Copy these files to a new location (eg. Desktop).
Follow the steps to install a new server. Once the install is complete go to the ProgramData (hidden by default) and copy the 4 files you backed up to this directory.
C:\ProgramData\Portus 4.3.1\configuration
You can run a new Portus server side-by-side with the existing server, so long as the datasets names and the port that the server listens on are different.
Alternatively, you can re-deploy a new server, and simply use the new LOAD library in the STEPLIB of your existing installation.
Follow the instructions here to deploy the updated server.
Follow the instructions here to copy web services between servers.
You can run a new Portus server side-by-side with the existing server, so long as the installation location and server port are different.
Alternatively, you can transfer the updated installation files, and provide the -update option when starting the installServer.sh script.
Follow the instructions here.
Follow the instructions here to copy web services between servers.
If you have updated an existing installation, then the update is now complete.
![]() ![]() |
![]() |
![]() ![]() |