VERY IMPORTANT ---------------------- You must backup before upgrading (at a minimum, we recommend backing up your data/, templates/, and uploads/ directories). If you are on mySQL and do not know how to backup your mySQL data, contact your web host for assistance. UPGRADING TO 2.16 FROM 2.14-2.15 ---------------------- You'll need to upload the following files from your 2.16 zip file: [cgi-bin]/artman2/admin.cgi [cgi-bin]/artman2/changelog.txt [cgi-bin]/artman2/search.cgi [cgi-bin]/artman2/modules/*.* [cgi-bin]/artman2/utils/*.* UPGRADING TO 2.16 FROM 2.00-2.13 ---------------------- You'll need to upload the following files from your 2.16 zip file: [cgi-bin]/artman2/admin.cgi [cgi-bin]/artman2/changelog.txt [cgi-bin]/artman2/search.cgi [cgi-bin]/artman2/modules/*.* [cgi-bin]/artman2/templates/admin/*.* [cgi-bin]/artman2/utils/*.* [webroot]/artman2/css/*.* [webroot]/artman2/javascript/*.* [webroot]/artman2/images/icons/templateEditor.gif From 2.03 and earlier, also upload: [webroot]/artman2/images/logo.gif [webroot]/artman2/images/logo - Fireworks Source Image.png REMOVED: (Optional) these v2.01 files can be deleted (they are now in admin/menus/admin). [cgi-bin]/artman2/templates/admin/menus/accounts.html [cgi-bin]/artman2/templates/admin/menus/admin.html [cgi-bin]/artman2/templates/admin/menus/databaseEditor.html [cgi-bin]/artman2/templates/admin/menus/fieldEditor.html [cgi-bin]/artman2/templates/admin/menus/publishRules.html [cgi-bin]/artman2/templates/admin/menus/tableEditor.html SPECIAL CHARACTERS IN 2.10+ ---------------------- After upgrading, you may discover that special characters from both version 1 and earlier versions of Article Manager 2 characters (non-english letters, angled quotes) are handled differently. If you have special characters that appear malformed, you will need to update your templates to support UTF-8 characters - add the following tag to your publish templates under the title tag: In addition, you will likely need to run the character conversion utility. Set this script to have execute (chmod 755) permissions and run it from your browser: [cgi-bin]/artman2/utils/convertDataToUnicode.cgi HOW TO UPGRADE FROM VERSION 1 ---------------------- 1) UPGRADE VERSION 1 TO v1.41 ------------------------------------------------------------------------------- Make sure you have upgraded your version 1 installation to version 1.41. You can only upgrade to version 2 from v1.41. Get 1.41 here: http://www.interactivetools.com/upgrade/ 2) INSTALL VERSION 2 ------------------------------------------------------------------------------- Install version 2 in a completely new directory. When installing, create an admin account with a username that doesn't exist in version 1 (eg: admin2). VERY VERY IMPORTANT: - DO NOT INSTALL version 2 over version 1! - DO NOT set any version 2 directories (such as publish or uploads) to point to version 1 folders. 3) RUN UPGRADE SCRIPT ------------------------------------------------------------------------------- You can find the upgrade script in the /utils/ directory. Example: /cgi-bin/programDir/utils/upgradeFromVersion1_41.cgi Run the upgrade script through your browser. 4) TEST EVERYTHING ------------------------------------------------------------------------------- Check that all the users, categories, articles, archives, templates, etc have all been moved over correctly. Click "Publish All" and check the published content looks correct. Make any template or setting adjustments as necessary. 5) PUBLISH OVER YOUR OLD CONTENT WITH ARTICLE MANAGER 2 ------------------------------------------------------------------------------- Once you are satisfied with your Article Manager 2 setup, you can overwrite your published site. (a) Login to Article Manager 2 and go Admin > Publishing. (b) Set the Default Publish Directory and URL to folder used in v1.41 and click "Save". (c) Select "Publish All". If something isn't quite right, you always have the option to simply login to Article Manager 1 and "Publish All" once again, rolling-back your Article Manager 1 published content. ------------------------------------------------------------------------------- end of file.