Friday. Log Out! Shut down! Get out!

How to update Typo3 in easy steps

September 23, 2011by Daniel Ighișanin Activities, DevelopmentNo Comments

In this post we will begin a series of articles dealing with upgrading a typo3 installation.This first article will follow the basic steps for upgrading to the latest Typo 4.5.2

1.) Make e full dump of the file system and the database so you backup your data prior to the update.

MySQL Dump: – mysqldump -u username -p database_name > database_dump.sql or, if you want a zipped sql dump mysqldump -u username -p database_name | gzip > database_dump.sql.gz
Next comes the file dump, we need to be sure to backup everything in case some goes wrong. Usualy it doesn’t, but just to be safe. File Dump: tar -czf /folder/ archive_name.tar.gz /var/www/directory_to_compress/

2.) Change the source code

If you’re using the source-distribution in the .tgz file then you need to use symbolic links. Go in the root folder of your website and in the folder “site”. /typo3installation/site/

Delete the typo3_src folder:
sudo rm -r typo3_src
Then type in the following command (while still in the folder where typo3_src used to be) to create a symbolic link to the new source folder:
ln -s /sources_folder/typo3_src-4.5.2/ typo3_src

If you’re using the .zip distribution, then replace these files and folders in the site root: media/, t3lib/, tslib/, typo3/, index.php and showpic.php

3.) Log into the install tool

You must enter a password to access the install-tool. The password is set in localconf.php:
$TYPO3_CONF_VARS["BE"]["installToolPassword"] = “bacb98acf97e0b6112b1d1b650b84971″;

Use an md5 generator to obtain the password you want. Also for the install tool to work you need to create an ENABLE_INSTALL_TOOL file with no extension, in the typo3conf folder. In the install tool go the upgrade wizard and follow the steps there, and at the end don’t forget to compare the database and update it. click “COMPARE” at the “Update required tables” header:

4.) Update the extensions, but be careful at templavoila because you may need to remap the templates after updating it.

5.) Do some basic tests after you finish updating all the extensions:

  • create a test page with a text/image element, preview it in the browser, and see if everything is ok
  • check the search engine of the site
  • check the contact form
  • check all the links

That’s all there is to it. In the next post we will deal with the specific problems that may arise after an update.


Daniel Ighișan

What do you think?