Upgrade
From TYPO3Wiki
<< Back to Getting started page
This is a step by step guide on how to upgrade from an older installation of TYPO3 to TYPO3 4.1.
See list of all ReleaseNotes.
Upgrading from 3.8.1 to 4.1 on a Windows system
Do the following, in the correct order!
1.) Remove the folders typo3/, media/, tslib/, t3lib/ and the files
showpic.php and index.php (alternatively to deleting, you can move
them to a backup location, but they must be completely out of the
way)
2.) Copy the new 4.1 source into the site location
3.) Go to the Install Tool->Database Analyser->Update required tables->COMPARE and IMPORT
Remember to clear your PHP accelerator cache after upgrading if you have any.
Please also read the TYPO3_4.0 Release notes.
Upgrading from 3.8.1 to 4.1 on a UNIX system
(one person's upgrade story)
Back up first! If things go wrong at least you can go back to the old version.
Environment:
- Installed on Unix system (i.e. Linux, FreeBSD) - Existing TYPO3 is setup with symlinks to make upgrading easier as described here - Using the source distribution effectively http://typo3.org/documentation/document-library/installation/doc_inst_upgr/current/view/3/3/
- Existing TYPO3 is setup in webroot folder
Current Environment:
$ pwd /home/typo3/ $ cd public_html/ $ ls -la drwxr-xr-x 7 typo3 typo3 512 Feb 7 05:02 . drwxr-xr-x 4 typo3 typo3 512 Apr 8 20:01 .. -rw-rw---- 1 typo3 www 4987 Nov 12 11:41 INSTALL.txt -rw-rw---- 1 typo3 www 608 Nov 12 11:41 Package.txt -rw-rw---- 1 typo3 www 8118 Nov 12 11:41 README.txt -rw-rw---- 1 typo3 www 1212 Nov 12 11:41 RELEASE_NOTES.txt -rw-rw---- 1 typo3 www 4957 Nov 12 11:40 _.htaccess -rw-rw---- 1 typo3 www 46 Nov 12 11:40 clear.gif drwxrwx--- 5 typo3 www 512 Feb 11 07:49 fileadmin lrwxr-xr-x 1 typo3 typo3 18 Nov 12 11:40 index.php -> tslib/index_ts.php lrwxr-xr-x 1 typo3 typo3 11 Nov 12 11:40 media -> tslib/media lrwxr-xr-x 1 typo3 typo3 17 Nov 12 11:40 showpic.php -> tslib/showpic.php lrwxr-xr-x 1 typo3 typo3 15 Nov 12 11:40 t3lib -> typo3_src/t3lib lrwxr-xr-x 1 typo3 typo3 15 Nov 12 11:40 tslib -> typo3_src/tslib lrwxr-xr-x 1 typo3 typo3 15 Nov 12 11:40 typo3 -> typo3_src/typo3 lrwxr-xr-x 1 typo3 typo3 18 Feb 7 05:02 typo3_src -> ./typo3_src-3.8.1/ drwxrwx--- 5 typo3 www 512 Nov 12 11:41 typo3_src-3.8.1 drwxrwx--- 3 typo3 www 512 Apr 3 07:26 typo3conf drwxrwx--- 6 typo3 www 512 Mar 10 07:56 typo3temp drwxrwx--- 9 typo3 www 512 Feb 11 08:22 uploads
Upgrade
1.) Get the new 4.1 source typo3_src-4.1.tar.gz into the site location and decompress
$ cp typo3_src-4.1.tar.gz public_html/ $ tar xvzf typo3_src-4.1.tar.gz
2.) Remove old source symbolic links and create new symlink to typo3_src
$ cd public_html $ rm typo3_src $ ln -s typo3_src-4.1 typo3_src
2.1 Using a Separate Source Directory
If you choose to keep your source in a separate directory, the symbolic link would be made with
$ ln -s ../typo3_src-4.1 typo3_src
This has the advantage of being able to host several typo3 installations using the same common source, thus saving space
3.) Cleaning up unused symbolic links
$ pwd /home/typo3/public_html $ rm media $ rm tslib $ rm showpic.php $ rm index.php
3.) Create new symlink:
$ pwd /home/typo3/public_html $ ln -s typo3_src/index.php index.php $ ln -s typo3_src/typo3 typo3 $ ln -s typo3_src/t3lib t3lib
Upgraded Environment:
$ ls -la drwxr-xr-x 8 typo3 www 512 Apr 9 22:39 . drwxr-xr-x 4 typo3 typo3 512 Apr 8 22:41 .. -rw-rw---- 1 typo3 www 4987 Nov 12 11:41 INSTALL.txt -rw-rw---- 1 typo3 www 608 Nov 12 11:41 Package.txt -rw-rw---- 1 typo3 www 8118 Nov 12 11:41 README.txt -rw-rw---- 1 typo3 www 1212 Nov 12 11:41 RELEASE_NOTES.txt -rw-rw---- 1 typo3 www 4957 Nov 12 11:40 _.htaccess -rw-rw---- 1 typo3 www 46 Nov 12 11:40 clear.gif drwxrwx--- 5 typo3 www 512 Feb 14 06:34 fileadmin lrwxr-xr-x 1 typo3 www 19 Apr 8 22:55 index.php -> typo3_src/index.php lrwxr-xr-x 1 typo3 www 15 Nov 12 11:40 t3lib -> typo3_src/t3lib lrwxr-xr-x 1 typo3 www 15 Apr 9 22:38 typo3 -> typo3_src/typo3 lrwxr-xr-x 1 typo3 www 13 Apr 9 22:38 typo3_src -> typo3_src-4.1 drwxrwx--- 4 typo3 www 512 Apr 8 22:40 typo3_src-3.8.1 drwxr-xr-x 5 typo3 www 512 Apr 7 00:18 typo3_src-4.1 drwxrwx--- 3 typo3 www 512 Apr 9 22:50 typo3conf drwxrwx--- 6 typo3 www 512 Feb 14 06:37 typo3temp drwxrwx--- 7 typo3 www 512 Feb 12 00:39 uploads
4.) Go to the Install Tool->Database Analyser->Update required tables->COMPARE and IMPORT
5.) set the $TYPO3_CONF_VARS['SYS']['encryptionKey']
6.) Go to the Install Tool->Update Wizard and set to 4.1
really important to correct the errors you might see in the BE in the 'Ext Manager' menu.
Trouble with click-enlarge Images
From 3.8.1 to 4.0 the showpic.php is replaced by /typo3/sysext/cms/tslib/showpic.php.
If you use RealURL and set config.baseurl = http://www.yourdomain.org
You will get an error when you open the popup "www.yourdomain.orgindex.php is not found".
Add a slash should help config.baseurl = http://www.yourdomain.org/
More Instructions for Upgrading from 3.8.x to 4.1.x on a Unix system or a PC
The Web-Empowered Church offers a tutorial titled "Upgrading from TYPO3 3.x to 4.x." It includes both text instructions and detailed step-by-step Flash movies created with Wink.
More Instructions for Upgrading
You can also look in the Typo3 Basic Upgrade Manual for more detailed upgrade instructions. //Peter.
Silly Cache Issues
During upgrade from 4.0.4 to 4.1.1, ajax pagetree got there but was rendered somewhat weird; Shift-Reload (to dump browser cache) sufficed to supposedly get a fresher CSS and settle everything down beautifully.
Upgrade 3.8.1 to 4.0.4 without using a shell
This describes how to migrate from TYPO3 3.8.1 to 4.0.4 without using a shell - only by using ftp.
Situation:
TYPO3 is installed in /typo3 without any symlinks
Read:
- Basic Upgrade Manual (http://www.infolagret.se/index.php?id=598)
- Upgrade... from TYPO3Wiki (http://wiki.typo3.org/index.php/Upgrade)
- TYPO 3.8.1 ... from TYPO3Wiki (http://wiki.typo3.org/index.php/TYPO3_3.8.1)
Download:
- Download typo3_src-4.0.4 from www.typo3.org
Lock:
- Think about user, who might do any changes during your upgrading and/or fallback
Backup:
- Download /typo3
- Export Database
Extensions:
- Change all global installed extensions to local ones
- Start Extension Manager
- Deinstall extension
- Delete extension
- Load extension from TER (LOCAL now)
- Install it
Cleanup:
- Remove following directories / files all located in /typo3:
- media
- tslib
- showpic.php
- index.php
- typo3
- t3lib
- changelog
- and all *.txt files, if you like
Copy typo3_src_4.0.4:
- Copy whole src to /typo3
Follow instruction on http://webempoweredchurch.com/support/tutorials/upgradingfromtypo33xto4x/
- Step 3 to 6 only
- Comments to Step 3: maybe the Install-Tool has to be started manually via <yourdomain>/typo3/typo3/install/index.php
- Comments to Step 4: Clear cache on the end with two links (see section "Admin functions")
Cleanup:
- Take the possibility to remove all unused extensions now
Upgrade 4.0.4 to 4.1.1 without using a shell
This describes how to migrate from TYPO3 4.0.4 to 4.1.1 without using a shell - only by using ftp.
Situation:
TYPO3 is installed in /typo3 without any symlinks
Download:
- Download typo3_src-4.1.1 from www.typo3.org
Lock:
- Think about user, who might do any changes during your upgrading and/or fallback
Backup:
- Download /typo3
- Export Database
Extensions:
- Change all global installed extensions to local ones
- Start Extension Manager
- Deinstall extension
- Delete extension
- Load extension from TER (LOCAL now)
- Install it
Copy typo3_src_4.1.1:
- Copy whole src to /typo3
Make things runnin' ... and runnin' fast:
- Log into Backend
- Run Install-Module
- Check all
- Set version with Upgrade Wizard to 4.1
- Set the $TYPO3_CONF_VARS['SYS']['encryptionKey'] (Basic Configuration > Encryption Key)
- Delete or rename /typo3/typo3conf/ENABLE_INSTALL_TOOL
- Run DB-Check-Module
- Rename _.htaccess: See list on http://typo3.org/development/articles/release-notes-41/page/4/
Cleanup:
- Take the possibility to remove all unused extensions now
Security-Patch for older versions than 4.0.9, 4.1.7, 4.2.1
If you use * See link: direct_mail_subscription, feuser_admin, kb_md5fepw you have to upgrade to fix the second minor security-issue.
If you can't upgrade yet this is the solution:
The new versions contain an updated default value for fileDenyPattern. If this default value is not used, there will be a warning displayed in backend module "About modules". This should remind the administrator to change the value of fileDenyPattern.
If you can't update directly, change the value of the configuration variable fileDenyPattern to the following value:
\.php[3456]?(\..*)?$|^\.htaccess$
This can be achieved by either changing the value of fileDenyPattern in the section "All configuration" within the TYPO3 install tool or by adding the line
<PHP> :$GLOBALS['TYPO3_CONF_VARS']['BE']['fileDenyPattern']='\.php[3456]?(\..*)?$|^\.htaccess$';
to the end of the TYPO3 configuration file typo3conf/localconf.php.
Upgrade to 4.2
Situation: You want to upgrade from Version 4.1 to 4.2
Be aware that you need PHP 5.1!
Download the TYPO3-Source from here
Now you have to extract the new source-files in the folder where the old installation is.
Finally, you have to start the install-tool and compare the databases.
Extensions that are not yet compatible
The following Extensions are not (yet) compatible with TYPO3 4.2
- dam Version 1.0.11 is not compatible with TYPO3 4.2, Upgrade first to dam 1.0.13 Media (DAM) (dam) (contact: tuurlijk)
- it is possible, that pmkisac Version 1.2.0 is not compatible with TYPO3 4.2 pmkisac (pmkisac) (contact: pmk65) - but the author had not noticed about that. If it really does not work, please send him a message.
- dam_catedit Version 1.0.6 is not compatible with TYPO3 4.2 Media>Categories (dam_catedit) (contact: tuurlijk) Popup menu is not working in BE
- pagetreetools Version 1.0.3 is not compatible with TYPO3 4.2 pagetreetools (pagetreetools) (contact: typoheads) produces error output in the pagetree area
- kickstarter Version 0.3.8 is not compatible with TYPO3 4.2 Extension Kickstarter (kickstarter) (contact: flyguide) produces error when editing existing extension.
