Neo4j 2.1.2 – Maintenance Release


Neo4j 2.1.2 is a patch release recommended for all users, available for immediate download.

Release Notes


Notable changes in Neo4j 2.1.2:
  • Cypher uses indexes for resolving WHERE clauses which use the IN operator
  • Resolves a recovery issue, where multiple forced-restarts in a row, without clean shutdown or log rotation in between, could lead to some transactions not being replayed on recovery
  • Neo4j Browser now defaults to long intervals of heartbeat pings to server, lowering CPU use and network traffic
  • Corrects a critical issue that can occur during migration from previous Neo4j releases, which could lead to incorrect record structures if the previous store had a large volume of deleted data

A concern about Neo4j 2.1.1


Shortly after the release of Neo4j 2.1.1, we discovered a critical issue that can occur during the upgrade of particular stores. While initial analysis suggested that the issue would impact only a small percentage of deployments, our product and engineering teams deemed it appropriate to pull the download and delay its availability, as a precaution while we sought to understand the scope of the issue and begin work toward a resolution. We now have a clear understanding of the issue and have released an update, Neo4j 2.1.2, which corrects this.

What to do now


If you have downloaded Neo4j 2.1.1, we strongly urge you to check if you have been affected by this issue, which will occur when migrating a data store from Neo4j 2.0 versions. The problem we have identified happens when a large amount of data has been deleted prior to migration. You can follow the following procedure to determine whether your application has encountered an issue. This procedure relies on a utility that is not present in Neo4j Community Edition. Community Edition users may use an evaluation license of Neo4j Enterprise 2.1.2 for the purpose of carrying out this check.

Checking your graph:
  1. Backup your database as described in the Neo4j Manual.
  2. The neo4j-backup tool will conduct a consistency check which will reveal any problems.
    1. There’s an excellent DZone article, by Mark Needham, which describes some of the details.
  3. If a problem is detected, please revert to an earlier (pre-2.1.1) backup.
Upgrade to Neo4j 2.1.2 only from a database store which you’ve verified to be in a consistent state. For any questions or concerns, reach out to us on the google group to discuss. Your success is our success.

What we’re doing now


Our team at Neo4j remains committed to pushing the envelope whilst ensuring the quality expected of software used in mission-critical applications. Every commit to GitHub triggers a cascade of punishing tests covering every aspect of the database. Extensive unit tests are followed by long running stress tests, which simulate heavy load and recovery in a variety of adverse conditions.

Every day, our community deploys Neo4j in new applications across a wide range of industries. It is the feedback from this community that helps with the development of new features in Neo4j, and in further improving the scope and depth of our product testing. We have now augmented our quality testing with additional upgrade tests, which includes a variety of obfuscated real life production stores and even more diverse generated stores.

We thank you for using Neo4j and for being part of our community.

— the Neo4j Team

Want to learn more about graph databases? Click below to get your free copy of O’Reilly’s Graph Databases ebook and discover how to use graph technologies for your application today.

Download My Ebook