Coremedia 8 Migration Guide Coremedia 8 Migration Guide |
Total Page:16
File Type:pdf, Size:1020Kb
CoreMedia 8 //Version 7.1.8-16 CoreMedia 8 Migration Guide CoreMedia 8 Migration Guide | CoreMedia 8 Migration Guide Copyright CoreMedia AG © 2015 CoreMedia AG Ludwig-Erhard-Straße 18 20459 Hamburg International All rights reserved. No part of this manual or the corresponding program may be reproduced or copied in any form (print, photocopy or other process) without the written permission of CoreMedia AG. Germany Alle Rechte vorbehalten. CoreMedia und weitere im Text erwähnte CoreMedia Produkte sowie die entsprechenden Logos sind Marken oder eingetragene Marken der CoreMedia AG in Deutschland. Alle anderen Namen von Produkten sind Marken der jeweiligen Firmen. Das Handbuch bzw. Teile hiervon sowie die dazugehörigen Programme dürfen in keiner Weise (Druck, Fotokopie oder sonstige Verfahren) ohne schriftliche Genehmigung der CoreMedia AG reproduziert oder vervielfältigt werden. Unberührt hiervon bleiben die gesetzlich erlaubten Nutzungsarten nach dem UrhG. Licenses and Trademarks All trademarks acknowledged. 19.May 2015 CoreMedia 8 ii CoreMedia 8 Migration Guide | 1. Preface ............................................................................. 1 1.1. Audience ................................................................ 2 1.2. Typographic Conventions ........................................... 3 1.3. CoreMedia Services .................................................. 5 1.3.1. Registration .................................................. 5 1.3.2. CoreMedia Releases ....................................... 5 1.3.3. Documentation ............................................. 6 1.3.4. CoreMedia Training ........................................ 8 1.3.5. CoreMedia Support ........................................ 9 1.4. Change Chapter ..................................................... 12 2. Overview ........................................................................ 13 2.1. Supported Environments ......................................... 14 2.2. Updated and New Components and Features ............... 16 2.3. Blueprint Changes .................................................. 17 2.4. Removed Components ............................................ 18 2.5. API Changes .......................................................... 19 2.5.1. Java API ..................................................... 19 2.5.2. Studio API .................................................. 26 2.6. CLI Changes .......................................................... 28 2.7. Updated Third-Party Libraries ................................... 30 3. Migration Tasks ................................................................ 32 3.1. Prerequisites ......................................................... 33 3.2. Migrating the Project Workspace ............................... 34 3.2.1. Chef Deployment ......................................... 34 3.2.2. Content Security Policy ................................. 34 3.3. Migrating the Servers .............................................. 36 3.4. Migrating Workflows ............................................... 37 3.4.1. Publication Workflows .................................. 37 3.5. Migrating Content Types .......................................... 38 3.6. Migrating CAE Applications ...................................... 41 3.6.1. CAE Modularization ...................................... 41 3.6.2. Changes in the CAE Tag Library ....................... 42 3.7. Migrating CAE Web Resources .................................. 44 3.8. Migrating Search .................................................... 51 3.9. Migrating the CAE Feeder ........................................ 54 3.10. Migrating the Content Feeder ................................. 56 3.11. Migrating Studio Customizations ............................. 58 3.11.1. Studio Plugins ........................................... 58 3.11.2. Content Security Policy ............................... 60 3.11.3. Page Grid ................................................. 60 3.11.4. Teaser Text ............................................... 61 CoreMedia 8 iii CoreMedia 8 Migration Guide | 3.12. Migrating Multi-Site Features .................................. 63 3.12.1. Site Model/Sites Service .............................. 63 3.12.2. MultiSiteUtil ......................................... 65 3.12.3. Document Forms ....................................... 72 3.12.4. Sites Structure ........................................... 73 3.12.5. Groups and Rights ...................................... 75 3.12.6. Multi-Site Workflows .................................. 75 3.12.7. Version Cleanup ........................................ 76 3.13. Migrating Elastic Social .......................................... 77 3.13.1. Data Changes ............................................ 77 3.13.2. Migration Tool ........................................... 78 3.13.3. Performing the Migration ............................ 78 Index ................................................................................. 81 CoreMedia 8 iv CoreMedia 8 Migration Guide | List of Tables 1.1. Typographic conventions ................................................... 3 1.2. Pictographs .................................................................... 3 1.3. CoreMedia manuals .......................................................... 6 1.4. Log files check list .......................................................... 10 1.5. Changes ....................................................................... 12 2.1. Supported Operation Systems ........................................... 14 2.2. Supported Databases ...................................................... 14 2.3. Other Environments ........................................................ 14 2.4. Client environments ....................................................... 15 2.5. Changes command line tools ........................................... 28 2.6. Overview of third-party library versions .............................. 30 3.1. Changed/New CoreMedia 8 Content Types .......................... 38 3.2. CAE Module contents ...................................................... 41 3.3. CoreMedia 8 Common Template Changes ........................... 44 3.4. CoreMedia 8 Sites Template Changes ................................. 46 3.5. CoreMedia 8 Extensions Template Changes ......................... 47 3.6. CoreMedia 8 Web resources structure for each theme ........... 50 3.7. CoreMedia 8 JS Changes .................................................. 50 3.8. Substitution of MultiSiteUtil.as methods ............................ 65 3.9. Substitution of MultiSiteUtil.as constants ........................... 70 3.10. Substitution of MultiSiteUtil.java methods ........................ 70 CoreMedia 8 v CoreMedia 8 Migration Guide | List of Examples 3.1. Retrieving SitesService ................................................. 65 3.2. Retrieving SitesService ................................................. 70 3.3. Retrieving ContentSiteAspect ......................................... 70 3.4. Using multiLanguageDocumentForm ................................. 73 CoreMedia 8 vi Preface | 1. Preface This manual describes the migration from a CoreMedia 7 Blueprint system to a CoreMedia 8 Blueprint system. ➞ Chapter 2, Overview [13] gives a high-level overview of all changes. This in- cludes new, deprecated and removed components and third-party software; new operation and configuration schemes, and much more. ➞ Chapter 3, Migration Tasks [32] describes the details for the actual migration tasks according to the migration scenarios. CoreMedia 8 1 Preface | Audience 1.1 Audience This manual is intended for developers, architects, and project managers who plan to migrate from CoreMedia 7 to CoreMedia 8. Project managers and architects should review Chapter 3, Migration Tasks [32] to gain a quick understanding of the neces- sary steps. CoreMedia 8 2 Preface | Typographic Conventions 1.2 Typographic Conventions CoreMedia uses different fonts and types in order to label different elements. The following table lists typographic conventions for this documentation: Element Typographic format Example Table 1.1. Typographic conventions Source code Courier new cm systeminfo start Command line entries Parameter and values Class and method names Packages and modules Menu names and entries Bold, linked with | Open the menu entry Format|Normal Field names Italic Enter in the field Heading CoreMedia Components The CoreMedia Component Applications Use Chef Entries In quotation marks Enter "On" (Simultaneously) pressed Bracketed in "<>", linked with Press the keys <Ctrl>+<A> keys "+" Emphasis Italic It is not saved Buttons Bold, with square brackets Click on the [OK] button Code lines in code examples \ cm systeminfo \ which continue in the next line -u user Mention of other manuals Square Brackets See the [Studio Developer Manual] for more information. In addition, these symbols can mark single paragraphs: Pictograph Description Table 1.2. Pictographs Tip: This denotes a best practice or a recommendation. Warning: Please pay special attention to the text. CoreMedia 8 3 Preface | Typographic Conventions Pictograph Description Danger: The violation of these rules causes severe damage. CoreMedia 8 4 Preface | CoreMedia Services 1.3 CoreMedia Services This section describes the CoreMedia services that support you in running a Core- Media system successfully. You will find all the URLs that guide you to the right places. For most of the services you need