Upgrading to ExpressionEngine 1.1

Upgrading from a previous version of ExpressionEngine to the 1.1 version of ExpressionEngine is accomplished in a few main steps.

  1. Prepare for the Upgrade
  2. Update your files and installation
  3. Update your preferences
  4. Notes

Prepare for the Upgrade

You must first prepare yourself to perform the upgrade for your site. As with any sort of site change you might make, it is recommended that you perform a full site backup as well as a database backup before making any changes.

Step 1

The first step is simply to download the 1.1 version of the ExpressionEngine software. Unzip the software to your local computer.

Step 2

Download the following configuration from your server to your local computer as a safety precaution.

Step 3

You only need to perform this step if you have customized your member profile templates under Admin > Member Profile Templates. If you have not customized them, then skip this step.

Download the following file from your server to your local computer.

Rename this downloaded file to default.php. It is very important that you name this file in a specific way. Copy this file to the downloaded ExpressionEngine Version 1.1 distribution and place it in the following location, overwriting the existing file.

This step is performed because the location for the Member Profile Templates file has been changed. Therefore, you need to ensure that your customized templates are carried over.

Step 4

It is recommended that you set your site to be "offline" for the duration of the upgrade. You can turn the site off under Admin > General Configuration. You can change what is displayed to visitors when the site is off under Admin > System Offline Template.

Remember that SuperAdmin users can still access the site while it is offline. Once you ensure that the upgrade has been performed successfully you can turn the site back on.

Update Files and Installation

You will now perform the actual updating of your site files and database.

Step 1

You now need to replace most of the existing directories on your server with the new version 1.1 files you downloaded.

Replace all of the files and directories inside your system/ directory except for:

Upload the files and directories in ASCII format (not Binary format). It is recommended that you delete the files and directories you will be replacing before uploading the new files and directories.

* Note: If you have installed any extra Plugins then you will want to be sure that you keep those files on your server inside the system/plugins/ directory.

Step 2

Upload the following files/directories in BINARY format:

Step 3

Ensure that the permissions on your files and directories are still correct. If you are using a Unix server you must set the following files to 666:

You must set the following directories to 777:

Step 4

Point your browser to the system/update.php file on your server. This file will perform changes that are required in order to update you to the new version of ExpressionEngine. Be sure that you're accessing the file through your webserver and not just loading the file into your web browser locally. Access the file as you would a regular webpage, using an address similar to http://www.example.com/system/update.php.

Delete the system/updates/ directory and system/update.php file from your server when you are finished running the update script.

Update Your Preferences

ExpressionEngine version 1.1 makes a number of new preferences available. A few of the new preferences should be mentioned in particular.

Weblog Management

There are several new preferences under Admin > Weblog Management. Previously, there was a single 'Weblog URL' path preference. There are now a number of path preferences which you may wish to update. Here is a short description and possible example of each:

404 Error Pages

In Admin > Template Preferences you may now specify a specific Template to use as your "404 error" page. This is used as a global, site-wide preference.

If you are running multiple domains, subdomains, sub-site, etc. using the Multiple Entry Pages method, then you may also specify a particular Template for that in the appropriate path.php file:

$site_404 = "template_group/template";

Due to the flexible way that ExpressionEngine implements URLs and interprets the URL segments, the 404 errors can only be triggered by an invalid Template Group in the URL.

License Number

Under the General Configuration section you should also ensure that your License Number is set. The license number was included in the email purchase receipt. If you no longer have your license number, you may view a copy of your license number by going to the Download Area of the pMachine site and accessing the "Purchase History" for your product.

Notes

Documentation

If you use the local version of the documentation, then you should replace your current version. The documentation is located in the user_guide directory on the download.

The documentation for v1.1 has had substantial changes made from previous versions. It may be best for you to delete the local version of the documentation you have on your server now and then upload the new version.

Language Packs

If you use any Language Packs beyond the standard "english" Pack that comes with the download, then you will need to go obtain the revised 1.1 version of the Language Packs and replace the versions you have on your server with the new ones.