Ataccama ONE Agentic Cloud Portal ONE Desktop ONE DQ&C ONE MDM ONE RDM ONE Runtime Server
latest (17.0.0) 16.3.x 16.2.0 16.1.0 16.0.0 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

RDM Example Project on Windows

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

For macOS instructions, see RDM Example Project on macOS.

Step 1: Download PostgreSQL and Keycloak plugins

Use PostgreSQL and Keycloak plugins to easily deploy the services needed for the RDM 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 and RDM Example Project Plugins from the Support Service Desk.

Step 2: Download and extract builds

Download the corresponding build packages of RDM and ONE Desktop from the Support Service Desk.

Extract packages

  1. Unpack ONE Desktop.

  2. In the ONE Desktop folder, create the following folders:

    • rdm

    • keycloak

    • pgsql

      Folder structure

  3. Extract the downloaded packages to these folders:

    • rdm-assembly-xxxxx.zip to rdm

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

      Click to view folder structure
      Keycloak new folder structure RDM new folder structure PostgreSQL new folder structure

Step 3: Configure RDM

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

    RDM application properties

Step 4: Start the example project

If you are preparing a project for Ataccama Cloud and you need to add new server or runtime configuration, you need to switch from the default configuration to a portal.serverConfig configuration with cloud-specific configuration options.

For more information, see deployment-guide:rdm-project-runtime-configurations.adoc.

  1. Start ONE Desktop.

    For detailed instructions, see Install ONE Desktop.

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

    ONE Desktop folder structure

  3. Select the ONE Desktop perspective.

    ONE Desktop perspective

  4. In the Model Explorer, select New and then Model Project.

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

  6. Once the project loads in the Model Explorer, navigate to Files/bin.

    Files/bin folder

  7. 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-postgres.bat. The database must be running before you execute the server script in the following step.

  8. Start RDM:

    1. Double-click start-server.bat. The RDM Server is ready once the following message appears:

      Started ... in <number> seconds
      Keep the prompt windows running until you are done working with the example project. See Step 5: Stop the example project.

    2. Double-click start-rdm.bat. The RDM Web Application is ready once the following message appears:

      Started ... in <number> seconds

  9. Once everything starts, open one of the following in your browser:

    • http://localhost:8060 — RDM Web Application

    • http://localhost:8060/admin — RDM Admin Console

  10. Log in with the following credentials:

    • Username: admin

    • Password: admin

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

Configure resources (optional)

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

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 /rdm/bin/start.bat file.

Step 5: Stop the example project

When you are finished working with the RDM example project:

  1. Stop the RDM Server and Web Application by closing their prompt windows.

  2. To stop Keycloak and PostgreSQL, navigate to the Files/bin folder in the Model Explorer:

    1. Stop PostgreSQL by double-clicking stop-postgres.bat.

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

Was this page useful?