These instructions are provided as-is. They worked at a point in time; other variants of software may work. These instructions may become stale if the build dependencies change.
They have been shown to work on 19th of December 2016.
To build, run tests, and debug Apache Atlas, the following software is required:
Atlas command line tools are written in Python.
Some of the Atlas source code is written in the Scala programming language. The Scala IDE feature is required to compile Scala source code in Eclipse.
Atlas tests use the TestNG framework, which is similar to JUnit. The TestNG plug-in is required to run TestNG tests from Eclipse.
a. File - Import - Maven - Existing Maven Projects b. Browse to your Atlas folder c. Uncheck the root project and non-Java projects such as dashboardv2, docs and distro, then click Finish
On the Mac, the Maven import fails with message
"Cannot complete the install because one or more required items could not be found. Software being installed: Maven Integration for AJDT (Optional) 0.14.0.201506231302 (org.maven.ide.eclipse.ajdt.feature.feature.group 0.14.0.201506231302) Missing requirement: Maven Integration for AJDT (Optional) 0.14.0.201506231302 (org.maven.ide.eclipse.ajdt.feature.feature.group 0.14.0.201506231302) requires 'org.eclipse.ajdt.core 1.5.0' but it could not be found".
Install http://download.eclipse.org/tools/ajdt/46/dev/update and rerun. The Maven AspectJ should plugin install - allowing the references to Aspects in Maven to be resolved.
d. In the atlas-typesystem, atlas-repository, hdfs-model, and storm-bridge projects, add the src/main/scala and src/test/scala (if available) directories as source folders. Note: the hdfs-model and storm-bridge projects do not have the src/test/scala folder.
Right-click on the project, and choose Properties.
Click the Java Build Path in the left-hand panel, and choose the Source tab.
Click Add Folder, and select the src/main/scala and src/test/scala directories.
Only the atlas-repository and atlas-type system projects have Scala source folders to update.
e. Select atlas-typesystem, atlas-repository, hdfs-model, and storm-bridge projects, right-click, go to the Scala menu, and choose ‘Set the Scala Installation’.
f. Choose Fixed Scala Installation: 2.11.8 (bundled) , and click OK.
g. Restart Eclipse
h. Choose Project - Clean, select Clean all projects, and click OK.
Some projects may not pick up the Scala library – if this occurs, quick fix on those projects to add in the Scala library – projects atlas-typesystem, atlas-repository, hdfs-model, storm-bridge and altas-webapp.
You should now have a clean workspace.
Sample Bash scripts to help mac users
You will need to change some of these scripts to point to your installation targets.
#!/bin/bash # export JAVA_HOME=/Library/Java/JavaVirtualMachines/macosxx6480sr3fp10hybrid-20160719_01-sdk export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home export M2_HOME=/Applications/apache-maven-3.3.9 # Git is installed in the system path export PYTHON_HOME='/Applications/Python 2.7' export PATH=$PYTHON_HOME:$M2_HOME/bin:$JAVA_HOME/bin:$PATH export MAVEN_OPTS="-Xmx1536m -Drat.numUnapprovedLicenses=100 -XX:MaxPermSize=256m"
#!/bin/bash export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home export M2_HOME=/Applications/apache-maven-3.3.9 # Git is installed in the system path export PYTHON_HOME='/Applications/Python 2.7' export PATH=$PYTHON_HOME:$M2_HOME/bin:$JAVA_HOME/bin:$PATH/Applications/neon.app/Contents/MacOS/eclipse