Installation

To install the server and the server configurator, download the archive corresponding to your operating system and hardware platform architecture and unpack it:

• Windows-x64 (https://monokot.io/download/mos-windows-x64-latest)

• Linux-x64 (https://monokot.io/download/mos-linux-x64-latest)

• Linux-arm (https://monokot.io/download/mos-linux-arm-latest)

• Linux-arm64 (https://monokot.io/download/mos-linux-arm64-latest)

• macOS-x64 (https://monokot.io/download/mos-osx-x64-latest)

Windows

Prerequisites for Windows 7 SP1, ESU:

• KB3063858 (https://www.microsoft.com/en-us/download/details.aspx?id=47442)

• Microsoft Visual C++ 2015–2019 (https://aka.ms/vs/16/release/vc_redist.x64.exe)

Prerequisites for Windows 8.1, Windows Server 2012:

• Microsoft Visual C++ 2015–2019 (https://aka.ms/vs/16/release/vc_redist.x64.exe)

To install the server and the server configurator, please run install.bat as an administrator and follow the instructions. If you are using a firewall, then you need to create rules for ports 9881 and 43043. By default, port 9881 is used for server configuration, and port 43043 is used for OPC UA connections.

Make sure that copying files has not been blocked by antivirus

Linux and macOS

To install the software, open a terminal and run the following commands:

cd path_to_unzipped_files_mos-x.x.x.x-full-platform-arch
sudo bash ./install.sh

rsync is required for successful installation

Enter the administrator password and press Enter then follow the steps suggested by the installation script. To start the server, you need systemd and launchd for Linux and macOS, respectively. Executable files: Monokot Server - server/mosconsole, Monokot Server Administrator - admin/mosadmin (macOS -> admin/Monokot Server Administrator.app/Contents/MacOS/mosadmin).

About Libssl

On fresh Linux distros (such as Ubuntu 22.04.2), the software does not start due to the incompatibility of the libssl library. The solution below is tested on Ubuntu 22.04.2.

If you have already tried to install the software, then first you need to remove it from the computer, to do this, run the following command:

# Default installation folder /opt/Monokot
sudo rm -rf /opt/Monokot

Next, download and install the missing version of libssl, to do this, run the following commands:

# arm
# wget http://ports.ubuntu.com/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5.13_armhf.deb
# sudo dpkg -i libssl1.0.0_1.0.2n-1ubuntu5.13_armhf.deb

# arm64
# wget http://ports.ubuntu.com/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5.13_arm64.deb
# sudo dpkg -i libssl1.0.0_1.0.2n-1ubuntu5.13_arm64.deb

# x64
wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5.13_amd64.deb
sudo dpkg -i libssl1.0.0_1.0.2n-1ubuntu5.13_amd64.deb

and run the installation script again.

About Libicu

To successfully launch Monokot Server Administrator, libicu must be installed (the issue is observed on Ubuntu 23.10). It can be installed using the following commands:

# arm
# wget http://ports.ubuntu.com/pool/main/i/icu/libicu70_70.1-2_armhf.deb
# sudo dpkg -i libicu70_70.1-2_armhf.deb

# arm64
# wget http://ports.ubuntu.com/pool/main/i/icu/libicu70_70.1-2_arm64.deb
# sudo dpkg -i libicu70_70.1-2_arm64.deb

# x64
wget http://en.archive.ubuntu.com/ubuntu/pool/main/i/icu/libicu70_70.1-2_amd64.deb
sudo dpkg -i libicu70_70.1-2_amd64.deb

Firewall

If you are using a firewall, then you need to allow incoming connections.

Linux:

Open a terminal and run the following commands:

sudo iptables -I INPUT -p tcp --dport 9881 -j ACCEPT # 9881 is for configuration
sudo iptables -I INPUT -p tcp --dport 43043 -j ACCEPT # 43043 is for OPC UA clients

macOS:

Apple menu -> System Preferences -> Security & Privacy -> Firewall, click on the + button and select the mosconsole executable file (default directory - /Library/Application Support/Monokot/Monokot Server)