eZ Publish / Releases / eZ Publish Community Project 2012 / ez-publish-community-project-2012-11

ez-publish-community-project-2012-11

eZ Publish Community Project 2012.11

You are using the innovative and cutting-edge version of eZ Publish, built by eZ Systems and the eZ Community.

Requirements

Version : Release date : Requirements :
Community Project 2012.11 (second "eZ Publish 5 build") Dec. 14th, 2012

PHP >= 5.3.3 (5.3.7 known to be bugged)
MySQL >= 5.0.51a
PostgreSQL >= 8

If using eZ Find : Java <= 1.6 or >= 1.7.1

Release Notes - ez-publish-community-project-2012-11

Highlights

This is the second eZ Publish 5 release of Community Project!

It comprises an eZ Publish 4.x build, under ezpublish_legacy (at the root of your eZ Publish 5 installation), that you can extract and use as a stand-alone version. We highly recommend, however, to get acquainted with the brand new eZ Publish 5 stack :). If you are not sure what this means, have a look at the announcement from The Community Project Board.

 

Installation of eZ Publish 5

The normal installation procedure for the eZ Publish 5 stack must be followed (make sure to follow the Virtual Host based installation procedure in the latter to initiate the setup wizard).

 

Resources, documentation & rendez-vous to discuss 

Read Damien's story of the upgrade of planet-ezpublish.fr to eZ Publish 5. Also, take a look at this tutorial by Granite Horizon, to take a safe start in creating controllers for eZ Publish 2012.11. 

 

Still up-to-date

Our core-team has blogged on the fly when developing eZ Publish 5, here is a short overview:

We discussed the topic extensively at the first eZ Community UnConference, and got our first hands-on experience on Symfony 2.

We have also been speaking at:

Last, but not least: the eZ Publish 5 documentation still is under construction, but great moves were achieved since 2012.9. You can find it here: https://confluence.ez.no/display/EZP/eZ+Publish+Documentation, notably the Cookbook for developers. Feedback appreciated on this too.

Feedback/reports are key, more than ever

Our community is at a turning point, where feedback is more important than ever. Should you encounter issues installing eZ Publish 5, using it, stumbling upon missing functionalities, or be willing to take an active part in eZ Publish 5 development, like some already did, use the following resources:

 

Known issues

  • When trying to sign-in, through the 5.x stack, you will encounter an issue if you are running PHP 5.4 or above.
  • The final screen of the installation wizard still requires you to enter information to be able to finalize the installation. We will make this an opt-in step, as discussed here.

 

Stats

  • 42 bug-fixes for registered issues
  • 30 pull-requests merged (Scooore again! Keep-on rocking fellas!)
  • 2 enhancements

See the changelog for details

Upgrade Notes

Upgrading from eZ Publish Community Project 2012.9 to 2012.11

Important information: This is the second "eZ Publish 5" build, that comprises an eZ Publish 4.x build, under the 'ezpublish_legacy' folder, at the root of your eZ Publish 5 installation. The upgrade procedure below must be applied to the latter, then the normal installation procedure for the eZ Publish 5 stack must be followed (make sure to follow the Virtual Host based installation procedure in the latter to initiate the setup wizard).

 

This section describes how to upgrade your existing eZ Publish Community Project 2012.9 installation to build 2012.11. 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.

Important upgrade notes:

The procedure for upgrading from eZ Publish Community Project build 2012.9 to build 2012.11 consists of the following steps:

 

This section describes how to upgrade your existing eZ Publish Community Project 2012.9 installation to build 2012.11. 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.

Important upgrade notes:

The procedure for upgrading from eZ Publish Community Project build 2012.9 to build 2012.11 consists of the following steps:

  • Backing up the website
  • Putting the website offline (optional)
  • Upgrading the database
  • Upgrading the distribution files to 2012.11
  • Upgrading custom extensions
  • Regenerate the autoload array for extensions
  • Clearing the caches
  • Putting the website online (optional)

 

Check for requirements

It is recommended to always verify the requirements for the new version of eZ Publish before attempting an upgrade. eZ Publish Community Project 2012.9 is compatible with PHP version 5.3 and above. So is eZ Publish Community Project 2012.11. For more information regarding system requirements check out http://doc.ez.no/eZ-Publish/Technical-manual/5.x/Installation/Normal-installation/Requirements-for-doing-a-normal-installation.

 

