Skip to content

Installing via the Installer

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

Download and install

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

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:

    sudo wso2mi-service start
    sudo service wso2mi start
    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:

    sudo wso2mi-service stop
    sudo service wso2mi stop
    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:

    sudo wso2mi-dashboard-service start
    sudo service wso2mi-dashboard start
    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:

    sudo wso2mi-dashboard-service stop
    sudo service wso2mi-dashboard stop
    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