MDM Example Project

The following guide shows you how to install and run the latest MDM example project on Windows. The example project provides a preconfigured environment for working through MDM tutorials.

For macOS instructions, see mdm-example-project-macos.adoc.

Step 1: Download PostgreSQL and Keycloak plugins

Use PostgreSQL and Keycloak plugins to easily deploy the services needed for the MDM example project.

The plugins are intended for demonstration purposes only and are not meant for production environments. By using these, you are accepting Keycloak and PostgreSQL licenses.

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 MDM Example Project Plugins from the Support Service Desk.

Step 2: Download and extract builds

Download the corresponding build packages of MDM, MDM Server, and ONE Desktop from the Support Service Desk.

Extract packages

Unpack ONE Desktop.
In the ONE Desktop folder, create the following folders:
- mdm
- mdm-server
- keycloak
- pgsql
Extract the downloaded packages to these folders:
- mdm-assembly-xxxxx.zip to mdm
- mdm-server-assembly-xxxxx.zip to mdm-server
- keycloak-x.x.x-x-demo.zip to keycloak
- pgsql-xxx.zip to pgsql
  
  Your folder structure should now look like this. This ensures the scripts in the example project Files > bin work without issues.
  
  Details

Step 3: Start the example project

Start ONE Desktop.

For detailed instructions, see Install ONE Desktop.
When prompted to select your workspace, keep the default location. For the example to run, the workspace folder must be located in the ONE Desktop installation folder.
In the upper-right corner, switch to the ONE Desktop perspective.
In the Model Explorer, select New Model Project Wizard.
For the initial model, keep the default template (General MDM project - CDI example). Select Finish.
Once the project loads in the Model Explorer, navigate to Files/bin.
Start Keycloak and PostgreSQL:
1. Double-click start-keycloak.bat. Keycloak is ready once the following message appears:
  Keycloak ... started in <number> s. Listening on: \http://0.0.0.0:8083
2. Double-click start-db-postgres.bat.
Start MDM:
1. Double-click start-mdm-server.bat. The MDM Server is ready once the following message appears:
  Started MdmServerApplication in <number> seconds
  Keep the prompt windows running until you are done working with the example project. See Step 4: Stop the example project.
2. Double-click start-mdm.bat. The MDM Web Application is ready once the following message appears:
  Started MdaWebApplication in <number> seconds
Once everything starts, open one of the following in your browser:
- http://localhost:8050 — MDM Web Application
- http://localhost:8051 — MDM Web App Admin Center
Log in with the following credentials:
- Username: admin
- Password: admin

If you want to view logs related to the example project, the default logging file path is defined using the DEFAULT_JVM_OPTS property in the /mdm/bin/start.bat file.

Default value

"-Dlogging.file.path=./log" "-Dlogging.path=./log" "-Dplugins.path=./plugin" "-Dspring.config.additional-location=./etc/application.properties"

Step 4: Stop the example project

When you are finished working with the MDM example project:

Stop the MDM Server and Web Application by closing their prompt windows.
To stop Keycloak and PostgreSQL, navigate to the Files/bin folder in the Model Explorer:
1. Stop PostgreSQL by double-clicking stop-db-postgres.bat.
2. Stop Keycloak by double-clicking stop-keycloak.bat.

Was this page useful?