-
Notifications
You must be signed in to change notification settings - Fork 16
/
Copy pathupgrade.html
76 lines (76 loc) · 12.5 KB
/
upgrade.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Appendix D. Upgrade Instructions</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="JanusGraph Documentation"><link rel="up" href="appendices.html" title="Part VIII. Appendices"><link rel="prev" href="changelog.html" title="Appendix C. Release Notes"><link rel="next" href="doc-versions.html" title="Appendix E. Other documentation versions"><script xmlns:d="http://docbook.org/ns/docbook" type="text/javascript" src="js/jquery/jquery-1.11.0.js"></script><script xmlns:d="http://docbook.org/ns/docbook" type="text/javascript" src="js/jquery/jquery-migrate-1.2.1.min.js"></script><link xmlns:d="http://docbook.org/ns/docbook" rel="stylesheet" id="inline-blob-janusgraph-docs-specific" href="css/docs.css" type="text/css" media="all"><link xmlns:d="http://docbook.org/ns/docbook" rel="apple-touch-icon" type="image/png" href="images/janusgraph-logomark.png"><script xmlns:d="http://docbook.org/ns/docbook" type="text/javascript">
WebFontConfig = {
google: {
families: [
"Lato:400,400italic,700,700italic:latin,greek-ext,cyrillic,latin-ext,greek,cyrillic-ext,vietnamese",
"Open+Sans:400,400italic,700,700italic:latin,greek-ext,cyrillic,latin-ext,greek,cyrillic-ext,vietnamese",
"Antic+Slab:400,400italic,700,700italic:latin,greek-ext,cyrillic,latin-ext,greek,cyrillic-ext,vietnamese"
]
}
};
(function() {
var wf = document.createElement('script');
wf.src = ('https:' == document.location.protocol ? 'https' : 'http') +
'://ajax.googleapis.com/ajax/libs/webfont/1/webfont.js';
wf.type = 'text/javascript';
wf.async = 'true';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(wf, s);
})();
</script></head><body xmlns:d="http://docbook.org/ns/docbook" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="wrapper"><div class="header-wrapper"><header id="header"><ul class="header-list"><li class="header-item"><a href="http://janusgraph.org"><img src="images/janusgraph-logo.png" alt="JanusGraph" class="normal_logo"></a></li><li class="header-item-right"><a href="https://github.com/JanusGraph/janusgraph/releases">Download JanusGraph</a></li><li class="header-item-right dropdown"><a href="https://docs.janusgraph.org/latest/doc-versions.html">Other Doc Versions</a><div class="dropdown-content"><a href="https://docs.janusgraph.org/latest/index.html">Latest</a><a href="https://docs.janusgraph.org/0.3.0/index.html">Version 0.3.0</a><a href="https://docs.janusgraph.org/0.2.2/index.html">Version 0.2.2</a><a href="https://docs.janusgraph.org/0.2.1/index.html">Version 0.2.1</a><a href="https://docs.janusgraph.org/0.2.0/index.html">Version 0.2.0</a><a href="https://docs.janusgraph.org/0.1.1/index.html">Version 0.1.1</a><a href="https://docs.janusgraph.org/0.1.0/index.html">Version 0.1.0</a></div></li><li class="header-item-right"><a href="index.html">Documentation (0.2.2)</a></li></ul></header></div><div id="main" class="clearfix width-100"><div class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">JanusGraph Documentation</a></span> > <span class="breadcrumb-link"><a href="appendices.html">Appendices</a></span> > <span class="breadcrumb-node">Upgrade Instructions</span></div><div class="appendix"><div class="titlepage"><div><div><h2 class="title"><a name="upgrade"></a>Appendix D. Upgrade Instructions</h2></div></div></div><p>Please follow these instructions when upgrading from Titan or an older
JanusGraph release.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_upgrading_from_titan_1_0_0_1_1_0_snapshot"></a>D.1. Upgrading from Titan 1.0.0, 1.1.0-SNAPSHOT</h2></div></div></div><p>JanusGraph is based on the latest commit to the <code class="literal">titan11</code> branch of
<a class="link" href="https://github.com/thinkaurelius/titan" target="_top">Titan repo</a>.</p><p>JanusGraph has made the following changes to Titan, so you will need to adjust
your code and configuration accordingly:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">module names: <code class="literal">titan-*</code> are now <code class="literal">janusgraph-*</code></li><li class="listitem">package names: <code class="literal">com.thinkaurelius.titan</code> are now <code class="literal">org.janusgraph</code></li><li class="listitem">class names: <code class="literal">Titan*</code> are now <code class="literal">JanusGraph*</code> except in cases where this would
duplicate a word, e.g., <code class="literal">TitanGraph</code> is simply <code class="literal">JanusGraph</code> rather than
<code class="literal">JanusGraphGraph</code></li></ol></div><p>For more information on how to configure JanusGraph to read data which had
previously been written by Titan refer to <a class="xref" href="migrating-titan.html" title="Chapter 38. Migrating from Titan">Chapter 38, <i>Migrating from Titan</i></a>.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_upgrading_from_janusgraph_0_1_z"></a>D.2. Upgrading from JanusGraph 0.1.z</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="_elasticsearch"></a>D.2.1. Elasticsearch</h3></div></div></div><p>JanusGraph 0.1.z is compatible with Elasticsearch 1.5.z. There were several
configuration options available, including transport client, node client, and
legacy configuration track. JanusGraph 0.2.0 is compatible with Elasticsearch
versions from 1.y through 6.y, however it offers only a single configuration
option using the REST client.</p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="_transport_client"></a>D.2.1.1. Transport client</h4></div></div></div><p>The <code class="literal">TRANSPORT_CLIENT</code> interface has been replaced with <code class="literal">REST_CLIENT</code>. When
migrating an existing graph to JanusGraph 0.2.0, the <code class="literal">interface</code> property must
be set when connecting to the graph:</p><pre class="programlisting"><span class="hl-attribute">index.search.backend</span>=elasticsearch
<span class="hl-attribute">index.search.elasticsearch.interface</span>=REST_CLIENT
<span class="hl-attribute">index.search.hostname</span>=127.0.0.1</pre><p>After connecting to the graph, the property update can be made permanent by
making the change with <code class="literal">JanusGraphManagement</code>:</p><pre class="programlisting">mgmt<span class="hl-gremlin-func"> </span>=<span class="hl-gremlin-func"> </span>graph.openManagement<span class="hl-gremlin-func">(</span><span class="hl-gremlin-func">)</span><span class="hl-gremlin-func">
</span>mgmt.set<span class="hl-gremlin-func">(</span><span class="hl-string">"index.search.elasticsearch.interface"</span>,<span class="hl-gremlin-func"> </span><span class="hl-string">"REST_CLIENT"</span><span class="hl-gremlin-func">)</span><span class="hl-gremlin-func">
</span>mgmt.commit<span class="hl-gremlin-func">(</span><span class="hl-gremlin-func">)</span></pre></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="_node_client"></a>D.2.1.2. Node client</h4></div></div></div><p>A node client with JanusGraph can be configured in a few ways. If the node
client was configured as a client-only or non-data node, follow the steps
from the <a class="link" href="upgrade.html#_transport_client" title="D.2.1.1. Transport client">transport client</a> section to connect to the
existing cluster using the <code class="literal">REST_CLIENT</code> instead. If the node client was
a data node (local-mode), then convert it into a standalone Elasticsearch
node, running in a separate JVM from your application process. This can be
done by using the node’s configuration from the JanusGraph configuration to
start a standalone Elasticsearch 1.5.z node. For example, we start with these
JanusGraph 0.1.z properties:</p><pre class="programlisting"><span class="hl-attribute">index.search.backend</span>=elasticsearch
<span class="hl-attribute">index.search.elasticsearch.interface</span>=NODE
<span class="hl-attribute">index.search.conf-file</span>=es-client.yml
<span class="hl-attribute">index.search.elasticsearch.ext.node.name</span>=alice</pre><p>where the configuration file <code class="literal">es-client.yml</code> has properties:</p><pre class="programlisting">node.data: true
path.data: /var/lib/elasticsearch/data
path.work: /var/lib/elasticsearch/work
path.logs: /var/log/elasticsearch</pre><p>The properties found in the configuration file <code class="literal">es-client.yml</code> and the
<code class="literal">index.search.elasticsearch.ext.*</code> properties can be inserted into <code class="literal">$ES_HOME/config/elasticsearch.yml</code>
so that a standalone Elasticsearch 1.5.z node can be started with the same
properties. Keep in mind that if any <code class="literal">path</code> locations have relative paths,
those values may need to be updated appropriately. Once the standalone
Elasticsearch node is started, follow the directions in the <a class="link" href="upgrade.html#_transport_client" title="D.2.1.1. Transport client">transport client</a>
section to complete the migration to the <code class="literal">REST_CLIENT</code> interface. Note that
the <code class="literal">index.search.conf-file</code> and <code class="literal">index.search.elasticsearch.ext.*</code> properties
are not used by the <code class="literal">REST_CLIENT</code> interface, so they can be removed from the
configuration properties.</p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="_legacy_configuration"></a>D.2.1.3. Legacy configuration</h4></div></div></div><p>The legacy configuration track was not recommended in JanusGraph 0.1.z and is
no longer supported in JanusGraph 0.2.0. Users should refer to the previous
sections and migrate to the <code class="literal">REST_CLIENT</code>.</p></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_upgrading_from_janusgraph_0_2_0"></a>D.3. Upgrading from JanusGraph 0.2.0</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="_hbase_ttl"></a>D.3.1. HBase TTL</h3></div></div></div><p>In JanusGraph 0.2.0, time-to-live (TTL) support was added for HBase storage backend.
In order to utilize the TTL capability on HBase, the graph timestamps need to be
MILLI. If the <code class="literal">graph.timestamps</code> property is not explicitly set to MILLI, the default
is MICRO in JanusGraph 0.2.0, which does not work for HBase TTL. Since the <code class="literal">graph.timestamps</code>
property is FIXED, a new graph needs to be created to make any change of the <code class="literal">graph.timestamps</code>
property effective.</p></div></div></div></div><div class="clearer"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="changelog.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="appendices.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="doc-versions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix C. Release Notes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix E. Other documentation versions</td></tr></table></div><div class="footer-wrapper"><footer id="footer"><div class="copyright">
Copyright © 2017 JanusGraph Authors. All rights reserved.<br>
The Linux Foundation has registered trademarks and uses trademarks. For a list of<br>
trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage">Trademark Usage</a> page.<br>
Cassandra, Groovy, HBase, Hadoop, Lucene, Solr, and TinkerPop are trademarks of the Apache Software Foundation.<br>
Berkeley DB and Berkeley DB Java Edition are trademarks of Oracle.<br>
Documentation generated with <a href="http://www.methods.co.nz/asciidoc/">AsciiDoc</a>, <a href="http://asciidoctor.org/">AsciiDoctor</a>, <a href="http://docbook.sourceforge.net/">DocBook</a>, and <a href="http://saxon.sourceforge.net/">Saxon</a>.
</div></footer></div></div></body></html>