A mod broke my forum: Difference between revisions From Online Manual

Jump to: navigation, search
(added link to ftp, mention that file managers are ok, and numbered the steps.)
mNo edit summary
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Modifications - A mod broke my forum. What should I do?}}
Before you install a modification (mod), you should [[Backup|back up]] your forum and files. If you forgot to do this, however, and the mod which you installed broke your forum such that you cannot even uninstall it, there may still be a way to fix your forum.
When you install a modification (mod), you, being a good admin, will backup both your database and your forum files.


Some admins, though, aren't as clever as you are. So, they install a mod without backing-up first. Oh, dear. The forum's dead. I DON'T HAVE A BACKUP!!!
SMF takes a file backup for you. It does this each time you install something, and restoring the files will take them back to the way they were just '''before''' your most recent install.


Well, relax. You MIGHT be lucky.
To restore the backup, you need to follow these steps:
# Open [[FTP_-_How_do_I_use_FTP|FTP]] or whichever file manager that comes with your hosting service.
# Look in your forum's "Packages" directory to find another directory named "backups". Suppose that the last mod which you installed was "PM On Registration", and that you did this on 26 Jan 2012. In the aforementioned "backups" directory, you would find the file '''2012-01-26_before_PM_On_Registration_1-0-2.tar.gz'''
# Download that file to a convenient directory on your desktop computer and extract it. To extract a "tar.gz" file on a Windows operating system, use a program like [http://www.winzip.com winzip].
# Upload the files and directories from this file to your forum to overwrite what is there now.


SMF, being the helpful system that it is, takes a file backup, for you. It does this each time you install something, and restoring the files will take them back to the way they were just BEFORE you did the install (if you <b>had</b> to, you could work through all of the file backups in reverse order to go back further in time, but that's a bit involved)
Once complete, your forum files should be exactly as they were before you installed the mod. This procedure does not restore a backup of your database nor touch the database in any way.
 
How do we restore the backup? Dead easy!
# you'll need to start up [[FTP_-_How_do_I_use_FTP|FTP]] or else the file manager that comes with your hosting service.
# you'll need to have a look in your forum's "Packages" directory. In there, you'll find another directory named, you guessed it, "backups". Suppose that the last mod that you installed was "PM On Registration", and that you did this on 26 Jan 2012. In the afore-mentioned "backups" directory, you'd find the file <b>2010-01-26_before_PM_On_Registration_1-0-2.tar.gz</b>
# Download that file to your desktop, or somewhere fairly empty of files and dearchive it. It's a "gz" file. When you dearchive it you'll be left with a "tar" file.
# Dearchive that gz file. You'll find loads of files and directories. Upload those files and directories to your forum, overwriting what's there now. (It'll take a while).
 
When that's done, Voila! Your forum files should be exactly as they were, before you installed the mod!
This procedure will not make any changes on your forum's database, of course.
 
Next time, backup before installing mods, won't you?  ;)
[[Category:FAQ]]
[[Category:FAQ]]

Latest revision as of 16:17, 7 October 2014

Before you install a modification (mod), you should back up your forum and files. If you forgot to do this, however, and the mod which you installed broke your forum such that you cannot even uninstall it, there may still be a way to fix your forum.

SMF takes a file backup for you. It does this each time you install something, and restoring the files will take them back to the way they were just before your most recent install.

To restore the backup, you need to follow these steps:

  1. Open FTP or whichever file manager that comes with your hosting service.
  2. Look in your forum's "Packages" directory to find another directory named "backups". Suppose that the last mod which you installed was "PM On Registration", and that you did this on 26 Jan 2012. In the aforementioned "backups" directory, you would find the file 2012-01-26_before_PM_On_Registration_1-0-2.tar.gz
  3. Download that file to a convenient directory on your desktop computer and extract it. To extract a "tar.gz" file on a Windows operating system, use a program like winzip.
  4. Upload the files and directories from this file to your forum to overwrite what is there now.

Once complete, your forum files should be exactly as they were before you installed the mod. This procedure does not restore a backup of your database nor touch the database in any way.



Advertisement: