Skip to content

Community Generated Upgrade Guide

nick edited this page Apr 25, 2011 · 3 revisions

Table of Contents

Movable Type 4 Upgrade Guide

Thank you for choosing Movable Type 4 for your publishing needs. Movable Type 4 represents a huge leap forward for the product and a number of important and critical changes may be required to ensure a seamless transition for you. Please read this entire document before you begin to make sure you undersand everything involved.

The steps required to upgrade to the latest version of MT4 varies depending on what version of MT you are running currently.

Getting Ready

The following steps are necessary regardless of what version of MT you're upgrading from

  1. Make a backup of your database - Whenever you are making a change to your system such as this, it is always considered wise to make a backup of your data just in case you need to undo anything you might have done. (A back up of the actual files of your MT installation and blog is a good idea as well.)
    1. MT 3.2 Documentation - MySQL Database Backup
    2. MT 4.0 Documentation - Backing Up and Restoring Blogs
    3. Learning Movable Type - Backing Up Your Blog
  2. Download Movable Type 4 - Once you have backed up your system, download the latest version of MT4 to your local PC.
    1. Download MTOS Stable
    2. Download MTOS Nightlies
    3. Download Free Personal Version or Purchase Supported Version
  3. Unzip Movable Type - Using your preferred unzipping software, unpack the Movable Type archive onto your local PC.
liability insurance ny

Upgrading From an Earlier Build of MT4

(Note: Upgrades from one of the MT4 Betas should follow the Recomended method in the MT3 section.)

Uppgrading from an earlier version of MT4 is easy. Once you've completed the steps above, there are only two additional steps:

  1. Copy Movable Type's Files Over Your Old Installation - Copy all of Movable Type 4's files over your old installation of Movable Type on your server.
  2. Login to Movable Type - The first time you access Movable Type, the system will detect the new version of MT installed on your system and take you through the automated process of upgrading your database. When this process is complete, you will be able to begin using Movable Type immediately.

Upgrading From Any Version of MT3

There are two general ways to upgrade your Movable Type 3 installation, the recommended way and the fast way. Either way you choose, the first few steps are the same:

  1. Review Changes in MT4 - You should review the following resources to see if there are any other actions you need to take prior to your upgrade:
    1. Database support changes - a list of databases that are no longer supported in MT4
    2. Deleting or renaming mt.cfg
    3. Obsolete plugins and plugins that should be removed
    4. Review the Guide to the New Features of Movable Type 4.2 that you may want to take advantage of.
  2. Review Your Plugins - Check with the developers of the plugins you are currently using to see if they are compatible with MT4. Download any new versions if necessary.
    1. Plugin Directory
    2. Works With MT4 A listing of plugins that work with MT4. (May be out of date.)

The Recommended Way

Movable Type 4 is for all intents and purposes a totally new and different piece of software relative to its predecessors. When making this upgrade, take this opportunity to do a little Spring cleaning by creating a fresh install of Movable Type.

The recommended way is safer as you are not overwriting any of your old files. Returning to to the old version is easier.

  1. Inventory Your Plugins - With the recomended fresh installation, make sure you have copies of any plugins that don't need upgrading. You will need to reinstal them as well.
  2. Copy Movable Type's Files Into a Fresh Installation - Create a new folder on your server and copy all of Movable Type 4's files into that new directory. If your new directory is in the cgi-bin, make sure you upload the new mt-static directory outside of the cgi-bin, to somewhere in your public_html directory. Upload the images in the mt-static directory as binary files. Upload all other files as text.
  3. Login to Movable Type - The first time you access Movable Type, the system will detect the new version of MT installed on your system and take you through the automated process of upgrading your database. When this process is complete, you will be able to begin using Movable Type immediately.
  4. Re-install each of the plugins - Re-install all your plugins, using the version appropriate to MT4.

The Fast Way

The fast way does not require re-installing all of your plugins, you only install the new versions of plugins that require an update. Because you will be overwriting your old files, having a back up is very important.

  1. Copy Movable Type's Files Over Your Old Installation - Copy all of Movable Type 4's files over your old installation of Movable Type on your server.
  2. Login to Movable Type - The first time you access Movable Type, the system will detect the new version of MT installed on your system and take you through the automated process of upgrading your database. When this process is complete, you will be able to begin using Movable Type immediately.
  3. Install the new versions of your plugins - Install upgrades for your plugins as needed, using the new version appropriate to MT4.
The first time you access the application, you may need to "shift-reload" your browser in order to clear the cache for your css, javascript and images. Doing so will fix any display abnormalities you may experience upon first logging in.

Upgrading from MT 2.6 and earlier

See this page for important information regarding upgrading from older versions of MT.

Additional Information

Some users may find the following links helpful for their upgrade:

Once your upgrade is complete you may be interested in the following additional resources:
Clone this wiki locally