Skip to end of metadata
Go to start of metadata

Introduction

This part describes the steps required to deploy midPoint Identity and Access Management from a binary distribution. MidPoint is a Java web application distributed in a form of WAR archive. All that is essentially needed is to run suitable script. This guide provides instructions to run midPoint using Spring Boot and also Docker container.

Spring Boot feature is available from MidPoint version 3.7.

You can run midPoint from linux based environment and also from Windows environment.

PRE-REQUISITES

 Java SE Development Kit 8

The development environment requires at least JDK 8. You can use OpenJDK wich might be already installed on your system of you can download JDK from Oracle.

JAVA_HOME environment variable should point to the JDK installation path.

JAVA 7 is not supported anymore

MidPoint Easy Install on Linux

GUIDE:

To run midPoint in Linux environment please follow these 2 simple steps:

  1. Download midPoint 3.7 binary

    1. Download the midPoint binary release according to the following table:

      ReleaseDownload

      Release 3.7

      Binary Distribution

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

      Unpack the archive file to a convenient location.

       

    2. open your terminal, download midPoint and unzip it to your local directory using commands:

  2. Deploy midPoint

               MidPoint application is deployed by using the midpoint.war file located in the lib subdirectory of the distribution archive. To deploy midPoint WAR file use the following step:

    1. Execute start.sh script form /midpoint-3.7/bin directory e.g.:

      This will run starting process in background and create midPoint home directory in /midpoint-3.7/var

      MidPoint home directory will be used to store your custom connector code, schemas, initial configuration and may also contains other files. MidPoint will populate that directory on the first start. The directory will not be overwritten when midPoint is restarted or redeployed.

    2. For stopping midPoint just run stop.sh script e.g:

      MidPoint will stop and all your configuration will be saved.

 

MidPoint Easy Install on Windows:

GUIDE:

To run midPoint in Windows environment please follow these 2 simple steps:

  1. Download midPoint 3.7 binary

    1. Download the midPoint binary release according to the following table

      ReleaseDownload

      Release 3.7

      Binary Distribution

      https://evolveum.com/downloads/midpoint/3.7/midpoint-3.7-dist.zip

      Unpack the archive file to a convenient location.

  2. Deploy midPoint

    MidPoint application is deployed by using the midpoint.war file located in the lib subdirectory of the distribution archive. To deploy midPoint WAR file use the following step:
    1. Execute start.bat script form \midpoint-3.7\bin directory e.g.:

      This will run starting process in background and create midPoint home directory in \midpoint-3.7\var

      MidPoint home directory will be used to store your custom connector code, schemas, initial configuration and may also contains other files. MidPoint will populate that directory on the first start. The directory will not be overwritten when midPoint is restarted or redeployed.

    2. For stopping midPoint just run stop.sh script e.g:

      MidPoint will stop and all your configuration will be saved.

MidPoint Easy Install using Docker

You can deploy midPoint in both Linux and Windows environment. All you need is to have installed Docker.

Note that for now it is only for your test purposes

PRE-REQUISITES

If you already have installed docker just continue to the section GUIDE

GUIDE

To run midPoint in Docker container please follow these 2 simple steps:

  1. Create container:

    • Open your console and execute command below. This command will create container from downloaded midPoint image and run that container. If your docker does not contain a midpoint image yet, command will look for it on DockerHub and download it.

    • You can also delete midPoint container and create it again but please note that this will erase your configuration in midPoint. For deleting midPoint container run command below (You have to stop container before removing it or use -f option for force removing):

      If it is not necessary do not remove midPoint container.

  2. Start and Stop container

    Once you have your container created use start and stop commands for starting and stopping it.
    • Start not running container:

    • Stop running container:

      Stop command will save your configuration until you remove midPoint container. 

    • To enter the midPoint container bash use:

MidPoint as Windows service

You can install MidPoint as windows service using Procrun which will wrap MidPoint and install it as windows service. Service will automatically starts when machine boots and will continue to run with no user logged onto the machine. To accomplish that please just follow simple steps bellow.

  1. Download midPoint 3.7 binary

    1. Download the midPoint binary release according to the following table

      ReleaseDownload

      Release 3.7

      Binary Distribution

      https://evolveum.com/downloads/midpoint/3.7/midpoint-3.7-dist.zip

      Unpack the archive file to a convenient location.

  2. Install MidPoint as windows service

    midpoint.exe located in \bin directory is application that will convert MidPoint into service. It's called by service.bat file which will set type of operation and also all necessary parameters for running MidPoint as a service.

    1. For installing MidPoint as service execute service.bat script from \midpoint-3.7\bin directory with install argument e.g.:

      Now is MidPoint installed as service and you can see it among other services in windows Services application.

    2. For uninstalling MidPoint service execute service.bat script from \midpoint-3.7\bin directory with uninstall argument e.g. (Stop the service before uninstallation):

  3. Start and Stop service

    Another binares midpointw.exe, is GUI application which is used to monitor and configure created MidPoint service. Main function of this application is to Start and Stop MidPoint service. Run this application located in \bin directory and Start/Stop MidPoint by click on start/stop. 

    You can also start/stop service with windows Services application.


Post-Installation Steps

Open your web browser and enter: http://localhost:8080/midpoint

 Now you can login into the midpoint with credentials: 

Usernameadministrator
Password5ecr3t

 

 

 

 

 

 

 

 

 

 

 

 

 

  • No labels