Updating your Awingu environment: What to expect from an Awingu version upgrade?

0 users found this article helpful


For instructions on upgrading your Awingu environment, and details about the changes in the Awingu version, please take a look at our release notes.

This article contains important factors to keep in mind/to expect when planning to upgrade Awingu to the latest version.


Upgrade paths

This is a summary of the upgrade paths:


From To Notes
3.6.4, 4.0.1, 4.0.2, 4.0.3, 4.0.4, 4.0.5, 4.0.6, 4.0.7, 4.0.8 4.0.9  
4.0.9, 4.1.1, 4.1.2 4.1.3  
4.1.3, 4.2.2 4.2.3  
4.2.2, 4.2.3 4.3.4  
4.3.3, 4.3.4 5.0.1  
5.0.1, 5.0.2, 5.0.3, 5.0.4, 5.0.5 5.0.6  
5.0.6, 5.1.1 5.1.3 Notes: before upgrading to 5.1.3, it's necessary to migrate the audit logs. If still required, this is visible at the bottom of System Settings > Global > General info.

Mind that the upgrade to 5.1.3 is a long one as it also upgrades the underlying OS.
For an estimate, take 45 minutes per appliance.

5.1.1, 5.1.3, 5.2.0, 5.2.2, 5.2.3 5.2.5  
5.2.4, 5.2.5, 5.3.1, 5.3.2 5.3.3  
5.3.3, 5.4.0, 5.4.2 5.4.4 Note: Mind that the upgrade to 5.4 is a long one as it also upgrades the underlying OS.
For an estimate, take 60 minutes per appliance.
5.4.0, 5.4.2, 5.4.4 5.5.1 (latest version)  

Related info: No upgrades available / latest version not available .


High availability

Since upgrades can take a while, there are some alternative strategies that may work as well.

For example, as of version 5.3, this could be a strategy to minimize downtime. 

  1. Communicate to users that they should not take certain actions until the upgrade has been performed.
    • For example: if they would still share files through Awingu after backing up the environment, this will not be present in the final environment. Once the upgrade is completed, each user would need to "update" their shares to make them work again.
  2. Create an "environment backup".
    • Do mind that it does not include the external database, so this would need to be backed up manually. 
    • Do mind that an environment backup has some limitations (see admin manual). For example, "shares" (files shared through Awingu) are not backed up/restored. After restoring, users will still see their shares, but they will need to press the "Upgrade" button again.
  3. Deploy a new node - this must match the existing Awingu version.
    • When working with an external database, deploy a copy (restore from backup) on the database server.
  4. During the initial configuration wizard, this environment backup can be imported.
    • Make sure to give this new node a new IP address.
    • When using an external database, make sure the configuration no longer points to the original database, but to the copy.
  5. Update this newly deployed node as usual.
  6. In case of a multi-node environment: add new nodes (same version).
  7. Update the applicable network infrastructure (DNS, firewall, load balancer, ...) to point to the IP address(es) of the new appliance(s).
  8. Communicate to users that everything is up and running again.
  9. Shut down the original nodes. Decommission once everything is confirmed to be working smoothly.

Note: there will be some missing audit logs etc. from between the moment of backing up the original database, and the go-live with the new environment.

Was this article helpful?

Tell us how we can improve it.