User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

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

PostgreSQL plugin

Keycloak plugin

Download Builds

Download the corresponding build packages of MDM, MDM Server and ONE Desktop from the Downloads page.

Extract Packages

  1. After unpacking ONE Desktop, in File Explorer create the following folders:

    • mdm

    • mdm-server

    • keycloak

    • pgsql

      Folders structure
  2. Extract the downloaded packages to these folders, as follows:

    1. mdm-assembly-xxxxx.zip to mdm

    2. mdm-server-assembly-xxxxx.zip to mdm-server

    3. keycloak-x.x.x-x-demo.zip to keycloak

    4. pgsql-xxx.zip to pgsql

    Your folder structure should now look like this:

mdm folder contents
mdm-server folder contents
keycloak folder contents
pgsql folder contents
This step is necessary when running the example projects to ensure the scripts in Files > bin work without issues.
  1. Replace start-keycloak.bat, start-keycloak.sh, stop-keycloak.bat, stop-keycloak.sh in the Files/bin folder with the following scripts:

    1. start-keycloak.bat

      @echo off
      set KEYCLOAK_HOME=%DQC_HOME%\..\keycloak
      cd "%KEYCLOAK_HOME%"
      start "KeycloakDemoWindow" cmd /C call scripts\start-demo.bat start
    2. 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
    3. stop-keycloak.bat

      @echo off
      taskkill /FI "WindowTitle eq KeycloakDemoWindow"
    4. 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"
  2. Open Files/etc/issue_management/config.xml and change the <clientSecret> value to mdm-admin-client-s3cret.

Start the Example

  1. Open ONE Desktop and select the ONE Desktop perspective.

    Creating an example project
  2. In Model Explorer, select New and then Model Project.

  3. In Use template select General MDM project - CDI example.

    Creating example project
  4. Open Files/bin.

    bin folder contents
  5. 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.

  6. Double-click start-db-postgres.bat. The database must be running before you execute the server script in the following step.

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

  8. Double-click start-mdm.bat and wait for the following message to appear in a separate window (MDM): Started MdaWebApplication in <number> seconds.

  9. Once everything starts, open localhost:8050 (MDM Web Application) or localhost:8051 (MDM Admin Center) in your browser.

  10. Log in with the following credentials:

    Username Password Can access MDM System Console

    admin

    admin

    yes

Stop the Example

  1. When you are finished working with the MDM Example, close the MDM Server and MDM prompt windows.

  2. To stop the database, go to Files/bin folder and double-click stop-db-postgres.bat.

  3. Stop Keycloak by double-clicking stop-keycloak.bat.

Was this page useful?