| (window.webpackJsonp=window.webpackJsonp||[]).push([[49],{"./src/documents/Tools/AtlasRepairIndex.md":function(e,t,a){"use strict";a.r(t),a.d(t,"default",(function(){return d}));var s=a("../node_modules/babel-preset-react-app/node_modules/@babel/runtime/helpers/esm/objectWithoutProperties.js"),i=(a("../node_modules/react/index.js"),a("../node_modules/@mdx-js/react/dist/esm.js")),l=(a("./theme/styles/styled-colors.js"),a("../node_modules/react-syntax-highlighter/dist/esm/styles/hljs/dark.js")),n=a("../node_modules/react-syntax-highlighter/dist/esm/default-highlight.js"),r=["components"],o={};function d(e){var t=e.components,a=Object(s.a)(e,r);return Object(i.mdx)("wrapper",Object.assign({},o,a,{components:t,mdxType:"MDXLayout"}),Object(i.mdx)("h1",{id:"atlas-repair-index"},"Atlas Repair Index"),Object(i.mdx)("h2",{id:"introduction"},"Introduction"),Object(i.mdx)("p",null,"The document describes the use of the Atlas Index Repair Utility for JanusGraph, with HBase as back-end data store and Solr as index store."),Object(i.mdx)("h4",{id:"need-for-this-tool"},"Need for this Tool"),Object(i.mdx)("p",null,"In rare, cases it is possible that during entity creation, the entity is stored in the data store, but the corresponding indexes are not created in Solr. Since Atlas relies heavily on Solr in the operation of its Basic Search, this will result in entity not being returned by a search. Note that Advanced Search is not affected by this."),Object(i.mdx)("h4",{id:"location"},"Location"),Object(i.mdx)("p",null,"The tool is part of the normal Atlas installation, it is located under the tools/atlas-index-repair directory."),Object(i.mdx)("h4",{id:"steps-to-execute-tool"},"Steps to Execute Tool"),Object(i.mdx)("h5",{id:"complete-restore"},"Complete Restore"),Object(i.mdx)("p",null,"If the user needs to restore all the indexes, this can be accomplished by executing the tool with no command-line parameters:"),Object(i.mdx)(n.a,{wrapLines:!0,language:"powershell",style:l.a,mdxType:"SyntaxHighlighter"},"atlas-index-repair/repair_index.py"),Object(i.mdx)("p",null,"This will result in vertex_index, edge_index and fulltext_index to be re-built completely. It is recommended that existing contents of these indexes be deleted before executing this restore."),Object(i.mdx)("h6",{id:"caveats"},"Caveats"),Object(i.mdx)("p",null,"Note that the full index repair is a time-consuming process. Depending on the size of data the process may take days to complete. During the restore process the Basic Search functionality will not be available. Be sure to allocate sufficient time for this activity."),Object(i.mdx)("h5",{id:"selective-restore"},"Selective Restore"),Object(i.mdx)("p",null,"To perform selective restore for an Atlas entity, specify the GUID of that entity:"),Object(i.mdx)(n.a,{wrapLines:!0,language:"powershell",style:l.a,mdxType:"SyntaxHighlighter"},"atlas-index-repair/repair_index.py [-g <guid>]"),Object(i.mdx)("p",null,"Example:"),Object(i.mdx)(n.a,{wrapLines:!0,language:"powershell",style:l.a,mdxType:"SyntaxHighlighter"},"atlas-index-repair/repair_index.py -g 13d77457-2a45-4e92-ad53-a172c7cb70a5"),Object(i.mdx)("p",null,"Note that Atlas will use REST APIs to fetch the entity, which will need correct authentication mechanism to be specified based on the installation."),Object(i.mdx)("p",null,"For an Atlas installation with username and password use:"),Object(i.mdx)(n.a,{wrapLines:!0,language:"powershell",style:l.a,mdxType:"SyntaxHighlighter"},"atlas-index-repair/repair_index.py [-g <guid>] [-u <user>] [-p <password>]"),Object(i.mdx)("ul",null,Object(i.mdx)("li",{parentName:"ul"},"guid: ","[optional]"," specify guid for which indexes are to be updated"),Object(i.mdx)("li",{parentName:"ul"},"user: ","[optional]"," specify username for atlas instance"),Object(i.mdx)("li",{parentName:"ul"},"password: ","[optional]"," specify password for atlas instance")),Object(i.mdx)("p",null,"Example:"),Object(i.mdx)(n.a,{wrapLines:!0,language:"powershell",style:l.a,mdxType:"SyntaxHighlighter"},"atlas-index-repair/repair_index.py -u admin -p admin123 -g\n\t13d77457-2a45-4e92-ad53-a172c7cb70a5"),Object(i.mdx)("p",null,"For Atlas installation that uses kerberos as authentication mode,\nuse: "),Object(i.mdx)("ul",null,Object(i.mdx)("li",{parentName:"ul"},"Add below to DEFAULT_JVM_OPTS in repair_index.py",Object(i.mdx)(n.a,{wrapLines:!0,language:"powershell",style:l.a,mdxType:"SyntaxHighlighter"},"-Djavax.security.auth.useSubjectCredsOnly=false -Djava.security.auth.login.config=atlas_jaas.conf")),Object(i.mdx)("li",{parentName:"ul"},"kinit -kt /etc/security/keytabs/atlas.service.keytab atlas/fqdn@DOMAIN")),Object(i.mdx)("p",null,"For Atlas installation that uses SSL, we need to make sure to add Solr cert or RootCA certificate, use below atlas-application properties:"),Object(i.mdx)("ul",null,Object(i.mdx)("li",{parentName:"ul"},"keystore.file {path to keystore jks file}"),Object(i.mdx)("li",{parentName:"ul"},"truststore.file {path to truststore jks file}"),Object(i.mdx)("li",{parentName:"ul"},"cert.stores.credential.provider.path {path to jceks file}")),Object(i.mdx)("p",null,"Example:"),Object(i.mdx)(n.a,{wrapLines:!0,language:"powershell",style:l.a,mdxType:"SyntaxHighlighter"},"kinit -kt /etc/security/keytabs/atlas.service.keytab atlas/fqdn@EXAMPLE.com\n\tatlas-index-repair/repair_index.py -g 13d77457-2a45-4e92-ad53-a172c7cb70a5"))}d&&d===Object(d)&&Object.isExtensible(d)&&Object.defineProperty(d,"__filemeta",{enumerable:!0,configurable:!0,value:{name:"MDXContent",filename:"src/documents/Tools/AtlasRepairIndex.md"}}),d.isMDXComponent=!0},"./theme/styles/styled-colors.js":function(e,t,a){"use strict";var s=a("../node_modules/react-syntax-highlighter/dist/esm/styles/hljs/dark.js");s.a.hljs.color="#37bb9b",t.a=s.a}}]); |
