Installing MidPoint Server From Distribution Package

Last modified 19 Sep 2024 15:22 +02:00
Table of Contents

This guide that describes how to install midPoint from Evolveum distribution package. MidPoint will be installed as a server, intended for pre-production or production environment. The guide assumes an ordinary server environment, running in a server operating system such as Linux. This is suitable for the installation on a virtual machine or physical hardware.

This guide may be too complex if all you want is just to try midPoint. In that case please see Quickstart guide.

There are also alternative installation methods, such as use of Containers or installing from a source code build.

MidPoint 4.0 and later

This guide applies to midPoint 4.0 and later. For guides that apply to older releases please see the release notes.

Before You Start

There are few things to check before you start the installation:

  • Make sure to see Release Notes for list of environments that are known to work and for the list of known issues in current release.

  • Make sure the System Requirements are met.

  • Make sure you are using a supported version of midPoint. When in doubt, use the latest midPoint release (4.9)

Prerequisites

MidPoint is a Java application, therefore it requires Java platform to run on. Java 21 is a recommended platform for MidPoint 4.9. Alternatively, Java 17 can be used. Other Java platform versions are not supported. Java platform distributions based on OpenJDK are recommended. Other JDK builds (e.g. Oracle) may work as well, but those have limited support for midPoint (see release notes for the details).

JAVA_HOME environment variable should point to the Java installation path.

Download

Download the midPoint binary release according to the following table:

MidPoint 4.9 Binary Distribution

https://evolveum.com/downloads/midpoint/4.9/midpoint-4.9-dist.zip
https://evolveum.com/downloads/midpoint/4.9/midpoint-4.9-dist.tar.gz

Unpack the archive file to a convenient location. Following instructions will refer to the relative paths inside this archive.

Installation

Installing the Files

Copy the files to an installation directory. Following directory locations are recommended:

Operating system Installation directory

Linux and other UNIX systems

/opt/midpoint

Windows

C:\Program Files\midpoint

Following instructions will refer to the relative paths inside the installation directory.

MidPoint Home Directory

MidPoint Home Directory is a filesystem directory that midPoint uses to store initial configuration, cryptographic keys, log files and similar "variable" content. MidPoint home directory is located in the var subdirectory by default (e.g. /opt/midpoint/var). This location is acceptable for many installations. However, some installations may want to separate the static (read-only) parts of the installation and the dynamic (read-write) parts. In that case the midPoint home directory may be moved to any suitable location. This can be achieved simply by setting MIDPOINT_HOME environment variable (on UNIX systems) or manipulating the JVM options. Please see MidPoint Home Directory and Stand-Alone Deployment pages for details.

MidPoint home directory may be moved even after midPoint is installed. However, setting the directory correctly during installation may save a lot of work later on.

MidPoint Repository

MidPoint comes with two repository implementations native PostgreSQL repository (preferred) and generic that supports multiple DB vendors (Oracle, SQL Server, PostgreSQL). Generic repository is deprecated and not recommended for new production deployments.

PostgreSQL database with native repository has to be used for any serious midPoint deployment. Please see native PostgreSQL repository page for installation details.

Post-Installation

Manual Run Control

MidPoint distribution package provides convenient scripts to start and stop midPoint service. Those scripts are located in the bin directory. The purpose of those scripts is to start and stop midPoint manually. Those scripts are not interacting with any service control facility on operating systems (e.g. systemd). Those scripts just start and stop midPoint process.

Linux (UNIX)

Starting midPoint (Linux)
./bin/start.sh
Stopping midPoint (Linux)
./bin/stop.sh

The start.sh and stop.sh scripts are just simple wrappers for midpoint.sh script. The midpoint.sh script is where all the action happens. This script can also be invoked directly:

Using midpoint.sh script (Linux)
./bin/midpoint.sh start
./bin/midpoint.sh stop

The midpoint.sh script will process the script setenv.sh if it exists in the same directory (bin) or in midPoint home directory. The script is a convenient place for customizing JVM properties, for example:

#!/bin/sh
export JAVA_OPTS="$JAVA_OPTS -Dmidpoint.nodeId=My_Node1"

The midpoint.sh script may provide more run control and diagnostics capabilities in the future.

Windows

Starting midPoint (Windows)
bin\start.bat
Stopping midPoint (Windows)
bin\stop.bat

The start.bat and stop.bat scripts are just simple wrappers for midpoint.bat script. The midpoint.bat script is where all the action happens.

The midpoint.bat script will process the script setenv.bat if it exists in the same directory (bin). The script is a convenient place for customizing JVM properties.

Changing keystore password

Do not forget to change initial keystore password!

We strongly recommend to perform this step right after initial startup of midPoint for all non-test environments.

To change the initial keystore password, please follow the change keystore password procedure.

Setting Up a Service

Proper way to run midPoint on a server is to register it to the operating system service control facility. This procedure is inherently dependent on an operating system. Following pages provide specific instruction for individual operating systems:

See Also

Was this page helpful?
YES NO
Thanks for your feedback