Upgrading Article Managerlink to this page

Generally, upgrading will be a simple matter of uploading all the files that have been updated from the previous version. If you're upgrading from Article Manager 1, it's important to install version 2 into a whole new directory first, NOT over top of your original installation.

Below are specific instructions for upgrading, depending on your version.

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 from 2.14-2.15

Upload the following files from the 2.16 zip file to their correspoding location where the program is installed (do NOT overwrite your data files or your non-admin templates!):

    [cgi-bin]/artman2/admin.cgi
    [cgi-bin]/artman2/changelog.txt
    [cgi-bin]/artman2/config.ini
    [cgi-bin]/artman2/search.cgi
    [cgi-bin]/artman2/utils/*.*             (all files and folders in this directory)
    [cgi-bin]/artman2/modules/*.*    (all files and folders in this directory)

Upgrading from 2.10-2.13

Upload the following files from the 2.16 zip file to their correspoding location where the program is installed (do NOT overwrite your data files or your non-admin templates!):

    [cgi-bin]/artman2/admin.cgi
    [cgi-bin]/artman2/changelog.txt
    [cgi-bin]/artman2/config.ini
    [cgi-bin]/artman2/search.cgi
    [cgi-bin]/artman2/utils/*.*                    (all files and folders in this directory)
    [cgi-bin]/artman2/modules/*.*           (all files and folders in this directory)
    [cgi-bin]/artman2/templates/admin/*.*    (all files and folders in this directory)
    [webroot]/artman2/css/*.*
    [webroot]/artman2/javascript/*.*
    [webroot]/artman2/wysiwyg/*.*

Upgrading from 2.00-2.02

Note: From v2.10, Article Manager requires Perl 5.8 or newer. Previous versions had this as a "soft" requirement, but because of some big changes to Article Manager v2.10, the program will not run on an older version of Perl.

To upgrade from version 2.00 through 2.02, you'll need to upload all updated program files.

Upload the following files from the 2.16 zip file to their correspoding location where the program is installed (do NOT overwrite your data files or your non-admin templates!):

    [cgi-bin] All files & folders specified above ("Upgrading from 2.10-2.13")
    [webroot] All files & folders specified above ("Upgrading from 2.10-2.13")
    [webroot]/artman2/images/logo.gif
    [webroot]/artman2/images/logo - Fireworks Source Image.png
    [webroot]/artman2/images/icons/templateEditor.gif
Special Characters in 2.10 and later

After upgrading, you may discover that special characters (non-english letters, angled quotes) are handled differently from both version 1 and earlier versions of Article Manager 2.

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:

<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">

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

Upgrading from Article Manager 1

1. Upgrade to v1.41 (if necessary)

To upgrade to Article Manager 2, you need to have Article Manager version 1.41 installed. If you are running an older version you can download 1.41 from the upgrade page.

2. Install Version 2

Install version 2 in a completely new directory (eg. /artman2/). When installing, create an admin account with a username that doesn't exist in version 1 (eg: admin2). See the Article Manager 2 installation docs for detailed instructions.

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. Depending on how many articles you have in version 1, the upgrade process could take some time.

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. Make Article Manager 2 live

Once you are satisfied with your Article Manager 2 setup, you can overwrite your published site.

  • Login to Article Manager 2 and go Admin > Publishing.
  • Set the Default Publish Directory and URL to folder used in v1.41 and click "Save".
  • 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.