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://dl.mugnsoft.com/release/<version>/mugnsoft-webserver-<version>.linux-amd64.tar.gz
# start **optional** : perform these steps to make sure the binaries have not been tampered
# #download signature digest
wget https://dl.mugnsoft.com/release/<version>/mugnsoft-webserver-<version>.linux-amd64.tar.gz.sig
# #download Mugnsoft's GPG public key
wget https://dl.mugnsoft.com/release/Mugnsoft_public.key
# #import Mugnsoft's GPG public key
gpg --import Mugnsoft_public.key
# #check binaries integrity against the Mugnsoft's GPG public key
gpg --verify mugnsoft-webserver-<version>.linux-amd64.tar.gz.sig mugnsoft-webserver-<version>.linux-amd64.tar.gz
# end **optional**
# 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 (http://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://dl.mugnsoft.com/release/<version>/mugnsoft-integrator-<version>.linux-amd64.tar.gz
# start **optional** : perform these steps to make sure the binaries have not been tampered
# #download signature digest
wget https://dl.mugnsoft.com/release/<version>/mugnsoft-integrator-<version>.linux-amd64.tar.gz.sig
# #download Mugnsoft's GPG public key
wget https://dl.mugnsoft.com/release/Mugnsoft_public.key
# #import Mugnsoft's GPG public key
gpg --import Mugnsoft_public.key
# #check binaries integrity against the Mugnsoft's GPG public key
gpg --verify mugnsoft-integrator-<version>.linux-amd64.tar.gz.sig mugnsoft-integrator-<version>.linux-amd64.tar.gz
# end **optional**
# 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
Configure and Install Mugnsoft’s Monitor
At startup the monitor component will autmatically look for its host version of web browsers and download the related webdrivers. To do so the probe will need access to the following webdriver website:
- https://chromedriver.chromium.org/downloads
- https://github.com/mozilla/geckodriver/releases/
- https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/
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’s Mugnsoft IDE plugin (OPTIONAL)
This plugin allows for automatic Selenium code generation. We will use it to generate the Selenium scenarii to be played by Mugnsoft’s monitor component.
Here is the link to Mugnsoft IDE’s 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://dl.mugnsoft.com/release/<version>/mugnsoft-monitor-<version>.linux-amd64.tar.gz
# start **optional** : perform these steps to make sure the binaries have not been tampered
# #download signature digest
wget https://dl.mugnsoft.com/release/<version>/mugnsoft-monitor-<version>.linux-amd64.tar.gz.sig
# #download Mugnsoft's GPG public key
wget https://dl.mugnsoft.com/release/Mugnsoft_public.key
# #import Mugnsoft's GPG public key
gpg --import Mugnsoft_public.key
# #check binaries integrity against the Mugnsoft's GPG public key
gpg --verify mugnsoft-monitor-<version>.linux-amd64.tar.gz.sig mugnsoft-monitor-<version>.linux-amd64.tar.gz
# end **optional**
# 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 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] run