| (window.webpackJsonp=window.webpackJsonp||[]).push([[47],{"./src/documents/Setup/InstallationInstruction.md":function(e,a,t){"use strict";t.r(a),t.d(a,"default",(function(){return c}));var n=t("../node_modules/babel-preset-react-app/node_modules/@babel/runtime/helpers/esm/objectWithoutProperties.js"),s=(t("../node_modules/react/index.js"),t("../node_modules/@mdx-js/react/dist/esm.js")),r=(t("./theme/styles/styled-colors.js"),t("../node_modules/react-syntax-highlighter/dist/esm/styles/hljs/dark.js")),o=t("../node_modules/react-syntax-highlighter/dist/esm/default-highlight.js"),l=["components"],i={};function c(e){var a=e.components,t=Object(n.a)(e,l);return Object(s.mdx)("wrapper",Object.assign({},i,t,{components:a,mdxType:"MDXLayout"}),Object(s.mdx)("h3",{id:"installing--running-apache-atlas"},"Installing & Running Apache Atlas"),Object(s.mdx)("h4",{id:"installing-apache-atlas"},"Installing Apache Atlas"),Object(s.mdx)("p",null,"From the directory you would like Apache Atlas to be installed, run the following commands:"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"tar -xzvf apache-atlas-{project.version}-server.tar.gz\ncd apache-atlas-{project.version}"),Object(s.mdx)("h4",{id:"running-apache-atlas-with-local-apache-hbase--apache-solr"},"Running Apache Atlas with Local Apache HBase & Apache Solr"),Object(s.mdx)("p",null,"To run Apache Atlas with local Apache HBase & Apache Solr instances that are started/stopped along with Atlas start/stop, run following commands:"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"export MANAGE_LOCAL_HBASE=true\nexport MANAGE_LOCAL_SOLR=true\nbin/atlas_start.py"),Object(s.mdx)("h4",{id:"running-apache-atlas-with-berkeleydb--apache-solr"},"Running Apache Atlas with BerkeleyDB & Apache Solr"),Object(s.mdx)("p",null,"To run Apache Atlas with BerkeleyDB, and local instances of Apache Solr and Apache Zookeeper, run following commands:"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"export MANAGE_LOCAL_SOLR=true\nbin/atlas_start.py"),Object(s.mdx)("h4",{id:"using-apache-atlas"},"Using Apache Atlas"),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"To verify if Apache Atlas server is up and running, run curl command as shown below:")),Object(s.mdx)(o.a,{wrapLines:!0,style:r.a,mdxType:"SyntaxHighlighter"},'curl -u username:password http://localhost:21000/api/atlas/admin/version\n {"Description":"Metadata Management and Data Governance Platform over Hadoop","Version":"2.2.0","Name":"apache-atlas"}'),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Run quick start to load sample model and data")),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"bin/quick_start.py\nEnter username for atlas :-\nEnter password for atlas :-"),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Access Apache Atlas UI using a browser: http://localhost:21000")),Object(s.mdx)("h4",{id:"stopping-apache-atlas-server"},"Stopping Apache Atlas Server"),Object(s.mdx)("p",null,"To stop Apache Atlas, run following command:"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"bin/atlas_stop.py"),Object(s.mdx)("h3",{id:"configuring-apache-atlas"},"Configuring Apache Atlas"),Object(s.mdx)("p",null,"By default, config directory used by Apache Atlas is ",Object(s.mdx)("em",{parentName:"p"},"{package dir}/conf"),". To override this set environment variable ATLAS_CONF to the path of the conf dir."),Object(s.mdx)("p",null,"Environment variables needed to run Apache Atlas can be set in ",Object(s.mdx)("em",{parentName:"p"},"atlas-env.sh")," file in the conf directory. This file will be sourced by Apache Atlas scripts before any commands are executed. The following environment variables are available to set."),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"# The java implementation to use. If JAVA_HOME is not found we expect java and jar to be in path\n#export JAVA_HOME=\nany additional java opts you want to set. This will apply to both client and server operations\n#export ATLAS_OPTS=\nany additional java opts that you want to set for client only\n#export ATLAS_CLIENT_OPTS=\njava heap size we want to set for the client. Default is 1024 MB\n#export ATLAS_CLIENT_HEAP=\nany additional opts you want to set for atlas service.\n#export ATLAS_SERVER_OPTS=\njava heap size we want to set for the atlas server. Default is 1024 MB\n#export ATLAS_SERVER_HEAP=\nWhat is considered as atlas home dir. Default is the base location of the installed software\n#export ATLAS_HOME_DIR=\nWhere log files are stored. Default is logs directory under the base install location\n#export ATLAS_LOG_DIR=\nWhere pid files are stored. Default is logs directory under the base install location\n#export ATLAS_PID_DIR=\nWhere do you want to expand the war file. By Default, it is in /server/webapp dir under the base install dir.\n#export ATLAS_EXPANDED_WEBAPP_DIR="),Object(s.mdx)("p",null,Object(s.mdx)("em",{parentName:"p"},"Settings to support large number of metadata objects")),Object(s.mdx)("p",null,"If you plan to store large number of metadata objects, it is recommended that you use values tuned for better GC performance of the JVM."),Object(s.mdx)("p",null,"The following values are common server side options:"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},'export ATLAS_SERVER_OPTS="-server -XX:SoftRefLRUPolicyMSPerMB=0 -XX:+CMSClassUnloadingEnabled -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:+PrintTenuringDistribution -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=dumps/atlas_server.hprof -Xloggc:logs/gc-worker.log -verbose:gc -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=1m -XX:+PrintGCDetails -XX:+PrintHeapAtGC -XX:+PrintGCTimeStamps"'),Object(s.mdx)("p",null,"The ",Object(s.mdx)("inlineCode",{parentName:"p"},"-XX:SoftRefLRUPolicyMSPerMB")," option was found to be particularly helpful to regulate GC performance for query heavy workloads with many concurrent users."),Object(s.mdx)("p",null,"The following values are recommended for JDK 8:"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},'export ATLAS_SERVER_HEAP="-Xms15360m -Xmx15360m -XX:MaxNewSize=5120m -XX:MetaspaceSize=100M -XX:MaxMetaspaceSize=512m"'),Object(s.mdx)("p",null,Object(s.mdx)("em",{parentName:"p"},"NOTE for macOS users"),"\nIf you are using a macOS, you will need to configure the ATLAS_SERVER_OPTS (explained above)."),Object(s.mdx)("p",null,"In ",Object(s.mdx)("em",{parentName:"p"},"{package dir}/conf/atlas-env.sh")," uncomment the following line"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"export ATLAS_SERVER_OPTS="),Object(s.mdx)("p",null,"and change it to look as below"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},'export ATLAS_SERVER_OPTS="-Djava.awt.headless=true -Djava.security.krb5.realm= -Djava.security.krb5.kdc="'),Object(s.mdx)("h4",{id:"configuring-apache-hbase-as-the-storage-backend-for-the-graph-repository"},"Configuring Apache HBase as the storage backend for the Graph Repository"),Object(s.mdx)("p",null,'By default, Apache Atlas uses JanusGraph as the graph repository and is the only graph repository implementation available currently. Apache HBase versions currently supported are 1.1.x. For configuring Apache Atlas graph persistence on Apache HBase, please see "Graph persistence engine - HBase" in the ',Object(s.mdx)("a",{parentName:"p",href:"#/Configuration"},"Configuration")," section for more details."),Object(s.mdx)("p",null,"Apache HBase tables used by Apache Atlas can be set using the following configurations:"),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"atlas.graph.storage.hbase.table=atlas\natlas.audit.hbase.tablename=apache_atlas_entity_audit"),Object(s.mdx)("h4",{id:"configuring-apache-solr-as-the-indexing-backend-for-the-graph-repository"},"Configuring Apache Solr as the indexing backend for the Graph Repository"),Object(s.mdx)("p",null,"By default, Apache Atlas uses JanusGraph as the graph repository and is the only graph repository implementation available currently. For configuring JanusGraph to work with Apache Solr, please follow the instructions below"),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Install Apache Solr if not already running. The version of Apache Solr supported is 5.5.1. Could be installed from ",Object(s.mdx)("a",{parentName:"li",href:"http://archive.apache.org/dist/lucene/solr/5.5.1/solr-5.5.1.tgz"},"http://archive.apache.org/dist/lucene/solr/5.5.1/solr-5.5.1.tgz"))),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Start Apache Solr in cloud mode.")),Object(s.mdx)("p",null,"SolrCloud mode uses a ZooKeeper Service as a highly available, central location for cluster management. For a small cluster, running with an existing ZooKeeper quorum should be fine. For larger clusters, you would want to run separate multiple ZooKeeper quorum with at least 3 servers.\nFor more information, refer Apache Solr documentation - ",Object(s.mdx)("a",{parentName:"p",href:"https://cwiki.apache.org/confluence/display/solr/SolrCloud"},"https://cwiki.apache.org/confluence/display/solr/SolrCloud")),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"For e.g., to bring up an Apache Solr node listening on port 8983 on a machine, you can use the command:")),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"$SOLR_HOME/bin/solr start -c -z <zookeeper_host:port> -p 8983"),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Run the following commands from SOLR_BIN (e.g. $SOLR_HOME/bin) directory to create collections in Apache Solr corresponding to the indexes that Apache Atlas uses. In the case that the Apache Atlas and Apache Solr instances are on 2 different hosts, first copy the required configuration files from ATLAS_HOME/conf/solr on the Apache Atlas instance host to Apache Solr instance host. SOLR_CONF in the below-mentioned commands refer to the directory where Apache Solr configuration files have been copied to on Apache Solr host:")),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"$SOLR_BIN/solr create -c vertex_index -d SOLR_CONF -shards #numShards -replicationFactor #replicationFactor\n$SOLR_BIN/solr create -c edge_index -d SOLR_CONF -shards #numShards -replicationFactor #replicationFactor\n$SOLR_BIN/solr create -c fulltext_index -d SOLR_CONF -shards #numShards -replicationFactor #replicationFactor"),Object(s.mdx)("p",null," Note: If numShards and replicationFactor are not specified, they default to 1 which suffices if you are trying out solr with ATLAS on a single node instance.\nOtherwise, specify numShards according to the number of hosts that are in the Solr cluster and the maxShardsPerNode configuration.\nThe number of shards cannot exceed the total number of Solr nodes in your SolrCloud cluster."),Object(s.mdx)("p",null," The number of replicas (replicationFactor) can be set according to the redundancy required."),Object(s.mdx)("p",null," Also note that Apache Solr will automatically be called to create the indexes when Apache Atlas server is started if the\nSOLR_BIN and SOLR_CONF environment variables are set and the search indexing backend is set to 'solr5'."),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Change ATLAS configuration to point to Apache Solr instance setup. Please make sure the following configurations are set to the below values in ATLAS_HOME/conf/atlas-application.properties")),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"atlas.graph.index.search.backend=solr\natlas.graph.index.search.solr.mode=cloud\natlas.graph.index.search.solr.zookeeper-url=<the ZK quorum setup for solr as comma separated value> eg: 10.1.6.4:2181,10.1.6.5:2181\natlas.graph.index.search.solr.zookeeper-connect-timeout=<SolrCloud Zookeeper Connection Timeout>. Default value is 60000 ms\natlas.graph.index.search.solr.zookeeper-session-timeout=<SolrCloud Zookeeper Session Timeout>. Default value is 60000 ms"),Object(s.mdx)("p",null,"For more information on JanusGraph solr configuration , please refer ",Object(s.mdx)("a",{parentName:"p",href:"http://docs.janusgraph.org/0.2.0/solr.html"},"http://docs.janusgraph.org/0.2.0/solr.html")),Object(s.mdx)("p",null,"Pre-requisites for running Apache Solr in cloud mode"),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},Object(s.mdx)("p",{parentName:"li"},"Memory - Apache Solr is both memory and CPU intensive. Make sure the server running Apache Solr has adequate memory, CPU and disk.\nApache Solr works well with 32 GB RAM. Plan to provide as much memory as possible to Apache Solr process")),Object(s.mdx)("li",{parentName:"ul"},Object(s.mdx)("p",{parentName:"li"},"Disk - If the number of entities that need to be stored are large, plan to have at least 500 GB free space in the volume where Apache Solr is going to store the index data")),Object(s.mdx)("li",{parentName:"ul"},Object(s.mdx)("p",{parentName:"li"},"SolrCloud has support for replication and sharding. It is highly recommended to use SolrCloud with at least two Apache Solr nodes running on different servers with replication enabled.\nIf using SolrCloud, then you also need ZooKeeper installed and configured with 3 or 5 ZooKeeper nodes")),Object(s.mdx)("li",{parentName:"ul"},Object(s.mdx)("p",{parentName:"li"},"Start Apache Solr in http mode - alternative setup to Solr in cloud mode."),Object(s.mdx)("p",{parentName:"li"},"Solr Standalone is used for a single instance, and it keeps configuration information on the file system. It does not require zookeeper and provides high performance for medium size index.\nCan be considered as a good option for fast prototyping as well as valid configuration for development environments. In some cases it demonstrates a better performance than solr cloud mode in production grade setup of Atlas.")),Object(s.mdx)("li",{parentName:"ul"},Object(s.mdx)("p",{parentName:"li"},"Change ATLAS configuration to point to Standalone Apache Solr instance setup. Please make sure the following configurations are set to the below values in ATLAS_HOME/conf/atlas-application.properties"))),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"atlas.graph.index.search.backend=solr\natlas.graph.index.search.solr.mode=http\natlas.graph.index.search.solr.http-urls=<a single or list of URLs for the Solr instances must be provided.> eg: localhost:2181,10.1.6.5:2181"),Object(s.mdx)("p",null," Note: Solr standalone can be run in embedded mode using ",Object(s.mdx)("inlineCode",{parentName:"p"},"embedded-hbase-solr")," profile."),Object(s.mdx)("p",null,Object(s.mdx)("em",{parentName:"p"},"Configuring Elasticsearch as the indexing backend for the Graph Repository (Tech Preview)")),Object(s.mdx)("p",null,"By default, Apache Atlas uses ",Object(s.mdx)("a",{parentName:"p",href:"https://janusgraph.org/"},"JanusGraph")," as the graph repository and is the only graph repository implementation available currently. For configuring ",Object(s.mdx)("a",{parentName:"p",href:"https://janusgraph.org/"},"JanusGraph")," to work with Elasticsearch, please follow the instructions below"),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Install an Elasticsearch cluster. The version currently supported is 5.6.4, and can be acquired from: ",Object(s.mdx)("a",{parentName:"li",href:"https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.6.4.tar.gz"},"https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.6.4.tar.gz"))),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"For simple testing a single Elasticsearch node can be started by using the 'elasticsearch' command in the bin directory of the Elasticsearch distribution.")),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Change Apache Atlas configuration to point to the Elasticsearch instance setup. Please make sure the following configurations are set to the below values in ATLAS_HOME/conf/atlas-application.properties")),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},"atlas.graph.index.search.backend=elasticsearch\natlas.graph.index.search.hostname=<the hostname(s) of the Elasticsearch master nodes comma separated>\natlas.graph.index.search.elasticsearch.client-only=true"),Object(s.mdx)("p",null,"For more information on JanusGraph configuration for elasticsearch, please refer ",Object(s.mdx)("a",{parentName:"p",href:"http://docs.janusgraph.org/0.2.0/elasticsearch.html"},"http://docs.janusgraph.org/0.2.0/elasticsearch.html")),Object(s.mdx)("h4",{id:"configuring-kafka-topics"},"Configuring Kafka Topics"),Object(s.mdx)("p",null,"Apache Atlas uses Apache Kafka to ingest metadata from other components at runtime. This is described in the ",Object(s.mdx)("a",{parentName:"p",href:"#/Architecture"},"Architecture"),"\nin more detail. Depending on the configuration of Apache Kafka, sometimes you might need to setup the topics explicitly before\nusing Apache Atlas. To do so, Apache Atlas provides a script =bin/atlas_kafka_setup.py= which can be run from Apache Atlas server. In some\nenvironments, the hooks might start getting used first before Apache Atlas server itself is setup. In such cases, the topics\ncan be run on the hosts where hooks are installed using a similar script ",Object(s.mdx)("inlineCode",{parentName:"p"},"hook-bin/atlas_kafka_setup_hook.py"),". Both these\nuse configuration in ",Object(s.mdx)("inlineCode",{parentName:"p"},"atlas-application.properties")," for setting up the topics. Please refer to the ",Object(s.mdx)("a",{parentName:"p",href:"#/Configuration"},"Configuration"),"\nfor these details."),Object(s.mdx)("h4",{id:"setting-up-apache-atlas"},"Setting up Apache Atlas"),Object(s.mdx)("p",null,"There are a few steps that setup dependencies of Apache Atlas. One such example is setting up the JanusGraph schema in the storage backend of choice. In a simple single server setup, these are automatically setup with default configuration when the server first accesses these dependencies."),Object(s.mdx)("p",null,"However, there are scenarios when we may want to run setup steps explicitly as one time operations. For example, in a multiple server scenario using ",Object(s.mdx)("a",{parentName:"p",href:"#/HighAvailability"},"High Availability"),", it is preferable to run setup steps from one of the server instances the first time, and then start the services."),Object(s.mdx)("p",null,"To run these steps one time, execute the command =bin/atlas_start.py -setup= from a single Apache Atlas server instance."),Object(s.mdx)("p",null,"However, Apache Atlas server does take care of parallel executions of the setup steps. Also, running the setup steps multiple times is idempotent. Therefore, if one chooses to run the setup steps as part of server startup, for convenience, then they should enable the configuration option ",Object(s.mdx)("inlineCode",{parentName:"p"},"atlas.server.run.setup.on.start")," by defining it with the value ",Object(s.mdx)("inlineCode",{parentName:"p"},"true")," in the ",Object(s.mdx)("inlineCode",{parentName:"p"},"atlas-application.properties")," file."),Object(s.mdx)("h3",{id:"examples-calling-apache-atlas-rest-apis"},"Examples: calling Apache Atlas REST APIs"),Object(s.mdx)("p",null,"Here are few examples of calling Apache Atlas REST APIs via curl command."),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"List the types in the repository")),Object(s.mdx)(o.a,{wrapLines:!0,language:"powershell",style:r.a,mdxType:"SyntaxHighlighter"},'curl -u username:password http://localhost:21000/api/atlas/v2/types/typedefs/headers\n [ {"guid":"fa421be8-c21b-4cf8-a226-fdde559ad598","name":"Referenceable","category":"ENTITY"},\n {"guid":"7f3f5712-521d-450d-9bb2-ba996b6f2a4e","name":"Asset","category":"ENTITY"},\n {"guid":"84b02fa0-e2f4-4cc4-8b24-d2371cd00375","name":"DataSet","category":"ENTITY"},\n {"guid":"f93975d5-5a5c-41da-ad9d-eb7c4f91a093","name":"Process","category":"ENTITY"},\n {"guid":"79dcd1f9-f350-4f7b-b706-5bab416f8206","name":"Infrastructure","category":"ENTITY"}\n ]'),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"List the instances for a given type")),Object(s.mdx)(o.a,{wrapLines:!0,language:"json",style:r.a,mdxType:"SyntaxHighlighter"},'curl -u username:password http://localhost:21000/api/atlas/v2/search/basic?typeName=hive_db\n {\n "queryType":"BASIC",\n "searchParameters":{\n "typeName":"hive_db",\n "excludeDeletedEntities":false,\n "includeClassificationAttributes":false,\n "includeSubTypes":true,\n "includeSubClassifications":true,\n "limit":100,\n "offset":0\n },\n "entities":[\n {\n "typeName":"hive_db",\n "guid":"5d900c19-094d-4681-8a86-4eb1d6ffbe89",\n "status":"ACTIVE",\n "displayText":"default",\n "classificationNames":[],\n "attributes":{\n "owner":"public",\n "createTime":null,\n "qualifiedName":"default@cl1",\n "name":"default",\n "description":"Default Hive database"\n }\n },\n {\n "typeName":"hive_db",\n "guid":"3a0b14b0-ab85-4b65-89f2-e418f3f7f77c",\n "status":"ACTIVE",\n "displayText":"finance",\n "classificationNames":[],\n "attributes":{\n "owner":"hive",\n "createTime":null,\n "qualifiedName":"finance@cl1",\n "name":"finance",\n "description":null\n }\n }\n ]\n }'),Object(s.mdx)("ul",null,Object(s.mdx)("li",{parentName:"ul"},"Search for entities")),Object(s.mdx)(o.a,{wrapLines:!0,language:"json",style:r.a,mdxType:"SyntaxHighlighter"},'curl -u username:password http://localhost:21000/api/atlas/v2/search/dsl?query=hive_db%20where%20name=\'default\'\n {\n "queryType":"DSL",\n "queryText":"hive_db where name=\'default\'",\n "entities":[\n {\n "typeName":"hive_db",\n "guid":"5d900c19-094d-4681-8a86-4eb1d6ffbe89",\n "status":"ACTIVE",\n "displayText":"default",\n "classificationNames":[],\n "attributes":{\n "owner":"public",\n "createTime":null,\n "qualifiedName":"default@cl1",\n "name":"default",\n "description":\n "Default Hive database"\n }\n }\n ]\n }'),Object(s.mdx)("h3",{id:"troubleshooting"},"Troubleshooting"),Object(s.mdx)("h4",{id:"setup-issues"},"Setup issues"),Object(s.mdx)("p",null,"If the setup of Apache Atlas service fails due to any reason, the next run of setup (either by an explicit invocation of\n",Object(s.mdx)("inlineCode",{parentName:"p"},"atlas_start.py -setup")," or by enabling the configuration option ",Object(s.mdx)("inlineCode",{parentName:"p"},"atlas.server.run.setup.on.start"),") will fail with\na message such as ",Object(s.mdx)("inlineCode",{parentName:"p"},"A previous setup run may not have completed cleanly."),". In such cases, you would need to manually\nensure the setup can run and delete the Zookeeper node at ",Object(s.mdx)("inlineCode",{parentName:"p"},"/apache_atlas/setup_in_progress")," before attempting to\nrun setup again."),Object(s.mdx)("p",null,"If the setup failed due to Apache HBase schema setup errors, it may be necessary to repair Apache HBase schema. If no\ndata has been stored, one can also disable and drop the Apache HBase tables used by Apache Atlas and run setup again."))}c&&c===Object(c)&&Object.isExtensible(c)&&Object.defineProperty(c,"__filemeta",{enumerable:!0,configurable:!0,value:{name:"MDXContent",filename:"src/documents/Setup/InstallationInstruction.md"}}),c.isMDXComponent=!0},"./theme/styles/styled-colors.js":function(e,a,t){"use strict";var n=t("../node_modules/react-syntax-highlighter/dist/esm/styles/hljs/dark.js");n.a.hljs.color="#37bb9b",a.a=n.a}}]); |
