Il repository delle estensioni del CMS TYPO3: vediamo come fare la migrazione di una installazione del CMS TYPO3 dalla versione 4.5 alla versione 6.x. Queste slides sono relative al talk fatto al T3Camp Italia 2014 tenutosi a Milano il 14-15 marzo 2014.

1. Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/
Migrare da
TYPO3 4.5 LTS
verso
TYPO3 6.x
T3Camp Italia 2014
L'evento italiano dedicato a TYPO3
Milano 14/15 Marzo 2014
BEST WESTERN Antares Hotel Concorde

2. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 2
Presentazione relatore
Dal 1994 mi occupo di progettazione e consulenza web
Nel 1996 co-fondatore della Archimede Informatica Società Cooperativa
di cui sono tuttora il presidente
Nel 1997 mi sono laureato in Scienze dell'Informazione all'Università di Pisa
Dal 2003 ha cominciato a realizzare i primi portali con TYPO3
Nel 2010 sono diventato “Certified TYPO3 Integrator”
In Archimede Informatica mi occupo di coordinare e gestire l’intera fase di
realizzazione dei progetti web, dalla analisi dei requisiti alla progettazione
fino alla implementazione finale con TYPO3.
Rino Razzi

3. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 3
Presentazione relatore
ISTAT – Istituto Nazionale di Statistica
CNR di Pisa (vari istituti)
Università di Pisa, Università di Firenze, Università della Calabria
Comuni di Pisa, Pistoia, Castagneto Carducci e di Bibbona
Opera Primaziale Pisana (ente gestore di Piazza dei Miracoli e Torre di Pisa)
Language Logic L.L.C. - USA
The 3rd Degree Limited – Londra
Quotidiano nazionale “il manifesto”
Centro di Ricerca Beni Culturali (CriBeCu) - Scuola Normale di Pisa
ASI- Agenzia Spaziale Italiana
Archimede Informatica: alcuni clienti e partner

4. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 4
Mostrare tutte le azioni e i passaggi necessari per portare
a termine la migrazione di una installazione
da TYPO3 4.5 LTS a TYPO3 6.x
NOTA:
Sarebbe stato meglio trattare la migrazione
TYPO3 4.5 LTS --> TYPO3 6.2 LTS
Ma sarebbe stato molto complicato poiché:
--> TYPO3 6.2 LTS sarà rilasciata tra circa 10 giorni
--> ci stanno lavorando molto e cambia continuamente anche in
modo consistente!!
Obiettivo della presentazione

5. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 5
Due parole su
4.5 LTS -> 6.2 LTS [ 1 ]
Esiste un progetto TYPO3 specificamente nato per pianificare e
supportare il passagio diretto LTS to LTS:
Si chiama "LTS Smooth Migration"
"A smooth upgrade path from TYPO3 CMS 4.5 LTS to TYPO3 CMS 6.2
LTS is one of the major goals during the development of the upcoming
version."
si trova su http://forge.typo3.org/projects/typo3cms-smoothmigration
iniziato a giugno 2013, ad oggi ha prodotto:
- Smooth Migration: una estensione per fare check pre-upgrade e
dare suggerimenti su modiche da fare prima dell'upgrade
- Indicazioni su step da seguire per upgrade
- Patch per alcune estensioni più diffuse: realurl, tt_news,
powermail

6. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 6
Nelle versioni beta più recenti della 6.2 (l'ultima è la beta 6 del
4/3/14), nell'Upgrade Wizard sono sono stati introdotti task specifici
per facilitare l'upgrade da 4.5 LTS, tra cui:
semplificazione delle procedure di upgrade
miglioramento della migrazione verso File Abstraction Layer (FAL)
si veda news di rilascio di della beta6:
http://typo3.org/news/article/typo3-cms-62-lts-beta6-released/
Due parole su
4.5 LTS -> 6.2 LTS [ 2 ]

7. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 7
Finché non ci sarà una versione della 6.2
"stabile" la strategia migliore appare:
migrare subito da 4.5 a 6.1 risolvendo il
grosso dei problemi e in un secondo
momento....
quando la 6.2 sarà stabile, migrare da
6.1 a 6.2: dovrebbe essere comunque
più facile!!
In attesa di TYPO3 6.2 LTS

8. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 8
Elenchiamo i punti che affronteremo:
Verifica cambiamenti requisiti HW e SW per la 6.1
Verifica delle estensioni in uso supportate anche in 6.1
Eliminare tutte le ext non utilizzate
Upgrade all'ultima 4.5 disponibile
Upgrade delle ext all'ultima versione supportata sulla 4.5
Upgrade del core alla 6.1.7
Upgrade estensioni a versione compatibile 6.1.7
Sostituzione estensioni non compatibili con nuove estensioni
Come migrare da 4.5 a 6.1

9. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 9
Requisiti minimi TYPO3 4.5 TYPO3 6.1.7
PHP 5.2.x 5.3.7
MySQL 5.0.x 5.1.x
PHP memory limit - minimo 64 MB 128 MB
Verifica dei requisiti SW e di memoria
Come migrare da 4.5 a 6.1

10. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 10
Admin Tools
-->
DB check
-->
Record
Statistics
Come migrare da 4.5 a 6.1
Verificare estensioni effettivamente
utilizzate [ 1 ]
Con Record
Statistics, per ogni
tipo di record
(estensione) si
vede quanti ne
sono utilizzati nel
sistema

11. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 11
Extension
Manager
Come migrare da 4.5 a 6.1
Verificare estensioni effettivamente
utilizzate [ 2 ]
Capita spesso di
avere alcune
estensioni
inutilizzate
(installate o meno)
che si possono
rimuove.

12. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 12
1) Elenco ext incompatibili con la 6.x
http://wiki.typo3.org/TYPO3_6.0_Incompatible_Extensions_T
Come migrare da 4.5 a 6.1
Verifica estensioni supportate in 6.1 [ 1 ]
A questa pagina si
trova un elenco
dettagliato delle
estensioni
incompatibili con
TYPO3 6.x con
indicazione della
ragione
dell'incompatibilità

13. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 13
2a) Controlla sul TER perchè l'elenco precedente potrebbe non essere
aggiornato
Come migrare da 4.5 a 6.1
Verifica estensioni supportate in 6.1 [ 2 ]
Per sicurezza è
bene fare un
ulteriore controllo
sul TER per quelle
estensioni che
risultano
incompatibili nella
pagina web
precedente

14. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 14
2b) Controlla sul TER perchè l'elenco precedente potrebbe non essere
aggiornato (http://www.typo3.org/)
Come migrare da 4.5 a 6.1
Verifica estensioni supportate in 6.1 [ 3 ]
A volte le
estensioni
presenti sul TER
non indicano la
la compatibilità
nell'apposito
campo della
scheda
“Dependencies”
Allora occorre
cercare più a
fondo

15. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 15
3a) Provare anche ad installare ed utilizzare l'estensione
Smooth Migration
Anche se realizzata per la 6.2 ci può dare informazioni utili sulle
incompatibilità delle estensioni.
Effettua una lunga serie di check sul codice PHP delle estensioni e
fornisce un report dettagliato di tutte le chiamate incompatibili con la 6.2.
- Si scarica dal GitHub: https://github.com/nxpthx/typo3-upgradereport
- Si salva in locale su typo3conf/ext/smoothmigration
- Si installa dall'Extension Manager
Come migrare da 4.5 a 6.1
Verifica estensioni supportate in 6.1 [ 4 ]

16. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 16
3b) Report dell'estensione Smooth Migration
Come migrare da 4.5 a 6.1
Verifica estensioni supportate in 6.1 [ 5 ]

17. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 17
Migrazione delle ext DAM (Digital Assets Management)
DAM non è compatibile con TYPO3 6.x!!!
Al posto di DAM ci sono il FAL del core TYPO3 6.x e la ext Media Management
Ci sono alcune estensioni specifiche per il porting DAM --> FAL
- DAM2FAL: porting da 4.5 a 6.1.x [reperibile sul TER]
- t3ext-dam_falmigration: varie versioni alcune per 6.2 altre per 6.1
non si trovano su TER, vanno scaricate da GitHub
Qualche caso speciale
Valutazioni su TemplaVoila! e TYPO3 6.x
TV 1.8.0 è compatibile con TYPO3 6.1.x
Quasi sicuramente ci sara un TV compatibile con TYPO3 6.2 LTS
Al momento TV non sembra avere più prospettive
==> forse è il momento giusto per decidere di passare ad altri strumenti di templating!!
Come migrare da 4.5 a 6.1
Verifica estensioni supportate in 6.1 [ 6 ]

18. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 18
1) Devo fare upgrade di PHP, MySql, RAM?
2) Quante e quali delle estensioni che utilizzo nella mia installazione
non sono supportate su 6.x? E per ognuna di queste:
- esiste una estensione sostitutiva 6.x compatibile?
- quanto tempo mi costa adottare la nuova estensione per 6.x?
Esempi di estensioni sostituibili a “basso costo”:
- slider di homepage, sitemap, menù lingue, ...
Esempi estensioni sostituibili ad “alto costo”:
- Shop, DAM, Seminars, ....
Prima di proseguire, fermiamoci un attimo
e facciamo il punto!!! [ 1 ]
Come migrare da 4.5 a 6.1

19. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 19
Due cose da valutare e soppesare:
tempo necessario per porting installazione
tempo necessario a rifare il sito su 6.1 e trasferire solo i
contenuti
A seconda delle valutazioni che faccio:
procedo con il porting :-)
rifaccio ex-novo sito su 6.x e trasferisco contenuti :-(
Prima di proseguire, fermiamoci un attimo
e facciamo il punto!!! [ 2 ]
Come migrare da 4.5 a 6.1

20. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 20
Proseguiamo con
la migrazione,
ipotizzando di
aver valutato che
è la soluzione
meno onerosa!
Procediamo con la
migrazione!

21. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 21
Disinstallare e rimuovere estensioni inutili
Come migrare da 4.5 a 6.1

22. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 22
Fare upgrade alla versione più recente della 4.5 (4.5.32)
Fare upgrade di tutte le estensioni alla versione più recente compatibile con la 4.5
Fare upgrade del core alla 6.1.7:
--> segui istruzioni upgrade sul wiki http://wiki.typo3.org/Upgrade#Upgrading_to_6.0
Come migrare da 4.5 a 6.1

23. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 23
Install Tool → System Enviroment (NUOVO):
verifica correttezza requisiti SW e memoria
IMPORTANTE: Memory limit >= 128Mb; PHP Max esecution time >= 300 sec
Altrimenti l'Upgrade Wizard può fallire!!!!
Come migrare da 4.5 a 6.1
Upgrade del core alla 6.1.7 [ 1 ]
System Environment check

24. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 24
Install Tool → Upgrade Wizard
-> Molte procedure riguardano il porting verso nuovo File Abstraction Layer (FAL)
Come migrare da 4.5 a 6.1
Upgrade del core alla 6.1.7 [ 2 ]
Upgrade Wizard – 1

25. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 25
Come migrare da 4.5 a 6.1
Upgrade del core alla 6.1.7 [ 3 ]
Upgrade Wizard – 2
Eseguire tutti i wizard
proposti.
Molte procedure
riguardano il porting verso
nuovo File Abstraction
Layer (FAL).

26. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 26
IMPORTANTE:
verificare con attenzione
tutte le proprietà del
TSconfig deprecate e
RIMOSSE e sostituirle con
le nuove.
Verificare sia
PageTSconfig
che UserTSconfig
Come migrare da 4.5 a 6.1
Upgrade del core alla 6.1.7 [ 4 ]
Upgrade Wizard – 3

27. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 27
1) Upgrade delle estensioni che ancora non sono compatibili 6.1.7
Esempio: Static_Info_Tables v. 6.0.9 compatibile 6.1.7 ma non 4.5
2) Sostituzione estensioni che non avevano una versione compatibile 6.1.7
Esempio: jpCarousel sostituito con ImageCycle
- Versione HTML prodotta?
Se non avete dichiarato il DocType il default è HTML5!!
## DocType Configuration
config.doctype = xhtml
- Modifiche introdotte nel nuovo css_styled_content ?
- Configurazioni necessarie per il FAL:
File Storage Records "fileadmin/ (auto-created)"
3) Altre verifiche e aggiustamenti:
Come migrare da 4.5 a 6.1
Ultimi ritocchi

28. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 28
Infine ...
FINALMENTE
TYPO3 6.1.7
Inside!!

29. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 29
Risorse utili
Link utili per approfondimenti
Progetto LTS Smooth Migration
→ http://forge.typo3.org/projects/typo3cms-smoothmigration
Dove scaricare l'estensione Smooth Migration
→ https://github.com/nxpthx/typo3-upgradereport
Indicazioni utili per la migrazione da DAM a FAL
→ http://forge.typo3.org/issues/30711
Suggerimenti per la migrazione di estensioni a TYPO3 6.x
→ http://wiki.typo3.org/TYPO3_6.0_Extension_Migration_Tips
Releas Notes per TYPO3 6.0 e 6.1.7
→ http://wiki.typo3.org/TYPO3_6.0
→ http://wiki.typo3.org/TYPO3_6.1.7
Guida all'upgrade per TYPO3 6.0
→ http://wiki.typo3.org/Upgrade#Upgrading_to_6.x

30. T3CAMP Italia
Milano
14 -15 marzo 2014
Rino Razzi || razzi@archicoop.it || http://www.archicoop.it/Pag. 30
Ringraziamenti
F I N E
GRAZIE PER L'ATTENZIONE !!!