Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

MidPoint Easy Install on Linux

GUIDE:

Info

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:

      Code Block
      wget https://evolveum.com/downloads/midpoint/3.7/midpoint-3.7-dist.tar.gz
      tar -xzf midpoint-3.7-dist.tar.gz
  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.:

      Code Block
      ./Downloads/midpoint-3.7/bin/start.sh

      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:

      Code Block
      ./Downloads/midpoint-3.7/bin/stop.sh

      MidPoint will stop and all your configuration will be saved.

 

MidPoint Easy Install on Windows:

GUIDE:

Info

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.:

      Code Block
      .\Downloads\midpoint-3.7\bin\start.bat

      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:

      Code Block
      .\Downloads\midpoint-3.7\bin\stop.bat

      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

Note that for now it is only for your test purposes

PRE-REQUISITES

Info

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

GUIDE

Info

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.

      Code Block
      docker run -d -p 8080:8080 --name midpoint evolveum/midpoint:latest
    • 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):

      Code Block
      docker rm midpoint

      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:

      Code Block
      docker start midpoint
    • Stop running container:

      Code Block
      docker stop midpoint

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

    • To enter the midPoint container bash use:

      Code Block
      docker exec -it midpoint bash

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.:

      Code Block
      .\Downloads\midpoint-3.7\bin\service.bat install

      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):

      Code Block
      .\Downloads\midpoint-3.7\bin\service.bat uninstall
  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. 

    Info

    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