When a new preview is out, they are available only as tgz-files with a simple compressed snapshot of “todays code”.
In order to upgrade an existing site with a preview there are these scenarios to think about BEFORE the 6 steps above is carried out:
If you are using symlinks on Unix, unzip the source, remove old symlink, create new symlink.
Otherwise follow these guidelines for correctly swapping the old source with the new:
Unzip the “preview” tgz-file with WinZip to some directory on your harddisc.
Compensate for the ignored symlinks in the tgz-file by:Copy t3lib/ ->typo3/t3lib/Copyt3lib/gfx/ ->typo3/gfx/Copytypo3/sysext/cms/tslib/ ->tslib/
Substitute the old source with the new by removing old dirs and copying new ones:Copytypo3/->[your_site]/typo3/Copyt3lib/->[your_site]/t3lib/Copytslib/->[your_site]/tslib/Copytslib/media->[your_site]/media/Copytslib/index_ts.php->[your_site]/index.phpCopytslib/showpic.php->[your_site]/showpic.php
It's very important to make sure all the old source-code is substituted correctly! We don't want bug-reports because and old t3lib/ was not removed and substituted with the new or something like that.
After making sure all the source files are in place, you basically need to follow the steps 1-6 as outlined in details above. Here I'll quickly list them:
(Make backup if you please)
(Install source - which you just did by the above steps....)
Update the database structure by clicking the COMPARE link for “Update required tables” in the Install Tools/“2: Database analyser”
Import the static tables by clicking IMPORT at “Dump static data” in the Install Tools/“2: Database analyser”.
Clear all cache!
Of course always check the changelog.txt file in the root of the source distribution. In particular pay attension to lines prepended with “!!!” - those may have important information for you!
Notice:
The same procedure takes place when you upgrade “new versions” of TYPO3 - not only previews. But with the new versions you may skip step 2 above (“Compensate for the ignored symlinks...”) because that is already done inside the .zip-destribution of the source.
Basically you have to follow guidelines on SourceForge to checkout TYPO3 from CVS. Also, Andreas Otto has written some documentation related to the TYPO3 project specifically. In any case there is a file, “CVSreadme.txt” in the source root.
You can only checkout the core from CVS. Writing back is reserved for only a few trusted persons.
If you want to help with extension development for TYPO3 there are less restricted rules. See the SourceForge project named “typo3xdev”.
In the folder “misc/” of the core you will find “superadmin.php” script. You can read inside how to use it. I will just mention it here because it is an indispensable tool when you want to upgrade many sites located in subfolders on the same level in the file system and which all shared the same source.
As the screenshot below shows you enter the “UPDATE” section of the tool. This will show you a list in the left frame of the sites that has been found on your server. Then you simply click all the links there from top-down and they will take you directly to the 4-5 mandatory steps involved in upgrading:
Clearing the extension cache files of typo3conf/
Upgrading database tables structure
Importing static table data (that might have been updated)
Clearing cache tables
Possibly, logging in in the backend.
The “superadmin.php” tool also features statistics that are nice for administrators including shortcuts to admin logins.
However it is a highly dangerous tool if you leave it unprotected on the server!!! Don't mess with the security of this baby! Protect it good, preferably insert an “exit;” statement in the top when not used and put a .htaccess password on its folder!
