Installation

Prerequisites

Identity Provider

The MOPS 4.0 system is installed with a built-in identity provider that can be used to authenticate users. However, if you want to use an external identity provider such as Microsoft Entra ID (formerly Azure AD) or Active Directory Federation Services (AD FS), you need to configure it before it can be used in MOPS 4.0.

The installation of MOPS 4.0 can be completed without an external identity provider, but it is recommended to set up an identity provider for production systems since using an existing identity provider will reduce administration.

• See Entra ID Configuration Manual for instructions on how to configure Entra ID for MOPS 4.0.
• See AD FS Configuration Manual for instructions on how to configure Active Directory Federation Services (AD FS) for MOPS 4.0.

Docker and Docker Compose Installation

Before installing the MOPS 4.0 system, you need to install Docker and Docker Compose on the server where MOPS 4.0 will be installed. Follow the Docker Installation instructions to complete the docker installation.

Installing PostgreSQL

MOPS 4.0 requires a PostgreSQL database to store data. Please install PostgreSQL using the installer for the version of MOPS 4.0 you’re installing, if no PostgreSQL installer exist use the latest previous MOPS 4.0 version.

When running the installer, make sure to select only the following components:

• pgAdmin 4
• Command Line Tools

Then update system PATH to use PostgreSQL commands:

1. Open the Start menu and search for “environment variables”.
2. Select Edit the system environment variables.
3. In the System Properties dialog, click Environment Variables
4. Under System variables, find and select Path, then click Edit.
5. Click New and add the full path to the PostgreSQL bin directory (e.g. C:\Program Files\PostgreSQL\17\bin).
6. Click OK to save.

This can also be done using Powershell with:

$env:PATH = $env:PATH + ";C:\Program Files\PostgreSQL\17\bin"

Container Registry Access

Obtaining access to the MOPS container registry is required to download the necessary container images for MOPS 4.0. The following steps are required:

1. Contact MOPSsys support to obtain access to the MOPS container registry at registry.mopssys.com. This access is typically provided through a generated token that is specific to your project.

2. Ensure that you have the necessary credentials to log in to the container registry. This can be done by running the following command in an elevated PowerShell session:

   docker login registry.mopssys.com
   

   And, entering the username and token when prompted.

Installing MOPS 4.0

Instruction for installing the core MOPS 4.0 can be found in the MOPS 4.0 Installation manual.

Installing MOPS 4.0 Condition Monitoring System (CMS)

The CMS is an optional module that can be installed after the core MOPS 4.0 system is configured. See the Condition Monitoring System Installation manual for instructions on how to install the CMS module.