Step 1: Backing up the website

  • Filesystem set: the extension and settings folders, plus any other folder where you have put your custom developments in (e.g. design/mydesign)
  • Content set: the var/storage, var/<vardir>/storage folders, and a dump of the database (nb: for ezdb cluster mode, a dump of the storage database is needed instead of the storage folders; for ezdfs cluster mode both a dump of the storage database and a backup of the shared var folder on nfs)
  • Optional: the complete installation directory of eZ Publish, except for the var directory and for the eZFind index directory. This is mandatory if you have customized the .htaccess or config.php files

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

 

Step 2: Putting the website offline (optional)

This step is recommended but not mandatory

  • Put the public website offline and set up a courtesy page to prevent end users from accessing the website while you upgrade. This involves generally modifying the webserver configuration. Make sure you have a different vhost available to access the public website using a private IP address or hostname during the upgrade process
  • Disable execution of eZ Publish cronjobs

 

Step 3: Upgrading the database

MySQL

Run the following against your MySQL database :

<span>SET</span> storage_engine<span>=</span>InnoDB; <span>ALTER</span> <span>TABLE</span> eznode_assignment <span>CHANGE</span> remote_id remote_id VARCHAR<span>(</span><span>100</span><span>)</span>;<span>UPDATE</span> ezsite_data <span>SET</span> value<span>=</span><span>'5.1.0alpha1'</span> <span>WHERE</span> name<span>=</span><span>'ezpublish-version'</span>;<span>UPDATE</span> ezsite_data <span>SET</span> value<span>=</span><span>'1'</span> <span>WHERE</span> name<span>=</span><span>'ezpublish-release'</span>;

Postgresql

Run the following against your Postgresql database :

<span>UPDATE</span> ezsite_data <span>SET</span> value<span>=</span><span>'5.1.0alpha1'</span> <span>WHERE</span> name<span>=</span><span>'ezpublish-version'</span>;<span>UPDATE</span> ezsite_data <span>SET</span> value<span>=</span><span>'1'</span> <span>WHERE</span> name<span>=</span><span>'ezpublish-release'</span>;<span>ALTER</span> <span>TABLE</span> eznode_assignment <span>ALTER</span> <span>COLUMN</span> remote_id TYPE VARCHAR<span>(</span><span>100</span><span>)</span>;

 

 

Step 4: Upgrading the distribution files

The easiest way to upgrade the distribution files is to unpack eZ Publish 2012.11 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:

  • design/<mydesign>
  • design/<mydesign_admin>
  • var
  • settings/siteaccess
  • settings/override

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

  • 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 
  • Alternative shell commands

 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 varchown -R <webuser>:<webusergroup> design extension settings var 

 

Step 5: Custom extensions

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.11 tarball, which are currently:

Bundled and enabled

  • ezautosave-5.1.0-alpha1
  • ezcomments-5.1.0-alpha1 (ezpublish-5.0.0)
  • ezformtoken-5.1.0-alpha1
  • ezie-5.1.0-alpha1
  • ezjscore-5.1.0-alpha1
  • ezmultiupload-5.1.0-alpha1
  • ezodf-5.1.0-alpha1 (ezpublish-5.0.0)
  • ezoe-5.1.0-alpha1
  • ezprestapiprovider-5.1.0-alpha1
  • eztags-1.3.0-dev

Bundled but not enabled

  • ezfind-5.1.0-alpha1
  • ezscriptmonitor-5.1.0-alpha1 (ezpublish-5.0.0)

Optional installation (depending on the package chosen during the installation wizard)

  • ezdemo-5.0 (ezpublish-5.0.0)
  • ezdemodesign-5.0 (ezpublish-5.0.0)
  • ezflow-5.0 (ezpublish-5.0.0)
  • ezwebin-5.0 (ezpublish-5.0.0)
  • ezwt-5.0 (ezpublish-5.0.0)
  • ezgmaplocation-5.0 (ezpublish-5.0.0)
  • ezstarrating-5.0 (ezpublish-5.0.0)

 

Step 6: Regenerate the autoload array for extensions

To regenerate the autoload array, execute the following script from the root of your eZ Publish installation:

