Differences

This shows you the differences between two versions of the page.

Link to this comparison view

user_documentation:learn:upgrade:upgrade_manual [2018/01/29 14:18]
plg moved upgrade guide from website to wiki
user_documentation:learn:upgrade:upgrade_manual [2020/08/29 10:48] (current)
plg
Line 1: Line 1:
 ====== Manual Upgrade ====== ====== Manual Upgrade ======
  
-This procedure is compatible with any version greater or equal to 1.4. For an older version, ask for help on the forum. +This content has been moved to a guide : [[https://piwigo.org/guides/update/manual|Manual Update]]
- +
- +
-<WRAP center info round 60%>Please do check Piwigo current [[user_documentation:learn:install:before|Requirements]]. Especially if your Php / MySQL configuration is NOT sufficient, do not go further as the upgrade process will fail.</WRAP> +
- +
-===== Step 1 - Package preparation ===== +
- +
-  * [[http://piwigo.org/download/dlcounter.php?code=latest|Download]] the latest Piwigo release archive +
-  * On your computer, extract the "piwigo" directory. +
-  * Remove the default "piwigo/local" directory. +
- +
-===== Step 2 - Database preparation ===== +
- +
-Backup your current tables (3-5 min.) +
- +
-If you are using a version from the PhpWebGallery 1.7 family or later, you can use the [[http://piwigo.org/ext/extension_view.php?eid=240|DB Backup]] plugin. Previous releases users should have to backup their tables by other means, for example with phpMyAdmin <wrap em>[fig A]</wrap>. +
- +
-{{ http://piwigo.org/screenshots/upgrade-2-fig_1_en.jpg?500 }} +
-<WRAP em center centeralign 50%>[A] PhpMyAdmin recommended options.</WRAP> +
- +
-**In any case**, be sure to check the backup is exhaustive and has successfully completed (the result is sometimes truncated due to server limits). +
- +
-[Our advice: unselect "Extended inserts" or reduce "Maximal length of created queries".] +
- +
- +
-===== Step 3 - File server preparation ===== +
- +
-If you're running Piwigo 2.1 or higher, skip this step. +
- +
-Backup your customized files only or all files (5 minutes).  +
- +
-  * [[http://piwigo.org/ext/download.php?eid=391|Download the Prepare 2.1 Upgrade extension tool]] +
-  * extract the prep21up.php script and transfer it at the root of your Piwigo installation +
-  * open prep21up.php from your web browser %%http://example.com/photos/prep21up.php%% and you will receive an "upgrade21.zip" archive +
-  * On your computer, extract the "local" directory from "upgrade21.zip" into the "piwigo" directory (extracted during step 1). +
- +
-===== Step 4 - Gallery preparation ===== +
- +
-Lock your gallery (1 minute) <wrap em>[fig B]</wrap> +
- +
-{{ http://piwigo.org/screenshots/upgrade-2-fig_2_en.jpg?500 }} +
-<WRAP em center centeralign 50%>[B] Lock gallery.</WRAP> +
- +
-With Piwigo 2.3 or earlier version: Configuration > General > Lock gallery. For Piwigo 2.4+: Tools > Maintenance. +
- +
-From now on, non-administrator users of any gallery version should see something like: //"The gallery is locked for maintenance. Please, come back later."//. +
- +
-===== Step 5 - Cleaning ===== +
- +
-Remove all files of your current Piwigo installation, with the following exceptions, do **NOT** delete these directories: +
- +
-  * galleries +
-  * upload +
-  * plugins +
-  * themes +
-  * template-extension +
-  * local +
-  * _data +
- +
-===== Step 6 - FTP upload ===== +
- +
-Use your standard FTP client to upload the new release, ie the content of the //"piwigo"// directory (extracted during step 1 and updated during step 3), into the previous Piwigo installation directory. +
- +
-Check that your FTP client did not encounter any error. +
- +
-===== Step 7 - Database upgrade ===== +
- +
-Launching upgrade (2 minutes). +
- +
-In your web browser, open the "upgrade.php" script and follow the guide, %%http://example.com/photos/upgrade.php%%  <wrap em>[fig C]</wrap> +
- +
-{{ http://piwigo.org/screenshots/upgrade-2-fig_3_en.jpg?500 }} +
-<WRAP em center centeralign 50%>[C] Starting upgrade page.</WRAP> +
- +
-To avoid any upgrade by another visitor you are invited to sign on. +
- +
-Your previous release is identified and you will get a summary of the upgrade operations; see <wrap em>[fig D]</wrap>. +
- +
-{{ http://piwigo.org/screenshots/upgrade-2-fig_4_en.jpg?500 }} +
-<WRAP em center centeralign 50%>[D] Upgrade memo page.</WRAP> +
- +
-Plugins active before the upgrade will be switched off to inactive status, as they could fail to work with the new release and need their own specific upgrade. +
- +
-===== Step 8 - Check the upgrade result ===== +
- +
-Your first controls could take time because you are not aware of all the changes (15 to 120 minutes). +
- +
-You will see a list of all your previous plugins; some of them have been fully integrated in the core (like Plugins Manager), others are now distributed (like LocalFiles Editor), but any desactivated plugin has been so for a good reason. +
- +
-Try to find an upgrade first; the plugins tabsheets can help you. +
- +
-For themes, keep an admin page opened in your browser in case you need to reverse any of your tests. +
- +
-Don't forget that your members or visitors can have a specific selected theme which is not compatible with your new release. You'd probably better have to reset their theme in the Admin users page. +
- +
-===== Step 9 - Unlock your gallery ===== +
- +
-You begin to be confortable with our last release, do not forget to unlock your gallery to give access to visitors (1 minute). +
- +
-===== Step 10 - Post upgrade cleaning ===== +
- +
-Nothing (0 minute) +
- +
-Nothing has to be removed after any upgrade. The "upgrade.php" itself is not to be removed. Remember that the //"No upgrade required"// message and the sign-on process are protecting your gallery. +
 
Back to top
user_documentation/learn/upgrade/upgrade_manual.txt · Last modified: 2020/08/29 10:48 by plg
 
 
github twitter newsletter Donate Piwigo.org © 2002-2022 · Contact