Differences

Link to this comparison view

user_documentation:learn:upgrade:upgrade_manual [2018/01/29 15:18] (current)
plg moved upgrade guide from website to wiki
Line 1: Line 1:
 +====== 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.
 +
 +
 +<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: 2018/01/29 15:18 by plg
 
 
github twitter facebook google+ newsletter Donate Piwigo.org © 2002-2018 · Contact