ABOUT

eZUpgrade is stand-alone application (not an eZ Publish extension) automating the process of upgrading an eZ Publish installation.

Using eZUpgrade is as easy as checking it out on the server where the upgraded installation will reside, inputting some configuration settings, and running ezupgrade from the command line.

DISCLAIMER

eZUpgrade makes a point of doing as little as possible to the original (source) installation. Still, the application is delivered as-is without any warranties of any kind.

You are strongly urged to backup your entire source installation (files and database(s)) before making use of this application.

SUPPORTED VERSIONS

eZUpgrade is built to be flexible when it comes to adding support for new eZ Publish versions. Depending on the complexity of the change from one eZP version to another, adding support could be as easy as adding some configuration settings to settings/ezupgrade.ini. For more complex changes, one might need to create some custome upgrade functions.

REQUIREMENTS

• eZUpgrade is dependent upon eZCopy (http://projects.ez.no/ezcopy) and its requirements.

• eZ Components: eZUpgrade requires the latest stable release of eZ Components. To install this, you also need PEAR See http://ez.no/ezcomponents for more information

HOW IT WORKS

The old eZ Publish installation can be located either on the same server as the upgraded installation, or on a remote server. If the latter is the case, eZUpgrade will make use of eZCopy to copy the old installation to the new server before starting the upgrade procedure.

eZUpgrade then performs the following steps:

1. Downloads and unpacks the distro of the version we want to upgrade to.

2. Copies files (var/, settings/ and extension/) from the old to the new installation, prompting when overrides are needed.

3. Copies the databases used by the old installation and updates the database connections in the new installation to the db copies.

4. Performs the upgrade steps needed between the version we are upgrading from and the version we are upgrading to. This includes sql updates, upgrade scripts and any other upgrade actions that can be performed automatically. If there are any upgrade actions that need to be performed manually, you will be informed.

5. Grants the database user access to the new database(s).

USAGE

From the shell prompt, where eZUpgrade is located, run:

php ezupgrade [account_username]

If you haven't set up any accounts, run php ezupgrade to initialize the configuration wizard.

NOTE ABOUT UPGRADING FROM VERSION 4.X TO 5.0.0

eZUpgrade supports upgrading from any 4.x version to 5.0.0.

IMPORTANT NOTE ABOUT UPGRADING FROM VERSION 3.x TO 4.x

Since 3-series of eZ Publish is run on php4 the upgrading process is a little more tricky than upgrading from 4.x.y. In order to fix this we have added paths to php4 and php5 in ezcopy.ini. This means that you need to upgrade on a server/machine that have both this or do it in cycles.

The way we have upgraded is doing it in cycles. Here is one of our example:

FROM TO
3.5.0 3.8.7 3.8.7 3.9.3 3.9.3 3.10.1 3.10.1 4.0.3

Tip! Instead of upgrading on the server, you could upgrade on your computer (if its unix based). Download a webserver that have both php4 and php5 set the paths and run the upgrade. After upgradring copy the last folder to the webserver and add the database.