php bin/php/ezpgenerateautoloads.php --extension

 

Step 7: Clearing the caches

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.

 

Step 8: Putting the website back online

This step is optional, and is only needed if you put the website offline at step 2

  • warm up the template cache by pre-compiling template files. This should be done from the root directory of your eZ Publish installation:
php bin/php/eztc.php --wwwdir=<value> --index-file=<value> 
  • re-enable the cronjobs
  • warm up the content cache: use a tool such as curl or wget that will navigate the website to force eZPublish to generate the view cache for all content
  • change the webserver / firewall configuration to allow public access to your website again
  • Backing up the website
  • Putting the website offline (optional)
  • Upgrading the database
  • Upgrading the distribution files to 2012.11
  • Upgrading custom extensions
  • Regenerate the autoload array for extensions
  • Clearing the caches
  • Putting the website online (optional)

Changelog

Changelog from Community Project 2012.9 to Community Project 2012.11

Bugfixes
  • 18007: LDAP user and group strings are not escaped
  • 18653: Fatal error when searching for some special characters
  • 19597: Memory leak on script bin/php/dfscleanup.php
  • Fixed EZP-196171 - DFS cluster: expiryXYZtmp.php with 0 byte size
  • Fixed EZP-19857: First login for a new user has the content tabs disabled
  • Fixed EZP-20090 - Cluster: images with name containing quotes disappear after discarding a draft of a published object
  • Fix EZP-19886: Wrong sort order in object relations list with ezautosave
  • Fixed EZP-19889: datatype eZSelection returns allways true in function hasObjectAttributeContent
  • Fixed EZP-20138: Links to not anymore existing documentation pages in install process
  • Fixed EZP-19697: Clustering: fetchFileMetaData() more expensive than necessary
  • Fixed EZP-19684: Search engine doesn't handle curly quotes correctly
  • Fixed EZP-19836: log size declared in config.php fails to apply
  • Fixed EZP-19660: viewcache is cleared/refreshed before content publish operation is finished.
  • Fixed: EZP-20089: Failure in legacy integration tests with non SQLite database
  • Fix EZP-14921: 'small' size hardcoded in ezoe code
  • Fix EZP-20022: clusterize.php generates an error in error.log
  • fixed ezp-20080: translation incorrect
  • Fix #EZP-19835: REST interface may not recognize SSL properly
  • Fix EZP-19929: embedding images in ezoe generates PHP warning
  • Fix EZP-19985: Unable to apply database upgrade on Postgres SQL
  • Fixed EZP-20012: Notice and incorrect behaviour of eZXMLTextType::title() method
  • Fix EZP-19798: INI placement in settings/view is broken
  • Fix EZP-19941: Expose API to be able to remove search index after object has been deleted
  • Fixed EZP-19712 Impossible to log in the admin interface using PHP 5.4
  • Fixed EZP-19904 Admin interface redirection to raw treemenu JSON output
  • Fix EZP-19832: IE8 Not aligning correctly the text
  • Fix EZP-19707: Unable to align an embed image
  • Fix EZP-19830: ezmultiupload is broken if used through the Symfony stack
  • Fix EZP-19834: Fatal error if the object is removed before running workflow cronjob
  • Fixed EZP-19876: Changing Class's attribute order mixes attributes when we use a already existing order number
  • Fixed EZP-19830: ezmultiupload is broken if used through the Symfony stack
  • Fixed issue EZP-19851 - The footer div is inside of columns div in the webshop
  • Fixed EZP-19838: updated rewrite rules the new admin skin
  • Fixed EZPNEXT-829: eZ DFS SQL errors storing image files when path contains apostrophe (urlalias_iri)
  • Fixed EZP-19849: added mapping from pgsql to eZPostgreSQLDB
  • Additional fix EZP-197: Warning: session already started when logging in
  • EZP-108, console.log removal
  • EZP-108, grippers positioning fix
  • Fix for issue #18411
  • Fixed: 018625: Upgrading from 4.5 to 4.6alpha1 database (mysql) consistency check fails
  • Fix for ticket #018582. Credits go to Jakub Derdziak :)

Enhancements
  • Implemented 'content/cache/all' event when clearing all content cache
  • Implemented support for PUT and DELETE + fallback to support those over POST with _method param

