ezupgrade

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 upgrade 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. The matrix above describes which versions that are currently supported.

Requirements

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

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).

Installation

1. Check out ezupgrade to the server where the upgraded installation will reside.
2. Check out ezcopy (http://projects.ez.no/ezcopy) to the /lib folder of ezupgrade (making the directory /lib/ezcopy) and and follow its installation instructions. Finally, copy the ezcopy.ini file from lib/ezcopy/settings/ to settings/
3. Copy settings/account_default.ini and rename the copy settings/account.ini. For each account you need to upgrade, create an Account block with the proper settings.
4. Run the following command within ezupgrade:

Usage

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