Deine Tiki Site Aktualisieren

Die Aktualisierung von Tiki ähnelt sehr der Installation. Aktualisieren funktioniert nur in eine Richtung. Es gibt keine Möglichkeit wieder auf eine kleinere Version zurückzustufen, es sei denn durch Einspielung einer Datensicherung. Bevor Du eine größere Aktualisierung durchführst (z.B. von 5.x auf 6.x) solltest Du einen Test mit einer Datensicherung durchführen bevor Du mit der "echten" Aktualisierung beginnst.

Benötige ich eine Aktualisierung?
Es kommt darauf an. Einige Tiki-Versionen werden als Long Term Support, LTS geführt. Dies bedeutet, dass Entwickler nach wie vor Sicherheitspatches und Fehlerbehebungen für diese Version erstellen. Wenn Du nur auf Sicherheitsgründen aktualisierst, kannst Du bei Deine LTS Version bleiben. Hauptaktualisierung bringen neue Funktionen. Existierende Funktionen, Themes, Plugins und Module können aber ggf. nicht mehr so funktionieren wie vorher. Eine Testaktualisierung wird daher dringend empfohlen. Aktualisierung innerhalb eines Zweiges (mit der gleichen Versionsnummer) verursachen nur selten Probleme und werden aus Sicherheitsgründen empfohlen.

Muss ich wirklich alles herunterladen und dann das ganze Ding hochladen? - Für einige Aktualisierungen gibt es "Patchversionen", wenn nur ein paar Dateien verändert wurden.

Alternativen zu FTP: Anstelle alles Herunterzuladen und dann das gesamte Packet heraufzuladen kannst Du die Befehle svn oder wget benutzen, um die Dateien direkt von Sourceforge auf Deinen Server zu kopieren (frage Deinen Hoster).

1.1. Stelle die aktuelle Tikiversion fest

Du kannst Sie überprüfen indem Du tiki-admin.php?page=general aufrufst

Wenn Deine Tikiversion kleiner als 1.9.0 istTiki 1.9.0 wurde am 27.04.2005 veröffentlicht, so dass er sehr unwahrscheinlich ist, dass Du es immer noch benutzt. Ältere Aktualisierungsskripts wurden inzwischen entfernt, stehen aber immernoch zum Herunterladen zur Verfügung.: Du musst zuerst auf 1.8 aktualiseren: Aktualisierung von 1.7 auf 1.8 und dann, Aktualisierung von 1.8.x auf 1.9.y (aktualisiere nicht direkt von 1.7.x auf 1.9.x oder neuer)

Von 1.9.0 und aktueller zu jeder nachfolgenden Version (3.x, 4.x, etc) kannst Du direkt aktualisieren. Tiki 3.x/4.x/5.x/6.x enthalten alle Datenbankmigrationsskripte von 1.9.0 zu der jeweiligen Version. Du möchtest vielleicht das Installationsskript manuell für Deine Version starten und auf unerwartete Fehler prüfen.

1.2. Lege fest, auf welche Version Du aktualisieren willst

Bedenke, dass Tiki3 und Tiki6 Long Term Support (LTS)-Versionen sind und dass es immer am sichersten ist, die aktuelleste Version in dem jeweiligen Zweig zu wählen. Benutze z.B. 4.1 anstelle von 4.0 wenn du eine Produktivsite mit extensiver Nutzung vieler Funktionen.

• Download Tiki

Bei manchen Veröffentlichungen (z.B. so wie bei 6.3) hast Du die Option entweder nur die Dateien herunterzuladen, die verändert wurden (in einer komprimierten Datei, wie z.B. "tikiwiki-inc-6.2-to-6.3.tar.gz"), oder die Vollversion herunterzuladen (z.B. "tikiwiki-6.3.tar.gz").

1.3. Neuinstallation oder auf bestehende Installation aktualisieren?

Neuinstallation (empfohlen)

Du musst manuell alle Daten, die nicht in der Datenbank gespeichert sind verschieben und/oder neu integrieeren. Z.B. Bilder und Anhänge, die als Dateien gespeichert sind. Dies ist die empfohlende Vorgehensweise, insbesondere wenn Du benutzerdefinierte Themes oder ein von der neuen Tikiversion nicht unterstütztes Theme verwendest.

