Upgrading to ArangoDB 2.5

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

    In 2.5 we have also changed the paths for Foxx applications.Please also make sure that you have a backup of all Foxx apps in your and javascript.dev-app-path.It is sufficient to have the source files for Foxx somewhere else so you can reinstall them on error.To check that everything has worked during upgrade you could use the web-interface Applications tab or

    for all your databases.The listed apps should be identical before and after the upgrade.

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

    The output will then look like this:

    1. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': Database directory version (20401) is lower than current version (20500).
    2. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': ----------------------------------------------------------------------
    3. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': It seems like you have upgraded the ArangoDB binary.
    4. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': If this is what you wanted to do, please restart with the
    5. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': option to upgrade the data in the database directory.
    6. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': Normally you can use the control script to upgrade your database
    7. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': /etc/init.d/arangodb upgrade
    8. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': /etc/init.d/arangodb start
    9. 2015-02-17T09:43:11Z [8302] ERROR In database '_system': ----------------------------------------------------------------------

    To make ArangoDB 2.5 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 —upgradeoption.Note: We have changed Foxx folder structure and implemented an upgrade task to move yourapplications to the new structure. In order to tell this upgrade task to also move yourdevelopment Foxx apps please make sure you give the dev-app-path as well.If you have not used development mode for Foxx apps you can drop the—javascript.dev-app-path.It is only possible to upgrade one dev-app-path together with one data folder.

    Note: here the same database should be specified that is also specified whenarangod is started regularly. Please do not run the command on eachindividual database subfolder (named database-<some number>).

    For example, if you regularly start your ArangoDB server with

    1. unix> arangod mydatabasefolder

    then running

    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 last line of the output should look like this:

    1. 2014-12-22T12:03:31Z [12026] INFO database upgrade passed

    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.

    We have tried to make this procedure as painless and convenient for you.We assume that you planned, launched and administrated a cluster using thegraphical front end in your browser. The upgrade procedure is then asfollows:

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

    • Then upgrade all dispatcher instances on all machines in yourcluster using the version check as described above and restart them.

    • 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.

    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.