| Both sides previous revision Previous revision Next revision | Previous revision |
| en:2.0:update [2023/07/15 18:43] – fasse | en:2.0:update [2025/11/16 12:02] (current) – fasse |
|---|
| ====== Update ====== | ====== Update ====== |
| |
| This page describes the steps that must be taken to update Admidio to a new version. | This page describes the steps required to update Admidio to a new version. |
| |
| <WRAP important>If you perform an update from Admidio version 3 oder 2 to **the current version 4** then follow the steps that are described on our [[en:2.0:update_to_version_4|special update page]].</WRAP> | <WRAP important>When updating from Admidio version 3 or 4 to the **current version 5**, existing layout customizations cannot be transferred. Before updating, switch to the default theme and check out the new configuration options for layout customizations in the settings.</WRAP> |
| |
| - [[de:2.0:datenbankbackup_erstellen_und_wiederherstellen|First make a backup of the database]] (In the database all your user data, role permissions, role memberships and more data are saved) | - If you use plugins, first check whether [[de:plugins:index|all plugins]] are also available for the new version. |
| - For safety, you should perform a backup of the Admidio folder structure (adm_program, adm_themes, adm_my_files and adm_plugins) | - [[de:2.0:datenbankbackup_erstellen_und_wiederherstellen|Create a backup of the database]] (The database stores all your user data, role permissions, role memberships, and much more). |
| - Download Admidio from [[http://www.admidio.org/download.php?language=en|this page]] to your computer and unzip the zip file with an appropriate program. | - To be on the safe side, you should create a backup of the Admidio folder structure in the next step. |
| - Delete now the directory **adm_program** and the file **index.php** on your Admidio webspace. | - Download Admidio from [[http://www.admidio.org/download.php?language=de|our website]] to your computer and unzip the file using a suitable program. |
| - Copy the unzipped directories **adm_program** including all files and subfolders as well as the file **index.php** from your computer to your webspace in the Admidio main directory. | - Now delete all directories except **adm_my_files** and **adm_plugins** on your Admidio web space. If you have made your own adjustments to the theme files, you should also not delete the **themes** folder. |
| - All [[en:plugins:index|plugins]] within the folder **adm_plugins** must also be changed. Please note our [[en:plugins:installation#how_do_i_update_a_plugin|plugin documentation]], especially if you have made your own settings in the config.php files of the plugins. | - Copy all folders, including all files and subfolders, as well as the **index.php** file from your computer to your web space in the Admidio main directory from which you removed the folders //before//. |
| - Now you need to update the theme. | - The [[en:plugins:index|plugins]] in the **adm_plugins** folder must also be replaced. Please refer to our [[en:plugins:installation#how_do_i_update_a_plugin|plugin documentation]], especially if you have made your own settings in the config.php files of the plugins. |
| - If you have not made any changes to our default theme, you can simply delete the theme folder **adm_themes** and upload the theme folder of the new version. | - If you are updating within version 5 and have made adjustments to the theme files in the **themes** folder in the past, you must update the theme in the next step. |
| - Have you made changes to a few files, then you can update the unchanged files and customize the other file with help from our [[aenderungshistorie_fuer_themes_42|change history for themes]]. | - If you have not made any changes to our standard themes, you can simply delete the **themes** folder and upload the theme folder of the new version. |
| - If you have created a backup under point 1, you can now call Admidio in your browser ''www.example.org/admidio/'' and will be redirected to the update page.\\ \\ If the update page is not called automatically, it can be called directly via the following URL: ''www.example.org/admidio/adm_program/installation/update.php''. | - If you have made changes to a few files, you can simply update the unchanged files and, if necessary, specifically adjust your customized files using our [[change_history_for_themes_50|change history for themes]] to make them compatible with the new version. |
| - Now appears the following page where you must confirm the update again. If the database is up to date then this will be reported there. So no one else can perform the update, you must enter the login data of a webmaster. After that click on **Update database** and the database will be updated to the new version. Wait with other actions in the browser until the confirmation appears that the update was completed successfully. This may take up to 4 minutes.\\ {{de:2.0:update:update_01.png?400}}\\ \\ :!: //If the update was run on an error, you can [[de:2.0:datenbankbackup_erstellen_und_wiederherstellen#wie_stelle_ich_ein_datenbankbackup_wieder_her|restore your backup]] and after the cause has been found start the update again or still use the previous version until the error is resolved. In case of more serious problems or a missing backup, it is still possible to [[en:2.0:probleme_beim_update|restore your previous version]].// | - If you created a backup in step 1, you can now open Admidio in your browser at ‘'www.example.org/admidio/’' and you will be redirected to the update page.\\ \\ If the update page does not open automatically, you can access it directly via the following URL: ‘'www.example.org/admidio/install/update.php’'. |
| | - The following page will now appear, where you must confirm the update again. If the database has already been updated, this will be indicated accordingly. To prevent anyone else from performing the update, you must enter the login details of a webmaster. Then click on **Update database** and the database will be updated to the new version. Wait with further actions in the browser until the confirmation appears that the update has been successfully completed. This can take up to 4 minutes.\\ {{:en:2.0:update:update.png?400|}}\\ \\ :!: //If the update has failed, you can restore your [[de:2.0:datenbankbackup_erstellen_und_wiederherstellen#wie_stelle_ich_ein_datenbankbackup_wieder_herstellen|backup]] and, after clarifying the cause, restart the update or continue using the previous version for the time being. In the event of more serious problems or if you do not have a backup, it is still possible to [[en:2.0:probleme_beim_update|restore your previous version]].// |
| |
| Admidio has now been successfully updated and you can now work with the new version. | Admidio has now been successfully updated and you can now work with the new version. |
| |
| Good luck! | Good luck! |
