Preparing for the Upgrade
There are some steps you can take to make the upgrade and transition to Avalon 2.0 smoother. Before doing anything to prepare for the upgrade, backup your Avalon 1.0 installation.
Avalon 2.0 has more powerful collections instead of the text field which existed in Avalon 1.0. 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 Avalon 2.0. 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 make administrator. Administrators are the only ones who have the ability to add users to the administrator or group_manager groups.
The following instructions will work for any Avalon 1.0 installation that used Puppet as its source. This includes the portable VM Image Installation, the Vagrant Virtual Machine Installation, and the Manual Installation of Avalon Using Puppet.
The one important piece of information you will need from the previous install is the name of the avalon dropbox user. The default is "avalondrop" (and the portable VM image uses this value), but it may have been changed during Step 6 of the Vagrant installation or Step 8 of the Puppet installation.
Upgrading is fairly simple, and must be run as the root user from a bash prompt on the Avalon system. The process for this depends on which kind of installation you have.
- Portable VM image:
Open a terminal window from within the VM console, and type
su rootto become the root user. This will require the root password you provided the first time the system was booted.
- Vagrant virtual machine:
From within the original installer directory (from step 4 of the Vagrant Virtual Machine Image Installation Instructions), type
vagrant sshto log in as the vagrant user, then type
sudo -ito become the root user.
- Manual Puppet installed machine:
Log in and become root as you did in steps 1 and 2 of the Manual Installation of Avalon Using Puppet instructions.
Once you have a root prompt, proceed with the upgrade as follows:
The directions for ingesting the latest example fixtures are located here.