%%(noinclude)
Also available in ((/Doc/Deutsch/Upgrade Deutsch)), ((/Doc/Français/MiseAJour Français)), ((/Doc/Español/Actualizar Español)), ((/Doc/Русский/Обновление Русский)), ((/Doc/简体中文/升级 简体中文))
%%
Upgrade your WackoWiki from **!!(green)6.0.x!!** to **!!(green)6.1.x!!**.
{{toc numerate=1}}
See also the migration guides for WackoWiki versions ((/Dev/Release/R5.5/Upgrade 5.5.x)) and ((/Dev/Release/R6.0/Upgrade 6.0.x)).
file:/logo_php8.svg?right&100
===Preparations===
1. Check ((/Dev/Release/R6.1/ReleaseNotes Release Notes)) for requirements.
1. **Back up your data:**
1. your **wiki database** (e.g. via phpMyAdmin or the backup module in the ((/Doc/English/AdminPanel Admin Panel))),
2. your **wiki folder**.
%%(info type="important")
**IMPORTANT**
Backup your data! Before doing anything, backup your existing database and files. Also ensure that during migration nobody uses the database, because it may cause loss of data.
2. It is imperative that you make a backup of your WackoWiki database before you upgrade.
3. The upgrade procedure transfers your installation instance data from the old version to the new version. Migration from the new version back to the old version is not supported.
%%
===Upgrade===
Requires at least WackoWiki **!!(green)6.0.22!!**, if you use a earlier version ((/Dev/Release/R6.0/Upgrade upgrade to this version first or later)), before you upgrade to WackoWiki **!!(green)6.1!!**.
====Download====
1. ((/Download Download wacko.6.1.x.zip))
2. Extract the archive
3. Delete **all** wacko folders and files from your current installation, **except**
* ##config/config.php##
* ##file/##
4. Copy the new wacko.6.1 files in your WackoWiki installation folder
5. Delete the cache file under ##cache/config/config.php##.
6. Check ((/Doc/English/FilePermissions file permissions))
If you have created custom themes, actions, handlers or formatters in the old version of WackoWiki, then you need to restore them from the backup you made at the beginning. Check their compatibility and fix them if necessary.
====MySQL 8====
Do not forget to remove the ##NO_AUTO_CREATE_USER## in your constants.php, if you use MySQL 8 or higher, e.g.
%%
const SQL_MODE_PERMISSIVE = 'NO_ENGINE_SUBSTITUTION';
%%
Otherwise it will throw a Fatal error:
%%
Uncaught mysqli_sql_exception: Variable 'sql_mode' can't be set to the value of 'NO_AUTO_CREATE_USER' in /setup/install-database.php:180
%%
This does not apply to MariaDB.
====Installer====
file:/wackowiki_r6_en_upgrade_1.png?right&400&caption
Call the URI of your Wiki in your browser. The installer starts and tells you (IMPORTANT) that you are **upgrading** from **!!(green)6.0.x!!** to **!!(green)6.1.x!!**
* go through all steps
* ((/Doc/English/Upgrade/Screenshots Screenshots from Upgrade procedure))
===Post-Upgrade===
====Configuration====
If you've had set custom values in ##constant.php##, ##router.conf##, ##csp_custom.conf## or elsewhere, you must set or merge these values again.
====Re-Synchronize data====
After a successful upgrade you can perform a re-rendering for all intrasite links to rebuild the records of the ##page_link## and ##file_link## table.
* Admin Panel -> Synchronizing data -> Wiki-links
file:/ap_rerender_links_en.png?right&400&caption
You can tune the re-rendering settings to avoid timeouts or reaching the memory limit. This is mostly interesting for shared hosting or servers you do not manage. The server terminates then the script without further notice.
If the re-rendering fails just reduce the number of pages it renders per turn, the redirect LIMIT is set to ##10##. If you reach the redirect limit the script will provide you with a link **Next »**, which you have to click to render the next batches of pages. Furthermore avoid possible session timeouts while the script is running.
====Changes====
1. Writes now the ##sitemap.xml## into the ##xml/## folder, please check and update your **robots.txt**, e.g.
* %%Sitemap: https://wiki.example.com/xml/sitemap.xml.gz%%
1. Requires now the ((https://unicode-org.github.io/icu/userguide/format_parse/datetime/#date-field-symbol-table ICU Dates and Times Format)) used by IntlDateFormatter, please update your custom settings in the Admin panel.
* #|
*| config | DateTime::format | IntlDateFormatter |*
|| date_format | ##d.m.Y## | ##dd.MM.yyyy## ||
|| time_format | ##H:i## | ##HH:mm## ||
|| time_format_seconds | ##H:i:s## | ##HH:mm:ss## ||
|#
1. To create the file hashes for files uploaded prior to WackoWiki **!!(green)6.1.19!!** use the ##~{{adminupdate}}## action.
* Set missing file hash for legacy records in file table
1. Remove the backups you've created prior to WackoWiki **!!(green)6.1.21!!** from the ##file/backup/## folder or replace the ##backup.log## with a JSON formatted version.
* %%
{
"cluster": "",
"data": "wacko_acl;wacko_auth_token;wacko_config;wacko_category;wacko_category_assignment;wacko_external_link;wacko_file;wacko_file_link;wacko_menu;wacko_page;wacko_page_link;wacko_revision;wacko_user;wacko_user_setting;wacko_usergroup;wacko_usergroup_member;wacko_watch",
"files": "file/global;file/perpage",
"size": 104080339,
"structure": "wacko_acl;wacko_auth_token;wacko_cache;wacko_config;wacko_category;wacko_category_assignment;wacko_external_link;wacko_file;wacko_file_link;wacko_log;wacko_menu;wacko_page;wacko_page_link;wacko_referrer;wacko_revision;wacko_user;wacko_user_setting;wacko_usergroup;wacko_usergroup_member;wacko_watch",
"time": 1681202531,
"wacko_version": "6.1.21"
}
%%
====Custom themes, actions, formatters, handlers and other modifications====
Do not forget to update and check your own modifications and extensions. Look out for changed functions, database changes or CSS changes.
1. Please look in the ((source:master/community/ community folder)) or ((/Dev/PatchesHacks Patches section)) for available updates.
1. ((/Doc/English/Themes Merge possible core changes in your own theme))
===Notes===
1. {{comment text="Leave a comment here"}} if something is not clear or you have further questions.
2. Do not hesitate to improve this instruction and the wording.