Keeping track of updates and patches for your WSO2 products can be a very time consuming activity and be honest; do you really check for updates on a regular basis?
With the release of WSO2 Update Manager – WUM – our friends at WSO2 made your job a lot easier by providing continuous access to all bug fixes and improvements for your products!
Since we @ Yenlo love products that make our live easier let’s take a look at WUM and what it can do for you.
To use WUM we need a WSO2 account. If you don’t have an account yet you can register for free here.
Let’s start by downloading WUM. In this tutorial I will make use of a Debian Linux instance but since we are talking about a command line tool the user experience will be similar on other operating systems.
Once downloaded we need to add the installation directory to our PATH environment variable (for Windows and Mac users this will be done by the installer):
We also want to set the location of our local repository:
wum config local.product.repo /home/user/my_wso2_repo
The next step is to setup your WUM installation to access the update repository.
WUM will ask for your WSO2 account credentials and after authentication your WSO2 update manager is ready to go!
At this moment WUM supports the following WSO2 products:
- WSO2 Enterprise Service Bus 5.0.0
- WSO2 Enterprise Service Bus 4.9.0
- WSO2 API Manager runtimes and analytics 2.0.0
- WSO2 Identity Server Analytics 5.2.0
- WSO2 Identity Server 5.2.0
- WSO2 Complex Event Processor 4.2.0
- WSO2 Enterprise Service Bus Analytics 5.0.0
Let’s start with the new enterprise service bus; WSO2 ESB 5.0.0 which has a lot of cool new features. If you’re interested you can read the blogs written by our colleague Thomas here and here.
wum add wso2esb-5.0.0
A fresh ESB in added to your repository and can be found in:
- ~/my_wso2_repo>/<productname>/<productversion>/ wso2esb-5.0.0.zip
For this blog I will assume we have this ESB up and running and it’s time to check for updates.
This command will check for updates for all products in your local repository.
wum check-update wso2esb-5.0.0
If you want to check for updates for specific products simply add the product name behind the check-update command. WUM will check WSO2’s online repository and report back all available updates. To build a package ready for deployment in your environment we run:
wum update wso2esb-5.0.0
This will make WUM download the latest updates and patches for our product. The package will be stored in our local repository:
Additionally, an update summary is sent to your e-mail address:
All we have left to do is unzip the patched archive and copy the updated files to your environment and your WSO2 product is ready for another round!
As you can see WUM is a very easy command line tool to manage your WSO2 product updates and patches and that’s exactly what it does. Since the patches are not “pushed” to your environment you will keep full control over deployment and downloading updates can be safely automated:
In a Linux environment use:
And add the following line:
0 2 * * 1-5 /user/home/wum/bin/wum update wso2esb-5.0.0 > /dev/null 2>&1
This will check for updates on the product wso2esb-5.0.0 every workday at 2:00 AM. If the update is available, it will be downloaded and reported to you by e-mail. Now that’s something to make your life easier!