As of version 2.2.1.5 we have automated updating the database, see the bottom of the page for manual upgrade steps for versions older than this.

Its a good idea to login to your site as admin before uploading the files for upgrade.

Upload the Setup folder first so you can be sure all the scripts are there first, then upload the rest of the files. After all the files are uploaded navigate to yoursiteroot/Setup/Default.aspx

Always backup your site and your database completely before upgrading so that if anything goes wrong you can restore your previous installation.

If you are upgrading from very old versions and have a custom skin that you are using, it might be wise to change to one of the built in skins like subblue before the upgrade, then after you upgrade change back to your custom skin. Sometimes changes are needed in custom skins after an upgrade. We will try to keep changes like this to a minimum. If upgrading a site from the older 1.x version of mojoPortal, you must do this because skinning changed a lot in 2.0 .NET. Old 1.x skins will not work and must be modified to get them working.

Copy the new files over your old files then edit the Web.config and user.config (if you are using a user.config file) to put back your correct custom settings like connection strings, smtp settings etc. You can get these settings out of your backup files.

After copying all the files you should restart the web application, making any change to the Web.config file will restart the web app so just type a space in it to modify it then cop it up to your server again.

Navigate to yoursiteroot/Setup/Default.aspx to complte the upgrade.

If you have any troubles post in the forums and we will try to help.

Last updated 2007-08-13 Joe Audette

Upgrading is a manual process for which I can offer guidelines. 


Guidelines for upgrading from previous versions of mojoPortal.

1.  Be sure and do a complete backup of both your web site and your db before proceeding so that if things don't workout you can go back easily to the previous version.

If you are planning to upgrade a production site I recommend doing a practice upgrade with a copy of your site and database. Then if all goes well you can cut over to the copy or at least have confidence that you can succeed in upgrading the production site.  For example if your site is www.mydomain.com, consider making a separate virutal host with a copy of the main site and db at dev.mydomain.com and do your upgrade on the copy.

2.  Upgrade the database structure.  You can go table by table comparing the the structure of your existing db with the CreateTables.sql script and adding tables and/or columns as needed to your existing db.  If you have the CreateTables script from your previous version consider diff the new file against the old to get a clue of what has changed.  If using MS SQL or PostgreSQL replace the existing stored procedures with the new script of stored procedure.

3.  Upgrade the data.  If new modules were added or old ones enhanced, there are likely to be new data for the mp_ModuleDefinitions, mp_SiteModuleDefinitions and mp_ModuleDefinitionSettings tables.  Again, you can diff the CreateData.sql script from your previous version against the new one for clues.
If there are new settings for existing ModuleDefinitions that you are already using, you may also need to add settings to the mp_ModuleDefinitions table which has settings instances of the module definitions you are using as represented in the mp_Modules table.

4.  Copy the new deployment files over the existing site. Make sure the connection string for your db is correct in the Web.config file and re-start apache or IIS.

5.  Make sure the Data folder and all of its children files and folders are writable. Previous permissions may be gone after overwriting.