Upgrading

  1. Always back up your database in case something goes wrong during the upgrade (highly unlikely, but just to be safe). For instructions, see Backing up an Omeka Database.
  2. Deactivate all plugins in Settings > Plugins of the administrative panel. Plugins must be upgraded to be compatible with the version you're upgrading.
  3. Be careful not to "uninstall" the plugins, because you may lose data. See Upgrading Plugins for more information.
  4. Move your old Omeka installation, either on your server or transfer the files to your local computer.
  5. Download and unzip your copy of the latest version of Omeka into the empty directory where your previous install of Omeka was located.
  6. Copy the following files and directories from your old Omeka folder to the corresponding location in your new Omeka installation:
    • db.ini (in version 0.9, this was located in application/config/db.ini; since version 0.10 this has been relocated to the root of your installation.)
    • archive/files
    • archive/thumbnails
    • archive/square_thumbnails
    • archive/fullsize
    • any other files you have personally modified (be careful with this, as the original file may have been changed in newer versions).
  7. Modify the permissions on your archive/ folder to make all folders and files within that directory writable by your Apache web server.
  8. Load the Omeka administrative panel in your web browser. Upon logging in, an alert appear on your dashboard. Click "Upgrade" to update your database to reflect the new data model. When that is done, reload the page and you're ready to go!