Steps overview:

1. Download all components
2. Install ONE Desktop
3. Launch ONE Desktop and create the RDM Banking example project
4. Place the files in the right structure
5. Modify a bunch of files so they work on MacOS
6. Configure the Mac permissions to run things
7. Launch ONE Desktop and create the RDM Banking example project
8. Launch them all (keycloak, postrgres), one by one

Download:

• Builds (Latest versions here):

  • RDM: Rdm-assembly-13.8.1-linux.zip (Linux)

  • ONE Desktop: Ataccama-one-desktop-13.8.1-macos.dmg (MacOS)

• Plugins (Latest versions here, the official Postgres version for Linux missing for now):

  • Postgres: https://drive.google.com/file/d/1Lho_9BQh78xRWR2QHAAGoQuERof-Rn-e/view?usp=sharing

  • Keycloak: https://ataccama.s3.amazonaws.com/Frances/Ataccama-one-desktop-13.0.0-GA_keycloak_12_0_4_plugin.zip

• Your license (.plf file)

Install ONE Desktop:

• Install One Desktop (Ataccama-one-desktop-13.8.1-macos.dmg (MacOS)

• Rename the application so that there are no spaces.

  • For example ONE Desktop.app —> ONEDesktop.app

Place the files in the right structure:

 To run the .sh scrips successfully, they need to be placed in a path that contains no spaces. The ONE Desktop path has at least one space, so we need to place the parts we want to run from the terminal on a spaceless path (Keycloak, Postgres, RDM, JRE and Server)

• To view the contents of ONE Desktop in Finder:

  • Right click on the application

  • Click on Show Package Contents

  • Click on Contents

  • Click on Eclipse

• Extract the following archives in the Eclipse folder and rename the folder names to the following:

  • rdm: Rdm-assembly-13.8.1-linux.zip (Linux)

  • pgsql: https://drive.google.com/file/d/1Lho_9BQh78xRWR2QHAAGoQuERof-Rn-e/view?usp=sharing

  • keycloak: https://ataccama.s3.amazonaws.com/Frances/Ataccama-one-desktop-13.0.0-GA_keycloak_12_0_4_plugin.zip

• The folder structure should look something like this

• Your path without spaces should be similar to /Applications/ONEDesktop.app/Contents/Eclipse

• Place your license in your home folder, e.g. /Users/<username>/emp_license_13.plf

Launch ONE Desktop and create the RDM Banking example project:

• Open Ataccama ONE Desktop and select the Ataccama ONE Desktop perspective.

• Navigate to RDM\ataccama-one-desktop-XX.X.X\rdm\etc and open application.properties. This is the main file for RDM configuration. 

• Uncomment the rows 

• Add the new ones

spring.mail.host=smtp.gmail.com spring.mail.port=587

spring.mail.username=user 

spring.mail.password=password 

spring.mail.default-encoding=utf-8

spring.mail.properties.mail.transport.protocol=smtp 

spring.mail.properties.mail.smtp.port=25

spring.mail.properties.mail.smtp.auth=true

spring.mail.properties.mail.smtp.starttls.enable=true 

spring.mail.properties.mail.smtp.starttls.required=true 

• Save, and exit.

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

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

• In Use template: select Reference Data Manager - Banking Example.

Configure the Mac permissions to run things:

Don't forget that if you replace some files you will need to set the permissions again and run the xattr command.

• Open the Terminal (command+Space Terminal) and navigate to the /Applications/ONEDesktop.app/Contents/Eclipsefolder. Eg: cd /Applications/ONEDesktop.app/Contents/Eclipse

  • Type CHMOD -R 777 . (the "." is intentional)

  • Type xattr -r -d com.apple.quarantine .

• Navigate to /Applications/ONEDesktop.app/Contents/Eclipse/pgsql

  • Type chmod -R 0700 .

• Navigate to /Applications/ONEDesktop.app/Contents/MacOs/eclipse

  • Type CHMOD -R 777 . (the "." is intentional)

Launch them all, one by one:

• Open Files/bin folder in the Reference Data Manager - Banking Example

• Launch keycloak: double-click on start_keycloak.sh and wait for Keycloak startup complete message to appear in the console

• Launch postgres: double-click on start_postgres.sh

• Launch rdm: double-click on  start_rdm.sh

• Launch rdm-server: double-click on start_server.sh

 Once everything starts and If everything launched correctly, you can find 

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

• Аdmin Center at http://localhost:8061/

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

• Keycloak: http://localhost:8083/auth

Login into the application with the default credentials: User_name: admin, password: admin