This section describes how to upgrade your existing eZ Publish Community Project 2012.2 installation to build 2012.3. Make sure that you have a working backup of the site before you do the actual upgrade, and make sure the installation you are performing the upgrade on is offline.
The procedure for upgrading from eZ Publish Community Project build 2012.2 to build 2012.3 consists of the following steps:
It is recommended to always verify the requirements for the new version of eZ Publish before attempting an upgrade. eZ Publish Community Project 2012.3 is compatible with PHP version 5.3 and above. So is eZ Publish Community Project 2012.2. For more information regarding system requirements check out http://doc.ez.no/eZ-Publish/Technical-manual/4.6/Installation/Requirements-4.6
Tip: if you have many user sessions, and the session data is stored in the database, it might be a good idea to remove all data from the session table before backing it up
Tip: in ezdb and ezdfs cluster modes, it is a good idea to clear all caches before dumping the storage database, as it is not easy to only backup storage and not caches
This step is recommended but not mandatory
Run the following against your MySQL database :
SET storage_engine=InnoDB; UPDATE ezsite_data SET value='4.7.0beta1' WHERE name='ezpublish-version'; UPDATE ezsite_data SET value='1' WHERE name='ezpublish-release'; ALTER TABLE ezcontentobject_attribute MODIFY COLUMN data_float double DEFAULT NULL; ALTER TABLE ezcontentclass_attribute MODIFY COLUMN data_float1 double DEFAULT NULL; ALTER TABLE ezcontentclass_attribute MODIFY COLUMN data_float2 double DEFAULT NULL; ALTER TABLE ezcontentclass_attribute MODIFY COLUMN data_float3 double DEFAULT NULL; ALTER TABLE ezcontentclass_attribute MODIFY COLUMN data_float4 double DEFAULT NULL;
Run the following against your Postgresql database :
UPDATE ezsite_data SET value='4.7.0beta1' WHERE name='ezpublish-version'; UPDATE ezsite_data SET value='1' WHERE name='ezpublish-release'; ALTER TABLE ezcontentobject_attribute ALTER COLUMN data_float TYPE double precision; ALTER TABLE ezcontentclass_attribute ALTER COLUMN data_float1 TYPE double precision, ALTER COLUMN data_float2 TYPE double precision, ALTER COLUMN data_float3 TYPE double precision, ALTER COLUMN data_float4 TYPE double precision;
The easiest way to upgrade the distribution files is to unpack eZ Publish 2012.3 to a separate directory and then copy into it the directories that contain site-specific files from the existing installation. Make sure that you copy the following directories:
Replace "mydesign" and "mydesign_admin" with the actual names of your designs.
Important note: Because the new directory has replaced the original directory, the directory permissions need to be fixed. Use the following commands to do this.
(You have the choice between Shell commands or Alternative shell commands):
These shell commands will give proper permission to the web server:
cd </path/to/your/eZ/Publish/directory> chmod -R a+rwx design extension settings var
These commands will setup the permission more correctly, but require knowledge about the user account used for running the web server process.cd </path/to/your/eZ/Publish/directory>
cd </path/to/your/eZ/Publish/directory> chmod -R og+rwx design extension settings var chown -R <webuser>:<webusergroup> design extension settings var
If you are using custom extensions, the sub-directories inside the "extension" directory will also have to be copied. However, make sure that you do not overwrite any extensions that are included in the eZ Publish 2012.3 tarball, which are currently:
Bundled and enabled
Bundled but not enabled
Optional installation (depending on the package chosen during the installation wizard)
To regenerate the autoload array, execute the following script from the root of your eZ Publish installation:
php bin/php/ezpgenerateautoloads.php --extension
Whenever an eZ Publish website is upgraded, all caches must be cleared in a proper way. This should be done from the root directory of your eZ Publish installation:
php bin/php/ezcache.php --clear-all --purge
Tip : Purging ensures that the caches are physically removed. When the "--purge" parameter is not specified, the caches will be expired but not removed.
Sometimes the script is unable to clear all cache files because of restrictive file/directory permission settings. Make sure that all cache files have been cleared by inspecting the contents of the various cache sub-directories within the "var" directory (typically the "var/cache/" and "var/<name_of_siteaccess>/cache/" directories). If there are any cache files left, you need to remove them manually.
This step is optional, and is only needed if you put the website offline at step 2
php bin/php/eztc.php --wwwdir=<value> --index-file=<value>