Important:
The information here is for minor updates, e.g. hotfixes, patches,
etc. For all major updates (e.g new software release), SOA Gateway should be
installed anew, and existing services should be copied using the Control
Centre. See here for more
details.
The following will guide you through the process of updating your existing SOA Gateway Control Centre and Server.
The SOA Gateway 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 SOA Gateway server will not be updated until you re-deploy the server.
It is assumed that the SOA Gateway 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 kit(s) to a level higher than the one currently installed
Eclipse checks a list of available software sites for updates. These sites can be configured by selecting Window -> Preferences -> Install Update -> Available Software Sites.
The SOA Gateway entry in this list needs to be checked for updates to function correctly.
Ask Eclipse to check for updates by selecting Help -> Check for Updates. All currently installed features will be checked.
If you wish to install additional server kits for deployment, use Help -> Install New Software.
If newer versions are found, they will be downloaded 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.
Important:
The SOA Gateway Server has not been changed at this stage. You
need to re-deploy to update the server.
You must uninstall your existing SOA Gateway Server before continuing. The uninstall process will not uninstall your existing dataviews and schemas. You may want to make a backup of your existing configuration, and restore it once the new installation is complete.
Make a backup of %ALLUSERSPROFILE%\Software AG\Adabas SOA Gateway 2.6.1\configuration\sampleConfig-win.xml , %ALLUSERSPROFILE%\Software AG\Adabas SOA Gateway 2.6.1\configuration\asg26.xml and C:\Program Files (x86)\Software AG\SOA Gateway 2.6.1\Apache22\conf
Follow the instructions here to uninstall SOA Gateway
Now restart the SOA Gateway deployment wizard, and follow the normal server installation process. See here for more details
Restore your configuration by putting back the previously saved sampleConfig-win.xml and httpd.conf
Stop and start SOA Gateway, and this completes the update.
If you followed the steps above, you now have successfully updated your Control Centre, and have downloaded the updated server installation files.
Important:
The SOA Gateway Server has not been changed at this stage. You
need to re-deploy to update the server.
You can run a new SOA Gateway 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.
Important:
Ensure you choose new dataset names.
Follow the instructions here to copy web services between servers.
You can run a new SOA Gateway 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.
Important:
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.