Install on Mac OS

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 Mac OS system (Launchd).

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>.darwin-amd64.tar.gz

# gunzip and untar the downloaded file and cd into it
tar -xzvf Mugnsoft-webserver-<version>.darwin-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

# load the service and enable it at startup (Launchd)
sudo launchctl load /Library/LaunchDaemons/MugnsoftWebserver.plist && sudo launchctl enable system/MugnsoftWebserver

# start the service and check its status (Launchd)
sudo launchctl start MugnsoftWebserver && sudo launchctl print system/MugnsoftWebserver

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>.darwin-amd64.tar.gz

# gunzip and untar the downloaded file and cd into it
tar -xzvf Mugnsoft-integrator-<version>.darwin-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

# load the service and enable it at startup (Launchd)
sudo launchctl load /Library/LaunchDaemons/MugnsoftIntegrator.plist && sudo launchctl enable system/MugnsoftIntegrator

# start the service and check its status (Launchd)
sudo launchctl start MugnsoftIntegrator && sudo launchctl print system/MugnsoftIntegrator

Note:

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

Configure and Install Mugnsoft’s Monitor

Monitor’s pre-requisites overview

We need the following pre-requisites for the monitor component:

JRE (usually that’s already installed on the monitor host server)
Mugnsoft IDE plugin for you favorite browser
Browser’s webdriver

Java: JRE or JDK (Mugnsoft’s Monitor component only)

To execute the monitor scenarii on the Monitor component, you will need a JRE (Java Runtime Engine). The minimum recommended version is JRE8+.

Note:

Usually it is already packaged with your OS, so that you have nothing to do. To check the version, simply open a command prompt and type in java -version.

If not, please download it from here and set up its environment variables:

OS	set environment variables
Windows	set JAVA_HOME=`<fullpath-to-jre-or-jdk>` set Path=`<fullpath-to-jre-or-jdk>`\bin;%Path%
Linux/MAC	export JAVA_HOME=`<fullpath-to-jre-or-jdk>` export Path=`<fullpath-to-jre-or-jdk>`\bin:$Path

Install Browser’s Mugnsoft IDE plugin (Mugnsoft’s Monitor component only)

This plugin is open source and is built and maintained by the Selenium community. It allows for automatic Selenium code generation. We will use it to generate the Selenium scenarii to be played by Mugnsoft’s monitor component.

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

Browser’s WebDriver (Mugnsoft’s Monitor component only)

In order to execute the monitor scenarii the Monitor component requires you Browser’s webdriver to be downloaded and put in the drivers folder of your Mugnsoft’s monitor component (usually <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)	-

Note:

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

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>.darwin-amd64.tar.gz

# gunzip and untar the downloaded file and cd into it
tar -xzvf Mugnsoft-monitor-<version>.darwin-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

# load the service and enable it at startup (Launchd)
sudo launchctl load /Library/LaunchDaemons/MugnsoftMonitor.plist && sudo launchctl enable system/MugnsoftMonitor

# start the service and check its status (Launchd)
sudo launchctl start MugnsoftMonitor && sudo launchctl print system/MugnsoftMonitor

Note:

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

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|run]

Install on Windows Folder structure