Installing MidPoint 1.7 "Prometheus" From Binary Distribution

Last modified 22 Apr 2021 17:31 +02:00

Introduction

This page describes the steps required to install midPoint from a binary distribution. This document describes the generic case suitable for trying out midPoint. For more complex installation scenarios please see Installation Guide.

Release Notes
Before you start the installation please 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.

Pre-requisites

Java SE Development Kit 6

The development environment requires JDK 6. Recommended is JDK 6 update 11 or above. Update 4 contains the JAX-WS 2.1 but there are some issues, so we suggest something after update 11 or the latest which you can download at http://java.sun.com/javase/downloads/widget/jdk6.jsp

JAVA_HOME environment variable should point to the JDK 6 installation path.

MySQL Database

Currently midPoint supports only MySQL database. More databases will be supported in later releases.

MySQL can be downloaded from http://www.mysql.com/downloads/mysql/5.1.html. Optionally you can download also MySQL workbench, a GUI interfaces for databases from http://dev.mysql.com/downloads/workbench/5.2.html.

For GNU/Linux, you can also use your distribution packages.

Apache Tomcat

midPoint needs an application server. Currently, Apache Tomcat 6.0.x is supported. More application servers will be supported in later releases.

Apache Tomcat can be downloaded from http://tomcat.apache.org/download-60.cgi. The Apache Tomcat installation directory is further referenced as <tomcat>.

After installation, please copy mysql-connector-java-5.1.X.jar into <tomcat>/lib/ (the "X" stands for MySQL minor version number and may vary).

Hint: For Debian/Ubuntu GNU/Linux distribution, you need to install “libmysql-java” package.

Hint: For RPM-based GNU/Linux distribution, you need to install “mysql-connector-java” package.

Prepare midPoint software

Download

Download the midPoint binary release according to the following table:

MidPoint 1.7 Binary Distribution

https://evolveum.com/downloads/midpoint/1.7/midpoint.war

Initialize Database

Initialize repository database by executing:

Locate appropriate database initialization script from the following location:

Release DB Scripts

Nightly Build

https://svn.evolveum.com/midpoint/trunk/repo/repo-db-impl/src/main/scripts/

Release 1.7

https://svn.evolveum.com/midpoint/tags/1.7-prometheus/repo/repo-db-impl/src/main/scripts/

Execute the script. For MySQL the command is as follows:

mysql -u root < create_openidm_tables_mysql.sql

The script will create schema "midPoint" (replacing existing schema) with default proxy user MIDPOINT\_PROXY and all necessary objects.

Use -f switch if you get drop errors. Use -v switch to watch the progress.

Deploy midPoint

To deploy midPoint WAR file, use the following steps:

  1. Stop Tomcat if it’s already running.

  2. Copy gui/admin-gui/target/idm.war to <tomcat>/webapps directory.

  3. Start Tomcat. It should pick up and deploy the "idm" application.

Test midPoint administration GUI

Log in to the midPoint administration console using the following URL:

Username administrator

Password

secret

A home page of the midPoint console should be displayed. This is a pretty dynamic web application using AJAX for better user interaction. The look&feel is quite minimalistic now, we are working on an improvement just now.

If there is a problem, please check Tomcat logs in <tomcat>/log/catalina.out and <tomcat>/log/idm.log.

For an quick introduction to use of midPoint please follow the instructions on First Steps page.

Download

Download the midPoint binary release according to the following table:

MidPoint 1.7 Binary Distribution

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

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

Start MidPoint

All that remains is to start midPoint server up:

Starting midPoint (Linux)
bin/start.sh
Starting midPoint (Windows)
bin\start.bat

Try MidPoint

Log in to the midPoint administration console using the following URL:

Username

administrator

Password

5ecr3t

User dashboard should be displayed after login. In case of any problems, please check midPoint logs in var/log/ directory.

What To Do Next?

For an quick introduction to use of midPoint please follow the instructions on First Steps page or read through the midPoint book to get familiar with midPoint.

The Stand-Alone Deployment page describes layout of the installation directory.