Introducing WSO2 Update Manager (WUM)

WSO2 recently released a tool called WUM (WSO2 Update Manager) with the main goal to provide continuous access to all the fixes and improvements for WSO2 products readily available for all the users. Most importantly, this will make the life easy for most of the first time users of a certain product as they will get all the latest updates for that product instantly, rather than waiting for next release to be available. The product download page also informs users about WUM and how many new updates available for that particular product.

This tool also enables existing users of the products to get all the latest fixes and improvements instantly as and when WSO2 release them.


WUM is a simple command line tool. It is available as installers and as binaries. Currently WUM installers are available for Linux (i586 & x64), Windows (i586 & x64) and MacOSX x64 platforms. You have to download the relevant installers for your OS and install it. The install and uninstall information for each of the installers are also given in the download page. After successfully installing WUM, you have to open a new terminal or cmd window and type “wum” to check and verify the installation. You will see the below output if WUM is successfully installed.


Above are the set of commands provided by WUM. Once you have successfully installed WUM, you have to first initialize it using the “wum init” command. Please note that to use WUM and its commands, you must have a registered account with WSO2. After successfully initializing, then you can tryout other commands provided. The commands are grouped together based on their usage and for ease of explanation as bellow.


Additionally each command has its own help content describing what it does . You can find more comprehensive information about each command from this post by Sameera Jayasoma. I recommend to read this post before proceeding.

A cool thing about WUM is that, once you update a product using the “wum update” command, you will be notified via an email about the new updates that were installed onto your product distribution. This email notification contains important information about the updates that were installed, instruction on the fix added with each update, security updates that were installed, etc. This email will also mention about any configuration changes that were introduced with any of the updates and how to apply them in your environment.

Below is an example email content for a particular product update.


Along with the email, additionally, all the updated information is also stored within the updated distribution under “<updated-product-dist-zip-file>/updates” directory as below.


By using WUM, you will find that it is very easy to get new updates and fixes instantly. Since WUM is command line based and dev-ops friendly, you can setup a cron job like mechanism to run the WUM update periodically so that you will get updates on a regular basis. For example, you can setup the cron job to run for every week which will give you the updates that are cumulatively released during that week by WSO2. Once everything in place, you can completely automate this process using some tools like puppet or chef. You cron is setup to get new updates every-week and when new updates are available, there will be a new updated distribution created and using puppet like tool, you can push this new updated distribution to your staging environment for testing before moving to production environment.

Please stay tuned for more information about how you can automate the process on updating products using WUM and what are the things to consider when applying the updated product to your production environment.

About kishanthan

I’m currently working as a Software Engineer at WSO2, an open source software company. I hold an Engineering degree, majoring in Computer Science & Engineering field, from University of Moratuwa, Sri Lanka.
This entry was posted in WSO2 and tagged , , , . Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s