Running MDM v14.5 Locally on MacOS

Steps overview:

1. Download all components
2. Install ONE Desktop
3. Launch ONE Desktop and create the MDM CDI 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, mdm-server, server), one by one

Download:

• Builds (Latest versions here):
  • MDM: Mdm-assembly-14.5.0-linux.zip
  • ONE Desktop: Ataccama-one-desktop-14.5.0-macos.dmg 
  • ONE MDM Server: Mdm-server-assembly-14.5.0-linux.zip  
• 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/products/releases/keycloak/keycloak-21.1.2-3-demo.zip

• Your license (.plf file)

Install ONE Desktop:

• Install ONE Desktop (Ataccama-one-desktop-14.5.0-macos.dmg)
• Rename the application so that there are no spaces
  • Make sure One Desktop application isn’t running while renaming the application
  • For example ONE Desktop.app —> ONEDesktop.app

Place the files in the right structure:

• To view the contents of ONE Desktop in Finder:

  • Under Applications, right click on the ONE Desktop 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-14.5.0-linux.zip
  • mdm-server: Mdm-server-assembly-14.5.0-linux.zip  
  • pgsql: 
  • keycloak: https://ataccama.s3.amazonaws.com/products/releases/keycloak/keycloak-21.1.2-3-demo.zip

• The folder structure should look 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_14.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 .
• Navigate to /Applications/ONEDesktop.app/Contents/MacOs
  • Type CHMOD -R 777 .

Launch it all, one by one:

• In the ONE Desktop, under the CDI Example navigate to the Files/bin folder
  • Right-click start-mdm-server.sh & select Open With Text Editor
  • Edit the path listed after -config to point to the CDI serverConfig
    • eg. config="/Applications/ONEDesktop.app/Contents/MacOS/workspace/mdm-cdi-example/Files/etc/mdm.serverConfig"

• 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-db-postgres.sh
• Launch mdm-server: double-click on start-mdm-server.sh
• Launch mdm: double-click on start-mdm.sh