MDM Example Project
The following guide shows you how to install and run the latest MDM example project on Windows.
Download Postgres and Keycloak Plugins
For ONE MDM on Windows, Postgres and Keycloak plugins have been provided in order to easily deploy the modules, specifically for the purpose of running the MDM Tutorial.
The plugins are intended for demonstration purposes only and are not meant for production environment. By using these, you are accepting Keycloak and PostgreSQL licenses. Also keep in mind that the third-party software used in the plugins might not be up-to-date and might therefore pose a security risk. |
Download the following packages:
Package |
---|
Download Builds
Download the corresponding build packages of MDM, MDM Server and ONE Desktop from the Downloads page.
Extract Packages
-
After unpacking ONE Desktop, in File Explorer create the following folders:
-
mdm
-
mdm-server
-
keycloak
-
pgsql
-
-
Extract the downloaded packages to these folders, as follows:
-
mdm-assembly-xxxxx.zip
tomdm
-
mdm-server-assembly-xxxxx.zip
tomdm-server
-
keycloak-x.x.x-x-demo.zip
tokeycloak
-
pgsql-xxx.zip
topgsql
Your folder structure should now look like this:
-
This step is necessary when running the example projects to ensure the scripts in Files > bin work without issues. |
-
Replace
start-keycloak.bat
,start-keycloak.sh
,stop-keycloak.bat
,stop-keycloak.sh
in theFiles/bin
folder with the following scripts:-
start-keycloak.bat
@echo off set KEYCLOAK_HOME=%DQC_HOME%\..\keycloak cd "%KEYCLOAK_HOME%" start "KeycloakDemoWindow" cmd /C call scripts\start-demo.bat start
-
start-keycloak.sh
#!/bin/bash export DQC_HOME=${DQC_HOME:-`readlink -f ../../../../runtime`} export KEYCLOAK_HOME="$DQC_HOME/../keycloak" cd "$KEYCLOAK_HOME" ./scripts/start-demo.sh start
-
stop-keycloak.bat
@echo off taskkill /FI "WindowTitle eq KeycloakDemoWindow"
-
stop-keycloak.sh
#!/bin/bash export DQC_HOME=${DQC_HOME:-`readlink -f ../../../../runtime`} export KEYCLOAK_HOME="$DQC_HOME/../keycloak" cd "$KEYCLOAK_HOME" export KC_PID=`cat ./keycloak.pid` kill "$KC_PID"
-
-
Open
Files/etc/issue_management/config.xml
and change the<clientSecret>
value tomdm-admin-client-s3cret
.
Start the Example
-
Open ONE Desktop and select the ONE Desktop perspective.
-
In Model Explorer, select New and then Model Project.
-
In Use template select
General MDM project - CDI example
. -
Open
Files/bin
. -
Double-click
start-keycloak.bat
and wait for Keycloak to start in a separate window titled KeycloakDemoWindow. Wait for the following message to appear in the window:Keycloak … started in <number> s. Listening on: http://0.0.0.0:8083
. -
Double-click
start-db-postgres.bat
. The database must be running before you execute the server script in the following step. -
Double-click
start-mdm-server.bat
and wait for the following message to appear in a separate window (MDM Server):Started MdmServerApplication in <number> seconds
. -
Double-click
start-mdm.bat
and wait for the following message to appear in a separate window (MDM):Started MdaWebApplication in <number> seconds
. -
Once everything starts, open localhost:8050 (MDM Web Application) or localhost:8051 (MDM Admin Center) in your browser.
-
Log in with the following credentials:
Username Password Can access MDM System Console admin
admin
yes
Stop the Example
-
When you are finished working with the MDM Example, close the MDM Server and MDM prompt windows.
-
To stop the database, go to
Files/bin
folder and double-clickstop-db-postgres.bat
. -
Stop Keycloak by double-clicking
stop-keycloak.bat
.
Was this page useful?