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. Move or copy the following files and directories from your old Omeka folder to the corresponding location in your new Omeka installation (if copying, make sure you keep all permissions the same as they were before):
    • 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/
    • any other files you have personally modified (be careful with this, as the original file may have been changed in newer versions).
  7. Upgrade the database
    • Omeka 1.3 and higher: If you go to your administrative panel, you should be redirected to a new page for upgrading (example.com/upgrade). Click "Upgrade" to update your database to reflect the new data model. (Please note that you cannot upgrade from a version of Omeka lower than 1.2 straight to 1.3.)
    • Omeka 1.2.1 and earlier: 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!
Retrieved from "http://omeka.org/codex/Upgrading"