Running MDM v13.x Locally on MacOS

Steps overview:

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

Download:

• Builds (Latest versions here):
  • MDM: MDM-Assembly-13.3.2-final-linux.zip
  • ONE Desktop: Ataccama-one-desktop-13.2.1.final-macos.dmg
  • ONE Runtime: Server-assembly-13.3.2-final.tar
• Plugins (Latest versions here, the official Postgres version for Linux missing for now):

  • Postgres:

    pgsql.zip

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

• Your license (.plf file)

For latest versions of the data (optional):

• ataccama.json permissions file, found here

Install ONE Desktop:

• Install One Desktop (Ataccama-one-desktop-13.2.1.final-macos.dmg)
• Rename the application so that there are no spaces.
  • For example ONE Desktop.app —> ONEDesktop.app

Place the files in the right structure:

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

  • mdm: MDM-Assembly-13.3.2-final-linux.zip
  • mdm-server: Server-assembly-13.3.2-final.tar
  • pgsql: [the one attached to the page]
  • 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

• Delete the data folder in /Applications/ONEDesktop.app/Contents/Eclipse/pgsql

• (Optional) Replace the ataccama.json file in /Applications/ONEDesktop.app/Contents/Eclipse/keycloak/ with the one you downloaded

• (Optional) Replace the backup file in /Applications/ONEDesktop.app/Contents/Eclipse/pgsql/pginit with the one you downloaded

• (Optional) Download Java jdk (you can find the recommended and supported version here) and set it as Java Home

Launch ONE Desktop and create the MDM Banking example project:

• Open Ataccama ONE Desktop and select the Ataccama ONE Desktop perspective.
• In Model Explorer, select New and then Model Project.
• In Use template: select General MDM project - CDI Example.

Configure the Mac permissions to run things:

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

Launch it all, one by one:

• Open Files/bin folder in the CDI 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 mdm-server: double-click on start_server.sh
• Launch mdm: open your terminal, navigate to /Applications/ONEDesktop.app/Contents/Eclipse/mdm/bin/ and execute sh start.sh from the Terminal