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:
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
|