Page tree
Skip to end of metadata
Go to start of metadata

These instructions will walk you through the process of upgrading an R1 avalon install that was made using vagrant to R2.

Preparing for the Upgrade

There are some steps you can take to make the upgrade and transition to R2 smoother.  Before doing anything to prepare for the upgrade, backup your vagrant machine by creating a snapshot using VirtualBox's interface.  

R2 has more powerful collections instead of the text field which existed in R1.  To prepare for this, make sure every item has one and only one collection entry.  During the upgrade collections will be created from these entries and items added.  If items do not have a collection defined then they will be added to the Default Collection.

Groups used by avalon to grant permissions have been revamped in R2.  An administrator group will be created during the upgrade process and the first user listed in the group_manager group will be added to the new group.  Make sure that this is the user you want to made administrator.  Administrators are the only ones who have the ability to add users to the administrator or group_manager groups.


  1. Stop the virtual machine: vagrant halt
  2. Move the R1 directory aside:

    cd ..
    mv avalon-installer-flat avalon-installer-flat-r1
  3. Download and extract the Avalon install script (as a zip or tar.gz)
  4. In a terminal window, cd to the avalon-installer-flat directory you just extracted
  5. Copy over the configuration from the R1 vagrant machine:

    cp -r ../avalon-installer-flat-r1/.vagrant .
    cp ../avalon-installer-flat-r1/avalon-install.yml .
  6. Start the virtual machine: vagrant up
  7. Be patient.  This will upgrade the various components of avalon and will migrate all of your content to R2 schemas.


If you run into problems you can stop the virtual machine and restore your snapshot to get right back where you were.

  • No labels