Pull requests
  • 114: from dpobel/admin2_css
  • 116: from eeggenberger/master
  • 117: from emodric/cro_flag
  • 119: from pkamps/StaticCache
  • 123: from emodric/fix_18411_2
  • 436: from jeromegamez/issue_19629_image_aliases
  • 460: from jeromegamez/19697_fetchfilemetadata
  • 470: from patrickallaert/EZPNEXT-829
  • 473: from pedroresende/EZP-19851
  • 475: from jeromegamez/ezp-19852
  • 476: from npanau/french_translation
  • 478: from patrickallaert/EZP-19876
  • 482: from harmstyler/patch-1
  • 485: from jeromegamez/EZP-19938
  • 486: from ezsystems/sessionPHP54
  • 488: from ezsystems/EZP-19941
  • 490: from johanberonius/patch-1
  • 492: from patrickallaert/EZP-20012
  • 497: from jeromegamez/EZP-20072
  • 498: from pbras/ezp20080
  • 502: from patrickallaert/EZP-20089
  • 504: from jjCavalleri/20002
  • 505: from patrickallaert/EZP-19660
  • 507: from patrickallaert/EZP-19684
  • 508: from crevillo/EZP-20138
  • 511: from bgamrat/master
  • 515: from jeromegamez/method_fetch
  • 516: from peterkeung/ezautosave-noconflict
  • 518: from jeromegamez/lastserialid
  • 524: from ezsystems/EzcComposerLoadingSupport

