FOR ARCHIVAL PURPOSES ONLY

The information in this wiki hasn't been maintained for a good while. Some of the projects described have since been deprecated.

In particular, the "Ushahidi Platform v3.x" section contains information that is often misleading. Many details about this version of Platform have changed since.

This website is an extraction of the original Ushahidi wiki into a static form. Because of that, functions like logging in, commenting or searching will not work.

For more documentation, please refer to https://docs.ushahidi.com

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The instructions below detail how to update your Ushahidi instance. It is intended for developers and admins who are running the engine on their own servers.

Upgrading your Ushahidi install using the auto upgrader:

  1. Log in to the admin dashboard ie. my-install.com/admin
  2. If there is an upgrade available a notification message will appear
  3. Follow the link to the upgrade page and follow the instructions there to upgrade
    1. NOTE: its highly recommended you backup both your database and all files before upgrading.

Upgrading your Ushahidi install manually:

  1. Backup everything, including:
    1. .htaccess, ./application/config/config.php, ./application/config/database.php, ./application/config/encryption.php and ./application/config/auth.php
    2. media/uploads - backup this entire folder
    3. Back up your database.
    4. It is recommended to keep a backup of the entire /ushahidi/ installation directory in case you make a mistake.
  2. Download the most recent version of Ushahidi from the Github.com repository at http://github.com/ushahidi/Ushahidi_Web/downloads
  3. Copy the new files over the old ones.
    1. Often files are removed in the new version, so its advisable to remove the old codebase entirely (keep a backup), and replace it with the newly downloaded one
  4. Update config.php, database.php, auth.php as necessary to match your previous configuration details with the database name, database user name, and database password.
  5. Copy media/uploads from your backup
  6. Upgrade your database:
    1. If you're upgrading to version 2.5 or later, you can run db upgrades from the admin dashboard.
      Log in as superadmin and you will be redirected to the upgrade page
    2. Or run db upgrades manually following the instructions below

That’s it! You are done. Your Ushahidi instance is updated. If you have problems visit the forums.

Manually running database upgrade scripts

  1. First determine your database schema revision: the version is stored in the settings table
    1. On versions before 2.5 run

      Code Block
      sql
      SELECT `db_version` FROM `settings`;
    2. On versions after 2.5 run

      Code Block
      sql
      SELECT * FROM `settings` WHERE `key` = 'db_version';
  2. Execute the appropriate upgrade*-*.sql scripts in phpMyAdmin or via the command line to bring your database up to date. 
    If you are at version 25, you need to execute SQL upgrade scripts: upgrade25-26.sql, upgrade26-27.sql, upgrade27-28.sql and so on up to the latest sql file in your /sql directory.
    Each schema revision is usually only a couple of small changes.

 

Working around errors in database upgrades: Manually running database upgrade scripts and fix error via phpMyadmin

If you hit errors while running database upgrades, you can work around this by running scripts manually.

...