Upgrading
SimpleID is currently in heavy development, with the software changing rapidly.
Newer versions often include improvements to the security of SimpleID software, and so it is very important to upgrade SimpleID when a new version is released.
Information on Upgrades
You can find information on upgrading in three locations -- be sure to read all of it carefully before you upgrade:
- The
UPGRADE.txt
file packaged with the SimpleID installation. - The news page announcing the release of your version.
- This page.
How to Upgrade
Important Notes
-
Warning: As with any software upgrade it is critical for you to have a current, tested backup of your site.
-
You cannot skip versions when upgrading. For example, in order to upgrade from version 0.4 to version 0.6, you must first upgrade from version 0.4 to version 0.5, then version 0.5 to version 0.6.
Upgrade Instructions
To upgrade your installation of SimpleID, follow the following steps.
-
Backup your existing installation. Note that your SimpleID installation resides in multiple directories, so remember to back up all of them.
-
Download and uncompress the new SimpleID installation package, and carefully review the information and instructions available in
UPGRADE.txt
-
Upload the new files to the appropriate locations of your server.
-
Some versions may require you to modify your
config.php
file. ReviewUPGRADE.txt
and the sections below to see if this is required.The new SimpleID installation package will not overwrite your
config.php
file. Instead, it will have a new version ofconfig.php.dist
file. You may have a look at the newconfig.php.dist
to see if there are any additional configuration options which you may put in yourconfig.php
file. In most cases, the defaults will be sensible. -
Some versions may require you to run upgrade.php. Review
UPGRADE.txt
and the sections below to see if this is required.
Running upgrade.php
More recent versions of SimpleID requires you to run upgrade.php script to update some of the data it stores.
To run upgrade.php:
-
Check whether you have a user who is an administrator. A user is an administrator if the user's identity file contains the line
administrator=1
.The default identity files supplied with older versions of SimpleID do not have this line, so this may need to be added in manually.
-
Log into SimpleID as the administrator.
If you are able to log in, go to step 4. Otherwise go to step 3.
-
If for some reason you cannot log in, you will need to edit upgrade.php manually in order to run the script.
Open upgrade.php using a text editor. Change the line
$upgrade_access_check = TRUE;
to$upgrade_access_check = FALSE;
-
Go to upgrade.php using your web browser. upgrade.php is located in the same directory as your SimpleID URL. So if you access SimpleID at
http://example.com/simpleid/
, then the upgrade script is located athttp://example.com/simpleid/upgrade.php
. -
Follow the instructions.
-
After you complete the upgrade, be sure to change the upgrade.php file back to its original state if you have edited it in step 3. Otherwise, anyone would be able to run the upgrade.php file on your site.
Specific version upgrade information
The following versions have specific upgrade instructions: