Portus Version 2018-08-24
 

Control Centre and Server Update

This will guide you through the process of updating your existing PortusControl Centre and Server.

Note: The information here is for minor updates, e.g. hotfixes, patches, etc. For all major updates (e.g new software release), Portus should be installed anew, and existing services should be copied using the Control Centre. See here for more details.

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.

Using the Eclipse Wizard to find and install updates

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.

Note: The Portus Server has not been changed at this stage. You need to re-deploy to update the server.

Update Server - Windows

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

Update Server - non-Windows Platforms

z/OS

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.

Note: Ensure you choose new dataset names.

Follow the instructions here to copy web services between servers.

*nix Platforms

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.

Note: If you want to create a new installation, ensure you choose a new installation directory, and a server port different from the existing.

Follow the instructions here to copy web services between servers.

If you have updated an existing installation, then the update is now complete.


Ostia
www.ostiasolutions.com
Copyright @ 2006-2018 Ostia Software Solutions Limited.