Installation auf eine bestehende Installation (NICHT empfohlen für Hauptaktualisierungen)

Hierdurch werden keine Dateien aus früheren Versionen gelöscht, die jetzt nicht mehr benötigt werden. Diese Dateien sollten nichts mehr tun - abgesehen davon ein wenig Festplattenplatz zu belegen und abgesehen von Vorlagendateien (.tpl Dateien im Ordner ./templates oder Unterordner). Du kannst in der Sicherheitsverwaltung übrig gebliebene PHP Dateien überprüfen.

Dies ist nicht empfohlen, da alle Dateien von früheren Tikiversionen, einschließlich alter tpl-Dateien, aufgehoben werden, die mit neueren Versionen, speziell bei Themes Konflikte verursachen können, wenn die Themes geändert wurden oder in der neuene Tikiversion nicht mehr unterstützt werden. Die beste Option diese Konflikte zu vermeiden, ist die vollständige Neuinstallation von Tiki in ein neues Verzeichnis wobei das alte Verzeichnis dann gegen das neue ersetzt wird und die benötigten Benutzerdateien wieder eingefügt werden (img/wiki_up, veränderte tpl Dateien wenn sichergestellt ist, dass sie an die neue Tikiversion angepasst sind, etc). Siehe unten "Neuinstallation".

Handelt es sich nur um eine untergeordnete Aktualisierung (z.B. 5.1 zu 5.2), ist es unwahrscheinlich, dass es zu Problemen kommen wird, da die Vorlagen nur geringfügig zur Fehlerbehebung geändert werden.

1.4. Erstelle eine Datensicherung

Die Datensicherung muss umfassen:

1. Dein gesamter Ordner in dem Tiki installiert ist (mit allen Unterordnern)
2. Deine MySQL Datenbank

Siehe Backup für weitere Details

1.5. Aktualisere Deine Dateien

Tikidateien werden in komprimierten Archiven veröffentlcht (z.B. .zip). Diese müssen entpackt (unzip) und dann auf Deinen Webserver hochgeladen werden.

Neuinstallation

Anstelle alle neue Dateien über die alten darüber zu kopieren kannst Du eine komplett neue Installation durchführen. Aktualisierst Du auf eine frühere Version von Tiki als 5.1 kannst Du die Datenbankinformationen Deiner früheren Tikiinstallation angeben (Informationen enthält die Datei db/local.php).

Dinge, die Du von Deiner alten Site in Deine neue Site kopieren musst:

• den Inhalt des Ordners img/wiki_up (hochgeladene Wiki Bilder)
• alle individuell angepassten *.tpl Dateien
• alle individuell angepassten Styles ( *.css )
• jedes Dateiarchivverzeichnis, wenn das Dateisystem zum Speichern genutzt wird
• jedes Bildergalerieverzeichnis, wenn das Dateisystem zum Speichern genutzt wird
• jeden individuell angepassten Code
  • Wenn Du Änderungen vornimmst, die auch für andere hilfreich sein könnten, denke bitte daran, der Tiki Gemeinschaft beizutreten und Deine Erweiterungen mit allen zu teilen. Abgesehen davon, dass Du damit allen hilfst, musst Du nicht bei jeder Aktualisierung Deine Änderungen neu einsetzen und warten. Siehe hierzu wie Du Commit-Zugriff erhälst. 😀

Datenbankkollation

Wenn Du auf einem neuen Server aktualisierst und deswegen eine neue Datenbank erstellst, stelle sicher, dass Du Deine Datenbank mit dem utf8 Zeichensatz kodierst.

• Hinweis: Standardmäßig benutzt Tiki UTF-8 für Deine Datenbankkodierung. Wir empfehlen dringend, immer "utf8" in der Auswahlliste "Kollation" bei phpMyAdmin (oder ähnlichem) zu wählen (siehe folgendes Bild):
  

Während der Aktualisierung mit tiki-install.php auf Tiki 5.1 (oder neuer), wird Tiki versuchen, das für Dich zu übernehmen. In manchen, seltenen Fällen kann Tiki die Kollation aber nicht eintragen, weswegen Du dies manuell tun musst. Ist die Datenbank bereits mit "latin1" kodiert und möchtest Du dies hinterher ändern, kannst Du die Kollation mit mit phpMyAdmin unter "Operationen" tun, sobald Du Deine Datenbank ausgewählt hast.

