

Installing WSO2 Micro Integrator on a VM¶

Follow the steps given below to install and run WSO2 Micro Integrator on a VM.

Installing WSO2 Micro Integrator¶

Follow the steps below:

Go to the WSO2 Enterprise Integrator product page and click Download -> Previous Versions to get the EI 7.0.2 version.

Note

The latest version of WSO2 Enterprise Integrator (EI 7.1.0) is now released. See the installation guide of the latest EI documentation.

You can download the product installer (which is compatible with your operating system) or the binary.
If you used the installer, double-click to open the installation wizard, which will guide you through the installation. When you finish, the product will be installed and ready for use.

Accessing the HOME directory¶

Let's call the installation location of your product the MI_HOME directory.

If you used the installer to install the product, this is located in a place specific to your OS as shown below:

OS	Home directory
Mac OS	`/Library/WSO2/EnterpriseIntegrator/7.0.2/micro-integrator`
Windows	`C:\Program Files\WSO2\Enterprise Integrator\7.0.2\micro-integrator`
Ubuntu	`/usr/lib/wso2/wso2ei/7.0.2/micro-integrator`
CentOS	`/usr/lib64/wso2/wso2ei/7.0.2/micro-integrator`

Uninstalling the product¶

If you used the installer to install the product, you can uninstall by following the steps given below:

OS	Instructions
Mac OS	Open a terminal and run the following command as the root user: `sudo bash /Library/WSO2/EnterpriseIntegrator/7.0.2/uninstall.sh`
Windows	Go to Start Menu -> Programs -> WSO2 -> Uninstall Enterprise Integrator 7.0.2 or search Uninstall Enterprise Integrator 7.0.2 and click the shortcut icon. This will uninstall the product from your computer.
Ubuntu	Open a terminal and run the following command: `sudo apt purge wso2ei-7.0.2`
CentOS	Open a terminal and run the following command: `sudo yum remove wso2ei-7.0.2`

Running the Micro Integrator¶

Start WSO2 Micro Integrator by following the instructions given below.

Using the installer¶

On MacOS/Linux/CentOS, open a terminal and execute the command given below.
```
sudo wso2mi
```
The operation log keeps running until the integrator starts, which usually takes several seconds. Wait until the profile fully boots up and displays a message similar to " WSO2 Carbon started in n seconds. "
On Windows, go to Start Menu -> Programs -> WSO2 -> Enterprise Integrator 7.0.2 Micro Integrator. This will open a terminal and start the relevant profile.

If you have installed the product using the installer and you want to manually run the product startup script from the MI_HOME/bin directory, you need to use the following command:

sudo sh launcher_micro-integrator.sh

This script automatically assigns the JAVA HOME of your VM to the root user of your Micro Integrator instance.

Using the binary distribution¶

Before you execute the product startup script, be sure to set the JAVA HOME in your machine. Use a JDK that is compatible with WSO2 Enterprise Integrator.
Open a terminal and navigate to the MI_HOME/bin/ directory, where MI_HOME is the home directory of the distribution you downloaded.
Execute the relevant command:
- On MacOS/Linux/CentOS:
```
sh micro-integrator.sh
```
- On Windows:
```
micro-integrator.bat
```

By default, the HTTP listener port is 8290 and the default HTTPS listener port is 8253.

Stopping the Micro Integrator¶

To stop the Micro Integrator runtime, press Ctrl+C in the command window.

Top