Migrating from 4.4 Community Edition to 4.4 Enterprise Edition

You can move from the Neo4j 4.4 Community Edition to the Neo4j 4.4 Enterprise Edition using the following steps.

Prepare your data and the neo4j.conf file

  1. Stop the running Neo4j 4.4 Community Edition server:

    neo4j stop
  2. Backup the system and neo4j databases using the neo4j-admin dump command:

    neo4j-admin dump --database=neo4j --to=/dumps/neo4j/neo4j-<timestamp>.dump
    neo4j-admin dump --database=system --to=/dumps/neo4j/system-<timestamp>.dump

    By default, dumps are located in data/dumps/. Alternatively, the location can be defined via the conf/neo4j.conf setting link:dbms.directories.dumps.root.

  3. Prepare a neo4j.conf file to be used by the new installation if you have any custom values configured in your old neo4j.conf file. Look for:

    • Any non-default settings.

    • Any custom values of the settings dbms.directories.* and dbms.default_database.

Install the Neo4j 4.4 Enterprise Edition

For Debian/RPM distributions

  1. Uninstall Neo4j 4.4 Community Edition.

    1. Create a backup using the neo4j admin dump command to avoid losing your data.

    2. Uninstall Neo4j by running the command:

      ---
      sudo apt remove neo4j
      ---
    1. Create a backup using the neo4j admin dump command to avoid losing your data.

    2. Uninstall Neo4j by running the following command:

      ---
      sudo yum remove neo4j
      ---
  2. Install Neo4j 4.4 Enterprise Edition.

For Windows/Docker/Linux tar.gz distributions

Follow the guidelines for the distribution you use:

Complete the migration from Community to the Enterprise Edition

  1. Replace the neo4j.conf file with the one that you have prepared.

  2. Copy all the files used for encryption, such as private key, public certificate, and the contents of the trusted and revoked directories (located in <neo4j-home>/certificates/).

  3. Load the system and neo4j databases into the Neo4j 4.4 Enterprise Edition server using neo4j-admin load:

    neo4j-admin load neo4j --from=/dumps/neo4j/neo4j-<timestamp>.dump
    neo4j-admin load system --from=/dumps/neo4j/system-<timestamp>.dump
  4. Navigate to the Neo4j 4.4 Enterprise Edition server and start the instance by running the following command from <neo4j-home>:

    neo4j start

    The upgrade takes place during startup.

  5. You must manually upgrade the system database. Connect to the system database and run the following procedure:

    CALL dbms.upgrade();
  6. Drop the existing neo4j database that was created by default on startup. Note, this does not remove any store files loaded via neo4j-admin load.

    DROP DATABASE neo4j;
  7. Create the neo4j database using the store files loaded via neo4j-admin load:

    CREATE DATABASE neo4j;
  8. Monitor the neo4j.log file for information on how many steps the upgrade involves and how far it has progressed.