General Notes

The standard method for upgrading your site from a Manifesto package is as follows:

1. Download the appropriate upgrade package and place the GZipped tarball in the /docs/ directory.
2. Extract the tarball with
   tar xzvf name_of_tar_file.tar.gz.
   This should leave you with a directory named "upgrade_nn" where nn corresponds to the upgrade version number.
3. Change ownership of the entire directory to values appropriate to your system, e.g.
   chown -R user:group upgrade_99.
4. Copy the upgrade.php file from the upgrade directory into the root directory of your site
5. Hit the upgrade.php file on your site using your browser, and follow the instructions from there.

Notes for the .98.2 to .99 upgrade

The .99 release of Manifesto is a major overhaul of the software, and it is a very complex upgrade process. Every effort has been made to maintain copies of your files and database tables, so any custom modifications you have made will be preserved in backup files.

Follow the general instructions above to prepare for the .99 upgrade.

Read these instructions as you proceed through the upgrade process!
See contact notes at the end if you run into a problem!

Startup) The script will check directory permissions. If they're not right, STOP and fix them manually!

Step 1) The script will check to see that you have proper MySQL permissions for all necessary actions. This is a slightly imprecise science because of the number of variables, but if you see an error, STOP! If there's a real problem, fix the MySQL permissions for your IMC user if you know how (Manifesto wants the user to have DROP privileges), or contact me. If there is NOT a real problem and you're SURE you have DROP permissions, you can skip this step manually by hitting

/upgrade.php?step=2

directly in the browser.

Step 2) The script will attempt to rename your "articles" table to "articles_old". It then attempts to extract articles, features, and comments into new, separate tables. This can take a LONG time (5 minutes per 10,000 records or so). The upgrade.php script attempts to set PHP's max_execution_time to 15 minutes, but it's possible that you may run into a browser or other timeout. If that is the case, STOP!

Fixing Step 2 problems)
If you can fix the timeout problem, you need to:
1) Delete the "articles", "comments" and "features" table in the new database
2) Rename "articles_old" back to "articles"
3) Run Step 2 again
OR
1) Open the file docs/upgrade_99/docs/upgrade_99/1_manifesto_base.sql
2) Copy the SQL statements out of the PHP code, and execute them manually on the command line or in phpMyAdmin

Step 3) Attempts to rename the base Manifesto database tables to *_old, and creates new tables, inserting the data from the corresponding "_old" tables using the new schema. If you run into a problem here, STOP! This is the worst point for a problem, where half of the tables are renamed and populated. This needs to be addressed carefully, so contact me.

Step 4) Attempts to rename/repopulate optional module Manifesto tables, based on whether or not those modules were installed already on your site. Works like Step 3, so STOP! if there's a problem. This step ends with a form that should be pre-populated with your current IMC settings. Verify them, enter any missing information, and submit.

Step 5) This step checks your form submission variables, and attempts to write out the "dt_dbinfo.php" file which is now used in place of imc_dbinfo.inc. If there's a problem, STOP! and let me know. It can probably be fixed manually and you can continue from there.

Step 6) Renames the "prefs" table to "prefs_old", and renamed "prefs_new" to "prefs". Attempts to backup all of your files, renaming files with suffix ".dadasaved", and renaming directories with suffix ".dadasaved". Unlike previous upgrades, it does NOT rename all the files within directories, just the directory itself. Then it attempts to copy all the NEW files into place. If you have a problem here, STOP! and contact me.

Step 7) Attempts to update some database records based on the new database schema and new files. Specifically, it

1. updates Media and Comments and edit_privs whose parent is now a Feature
2. updates Media and edit_privs whose parent is now a Comment
3. tries to update authorid for content based on edit_privs
4. tries to thread all comments
5. sets the mod_pref for the Calendar module if in use

If you've gotten this far with no errors, congratulations! You should be running .99 now! Don't forget to check the release notes for important information about this upgrade.

CONTACT INFORMATION:
If you have a problem during the upgrade process, send email to support (at) dadaimc.org. Please include as much of the following as possible:

1. A description of the error
2. A screenshot of the page (including the URL you're on)
3. Log files or directory (permissions) listings if appropriate