History: Aktualisieren

• «
• »

            ^Die Übersetzung der Seite ist unvollständig.^

! Deine Tiki Site Aktualisieren
Die Aktualisierung von Tiki ähnelt sehr der ((installation|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 ((dev:Version+Lifecycle|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. 

{BOX(title=>"Übersicht: Wie eine Aktualisierung funktioiniert")}
{FANCYLIST()}Erstelle eine Datensicherung aller Dateien und der Datenbank aus Deiner aktuellen Installation. 
Installiere die neue Version, verzugsweise in einen neuen Ordner. 
Kopiere alle benutzerdefinierten Dateien ~np~(css, hochgeladenen Dateien und Bilder, benutzerdefinierte Vorlagen) ~/np~aus Deiner Datensicherung. 
Starte den Installer ~np~(tiki-install.php) ~/np~der die Datenbank aktualisert{FANCYLIST}{BOX}

__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).

{maketoc title="Detaillierte Instruktionen"}

!!# Stelle die aktuelle Tikiversion fest
Du kannst Sie überprüfen indem Du -+tiki-admin.php?page=general+- aufrufst

{MOUSEOVER(label=Wenn Deine Tikiversion kleiner als 1.9.0 ist)}Tiki 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.{MOUSEOVER}: Du musst zuerst auf 1.8 aktualiseren: ((Upgrade 1.7 to 1.8|Aktualisierung von 1.7 auf 1.8)) und dann, ((Upgrade 1.8.x to 1.9.y|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.

^__Deaktiviere benutzerdefinierte Themes:__ benutzerdefinierte Themes und .tpl-Dateien von älteren Versionen werden wahrscheinlich nicht mehr funktionieren und können die Aktualisierung verhindern. Deaktiviere benutzerdefinierte Themes vor der neuen Installation durch Umbenennung der aktiven CSS-Datei, so dass sie nicht mehr von Tiki gefunden wird. Tiki greift dann auf das Standard-Theme zurück.^ 

!!# 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.

*((info: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").

!!# 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 ((Security Admin|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.

!!# Erstelle eine Datensicherung

Die Datensicherung muss umfassen:
# Dein gesamter Ordner in dem Tiki installiert ist (mit allen Unterordnern)
# Deine MySQL Datenbank
Siehe ((Backup)) für weitere Details
!!# 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). 

^__Hinweis für alle Tiki Versionen nach 5.1 (5.3, 6.0, ...)__:
Du solltest KEINESFALLS Deine alte local.php in die neue Site kopieren und/oder bearbeiten. Das Tiki-Installationsskript (tiki-install.php) erstellt diese local.php-Datei, sobald sie später benätigt wird. Hierduch wird das frühere Kodierungsproblem richtig behoben. ^

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 ((dev:How to get commit access|wie Du Commit-Zugriff erhälst)). (:biggrin:)

__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):
+ {img fileId="297" thumb="y" alt="" rel="box[g]"} 

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 -> ((dev:Get Code))
!!# Check permissions
{INCLUDE(page="File and folder permissions")}{INCLUDE}

After correcting any directory or file permission problems, visit __tiki-install.php__ to continue.


!!# 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. 

^__Note__:
For upgrades to versions equal or later than 5.1 (5.3, 6.0, ...), you are encouraged to re-set the connection settings, while keeping the "Force utf-8 connection" option checked, and follow the on-screen instructions.^

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. 

^__Note:__ 
However, for upgrades to versions equal or newer than 5.1 (5.3, 6.0, ...), you are encouraged to re-set the connection settings, while keeping the "Force utf-8 connection" option checked, and follow the on-screen instructions.^

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

!!! Fix the encoding issue
{REMARKSBOX(type="note",title="Upgrade from previous to 5.1 to 5.1 or newer",highlight="n",close="n",width="100%")}
!!!! Either (A) or (B): fix the encoding issue (5.0 or before -> 5.1 or later)

Previously to Tiki 5.1, some users might have had a double encoding issue in the database of their Tiki. To ensure that this potential problem is fixed for all, if you are upgrading from a Tiki version equal or earlier than 5.0, into some newer Tiki version (5.1, ...5.x; 6.0, 6.x...), you are encouraged to follow once the three steps to fix the issue by means of the __tiki-install.php__ script.

!!!!# Force connection to utf-8 in db/local.php
Briefly explained above. For the sake of clearness, covered here in detail.

* Go to tiki-install.php, and follow steps until step 4: "__Set the Database Connection__". 
* Even if you have a local.php file already there, click on "__Modify database connection__" instead of "Use Existing Connection". This will open a form in the lower part of the window for you
+ {img src="dl343&display" thumb="y" alt="" rel="box[g]" width=400 desc="Click to enlarge" styleimage="border" imalign="center"} 
** At the bottom, there will be a section called "Character set", with a checkbox called "__Always force connection to use UTF-8__", that needs to be kept as checked. 
++ {img src="dl344&display" thumb="y" alt="" rel="box[g]" width=600 desc="Click to enlarge" styleimage="border" imalign="center" }
+ Fill in your db/local.php details through that form, and click on the "Continue" bottom at the bottom when ready.
* Continue to step 5 in the installation process, where you'll have the opportunity to "__Convert database and tables to UTF-8__" (see below).

!!!!# Convert database and tables to UTF-8
In step 5 of the installation process, you will be offered the option to "__Convert database and tables to UTF-8__", and you will be also shown the current encoding of your database. 

* Write down the name of the current encoding of your database, because you will need it in the next step below. 
+ {img src="dl345&display" thumb="y" alt="" rel="box[g]" width=400 desc="Click to enlarge" styleimage="border" imalign="center" }
* You can now click on the button "__Convert database and tables to UTF-8__".
* Once successfully performed, you will not see this option anymore, but just the usual question of whether you want to Re-install the database, or "__Automatically upgrade your existing database to__" your new Tiki version.  Choose this later option, since you are upgrading.
+ {img src="dl346&display" thumb="y" alt="" rel="box[g]" width=400 desc="Click to enlarge" styleimage="border" imalign="center" }

(Note: This step is converting you db collation to utf-8, and your db tables to use the utf-8 charset also.)

!!!!# Convert content from your previous encoding to utf-8
Finally, you need to convert the content from your existing database (content from wiki pages, etc., but also preferences, which include paths to file and image attachments, like in image galleries, etc.) to utf-8. 

* To do so, you have an option in the final step under the section "__Upgrading and running into encoding issues?__"
+ {img src="dl347&display" thumb="y" alt="" rel="box[g]" width=400 desc="Click to enlarge" styleimage="border" imalign="center" }
* In the dropdown called "__Previous table encoding__", choose the one which applies to your case (you wrote it down in the previous step), and click on the button: "__Dangerous: Fix double encoding__" 

Given the nature of this fix, it's best to do some quick ((Encode fix verification|verification)) of the changes.

Congratulations! You are done. 

You can now enter Tiki locking the installer (recommended) or without locking it, and continue using Tiki as normally.

If you have any issues, provide feedback through the usual ((tw:Support)) channels.
{REMARKSBOX}

!!!- Alternative: Upgrading your database through shell
''Upgrading your database manually through shell (faster than phpmyadmin)''

^__Note__:
If you upgrade from a version earlier to Tiki 5.1 to a version of Tiki5.1 or newer, you are encouraged to run at least once the __tiki-install.php__ script as explained above, so that you fix the encoding issue that may exist in your database previous to Tiki 5.1.^

Assuming you have the command line version of PHP (PHP-CLI), you can simply use the command line version of the installer.
{CODE()}
[www]$ php installer/shell.php
Running installer for: db/local.php
        Patches installed:
                20090811_quizzes_tiki
        Queries executed successfully: 3686
[www]$
{CODE}


For multi-tiki installations, the dev script can be used. PHP-CLI is still required.
{CODE()}
  sh doc/devtools/sqlupgrade.sh
{CODE}


If you are updating your database this way instead of tiki-install.php, you should clear your cache  (which tiki-install.php does)

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

!!#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))

!!#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 (:smile:) 
* 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:{CODE(wrap="1")}mysql -u user_dbuser -p user_dbname -B -e "update users_users set waiting=NULL where waiting is not NULL and valid is NULL;"{CODE}
!!! 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 ((tw:Irc)) or ((tw:forums))
*If you found a bug, please report it (and fix if you can!) at http://dev.tiki.org




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

!!!# 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.

!!!# 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__


!!# Upgrade your Theme
{VERSIONS(nav="y",title="General notes",default="newer")}
Revise the notes at
http://themes.tiki.org/Upgrading
---(4.x)---
Read the following guidelines:
http://themes.tiki.org/Stylesheet+changes+from+Tiki+3+to+4

And ifyou are upgrading from 2.x or ealier, read also the following page:
http://themes.tiki.org/Stylesheet+changes+from+Tiki+2+to+3

---(3.x)---
The layout system of the Themes' styles in Tiki 3 (table-less) has changed from previous versions of Tiki (table-based). So you'd better start playing with one of the bundled themes in your Tiki 3 installation, and fine tune your CSS to meet your needs (and/or past Theme style design), because you might not need to adapt your *.tpl files to it. 

And in case you need to adapt them, you might find it easier to update the new tpl files with the modifications you need, than to start from your old tpl files and attempt to apply all the changes in display that were introduced in Tiki 3.

For more information, please see: ((Upgrade 2.x to 3.x)) 
---(2.x and 1.9.x)---

If your site uses a custom theme, you will need to copy all the appropriate css files and the image folder from the /styles folder, the custom templates from the templates/styles folder, and upgrade your css to include any new classes. Between releases, ((CSS)) classes are often added to accommodate new features. You will find the list of the changes in the directory styles/transitions/ in the downloaded install package. These are named something like version_to_version.css. To update your css file, add the new classes and update the line at the top of your file that gives the version of your current Tiki's CSS. For instance
@version:1.9
{VERSIONS}

For a more detailed description, read ((Styles and Themes))

!! Further help?
If you need further instructions, ask in ((tw:IRC)) or in the [http://tiki.org/forum6|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 .

-=Related pages=-
{TITLESEARCH(search=>"Upgrade",noheader="1")/}

-=Alias=-
*(alias(Update))
*(alias(Update Tiki))
*(alias(Upgrade Tiki))


!!- Notes for advanced users 
!!! symlinks
When you are happy with the result delete the directory structure of the old site and move the directory of the new site in place. In fact on GNU/Linux or other Unix based servers you can usually use a symlink instead, making upgrade easy.
{CODE()}ln -s tikiwiki-3.0 tiki{CODE}

!!! MultiTiki
If you manage many tiki sites in the same tiki instance ( ((MultiTiki)) ) but having them in subdirectories, you can follow also the instructions at the ((Manual Installation)) page.

!!! Updating via SVN
If you have shell access and SVN: dev:((dev:Download))

!!! Tiki Remote Instance manager (TRIM)
If you manage many instances, you should consider ((TRIM)).

!!! Manual Upgrade
Please see: ((Manual Upgrade))

!!! Delete Unused Tables
When upgrading, some tables may no longer be used if the related feature has been discontinued. The upgrade script doesn't delete these extra in case users have data in them they want to keep. You can delete the tables manually if you have access to the database on the server. The following tables are no longer used as of ((Tiki5)):
* The 10 galaxia tables
* The 4 tiki_chart or tiki_charts tables
* tiki_drawings
* tiki_newspaper_marks
* tiki_newspaper_servers
* tiki_quicktags

-=Aliases=-
(alias(Upgrades))