Miscellaneous
  • Change Composer use to avoid including legacy autoload.php when legacy folder is called 'ezpublish'
  • Make the app folder configurable
  • Add support for loading Zeta Componebnts via Composer in ezpublish5 context
  • Bump composer version
  • Fix a minor mistake in 86a052683cd573c0792015686208ec6fc2c0c4ba
  • Reconfigure master for next version
  • Fixed unit tests with PHP 5.4
  • Disabled PostgreSQL tests for now [ci skip]
  • Fixed travis conf to correctly initialized the PostgreSQL database
  • Fixed eZDBFileHandlerTest to not run against postgresql
  • Improved travis conf to run unit tests in PHP 5.3 and 5.4 using mysql or postgresql
  • Fixed the eZLocale unit tests to correctly run in default PHP configuration
  • Fixed DFS file handler backend so that unit tests succeed
  • Revert "Fixed DFS file handler backend so that unit tests succeed"
  • Fixed DFS file handler backend so that unit tests succeed
  • Fixed: make sure unit tests correctly remove the language they create
  • Fixed: make sure the autoload for extensions are also generated by travis
  • Fixed failing unit test on ezpRestHttpRequestParser
  • Skipped unit tests that relies on stmp.ez.no
  • Removes the comment & variable altogether...
  • Added travis badge to README file [ci skip] (cherry picked from commit 2f5c4709d7801ef4d02ee3192802aecf2db62ba5)
  • Fixed ez xml related unit tests (cherry picked from commit 3ef6584156166380acc7c110527e07254b0ad724)
  • Configured Travis CI (cherry picked from commit 79772223ca921212e2f0f393d45cac60b2d83805)
  • EZP-196171 - Added missing variable initialization
  • PHPDoc for lastSerialId()
  • Remove `@method fetch` PHPDoc
  • Use jQuery no-conflict selections
  • Update kernel/private/classes/ezpmobiledeviceregexpfilter.php
  • Merge branch 'ezp-14921_ezoe_small_hardcoded'
  • Enhances handling of deleted users references
  • Ref EZP-19649 - Fixed missing _md5() call
  • Replaced direct access to protected class variable with setter call
  • Improve indenting of csrf meta tags
  • Update kernel/classes/clusterfilehandlers/ezfsfilehandler.php
  • Added SORT_REGULAR flag to array_unique()
  • array_unique() on 2-dimensional array produces PHP notices
  • Move the comment to the line above the variable.
  • Update kernel/classes/datatypes/ezxmltext/ezxmlinputparser.php
  • Merge commit '6b6af15'
  • Merge branch 'ezp-19830_ezmultiupload_session'
  • suppression unfinished
  • Add phpdoc on eZSearch:getEngine()
  • Fixed a display issue when the trash is empty
  • Fixed: one too many </div>
  • Fixed template errors in trash.tpl
  • Fixed SCRIPT_NAME usage instead of SCRIPT_FILENAME to get current front controller
  • $functions is not defined, use $def["functions"][$attr] instead
  • Merge branch 'EZP-108.clean2'
  • Fixed: make sure the create new menu is visible above and below the #columns
  • Fixed: make sure table options and its mask are above the rest
  • Fixed: optimized PNG images
  • Fixed: vertically centered image in image + text links
  • Fixed: decreased a bit the font size in popmenu
  • Fixed: removed useless background that causes problem on ezflow push to block
  • Fixed: give some love to the context menus
  • Fix fatal error in standalone execution introduced in 4856b2328d6fd019cf573ffa429139d438bca210
  • Fixed: CS no trailing spaces
  • Changed: more use of sprites
  • Fixed label size in search scope body
  • Fixed: integrate register_page_fix.css code into main stylesheets
  • Fixed leftmenu behaviour to not break login form
  • Fix hardcoded use of 'index.php' in ezpKernelWeb
  • Fixed a regression on login page (white background and not centered)
  • Fixed: make sure (again!) that the context menu is above the left menu handler
  • Fixed: removed the useless onDrawCallback
  • Revert "added updatePanelsHeight callback on TreeMenu unfold"
  • Fixed: get rid of the useless scrollbar on the subitem list
  • Fixed the modal window style to be consistent with the rest
  • Fixed: restored (again!) the ability show/hide the left column while editing
  • Fixed table prefs. controls
  • Merge branch 'EZP-108.clean2' of github.com:ezsystems/ezpublish into EZP-108.clean2
  • Fixed: restored Arial as the main font and fixed most font size issues
  • Merge branch 'EZP-108.new.panels' into EZP-108.clean2
  • New equal height panels mechanism done
  • Testing new equal height panels mechanism
  • Fixed: fix the behaviour of the fixed controlbar to be the same in content and class edit
  • Fixed: the maincontent on content/edit is always positionned as if the leftmenu is uncollpased.
  • Fixed the text color of table headers in edit form
  • Fixed: make sure the popupmenu are above the with control handler of the right column
  • Fixed: make sure the fixed controlbar is above everything else
  • Fixed: bring back the ability to show/hide the left column while editing
  • Changed: format of injected settings as flat hash
  • Content Structure, language panel positioning fix
  • Dragging and Expanding icons in panels updated
  • added updatePanelsHeight callback on TreeMenu unfold
  • Re-enabled breadcrumb path
  • Implementing sprites wherever possible
  • Added campaign tracking code to dashboard links
  • Updated maintenance block
  • Fixes to previous commit, after Jerome\'s feedback - thanks\!
  • Re-inforced branding of eZ Publish Community Project: new block and reworked verbiage on the back-office dashboard
  • Highlighted version information in dashboard and footer more visible
  • Less expensive MySQL query when fetching meta data
  • Retargeted "to the top" links to the columns instead of header
  • Merge branch 'master' into EZP-108.clean
  • Remove temorary community project switch variables
  • Admin2: Moved debug output bellow <div id='page'> to avoid issues with height js
  • Minor style corrections
  • Merge branch 'EZP-108' of https://github.com/ezsystems/ezpublish into EZP-108
  • Merge commit '6175de816d0a038969183f48fb556534afde8876' into EZP-108
  • Merge branch 'master' of git://github.com/ezsystems/ezpublish into issue_19629_image_aliases
  • Merge branch 'issue_19629_image_aliases' of github.com:jeromegamez/ezpublish into issue_19629_image_aliases
  • Always remove a filepath from the table ezimagefile
  • New skin for administration interface: changes achievable by pure CSS changes
  • new interface added to autoload
  • Fix for Croatian flag not displaying in admin interface
  • Merge branch 'master' of github.com:ezsystems/ezpublish
  • Added: ezorder_nr_incr for postgresql upgrade
  • Changed: set vertical align of icon title to middle
  • Fixed style of table headers to be consistent across browsers
  • Changed: set vertical align to middle in tables
  • Made buttons a bit bigger especially in Chrome/Safari

Tags

eZ Publish 2012