Talk at eZ Oslo meetup on January 28th of January 2016, about migration from eZ Publish to eZ Platform and eZ Studio. http://www.meetup.com/eZ-Oslo-Meetup/events/227909592/

1. www.ez.no
MIGRATING TO EZ PLATFORM AND EZ STUDIO
A GUIDE FOR TRANSITIONING TO
EZ’S NEW GENERATION
VERSION 1ar

2. www.ez.no
Agenda
TODAY: 5.X STACK MANUAL MIGRATION
Look at manual migration and an recent example of that.
SOON: 5.X CONTENT MIGRATION PREVIEW
Look at what migration tools will be available soon in 16.02 and 16.04.
LATER: FULL CONTENT MIGRATION
Overview of missing features before we can call it feature complete.
FUTURE: 3.X / 4.X CONTENT MIGRATION
Some info on how we might be able to cover 3.x/4.x content migration.
INTRODUCTION
Overview of what migration implies.

3. Introduction
Overview of how migration will work once all migration features are in place.

4. www.ez.nowww.ez.no
Migration Overview
Solution based
on 3rd, 4th or 5th
generation eZ CMS:
eZ Publish “legacy”
Solution based
on 6th generation
eZ CMS:
eZ Platform
and eZ Studio
“Legacy” eZ Platform / eZ Studio

5. www.ez.nowww.ez.no
Overview of differences
Environment
(operating system, web servers
, database server…)
eZ Publish
eZ Publish
Customization
eZ Publish
Extensions
Content
Environment
(operating system, web servers
, database server…)
eZ Platform &
Symfony
eZ Platform & Studio
Customization
eZ Platform &
eZ Studio Bundles
Content
“Legacy” eZ Platform / eZ Studio

6. www.ez.nowww.ez.no
Re Development
Upgrade
Option A: Direct Upgrade
Environment
(operating system, web servers
, database server…)
eZ Publish
eZ Publish
Customization
eZ Publish
Extensions
Content
Environment
(operating system, web servers
, database server…)
eZ Platform &
Symfony
eZ Platform & Studio
Customization
eZ Platform &
eZ Studio Bundles
Content
“Legacy” eZ Platform / eZ Studio

7. www.ez.nowww.ez.no
Upgrade
Upgrade
Option B: Via 5.x, part 1
Environment
(operating system, web servers
, database server…)
eZ Publish
eZ Publish
Customization
eZ Publish
Extensions
Content
Environment
(operating system, web servers
, database server…)
eZ Platform 5.x stack
Customization
Symfony Bundles
Content
“Legacy” eZ Publish 5.x “Hybrid”
eZ Publish
eZ Publish
Customization
eZ Publish
Extensions
eZ Platform 5.x stack & Symfony

8. www.ez.nowww.ez.no
Upgrade
Upgrade
Option B: Via 5.x, part 2
Environment
(operating system, web servers
, database server…)
eZ Platform 5.x stack & Symfony
Content
eZ Publish 5.x “Full stack”
eZ Publish
eZ Publish
Customization
eZ Publish
Extensions
Environment
(operating system, web servers
, database server…)
eZ Platform &
Symfony
eZ Platform & Studio
Customization
eZ Platform &
eZ Studio Bundles
Content
eZ Platform / eZ Studio
eZ Platform 5.x stack
Customization
Symfony Bundles

9. 5.X stack manual migration
With code on 5.x “Full stack”, and with simple content, you can already migrate.

10. www.ez.nowww.ez.no
FROM EZ 5.X SYMFONY TO EZ PLATFORM & EZ STUDIO
๏ Download eZ Platform or eZ Studio
๏ Move configuration and code over
๏ Add RichText and/or Landing Page field
๏ Manually move content over using UI

11. www.ez.nowww.ez.no
๏ Installation:
๏ 5.4 installation, all Symfony/5.x “Full stack”
๏ Only light use of XmlText: headings, paragraphs and bullet lists
๏ POC upgrade:
๏ 1 day
๏ 50% on re creating basic content structure, 50% setup & alignment
๏ Content moved by copy paste
๏ Both OE and RichText FieldType cable of handling this content
๏ Limitations: No controls exposed yet on adding new bullets list groups
POC Example: GodFisk.no

12. Content Migration Preview
What tools and guides to expect for 16.02/16.04

13. www.ez.nowww.ez.no
Content Migration Preview
๏ 5.4 to eZ Platform/eZ Studio Upgrade Guide [planned, eta 16.02]
๏ RichText
๏ Script for upgrading XmlText to RichText [in progress, eta 16.02]
๏ Custom tag guide [planned, eta 16.04]
๏ Custom tag migration guide [planned, eta 16.04]
๏Landing Page
๏ Script for upgrading Flow to Landing Page [planned, eta 16.04]
๏ Content and configuration
๏ Custom block guide [exists]
๏ Custom block migration guide [planned, eta 16.04]

14. Full Content Migration
Overview of the main missing features in order to enable all migrations.

15. www.ez.nowww.ez.no
Feature status
✓ Landing Page Field type feature parity, including custom blocks
✓ Rich Text Field type feature parity, including custom tags
‣ OE (Online Editor)
➡ Controls for Bullet lists [eta 16.02]
➡ Broader Embed support [eta 16.02 and 16.04]
➡ Controls for Tables
➡ Custom tags
➡ Custom attributes
➡ Classes (for all tags)
Further info: https://doc.ez.no/display/MAIN/Transitioning+from+eZ+Publish
+to+eZ+Platform+and+eZ+Studio%3A+Feature+Comparison

16. 3.x/4.x Content Migration
Look beyond for possible direct content migration for legacy versions.

17. www.ez.nowww.ez.no
3.x / 4.x content migration
๏ Once we have 5.x upgrades covered
๏ Handle 4.7 and while on it we can go as far back as sensible
๏Feedback on which versions most installs are on is welcome to identify needs!
Again, further info in regards to features: https://doc.ez.no/display/MAIN/
Transitioning+from+eZ+Publish+to+eZ+Platform+and+eZ+Studio%3A
+Feature+Comparison

18. Summary

19. www.ez.nowww.ez.no
Summary
➡Upgrade Doc from 5.4 - planned, preview eta around 16.02
๏Rich text
✓ eZ XmlText upgrade to eZ Richtext (Docbook) - now in prototype for 16.02
See: https://github.com/ezsystems/ezplatform-xmltext-fieldtype/pull/7
✓ eZ RichText Field Type supports all features XmlText did, incl. custom tags & embeds
➡ But you’ll have to adjust your code for this, code migration guide planned.
➡Known limitations with OE: Tables, Bullets, Custom tags, limited embeds
๏Pages
✓ eZ Flow upgrade to eZ (Studio) Landing Page - planned, eta 16.04
✓ eZ Landing Page Field Type supports all features Flow did, incl. pages, zones & blocks
➡ But you’ll have to re implement your blocks, code migration guide planned.
➡Known limitations: Landing page not updated on content delete

20. www.ez.nowww.ez.no
Migration Take aways
๏Right now (15.12, & 15.12.1 due next week) best match is new projects
๏Migrations becomes possible increasingly over the course of 2016
๏Simple sites with simple needs possible starting 16.02 end of February
๏Most sites, even those with simple approval workflows and Flow, by 16.04/16.06
๏Complex sites should ideally go via 5.4 and should rather evolve there until ready,
migrations can happen as of Fall 2016
๏After this point we can consider prioritizing direct 4.x content upgrade scenarios

21. www.ez.no
THANK YOU
MORE MIGRATION RESOURCES
COMING OVER THE NEXT RELEASES.