

Installing via the Installer¶

Follow the steps given below to install the WSO2 Micro Integrator runtime and its monitoring Dashboard.

Download and install¶

You can refer to the following video to get a quick understanding of how this is done.

Go to the WSO2 Enterprise Integrator product page, click Download, and then click the Installer.

The product installer that is compatible with your operating system will be downloaded.

Double-click to open the installation wizard, which will guide you through the installation. When you finish, all the runtimes of WSO2 Enterprise Integrator will be installed and ready for use.

Running the MI server¶

If you installed the product using the installer, use the following instructions to start and stop the MI server.

Starting the MI server¶

You can refer to the following video to get a quick understanding of how this is done.

On MacOS/Linux/CentOS, open a terminal and execute one of the commands given below.

To start the Micro Integrator as a standalone application:
```
sudo wso2mi
```

To start the Micro Integrator as a service:

On MacOS

sudo wso2mi-service start

On Linux

sudo service wso2mi start

On Centos

sudo wso2mi start

On Windows

Go to Start Menu -> WSO2 -> Enterprise Integrator 7.1.0 Micro Integrator. This will open a terminal and start the Micro Integrator.

Tip

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.

Stopping the MI server¶

To stop the Micro Integrator standalone application, go to the terminal and press Ctrl+C.

To stop the Micro Integrator service:

On MacOS

sudo wso2mi-service stop

On Linux

sudo service wso2mi stop

On CentOS

sudo wso2mi stop

Running the MI dashboard¶

If you installed the product using the installer, use the following instructions to start and stop the Micro Integrator dashboard.

Starting the dashboard server¶

On MacOS/Linux/CentOS, open a terminal and execute one of the commands given below.

To start the dashboard as a standalone application:
```
sudo wso2mi-dashboard
```

To start the dashboard as a service:

On MacOS

sudo wso2mi-dashboard-service start

On Linux

sudo service wso2mi-dashboard start

On CentOS

sudo wso2mi-dashboard start

On Windows

Go to Start Menu -> WSO2 -> Enterprise Integrator 7.1.0 Micro Integrator Monitoring Dashboard. This will open a terminal and start the dashboard.

Accessing the dashboard¶

Once you have started the dashboard server, you can access the dashboard using the following URL:

https://localhost:9743/dashboard

Warning

In a non-production environment (with the self-signed certificate), you have to add the certificate of the micro integrator instance to the browser as a trusted source. For example, direct the browser to https://localhost:9164/management and add the site as trusted. This step will not be required with a custom production certificate.
We have identified issues with the Microsoft Edge browser, which prompts trusting the management URL (with the self-signed certificate) in a loop. Please try trusting the management URL in the same tab if you face this issue. If the issue still persists, consider switching the browser.

See the Micro Integrator Dashboard documentation for information on how to sign in and use the dashboard.

Stopping the dashboard server¶

To stop the dashboard standalone application, go to the terminal and press Ctrl+C.

To stop the dashboard service:

On MacOS

sudo wso2mi-dashboard-service stop

On Linux

sudo service wso2mi-dashboard stop

On CentOS

sudo wso2mi-dashboard stop

Accessing the HOME directory¶

MI_HOME¶

MI_HOME is the installation location of the Micro Integrator runtime. When you use the installer, the MI_HOME is located in a place specific to your OS as shown below:

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

DASHBOARD_HOME¶

DASHBOARD_HOME is the installation location of the Micro Integrator dashboard. When you use the installer, the DASHBOARD_HOME is located in a place specific to your OS as shown below:

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

Uninstalling the product¶

If you used the installer to install WSO2 Enterprise Integrator, 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/wso2ei/7.1.0/uninstall.sh`
Windows	Go to Start Menu -> WSO2 -> Uninstall Enterprise Integrator 7.1.0 or search Uninstall Enterprise Integrator 7.1.0 and click the shortcut icon. This will uninstall the product from your computer.
Linux	Open a terminal and run the following command: `sudo dpkg --purge wso2ei-7.1.0`
CentOS	Open a terminal and run the following command: `sudo rpm -e wso2ei-7.1.0-1.el7.x86_64`

Top