blob: 588fe6d886cc042b251d0f079709ed91fbe6750c [file] [log] [blame]
{"version":3,"sources":["/home/madhan/Apache/git/atlas/docs/target/src/documents/Setup/EclipseSetup.md","/home/madhan/Apache/git/atlas/docs/target/theme/styles/styled-colors.js"],"names":["layoutProps","MDXContent","components","props","mdxType","parentName","wrapLines","language","style","theme","isMDXComponent","dark","hljs","color"],"mappings":"6kBAWMA,EAAc,GAIL,SAASC,EAAW,GAG/B,IAFFC,EAAU,EAAVA,WACGC,EAAK,iBAER,OAAO,cALS,UAKC,iBAAKH,EAAiBG,EAAK,CAAED,WAAYA,EAAYE,QAAQ,cAE5E,oBACE,GAAM,2DAAyD,2DAEjE,4MACA,iFACA,2GACA,uBAAG,wBAAQC,WAAW,KAAG,SACzB,wBACE,oBAAIA,WAAW,MAAI,uCACnB,oBAAIA,WAAW,MAAI,iFACnB,oBAAIA,WAAW,MAAI,+CAErB,uBAAG,wBAAQA,WAAW,KAAG,UAAoB,qDAE7C,wBACE,oBAAIA,WAAW,MAAI,6CACnB,oBAAIA,WAAW,MAAI,2BACnB,oBAAIA,WAAW,MAAI,6CAErB,uBAAG,wBAAQA,WAAW,KAAG,UACzB,wBACE,oBAAIA,WAAW,MAAI,oCACnB,oBAAIA,WAAW,MAAI,gFACnB,oBAAIA,WAAW,MAAI,qHAErB,uBAAG,wBAAQA,WAAW,KAAG,QACzB,wBACE,oBAAIA,WAAW,MAAI,eACnB,oBAAIA,WAAW,MAAI,oFAErB,uBAAG,wBAAQA,WAAW,KAAG,YACzB,wBACE,oBAAIA,WAAW,MAAI,8BACnB,oBAAIA,WAAW,MAAI,0EACnB,oBAAIA,WAAW,MAAI,4FAErB,uBAAG,wBAAQA,WAAW,KAAG,6BAAuC,qJAEhE,wBACE,oBAAIA,WAAW,MAAI,qDACnB,oBAAIA,WAAW,MAAI,2DAA6D,mBAAGA,WAAW,KAC1F,KAAQ,sEAAoE,uEAEhF,oBAAIA,WAAW,MAAI,oEACnB,oBAAIA,WAAW,MAAI,iCACnB,oBAAIA,WAAW,MAAI,gHACvB,oBAAIA,WAAW,MAAI,4BAEjB,8CAA2B,mBAAGA,WAAW,IACrC,KAAQ,iDAA+C,oBAC9B,iGAC7B,wBACE,oBAAIA,WAAW,MAAI,qDACnB,oBAAIA,WAAW,MAAI,2DAA6D,mBAAGA,WAAW,KAC1F,KAAQ,2DAAyD,2DAEnE,qBAAKA,WAAW,MAAK,sBAAMA,WAAW,OAAK,kLAI3C,oBAAIA,WAAW,MAAI,mCACrB,oBAAIA,WAAW,MAAI,qDACnB,oBAAIA,WAAW,MAAI,2DAA6D,mBAAGA,WAAW,KAC1F,KAAQ,kDAAgD,mDAE5D,oBAAIA,WAAW,MAAI,qEACnB,oBAAIA,WAAW,MAAI,iCACnB,oBAAIA,WAAW,MAAI,6HACvB,oBAAIA,WAAW,MAAI,+CAEjB,sNACA,0EACA,cAAC,IAAiB,CAACC,WAAW,EAAMC,SAAS,QAAQC,MAAOC,IAAYL,QAAQ,qBAAmB,+cAKnG,kCAAe,mBAAGC,WAAW,IACzB,KAAQ,wDAAsD,wDACD,qHACjE,8RACA,iEAA8C,oBAAIA,WAAW,KAAG,cAAoB,KACpF,oCAAiB,oBAAIA,WAAW,KAAG,mBAAyB,2CAA4C,oBAAIA,WAAW,KAAG,UAAgB,SAC1I,gCAAa,oBAAIA,WAAW,KAAG,cAAoB,mEACnD,wHACA,qMACA,+FACA,6CACA,8FACA,wPACA,iEACA,uBAAG,oBAAIA,WAAW,KAAG,0CACrB,+GACA,wBACE,oBAAIA,WAAW,MAAI,iEAErB,cAAC,IAAiB,CAACC,WAAW,EAAMC,SAAS,QAAQC,MAAOC,IAAYL,QAAQ,qBAAmB,mcAQnG,wBACE,oBAAIC,WAAW,MAAI,2LAErB,cAAC,IAAiB,CAACC,WAAW,EAAMC,SAAS,QAAQC,MAAOC,IAAYL,QAAQ,qBAAmB,mVAStG,yLAEDH,EAAWS,gBAAiB,G,+DC3I5B,iFAqBAC,IAAKC,KAAKC,MAAQ,UACHF,MAAI","file":"static/js/documents-setup-eclipse-setup.2e40a125.js","sourcesContent":["\nimport React from 'react'\nimport { mdx } from '@mdx-js/react'\n\n/* @jsxRuntime classic */\n/* @jsx mdx */\nimport themen from 'theme/styles/styled-colors';\nimport * as theme from 'react-syntax-highlighter/dist/esm/styles/hljs';\nimport SyntaxHighlighter from 'react-syntax-highlighter';\n\n\nconst layoutProps = {\n \n};\nconst MDXLayout = \"wrapper\"\nexport default function MDXContent({\n components,\n ...props\n}) {\n return <MDXLayout {...layoutProps} {...props} components={components} mdxType=\"MDXLayout\">\n\n <h1 {...{\n \"id\": \"tools-required-to-build-and-run-apache-atlas-on-eclipse\"\n }}>{`Tools required to build and run Apache Atlas on Eclipse`}</h1>\n <p>{`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.`}</p>\n <p>{`They have been shown to work on 19th of December 2016.`}</p>\n <p>{`To build, run tests, and debug Apache Atlas, the following software is required:`}</p>\n <p><strong parentName=\"p\">{`Java`}</strong></p>\n <ul>\n <li parentName=\"ul\">{`Download and install a 1.8 Java SDK`}</li>\n <li parentName=\"ul\">{`Set JAVA_HOME system environment variable to the installed JDK home directory`}</li>\n <li parentName=\"ul\">{`Add JAVA_HOME/bin directory to system PATH`}</li>\n </ul>\n <p><strong parentName=\"p\">{`Python`}</strong>{`\nAtlas command line tools are written in Python.`}</p>\n <ul>\n <li parentName=\"ul\">{`Download and install Python version 2.7.7`}</li>\n <li parentName=\"ul\">{`For Mac, we used 2.7.11`}</li>\n <li parentName=\"ul\">{`Add Python home directory to system PATH`}</li>\n </ul>\n <p><strong parentName=\"p\">{`Maven`}</strong></p>\n <ul>\n <li parentName=\"ul\">{`Download and install Maven 3.3.9`}</li>\n <li parentName=\"ul\">{`Set the environment variable M2_HOME to point to the maven install directory`}</li>\n <li parentName=\"ul\">{`Add M2_HOME/bin directory to system PATH e.g. C:\\\\Users\\\\IBM_ADMIN\\\\Documents\\\\Software\\\\apache-maven-3.3.9\\\\bin`}</li>\n </ul>\n <p><strong parentName=\"p\">{`Git`}</strong></p>\n <ul>\n <li parentName=\"ul\">{`Install Git`}</li>\n <li parentName=\"ul\">{`Add git bin directory to the system PATH e.g. C:\\\\Program Files (x86)\\\\Git\\\\bin`}</li>\n </ul>\n <p><strong parentName=\"p\">{`Eclipse`}</strong></p>\n <ul>\n <li parentName=\"ul\">{`Install Eclipse Neon (4.6)`}</li>\n <li parentName=\"ul\">{`The non-EE Neon for iOS from eclipse.org has been proven to work here.`}</li>\n <li parentName=\"ul\">{`Install the Scala IDE, TestNG, and m2eclipse-scala features/plugins as described below.`}</li>\n </ul>\n <p><strong parentName=\"p\">{`Scala IDE Eclipse feature`}</strong>{`\nSome Atlas source code is written in the Scala programming language. The Scala IDE feature is required to compile Scala source code in Eclipse.`}</p>\n <ul>\n <li parentName=\"ul\">{`In Eclipse, choose Help - Install New Software...`}</li>\n <li parentName=\"ul\">{`Click Add... to add an update site, and set Location to `}<a parentName=\"li\" {...{\n \"href\": \"http://download.scala-ide.org/sdk/lithium/e44/scala211/stable/site\"\n }}>{`http://download.scala-ide.org/sdk/lithium/e44/scala211/stable/site`}</a></li>\n <li parentName=\"ul\">{`Select Scala IDE for Eclipse from the list of available features`}</li>\n <li parentName=\"ul\">{`Restart Eclipse after install`}</li>\n <li parentName=\"ul\">{`Set the Scala compiler to target the 1.7 JVM: Window - Preferences - Scala - Compiler, change target to 1.7\n`}<em parentName=\"li\">{`TestNG Eclipse plug-in`}</em></li>\n </ul>\n <p>{`Atlas tests use the `}<a parentName=\"p\" {...{\n \"href\": \"http://testng.org/doc/documentation-main.html\"\n }}>{`TestNG framework`}</a>{`, which is similar to JUnit. The TestNG plug-in is required to run TestNG tests from Eclipse.`}</p>\n <ul>\n <li parentName=\"ul\">{`In Eclipse, choose Help - Install New Software...`}</li>\n <li parentName=\"ul\">{`Click Add... to add an update site, and set Location to `}<a parentName=\"li\" {...{\n \"href\": \"http://beust.com/eclipse-old/eclipse_6.9.9.201510270734\"\n }}>{`http://beust.com/eclipse-old/eclipse_6.9.9.201510270734`}</a>\n <pre parentName=\"li\"><code parentName=\"pre\" {...{}}>{` * Choose TestNG and continue with install\n * Restart Eclipse after installing the plugin\n * In Window - Preferences - TestNG, <b>un</b>check \"Use project TestNG jar\"\n`}</code></pre>\n <em parentName=\"li\">{`m2eclipse-scala Eclipse plugin`}</em></li>\n <li parentName=\"ul\">{`In Eclipse, choose Help - Install New Software...`}</li>\n <li parentName=\"ul\">{`Click Add... to add an update site, and set Location to `}<a parentName=\"li\" {...{\n \"href\": \"http://alchim31.free.fr/m2e-scala/update-site/\"\n }}>{`http://alchim31.free.fr/m2e-scala/update-site/`}</a></li>\n <li parentName=\"ul\">{`Choose Maven Integration for Scala IDE, and continue with install`}</li>\n <li parentName=\"ul\">{`Restart Eclipse after install`}</li>\n <li parentName=\"ul\">{`In Window - Preferences -Maven - Errors/Warnings, set Plugin execution not covered by lifecycle configuration to Warning\n`}<em parentName=\"li\">{`Import Atlas maven projects into Eclipse:`}</em></li>\n </ul>\n <p>{`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`}</p>\n <p>{`On the Mac, the Maven import fails with message`}</p>\n <SyntaxHighlighter wrapLines={true} language=\"shell\" style={theme.dark} mdxType=\"SyntaxHighlighter\">\n {`\"Cannot complete the install because one or more required items could not be found.\nSoftware being installed: Maven Integration for AJDT (Optional) 0.14.0.201506231302 (org.maven.ide.eclipse.ajdt.feature.feature.group 0.14.0.201506231302)\nMissing 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\".`}\n </SyntaxHighlighter>\n <p>{`Install `}<a parentName=\"p\" {...{\n \"href\": \"http://download.eclipse.org/tools/ajdt/46/dev/update\"\n }}>{`http://download.eclipse.org/tools/ajdt/46/dev/update`}</a>{` and rerun. The Maven AspectJ should plugin install - allowing the references to Aspects in Maven to be resolved.`}</p>\n <p>{` 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.`}</p>\n <p>{`Right-click on the project, and choose `}<em parentName=\"p\">{`Properties`}</em>{`.`}</p>\n <p>{`Click the `}<em parentName=\"p\">{`Java Build Path`}</em>{` in the left-hand panel, and choose the `}<em parentName=\"p\">{`Source`}</em>{` tab.`}</p>\n <p>{`Click `}<em parentName=\"p\">{`Add Folder`}</em>{`, and select the src/main/scala and src/test/scala directories.`}</p>\n <p>{`Only the atlas-repository and atlas-type system projects have Scala source folders to update.`}</p>\n <p>{`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’.`}</p>\n <p>{`f. Choose Fixed Scala Installation: 2.11.8 (bundled) , and click OK.`}</p>\n <p>{`g. Restart Eclipse`}</p>\n <p>{`h. Choose Project - Clean, select Clean all projects, and click OK.`}</p>\n <p>{`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 atlas-webapp.`}</p>\n <p>{`You should now have a clean workspace.`}</p>\n <p><em parentName=\"p\">{`Sample Bash scripts to help mac users`}</em></p>\n <p>{`You will need to change some of these scripts to point to your installation targets.`}</p>\n <ul>\n <li parentName=\"ul\">{`Run this script to setup your command line build environment`}</li>\n </ul>\n <SyntaxHighlighter wrapLines={true} language=\"shell\" style={theme.dark} mdxType=\"SyntaxHighlighter\">\n {`#!/bin/bash # export JAVA_HOME=/Library/Java/JavaVirtualMachines/macosxx6480sr3fp10hybrid-20160719_01-sdk\nexport JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home\nexport M2_HOME=/Applications/apache-maven-3.3.9 # Git is installed in the system path\nexport PYTHON_HOME='/Applications/Python 2.7'\nexport PATH=$PYTHON_HOME:$M2_HOME/bin:$JAVA_HOME/bin:$PATH\nexport MAVEN_OPTS=\"-Xmx1536m -Drat.numUnapprovedLicenses=100\"`}\n </SyntaxHighlighter>\n <ul>\n <li parentName=\"ul\">{`If you do not want to set Java 8 as your system java, you can use this bash script to setup the environment and run Eclipse (which you can drop in Applications and rename to neon).`}</li>\n </ul>\n <SyntaxHighlighter wrapLines={true} language=\"shell\" style={theme.dark} mdxType=\"SyntaxHighlighter\">\n {`#!/bin/bash\nexport JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home\nexport M2_HOME=/Applications/apache-maven-3.3.9\n# Git is installed in the system path\nexport PYTHON_HOME='/Applications/Python 2.7'\nexport PATH=$PYTHON_HOME:$M2_HOME/bin:$JAVA_HOME/bin:$PATH/Applications/neon.app/Contents/MacOS/eclipse`}\n </SyntaxHighlighter>\n </MDXLayout>;\n}\n;\nMDXContent.isMDXComponent = true;","/**\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { dark } from \"react-syntax-highlighter/dist/esm/styles/hljs\";\n\n//dark[\"powershell\"][\"color\"] = \"#37bb9b\";\ndark.hljs.color = \"#37bb9b\";\nexport default dark;"],"sourceRoot":""}