Install over existing

To upgrade, copy or upload all the files of the newer version onto the files of the older version so any older ones are replaced (FTP with "overwrite if source is newer").

Before overwriting the files, remove the non-customized style-specific templates (templates/styles/*, and templates/yoursite/* if any). Previous versions often contained per-style modifications. Those files have since been removed from standard distribution, leaving the old files intact and not taking advantage of enhancements.

Updating via SVN

If you install using SVN, you can easily update via SVN -> Get Code

1.6. Check permissions

1.6.1. File and Folder permissions

If your server is unhappy with Tiki file and folder permissions (this is dependent on server configuration), you may get an error message or blank pages. These failed attempts are typically in the error log (ask your web host to know where they are as it's different depending of your setup)

Too few permissions
If a message appears indicating that specific directories are not writable, you will need to change the permissions on the indicated directories. Tiki will attempt to verify that it can read (and write) to all necessary directories. This error message will include instructions about how to resolve the issue.

Too many permissions
If you are getting Internal Server Error 500, blank pages or similar, it could be that the permissions on the files are not appropriate for your webhost.

If your permissions are currently at "777", use your FTP client to change the files to "755". If Tiki is installed in a directory, make sure to also change the permission of the folder which contains the tiki files.

If you have shell access, you can run:

sh setup.sh

and answer any questions. If you don't know what to answer, just click "enter" to keep the defaults.

root@yourserver:/var/www/tiki# sh setup.sh

 Tiki setup.sh - your options
 ============================

Composer: If you are installing via a released Tiki package (zip, tar.gz, tar.bz2, 7z), you can and should skip using Composer. If you are installing and upgrading via SVN, you need to run Composer after 'svn checkout' and 'svn upgrade'. More info at https://dev.tiki.org/Composer
  
 c run composer and exit (recommended to be done first)

For all Tiki instances (via SVN or via a released package):

 f fix file & directory permissions (classic default)          o open file and directory permissions (classic option)
 S clear screen

 predefined Tiki Permission Check models:
 ----------------------------------------

 1 paranoia
 2 paranoia-suphp                        w suphp workaround
 3 sbox                                  W sbox workaround
 4 mixed
 5 worry                                 6 moreworry
 7 pain                                  8 morepain
 9 risky                                 a insane

 q quit                                  x exit

There are some other commands recommended for advanced users only.
More documentation about this: https://doc.tiki.org/Permission+Check

Your choice [f]?

The option preselected in "Our choice" will initially be "c", to run "composer" script and get the required php dependencies for you. and in a second step, it will suggest "f", to fix file and directory permissions (classic default option). You can choose at any time the letter that best suits your needs, among the options offered.

If "sh setup.sh" doesn't work for you, you may try, in your ./tiki/ directory

chmod -R 777 ./db ./dump ./img/wiki ./img/wiki_up ./img/trackers ./modules/cache ./temp ./temp/cache ./temp/templates_c ./templates ./styles ./whelp/

Another way is to set permissions for all directories and then set permissions for all files. For example, to set the permissions for all directories to 777 and the permissions for all files to 644, use the following separate commands through shell access:

find [YOURDIR] -type d -exec chmod 777 {} \;

find [YOURDIR] -type f -exec chmod 644 {} \;

After correcting any directory or file permission problems, visit tiki-install.php to continue.

1.6.2. SuPHP Problems

Systems with SuPHP need permissions 755 at maximum. Group must not be allowed to write. This includes the complete path in the filesystem, not only document root of the webserver. Wrong permissions may lead to 500 Internal Server Error here. On the other hand less permissions (namely 750 without x/execute/subdir entry for webserver) may lead to 403 Forbidden Error.

1.6.3. Permission Matrix

Several usecases and minimum to maximum permissions you may try if something doesn't work properly. Permissions refer to data directly accessed by the webserver (files included by Tiki itself may and should have less permissions):

1.6.3.1. Option

find . -type d -exec chmod 755 {} \; ; chmod 755 . ; find . -type f -exec chmod 755 {} \; ; chmod 751 db/local.php

1.6.3.2. Option

The following commands might be useful. In particular, it might help you use an IDE (PhpStorm), etc:

$ export PathToTiki="/var/www/tiki"
$ export WebServerOwner="www-data"
$ sudo usermod -aG ${WebServerOwner} $(whoami)
$ sudo chown -R ${WebServerOwner}: ${PathToTiki}
$ sudo chmod -R g+rw ${PathToTiki}

In English, the above code adds you to the web-server group; forces the tiki tree to be owned by the web-server user and group; and then makes sure the tiki tree is readable and writable by the web-server group (you). Suggestions welcome!

After correcting any directory or file permission problems, visit tiki-install.php to continue.

1.7. tiki-install.php to update your database

(A) Fresh install

On the tiki-install.php page of this new site, connect to the same database as your old site (you can find this info in the file db/local.php of your old site) and follow the instructions to upgrade your site. Make sure to click upgrade and not install, else you wipe out your database.

For upgrades to earlier branches and versions (like any of the Tiki3 LTS branch), you can alternatively just copy db/local.php from your old site to your new site, to avoid entering the information, if you wish.

(B) Install over existing

Then, go to tiki-install.php and click the "upgrade" button, which will update the database. Tiki can read your previous db/local.php file and use this information.

If the installer was previously locked (which it should be), you will need to unlock it by deleting db/lock

Fix the encoding issue

Alternative: Upgrading your database through shell

[www]$ php installer/shell.php
Running installer for: db/local.php
        Patches installed:
                20090811_quizzes_tiki
        Queries executed successfully: 3686
[www]$

sh doc/devtools/sqlupgrade.sh

1.8. Post tiki-install.php

At the end, proceed as usual to the Tiki site while disabling the tiki-install.php script.

1.9. Update the .htaccess file

Tiki ships with a _htaccess file. It needs to be renamed to .htaccess and replace the one from the previous version. If you made any customizations, you should redo them in the new file. See: Clean URLs

1.10. Test

What to expect as problems

• Changes of behavior
  • A feature was activated but no longer is (ex. default behavior has changed). You need to go to the admin panel and activate it.
• Bugs
  • Each Tiki version brings loads of new features. However, sometimes, enhancements can bring new bugs as well 😊
• If you customized your themes, they may come out weird
  • You should plan a bit of time to re-integrate your customizations in the new theme.
• If you've upgraded your MySQL server from 4 to 5, when you login for the first time, you may get an "Account disabled" error. To repair this:
  Copy to clipboard

  mysql -u user_dbuser -p user_dbname -B -e "update users_users set waiting=NULL where waiting is not NULL and valid is NULL;"

Where to look

• Look in the release notes of your version for any specific things to look for, and to the documentation pages of each new release (i.e. Tiki2, Tiki3, Tiki4, Tiki5, Tiki6 ...)

What to do

• If you need help, visit Tiki chat room Irc or forums
• If you found a bug, please report it (and fix if you can!) at http://dev.tiki.org

1.10.1. Check your content

Check if your new web site contains everything from the old website.

1.10.2. Check that the features you used to use are still turned on.

More specifically, structures, search, individual plugins, and some other features may have to be activated in the admin panel.

1.10.3. Revise potentially unsafe plugin calls and approve or reject them

Usage of potentially unsafe wiki plugins has to be validated by users with the new permissions related to approve plugins. This way, any usre can make any attempt to use potentially any plugin, including iframe, dbreport, tag, sql, snarf, regex... which would need to be validated by some trusted users/editors/admins later on in order to approve or reject them.

A list of plugin calls pending revision can be found at any time here: tiki-plugins.php

1.11. Upgrade your Theme

For a more detailed description, read Styles and Themes

Further help?

If you need further instructions, ask in IRC or in the forums, and please, come back here and upgrade the documentation with what you learned. This is a way for you to help and make it easier for new users .

• Upgrade trunk
• Upgrade from unmaintained versions
• Upgrade 3.x to 3.latest
• Upgrade 2.x to 3.x
• Upgrade 1.9.x to 2.x
• Upgrade 1.9.x to 1.9.y
• Upgrade 1.8.x to 1.9.y
• Upgrade 1.7 to 1.8
• Upgrade
• Manual upgrade
• Archives Upgrade

• Update
• Update Tiki
• Upgrade Tiki

Notes for advanced users

ln -s tikiwiki-3.0 tiki