Updating a Bridge
Before upgrading your Bridge installation to Bridge 7, please consult our Bridge 7 Migration Guide. It explains important prerequisites concerning
software versions
license handling
Bridge Certificates
service repositories and the Builder / Compiler
Node.js and REST services
Additionally, it features a migration checklist to guide you through all necessary tasks.
To update a Bridge® using an installer, there are two standard update routines available:
Guided update with a GUI (see Guided Update of the Bridge with GUI)
GUI-less update (see Updating a Gui-less Installation of the Bridge)
Preliminary Notes
Bridge 7: The Bridge installer will check your Bridge license. When updating a Bridge to a new version (e.g. Bridge 6 to Bridge 7), you need to apply the new license before updating the system. Otherwise the installer will complain about a license mismatch: "Your current license version '<your old version>' is not valid for upgrading to Bridge version '<target version>'. Please update the license first and run the update installation again."
As of Bridge 7, the Bridge uses Apache 2.4. You can find information on behavior changes on the Apache pages.
If you have modified the Apache configuration as described on Configuring the Proxy, you may need to apply your changes to the new Apache templates that have been provided with the update. Please refer to the mentioned page for more information.
The Bridge Installer overwrites file server.xml upon updating the BRIDGE. The old server.xml is copied to server.xml.old. If you changed the server.xml of your Bridge installation (to e.g. apply an individual Tomcat configuration), you can re-apply your changes from the copy.
But please note, that there will be only one copy of server.xml: server.xml.old will get overwritten on every update.
Bridge 7: If you are updating an older installation (e.g. Bridge 6), your Bridge and/or proxy certificate might still use the MD5 algorithm. This algorithm is insecure and deprecated and is not accepted by Bridge 7 installations anymore.
Before updating your Bridge, make sure that both certificates are using a secure algorithm, e.g. SHA256. How to update the certificates is described on Managing the Bridge Certificate and Managing Bridge Proxy Server Certificates pp.
When updating the Bridge, all deployed services (xUML, Node.js, and Java services) will be kept. However, the automatic startup option will be ignored on the very first start-up after the update.