Loading ...

OpenWGA 7.1 - Updating to OpenWGA 7.1

Doing the update

Installations from the linux installer

The linux installer installed two components to your server, the actual OpenWGA server plus the Apache Tomcat Server it resides on.

Only update OpenWGA

If you have an OpenWGA CMS server running, which has been setup with the Linux-Installer for non-debian distributions, you can perform the following steps to update your installation to the latest OpenWGA CMS version:

openwga:/# /etc/init.d/tomcat stop

  • Rename the currently installed war archive in order to allow a downgrade to the previous version if necessary, for example to 'ROOT.war.last' (but always to a name that does not have the .war suffix to prevent it from being deployed!):

openwga:/# mv /opt/tomcat/webapps/ROOT.war /opt/tomcat/webapps/ROOT.war.last

  • Copy the downloaded war file into '/opt/tomcat/webapps' and rename it to 'ROOT.war':

openwga:/opt/tomcat/webapps# mv /root/openwga-7.0.4-ce.war /opt/tomcat/webapps/ROOT.war

  • Remove the unpacked OpenWGA version and the corresponding working directory:

openwga:/# rm -r /opt/tomcat/webapps/ROOT
openwga:/# rm -r /opt/tomcat/work/Catalina

  • Start tomcat:

openwga:/# /etc/init.d/tomcat start

Reinstall OpenWGA from scratch

For performing a reinstall you should

  1. Have a good understanding of bash scripts and the Tomcat configuration files in "/opt/tomcat/conf"
  2. Have an overview about was has been altered in "/etc/tomcat.conf" and the Tomcat configuration files "/opt/tomcat/conf" from the vanilla installation

Follow these steps to reinstall OpenWGA while keeping all existing configuration and connections:

  • Shutdown OpenWGA server
  • Create a copy of the complete configuration directory "/opt/wga" at a safe place
  • Also create a safe copy of the following files and folders:
    • The "/opt/tomcat/conf" folder, which may contain altered Tomcat configuration
    • The "/etc/tomcat.conf" file which may contain altered startup parameters
  • Delete all files of your OpenWGA installation
    • /opt/tomcat (folder)
    • /opt/wga (folder)
    • /etc/init.d/tomcat (file)
    • /etc/tomcat.conf (file)
  • Download the new OpenWGA linux installer from the openwga.com homepage
  • Install OpenWGA using the instructions from our homepage, but do not yet start the server
  • Move the whole default contents of the "/opt/wga" folder which was recreated by the installer to some safe copy place (just for precaution purposes, so you have a later reference what would have been installed for this new OpenWGA version)
  • Copy the whole contents of your saved OpenWGA configuration directory from the previous installation to the now empty "/opt/wga"
  • Manually migrate settings from your saved "/etc/tomcat.conf" from the previous installation into the newly created "/etc/tomcat.conf"
  • Manually migrate settings from the config files in saved folder "/opt/tomcat/conf" from the previous installation into the newly created "/opt/tomcat/conf"
  • Start the server
  • Have a look at problems and errors in application log in OpenWGA admin client to see what other resources may need to be re-setup