upgrade to typo3 6 - jweiland.net •500.000+ web sites made with typo3 •less than 200 days left...
TRANSCRIPT
Facts
• 500.000+ Web Sites made with TYPO3
• less than 200 days left to update!
• ~ 2.500 Updates per work day!
Important
• Never ever on live site!
• Use a copy of live site for upgrade!
• Make sure you have a backup!
Your Choice:
• Clean-up installation, then make copy
• faster, but changes in live site
• Make copy, then clean-up installation
• safer, but slower
Clean-up first: smaller database and project to copy, but you make changes in live system !Copy-first: you are on the safe side, but copying takes longer
Creating a DB Copy
• Create new, empty database
• Collation: utf8_general_ci
• Duplicate the database: mysqldump --opt -u user1 -ppassword1 olddatabase | mysql -u user2 -ppassword2 newdatabase
in typo3conf: !../../tools/mysqldump --opt -u root -psecret muster-45 | ../../tools/mysql -u root -psecret muster-t3dd14 !if database host is NOT 127.0.0.1, you need to specify host with -h host
Finalize Copy
• Create new domain (virtual host) and update domain records accordingly
• localconf.php (or Install Tool): Enter new database parameters
• TypoScript: Adjust baseURL
Remove installed, unused Extensions
in our example we removed: lorem_ipsum, veguestbook, timtab, adminpanel, sbaccessiblecontent, lib, div
Clean Up Installation
!
• Run Database Analyzer in Install Tool
• Update Required Tables
• Remove unused tables
Shrink Database
• Decrease table size:
• cache_ …
• cachingframework_ …
• cf_ …
• sys_log, sys_stat, …
• tx_realurl_errorlog, …
SQL statement TRUNCATE will empty a table, DROP will delete a table
For other tables: use phpmyadmin !For very large tables: delete (drop) table and re-create via install tool (compare table structure)
Check PHP Version
• TYPO3 4.5, 4.6 work with PHP 5.2-5.5
• TYPO3 4.7 and higher require PHP 5.3-5.5
some old extensions my not be compatible with PHP 5.3+ !update realurl Extension
Check ExplicitAllow/Deny
Important: if setting in field explicitADmode is empty, you need to change it to explicitDeny !in TYPO3 6.2, default is explicitAllow
Reference Index
Make sure that all internal Database references are up-to-date !Using shell: make sure that path to php-cli version is correct !Make sure that user _cli_lowlevel exists
Smooth Migration
• Make sure that extensions extbase and fluid are installed
• Install extension smoothmigration
• Create BE user _cli_smoothmigration
• Reload Backend
smoothmigration extension can be used in TYPO3 4.5-4.7, after upgrading to 6.2 you can uninstall it
Overview
Run the checks first, then switch to „Report“. Note that the spinner during „Check“ will never stop, so just start the „Check“ process, wait a minute or so and then look up the „Report“
Database utf-8
In most cases you can’t change the MySQL server setting yourself, you need to make sure to use the forceCharset and setDBinit settings in the Install Tool correctly (see next slide)
Database utf-8
Important: if you change these settings, you may end up with unpredictable results in your database. It may be necessary to convert the database to UTF-8 format!
require_once
changed in cron_printlink (pi1, pi2) and sr_language_menu (pi1) !other occurrences will be fixed after updating extensions
Change Symlink
• Change to new TYPO3 version:typo3_src -> typo3_src-6.2.x
• Update index.php in DOC_ROOT
Updating index.php only necessary if not symlinked !
Go to Install Tool
if from BE „no input file specified“: use URL project/typo3/install instead !if connection to DB fails with IP 127.0.0.1, use localhost instead !Note: on jweiland.net Hosting Packages the DB server is at 127.0.0.3 !
Ext not in TER? Try GIT!
• git.typo3.org
• Repository from author, e.g.github.com/jweiland-net/rlmp_tmplselector
Extensions from git
• in typo3conf/ext:git clone https://github.com/jweiland-net/rlmp_tmplselector
sr_language_menu: Plugin neu konfigurieren, Static modules: static_info_tables und sr_language_menu neu einfügen !DefaultISOlanguage in TS setzen: plugin.tx_srlanguagemenu.settings.defaultLanguageISOCode = DE
TYPO3 4.x
local file
uploads/media uploads/pics
uploads/
fileadmin/….
direct upload RTE upload
upload through element browser
contentelement
typo3temp/…
BROWSER
rendered images
RTE linked files
TYPO3 6.x - FAL
local file
fileadmin/user_uploaddirect upload
upload through element browser RTE upload
fileadmin/_processed_
BROWSER
rendered images
fileadmin/….
TYPO3 4.x DAMlocal file
fileadmin/… uploads/media uploads/pics uploads/
tx_dam/….
upload in backend
index and meta-extraction
use in content
tx_dam_categories
local file
FTP Upload
TYPO3 4.x DAMlocal file
fileadmin/… uploads/media uploads/pics uploads/
tx_dam
upload in backend
index and meta-extraction
use in content
tx_dam_categories
local file
FTP Upload
add’l data
DAM to FAL Migrationtx_dam
tx_dam_categories
sys_file
sys_category
sys_file_metadata
ext:filemetadata
some information may be lost (e.g. copyright)
some fields may be lost (if they don’t exist in sys_file_metadata)
DAM to FAL Migration• Extension dam_falmigration
https://github.com/froemken/t3ext-dam_falmigration
• Migrates tx_dam records to sys_file
• Migrates tx_dam metadata to sys_filemetadata
• Migrates media-tags from RTE to link-tags
• Migrates dam_category to sys_category
DAM to FAL Migration
• typo3/cli_dispatch.phpsh extbase… [help] dammigration:migratedamrecords dammigration:migraterelations dammigration:migratedamcategories dammigration:migratedamcategoryrelations dammigration:migratedamselections dammigration:migratemediatagsinrte
execute this after upgrade has been made in install tool execute before editing content