This section describes how to upgrade Neo4j from an earlier version.
Plan your upgrade by following the steps in this chapter.
Throughout this instruction, the directory used to store the Neo4j data is referred to as
The default path of the database directory is: <neo4j-home>/data/databases/graph.db
If you have a custom value for either of the parameters dbms.directories.data or dbms.active_database, this will affect the location of the database directory.
Before upgrading to a new major or minor release, the database must first be upgraded to the latest version within the relevant release. The latest version is available at this page: http://neo4j.com/download/other-releases. The following Neo4j upgrade paths are supported:
Read through the Upgrade guide at neo4j.com. The Upgrade guide is being maintained by Neo4j Customer Support and contains valuable information about upgrade actions particular to this release.
It happens that new configuration settings are introduced and that existing configurations are changed between versions. Any such changes are pointed out in the Upgrade guide mentioned above. Make sure that you have taken such changes into account.
As part of the upgrade planning, it is vital to test and potentially update the applications using Neo4j. How much development time required to update the code will depend on the particular application.
Check the plugins directory (see Section 3.1, “File locations”) to verify whether custom plugins are used in your deployment. Ensure that any plugins are compatible with Neo4j 3.1.3.
An upgrade requires substantial free disk space, as it makes an entire copy of the database.
For the upgrade, make sure to make available an additional ( 50% * size_of(
database directory) ).
In addition to this, do not forget to reserve the disk space needed for the pre-upgrade backup.
The upgraded database may require slightly larger data files overall.
Based on the findings in this chapter, allocate a test environment for the upgrade and do a test upgrade. The test upgrade will give you valuable information about the time required for the production upgrade, as well as potential additional action points such as upgrade of plugins and application code.