ONE Desktop ONE DQ&C ONE MDM ONE RDM ONE Runtime Server
latest (15.4.0) 15.3.0 15.2.0 15.1.x 14.5.x 13.9.x 13.8.x 13.7.x 13.6.x 13.5.0 13.4.x 13.3.x 13.2.x
User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

RDM Example Project

The following guide shows you how to install and run the latest RDM example project on Windows.

Download PostgreSQL and Keycloak plugins

For ONE RDM on Windows, PostgreSQL and Keycloak plugins have been provided in order to easily deploy the modules, specifically for the purpose of running the RDM Tutorial.

Note that 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 them from the Downloads page (MDM and RDM Example Project Plugins).

Download builds

Download the corresponding build packages of RDM and ONE Desktop from the Downloads page.

Extract packages

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

    • rdm

    • keycloak

    • pgsql

      Folder structure

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

    1. rdm-assembly-xxxxx.zip to rdm

    2. keycloak-x.x.x-x-demo.zip to keycloak

    3. pgsql-xxx.zip to pgsql

      Your folder structure should now look like this:

      Click to view folder structure
      Keycloak new folder structure RDM new folder structure PostgreSQL new folder structure
      This step is necessary when running the example projects to ensure the scripts in Files > bin work without issues.

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

You can now run the RDM example project.

Start the example

  1. Navigate to rdm/etc and open application.properties. This is the main file for RDM configuration. Uncomment the rows, save, and exit.

    RDM application properties

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

    ONE Desktop perspective

  3. In Model Explorer, select New and then Model Project.

  4. In Use template, select Reference Data Manager - Banking Example.

  5. Open Files/bin folder.

    Files/bin folder

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

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

  8. Double-click start-server.bat and wait for the following message to appear in a separate window: Started …​ in <number> seconds.

  9. Double-click start-rdm.bat and wait for the following message to appear in a separate window: Started …​ in <number> seconds.

  10. Once everything starts, open http://localhost:8060 (RDM Web Application) or http://localhost:8060/admin (RDM Admin Console) in your browser.

  11. Log in to the application with the following credentials:

    Username Password Can access RDM System Console

    admin

    admin

    Yes

  12. To access the RDM Online Server Web Console, open http://localhost:8061 in your browser. There you can find the following information:

    • http://localhost:8888/console/applications/ - Available online services

    • http://localhost:8888/console/wfConfigs/ - Configured workflows

    • http://localhost:8888/console/scheduler/ - Defined schedulers

  13. For additional work on configuration, in the File Explorer perspective, define the following resources:

    • Database resource called rdm_db with attributes:

      • Host:`localhost`

      • Port:` 5432`

      • Database name: rdm

      • Username: rdm

      • Password: rdm

    • Server resource called rdmapp with attributes:

      • URL: http://localhost:8060/admin

      • User: admin

      • Password: admin

    • Server resource called server with attribute:

      • URL: http://localhost:8061

Stop the example

  1. When you are finished working with RDM Banking Example, close the prompt windows.

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

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

Was this page useful?