How to upload a fresh set of files: Difference between revisions From Online Manual

Jump to: navigation, search
No edit summary
(Be clear that we are getting the EXACT same version as was previously installed, and not running upgrade.php)
Line 3: Line 3:
* SMF [[Patch_(term)|update/patch]] fails because of the changes mods have made.
* SMF [[Patch_(term)|update/patch]] fails because of the changes mods have made.


These are instructions to restore the current version of SMF, without making any changes to the database. Then, it will be possible to re-install mods or upgrade to a newer version of SMF. These instructions will delete all mods and other changes to the SMF-supplied themes, and erase all hand-made customizations from all files. It won't delete any "extra" files or directories you may have added by hand or through mod or theme installations. For other options, please seek support at the 1.1 support board or the 2.0 support board.
These are instructions to restore the current version of SMF, without making any changes to the database. Then, it will be possible to re-install mods or upgrade to a newer version of SMF. These instructions will delete all mods and other changes to the SMF-supplied themes, and erase all hand-made customizations from all files. It won't delete any "extra" files or directories you may have added by hand or through mod or theme installations. For other options, please seek help at the 1.1 support board or the 2.0 support board.


;First -- [[Backup]] '''everything'''
;First -- [[Backup]] '''everything'''
Line 9: Line 9:
:Backup your custom themes and graphics. Make careful notes about any hand-made customizations you have made to files.
:Backup your custom themes and graphics. Make careful notes about any hand-made customizations you have made to files.


;Second: Download the large upgrade package for the major version of SMF that you're using [http://download.simplemachines.org/ from the download site]  
;Second: Download the large upgrade package for the major version of SMF that you're using [http://download.simplemachines.org/index.php?archive from the download site].  Be sure to select your current version of SMF from the drop-down list next to "Select Version".


;Third: Extract the package and delete upgrade.php and all the upgrade-x.x.sql files.
;Third: Extract the package and delete upgrade.php and all the upgrade-x.x.sql files.
Line 15: Line 15:
;Fourth: Upload the files, EXCEPT UPGRADE.PHP (and the .SQL files), to the forum's directory, overwriting what's there, now. You can either use FTP or, in a pinch, CPanel's File Manager. On your forum, if you've replaced the standard smiley files with your own and/or replaced the standard avatar files, you might want to refrain from uploading the 'Smileys' directory and the 'avatars' directory.
;Fourth: Upload the files, EXCEPT UPGRADE.PHP (and the .SQL files), to the forum's directory, overwriting what's there, now. You can either use FTP or, in a pinch, CPanel's File Manager. On your forum, if you've replaced the standard smiley files with your own and/or replaced the standard avatar files, you might want to refrain from uploading the 'Smileys' directory and the 'avatars' directory.


Once done, your forum will be in a virgin state, software-wise. All of your members, posts, etc. will be intact. However, none of your mods will be installed, now. They will, fortunately, still be in Package Manager. From there, you can either apply/install them, or delete them, as you desire. Any of your mod's settings that are stored in the database will be retained and still be usable when the mod is reinstalled.
Once done, your forum will be in a virgin state, software-wise. All of your members, posts, etc. will be intact. However, none of your mods will be installed now. They will, fortunately, still be in Package Manager. From there, you can either apply/install them, or delete them, as you desire. Any of your mod's settings that are stored in the database will be retained and still be usable when the mod is reinstalled.


If you are using SMF 2.0 and had mods installed you may want to use [[Manually setting a package installed or uninstalled|Fix_Packages.php]] to remove the hooks that the mods installed. This is a good idea if you see some mods are still installed when browsing the admin panel after uploading clean files.
If you are using SMF 2.0 and had mods installed you may want to use [[Manually setting a package installed or uninstalled|Fix_Packages.php]] to remove the hooks that the mods installed. This is a good idea if you see some mods are still installed when browsing the admin panel after uploading clean files.


[[category:FAQ]]
[[category:FAQ]]

Revision as of 16:08, 28 May 2014

When the database is OK, but some SMF files are damaged, it may be a good idea to reinstall the current version of SMF. This recreates what is called a "clean SMF installation". This might be necessary if

  • a mod fails to completely install or uninstall, leaving the forum unworkable
  • SMF update/patch fails because of the changes mods have made.

These are instructions to restore the current version of SMF, without making any changes to the database. Then, it will be possible to re-install mods or upgrade to a newer version of SMF. These instructions will delete all mods and other changes to the SMF-supplied themes, and erase all hand-made customizations from all files. It won't delete any "extra" files or directories you may have added by hand or through mod or theme installations. For other options, please seek help at the 1.1 support board or the 2.0 support board.

First -- Backup everything
Backup your database. Make sure you have backed up all your data!
Backup your custom themes and graphics. Make careful notes about any hand-made customizations you have made to files.
Second
Download the large upgrade package for the major version of SMF that you're using from the download site. Be sure to select your current version of SMF from the drop-down list next to "Select Version".
Third
Extract the package and delete upgrade.php and all the upgrade-x.x.sql files.
Fourth
Upload the files, EXCEPT UPGRADE.PHP (and the .SQL files), to the forum's directory, overwriting what's there, now. You can either use FTP or, in a pinch, CPanel's File Manager. On your forum, if you've replaced the standard smiley files with your own and/or replaced the standard avatar files, you might want to refrain from uploading the 'Smileys' directory and the 'avatars' directory.

Once done, your forum will be in a virgin state, software-wise. All of your members, posts, etc. will be intact. However, none of your mods will be installed now. They will, fortunately, still be in Package Manager. From there, you can either apply/install them, or delete them, as you desire. Any of your mod's settings that are stored in the database will be retained and still be usable when the mod is reinstalled.

If you are using SMF 2.0 and had mods installed you may want to use Fix_Packages.php to remove the hooks that the mods installed. This is a good idea if you see some mods are still installed when browsing the admin panel after uploading clean files.



Advertisement: