In this blog I’m going to describe a generic way of installing the WSO2 Enterprise Integrator on your Windows machine. Why generic? Well, simply because although the versions of the Enterprise Integrator may change, the installation procedure for the Enterprise Integrator – and in general all WSO2 products – is pretty much the same. I am going to describe a situation where we install as little as possible and also not make lasting changes to the PC. We can surely also run in VirtualBox with Vagrant but that would require additional installations which I would like to avoid.
Hardware and OS
So, what do we need, what do we need? Well, first of all, a Windows PC. Although other operating systems will also work (e.g. Linux) they require a different setup, and this blog is about installation on Windows. And to be more specific: Windows 10.
Microsoft’s strategy to push Windows 10 into the market with free updates has surely worked with more than 1 billion devices running Windows 10. However, the older versions will probably also work. As far as the hardware goes, let’s say that we need a modern PC meaning Intel Core I3, i5, I7 or equivalent chips from AMD, 8 gigabytes of Ram and all the other things that you expect from a modern-day PC.
Java
For the large part, WSO2 is written in Java and therefore a JDK or JRE is needed. These supply the environment that is needed to run WSO2. There are a number of Java versions, numbered from 1 to 18 at the moment. However, WSO2 requires either Java 8 or 11. When we consider the Enterprise Integrator, Java 8 is a good choice since it will accommodate older versions of the Enterprise Integrator. If you are sticking with, for instance, Enterprise Integrator 6.6.0, Java 11 works. As far as the distribution, Adopt OpenJDK is ok, but others also work.
Let’s start by downloading Adopt OpenJDK 11 from this URL (Java 8 can be found here as well). We will use the zip file rather than the installer (MSI). Make sure you have the right version, i.e. x64.
WSO2
For this blog I am going to use the Apache 2.0 version of the Enterprise Integrator. This version can freely be used as described in the license, but it is not suited for use in a production environment.
I will download the version directly from the WSO2 GitHub page for Enterprise Integrator. Please download both files, wso2am-6.6.0.zip. It is a good idea to also download the MD5 checksum (wso2am-6.6.0.zip.md5) to verify the download. When you calculate the checksum on your PC, it should match the one you downloaded. The Analytics for Enterprise Integrator is part of the download and does not need to be downloaded separately.
Open a CMD window and type the following command.
CertUtil -hashfile <path to file> MD5
Change the <path to file> to the actual path and file location.
Compare this to the MD5 filewso2ei-6.6.0.zip: A4 7A 00 E2 EA 72 2A 91 C3 62 69 60 06 7C E6 33. The only difference is lower/uppercase. Repeat for the Analytics zip as well.
Creating a directory
Create a directory on, for instance, the desktop using File Explorer. Call it WSO2-AM, for instance.
Copy the three downloaded files (JDK and EI) to that directory. Unzip each zip. You will end up with this:
I do not want to change any environment variables or path settings so I am going to create a batch file that will set the required variables like:
- JAVA_HOME
- PATH
This change is only for the duration of the batch file.
But first we need to enable the Analytics in the WSO2 Enterprise Integrator. This is done by changing the carbon.xml file in [EI-HOME]/conf.
Search for Analytics and validate the settings:
Go to synapse.properties file in [EI-HOME]/conf and set these values to true. Save the file.
We now have enabled Analytics.
Starting everything
The batch file looks something like this. This will set the parameters JAVA_HOME and PATH for the duration of the batch file and command window. Change the location (i.e. C:\Users…) to match your local installation.
@set OLDPATH=%PATH%
@set OLDJH=%JAVA_HOME%
@echo Setting JAVA_HOME
@SET "JAVA_HOME=C:\Users\rob\Desktop\WSO2-EI\jdk-11.0.11+9"
@echo JAVA_HOME: %JAVA_HOME%
@echo Setting PATH
@SET "PATH=C:\Users\rob\Desktop\WSO2-EI\jdk-11.0.11+9\bin;%PATH%"
@echo PATH: %PATH%
@echo starting WSO2 AM Analytics Worker Node
@cd C:\Users\rob\Desktop\WSO2-EI\wso2ei-6.6.0\wso2\analytics\bin
@start worker.bat
@echo starting WSO2 AM Analytics Dashboard Node
@cd C:\Users\rob\Desktop\WSO2-EI\wso2ei-6.6.0\wso2\analytics\bin
@start dashboard.bat
@echo starting WSO2 AM 6.6.0
@cd C:\Users\rob\Desktop\WSO2-EI\wso2ei-6.6.0\bin
@start integrator.bat
@cd ..\..
@set PATH=%OLDPATH%
@set JAVA_HOME=%OLDJH%
@echo DoneResult
This will start the worker, dashboard and Enterprise Integrator in three separate windows whilst not making permanent changes to the computer, only for the duration of the command / terminal session the values have changed but also set to their original values. You can access the Enterprise Integrator via the Management UI in your browser. This is the link to the Analytics Dashboard (https://localhost:9643/portal).
Conclusion
This is a simple and non intrusive way to install the WSO2 Enterprise Integrator and Analytics on your PC. If you were to fully automate the setup with PowerShell, you could create a simple batch file that you could run whenever you need a setup on your PC.
If you want to learn more about Enterprise Integrator, please take a look at our Yenlo training pages.
