Skip to content

Commit 4d4157b

Browse files
Restructure 1.0.0 changelog CTR
Signed-off-by: Florian Hockmann <fh@florian-hockmann.de>
1 parent f35a903 commit 4d4157b

1 file changed

Lines changed: 38 additions & 34 deletions

File tree

docs/changelog.md

Lines changed: 38 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ use the latest versions of the software.
1919
### Version Compatibility Matrix
2020

2121
#### Currently supported
22+
2223
All currently supported versions of JanusGraph are listed below.
2324

2425
!!! info
@@ -30,6 +31,7 @@ All currently supported versions of JanusGraph are listed below.
3031
| 1.0.z | 2 | 3.11.z, 4.0.z | 2.5.z | 1.3.0, 1.4.0, 1.5.z, 1.6.z, 1.7.z, 1.8.z, 1.9.z, 1.10.z, 1.11.z, 1.14.z | 6.y, 7.y | 8.y | 3.6.z | 3.2.z | 2.12.z |
3132

3233
#### End-of-Life
34+
3335
The versions of JanusGraph listed below are outdated and will no longer receive bugfixes.
3436

3537
| JanusGraph | Storage Version | Cassandra | HBase | Bigtable | Elasticsearch | Solr | TinkerPop | Spark | Scala |
@@ -68,7 +70,7 @@ compile "org.janusgraph:janusgraph-core:1.0.0"
6870
* Apache TinkerPop 3.6.1
6971
* Java 8, 11
7072

71-
**Installed versions in the Pre-Packaged Distribution**
73+
**Installed versions in the Pre-Packaged Distribution:**
7274

7375
* Cassandra 4.0.6
7476
* Elasticsearch 7.14.0
@@ -88,10 +90,25 @@ For more information on features and bug fixes in 1.0.0, see the GitHub mileston
8890

8991
#### Upgrade Instructions
9092

93+
##### Add support for Java 11
94+
95+
JanusGraph now officially supports Java 11 in addition to Java 8. We encourage everyone to update to Java 11.
96+
97+
!!! note
98+
The pre-packaged distribution now requires Java 11.
99+
100+
##### Upgrade of log4j to version 2
101+
102+
This change requires a new log4j configuration. You can find an example configuration in `conf/log4j2-server.xml`. As a result of the changed configuration format,
103+
we clean up all configurations. This could lead to unexpected new log lines. Please open an issue, if you see any unwanted log line.
104+
105+
!!! note
106+
Log4j is only used for standalone server deployments and JanusGraph testing.
107+
91108
##### Removal of cassandra-all dependency
92109

93-
JanusGraph had a dependency on cassandra-all only for some Hadoop-related classes. We moved these few classes into
94-
a new module cassandra-hadoop-util to reduce the dependencies of JanusGraph. If you are running JanusGraph with
110+
JanusGraph had a dependency on cassandra-all only for some Hadoop-related classes. We moved these few classes into
111+
a new module cassandra-hadoop-util to reduce the dependencies of JanusGraph. If you are running JanusGraph with
95112
an embeded Cassandra, you have to exclude the `cassandra-hadoop-util` from `janusgraph-cql`.
96113

97114
##### Drop support for HBase 1
@@ -102,9 +119,15 @@ We are dropping support for HBase 1.
102119

103120
We are dropping support for Solr 7.
104121

122+
##### Drop support for Gryo MessageSerializer
123+
124+
Support for Gryo MessageSerializer [has been dropped in TinkerPop 3.6.0](https://tinkerpop.apache.org/docs/3.6.1/upgrade/#_removed_gryo_messageserializers)
125+
and we therefore also no longer support it in JanusGraph.
126+
GraphBinary is now used as the default MessageSerializer.hb
127+
105128
##### Breaking change for Geoshape GraphBinary serialization
106129

107-
Support for the [GraphBinary](http://tinkerpop.apache.org/docs/3.5.1/dev/io/#graphbinary) serialization format was
130+
Support for the [GraphBinary](http://tinkerpop.apache.org/docs/3.6.1/dev/io/#graphbinary) serialization format was
108131
added in JanusGraph 0.6.0. This also included support to serialize Geoshapes via GraphBinary. The implementation of the
109132
Geoshape serializer was unfortunately closely tied to the Java library `Spatial4j` that we are using to implement
110133
Geoshapes in Java. This made it very complicated to add support for GraphBinary in other languages than Java. To make
@@ -127,6 +150,17 @@ example.
127150

128151
Users who don't want to use this feature can simply continue providing the `index.name` in the template configuration.
129152

153+
##### Remove support for old serialization format of JanusGraph predicates
154+
155+
We are dropping support for old serialization format of JanusGraph predicates. The old predicates serialization format is only used by client older than 0.6.
156+
The change only affects GraphSON.
157+
158+
##### Mixed index aggregation optimization
159+
160+
A new optimization has been added to compute aggregations (min, max, sum and avg) using mixed index engine (if the aggregation function follows an indexed query).
161+
If the index backend is Elasticsearch, a `double` value is used to hold the result. As a result, aggregations on long numbers greater than 2^53 are approximate.
162+
In this case, if the accurate result is essential, the optimization can be disabled by removing the strategy `JanusGraphMixedIndexAggStrategy`: `g.traversal().withoutStrategies(JanusGraphMixedIndexAggStrategy.class)`.
163+
130164
##### Removal of deprecated classes/methods/functionalities
131165

132166
###### Methods
@@ -157,36 +191,6 @@ Users who don't want to use this feature can simply continue providing the `inde
157191
* RemovableRelationIterator class
158192
* ImmutableConfiguration class
159193

160-
##### Remove support for old serialization format of JanusGraph predicates
161-
162-
We are dropping support for old serialization format of JanusGraph predicates. The old predicates serialization format is only used by client older than 0.6.
163-
The change only affects Gryo and GraphSON.
164-
165-
##### Upgrade of log4j to version 2
166-
167-
This change requires a new log4j configuration. You can find an example configuration in `conf/log4j2-server.xml`. As a result of the changed configuration format,
168-
we clean up all configurations. This could lead to unexpected new log lines. Please open an issue, if you see any unwanted log line.
169-
170-
!!! note
171-
Log4j is only used for standalone server deployments and JanusGraph testing.
172-
173-
##### Add support for Java 11
174-
175-
JanusGraph now officially supports Java 11 in addition to Java 8. We encourage everyone to update to Java 11.
176-
177-
!!! note
178-
The pre-packaged distribution now requires Java 11.
179-
180-
##### Drop support for
181-
182-
Preparation for TinkerPop 3.6.
183-
184-
##### Mixed index aggregation optimization
185-
186-
A new optimization has been added to compute aggregations (min, max, sum and avg) using mixed index engine (if the aggregation function follows an indexed query).
187-
If the index backend is Elasticsearch, a `double` value is used to hold the result. As a result, aggregations on long numbers greater than 2^53 are approximate.
188-
In this case, if the accurate result is essential, the optimization can be disabled by removing the strategy `JanusGraphMixedIndexAggStrategy`: `g.traversal().withoutStrategies(JanusGraphMixedIndexAggStrategy.class)`.
189-
190194
### Version 0.6.3 (Release Date: ???)
191195

192196
```xml tab='Maven'

0 commit comments

Comments
 (0)