Upgrading to ArangoDB 2.2

    Please note first that a database directory used with ArangoDB 2.2cannot be used with earlier versions (e.g. ArangoDB 2.1) anymore. Upgrading a database directory cannot be reverted. Thereforeplease make sure to create a full backup of your existing ArangoDBinstallation before performing an upgrade.

    ArangoDB will perform a database version check at startup. When ArangoDB 2.2encounters a database created with earlier versions of ArangoDB, it will refuseto start. This is intentional.

    The output will then look like this:

    To make ArangoDB 2.2 start with a database directory created with an earlierArangoDB version, you may need to invoke the upgrade procedure once. This canbe done by running ArangoDB from the command line and supplying the option:

      where data is ArangoDB’s main data directory.

      Note: here the same database should be specified that is also specified whenarangod is started regularly. Please do not run the —upgrade command on eachindividual database subfolder (named ).

      then running

      1. unix> arangod mydatabasefolder --upgrade

      will perform the upgrade for the whole ArangoDB instance, including all of itsdatabases.

      Starting with —upgrade will run a database version check and perform anynecessary migrations. As usual, you should create a backup of your databasedirectory before performing the upgrade.

      The output should look like this:

      Please check the output the —upgrade run. It may produce errors, which needto be fixed before ArangoDB can be used properly. If no errors are present orthey have been resolved, you can start ArangoDB 2.2 regularly.

      Upgrading a cluster planned in the web interface

      A cluster of ArangoDB instances has to be upgraded as well. Thisinvolves upgrading all ArangoDB instances in the cluster, as well asrunning the version check on the whole running cluster in the end.

      • First shut down your cluster using the graphical front end asusual.

      • Now open the cluster dash board in your browser by pointing it tothe same dispatcher that you used to plan and launch the cluster in the graphical front end. In addition to the usual buttons“Relaunch”, “Edit cluster plan” and “Delete cluster plan” you willsee another button marked “Upgrade and relaunch cluster”.

      • Hit this button, your cluster will be upgraded and launched andall is done for you behind the scenes. If all goes well, you willsee the usual cluster dash board after a few seconds. If there is an error, you have to inspect the log files of your clusterArangoDB instances. Please let us know if you run into problems.

      There is an alternative way using the shell. Instead ofsteps 3. and 4. above you can launch arangosh, point it to the dispatcherthat you have used to plan and launch the cluster using the option—server.endpoint, and execute

        This upgrades the cluster and launches it, exactly as with the button above in the graphical front end. You have to replace witha user name and "" with a password that is valid for authenticationwith the cluster.