Install on Linux

This page explains how to install Mugnsoft components. It provides the download link and the procedure to get your Mugnsoft services up and running on your Debian/Ubuntu, Red Hat/CentOS system (systemd | Upstart | SysV).

Note:

Note: You need root privileges to install the Mugnsoft components.

Configure and Install Mugnsoft’s Webserver

Configure and Install Mugnsoft’s Webserver from .tar.gz file


# download the tar.gz file by specifying the version you want
wget https://mugnsoft.com/bin/<version>/mugnsoft-webserver-<version>.linux-amd64.tar.gz

# gunzip and untar the downloaded file and cd into it
tar -xzvf mugnsoft-webserver-<version>.linux-amd64.tar.gz && cd webserver

# update the API and WEB port in the webserver.json file
vi webserver.json

# proceed with the installation as a service daemon
chmod +x ./webserver && sudo ./webserver install

# start the service and check its status (systemd)
sudo systemctl start mugnsoftWebserver && sudo systemctl status mugnsoftWebserver

# enable the service at startup (systemd)
sudo systemctl enable mugnsoftWebserver && sudo systemctl daemon-reload

Note:

You can now connect to the webserver’s web server: open your browser and go to (https://localhost:9090/ where 9090 is the port defined in your webserver.json file).

Configure and Install Mugnsoft’s Integrator

Configure and Install Mugnsoft’s Integrator from .tar.gz file


# download the tar.gz file by specifying the version you want
wget https://mugnsoft.com/bin/<version>/mugnsoft-integrator-<version>.linux-amd64.tar.gz

# gunzip and untar the downloaded file and cd into it
tar -xzvf mugnsoft-integrator-<version>.linux-amd64.tar.gz && cd integrator

# update the API and WEB port in the integrator.json file
vi integrator.json

# proceed with the installation as a service daemon
chmod +x ./integrator && sudo ./integrator install

# start the service and check its status (systemd)
sudo systemctl start mugnsoftIntegrator && sudo systemctl status mugnsoftIntegrator

# enable the service at startup (systemd)
sudo systemctl enable mugnsoftIntegrator && sudo systemctl daemon-reload

Note:

You can now enable that integrator from the Mugnsoft’s webserver components list: open your browser and go to (https://localhost:9090/web/html/layout.html#/server where 9090 is the webserver port).

Configure and Install Mugnsoft’s Monitor

At startup the monitor component will autmatically look for his host version of web browsers and download the related webdrivers. To do so the probe will need access to the following webdriver website:

Note:

Note: Access to the above three webdriver’s websites are not mandatory as you can manually download the webdrivers and put them in the drivers folder of your Mugnsoft’s monitor component (<monitor_installDir\drivers>).

Browser webdriver webdriver download URL
Chrome Chromedriver You can download them here
Firefox Geckodriver You can download them here
Edge msedgedriver You can download them here
Safari Built-in (no webdriver required) -

Always download the browser driver that matches your browser version. Using mismatched version would result in a error during runtime.

Install Browser extension’s Mugnsoft IDE plugin (for automatic code generation)

This plugin allows for automatic code generation. We will use it to generate the Mugnsoft scenarios to be played by Mugnsoft’s monitor component.
Check Mugnsoft IDE documentation: here

Browser plugin URL
Chrome You can install it from here
Firefox You can install it from here

Configure and Install Mugnsoft’s Monitor from .tar.gz file

Now that the pre-requisite have been fullfilled, we can proceed with the same installation as the other components.


# download the tar.gz file by specifying the version you want
wget https://mugnsoft.com/bin/<version>/mugnsoft-monitor-<version>.linux-amd64.tar.gz

# gunzip and untar the downloaded file and cd into it
tar -xzvf mugnsoft-monitor-<version>.linux-amd64.tar.gz && cd monitor

# update the API and WEB port in the monitor.json file
vi monitor.json

# proceed with the installation as a service daemon
chmod +x ./monitor && sudo ./monitor install

# start the service and check its status (systemd)
sudo systemctl start mugnsoftMonitor && sudo systemctl status mugnsoftMonitor

# enable the service at startup (systemd)
sudo systemctl enable mugnsoftMonitor && sudo systemctl daemon-reload

Note:

You can now enable that monitor from the Mugnsoft’s webserver components list: open your browser and go to (https://localhost:9090/web/html/layout.html#/server where 9090 is the webserver port).

Note for all the components:

Each component can be started as the daemon service from the binary itself or be run as a process:


sudo [webserver|monitor|integrator] [start|stop|restart|run]