MOPS 4.0 Installation

Installing MOPS 4.0

Installing MOPS 4.0 is done by running the setup script. Some steps you will need to check before running the setup script:

  1. Open an elevated Powershell session and run docker login registry.mopssys.com to login to MOPS container registry. This should be done with a generated token for this specific project. If you do not have a token you should contact MOPSsys support to get one.

  2. Download all containers before running setup by running the script Download-MOPSContainers.ps1 that can be found the tools folder of the deployment package:

    .\tools\Download-MOPSContainers.ps1 -Version v2.1.12 -OS 2022 -IncludeCMS

    This will download all containers required for MOPS 4.0 version 2.1.12, including the CMS container images. If you do not want to include the CMS container images, you can remove the -IncludeCMS parameter. The -OS parameter specifies the Windows Server version, which can be either 2022 or 2025. The -Version parameter specifies the MOPS 4.0 version to download containers for. See Downloading Container Images for more information about downloading container images.

    This step is optional as the setup script is also able to download containers but it is recommended to download them beforehand to reduce setup time.

  3. Run the setup script in an elevated Powershell from the root directory:

    .\tools\setup.ps1

    or with parameters (optional):

    .\tools\setup.ps1 -rootFolder E:\mops -windowsVersion 2022 -registryUser <user> -registryToken <token>

    It can be run with these optional parameters: -rootFolder, -windowsVersion, -registryUser, and -registryToken.

    • rootFolder: Specifies the root folder where MOPS 4.0 will be installed.
    • windowsVersion: Specifies the Windows Server version, which can be either 2022 or 2025.
    • registryUser: Specifies the username for the MOPS container registry.
    • registryToken: Specifies the token for the MOPS container registry.

Setup will check for following requirements:

  1. Setup is running in an elevated Powershell, otherwise you need to restart the script in an elevated session.
  2. Docker and Docker Compose is installed, if not the script will output what is incorrect or missing.
  3. PostgreSQL is installed, if not setup will launch PostgreSQL installation and provide instructions.

Next step in setup is configuration of MOPS 4.0, note that most configuration has default values that will work for setting up a local MOPS 4.0, apply default values by pressing Return.

General Configuration

Property Description Default Value
Docker System Name This value will be used by Docker and is required if you have more than one MOPS 4.0 installed. mops
Application URL The URL application should be accessed on. http://localhost
MOPS 4.0 backend URL MOPS 4.0 engine URL to fetch tag data from. http://localhost:9003
Database port Can be set if running multiple MOPS 4.0. 5434
DNS servers Multiple DNS servers can be set as comma-separated, e.g. ‘192.168.0.1, 127.0.0.11’. Docker DNS

Authentication

Property Description Default Value
Identity Provider name Display name for the Identity Provider that will be shown as the main login option, e.g. ‘Entra ID’, ‘Company Name AD FS’
Identity Provider issuer URL Issuer URL from configured IDP. Azure AD/Entra ID example: https://login.microsoftonline.com/<tenant_id>/v2.0
Identity Provider client/app id Client ID for configured IDP client.

Keycloak

Property Description Default Value
Database server for Keycloak mops4.0-db01
Database port for Keycloak 5432

Initial Administrator

Property Description Default Value
Name Enter full name of the user, for example ‘John Doe’.
Email address Enter email address of the user.

Operation System Configuration

Property Description Default Value
Windows Server Version 2019 or 2022. 2019

After configuration, setup will the installation with instructions for some additional input that is required, such as login to MOPS container registry, Keycloak credentials etc.