The Arcive of Official vBulletin Modifications Site.It is not a VB3 engine, just a parsed copy! |
|
How 2 Guide - Backups, Upgrades, and Recovery!
TheLastSuperman
Join Date: Sep 2008
Posts: 5,844
Hey vb.org members and coders! Not much to say except I have a beautiful wife, three fantastic kids North Carolina
vBulletin 4.0 - Backups, Upgrades, and Recovery! Updated 1.15.2010 I wanted to post this here just like I did for vBulletin.com, you can locate this same tutorial there via this link: http://www.vbulletin.com/forum/showthread.php?335689-[Suite-OR-Forum]-How-2-Guide-Backups-Upgrades-and-Recovery!_____________________________________ If your unsure of ANY steps below please post but remember I color coded each section so when your scrolling for info bare in mind what's in blue pretty much relates to the blue text area and the other colors accordingly as well etc etc . Upgrading is an important process and should not be taken lightly. Please be aware you should always do a backup and here is the best way to be perfectly safe about it: Section 1 - Don't be stubborn, read the instructions you Grinch . 1. Check the Minimum Requirements found here: http://www.vbulletin.com/forum/showt...m-Requirements Also found here: http://www.vbulletin.com/faq.php#faq-125 If your Hosting account/Server is not up to par with the minimum requirements it might not upgrade at all or cause you more trouble then it's worth! Some host will move you to another server with the minimum requirements if available or perhaps for an additional fee or monthly cost. 1a. Trevor Hannant has released a very detailed Guide to Upgrading including screenshots so I highly recommend you view all of Trevor's upgrading instructions, they might be just what you need for a super simple upgrade then you can skip the upgrade information below and simply use this forum tutorial if you need to recover your forum or learn some useful information on backups! Please see all five parts via the vBulletin CMS however here are the links: http://www.vbulletin.com/forum/conte...uctions/view/1 http://www.vbulletin.com/forum/conte...uctions/view/2 http://www.vbulletin.com/forum/conte...uctions/view/3 http://www.vbulletin.com/forum/conte...uctions/view/4 http://www.vbulletin.com/forum/conte...uctions/view/5 1b. Another bit of helpful information is Wayne Lukes information on upgrading to 4.0 located here: http://www.vbulletin.com/forum/conte...-vBulletin-4-0 2. Test the backup to see if it will restore in a test environment. 3. If it restores then use it to test the upgrade but remember to disable all mods in admincp product manager and via Section 4 below in the config file. 4. If the upgrade was successful... now what? You decide! Change your forums folder name and rename the test one to be your forum, redo cookies to prevent login problems using tools.php and any posts since the time of the backup used are lost... or tell your members now about upgrading and close the board and repeat? Make that choice now and simply read for your parts below it's quite simple to keep up with otherwise post a comment and await a reply. 5. Well this is step number five so did it work? If so great copy this article and save on your computer with your vbulletin files so you don't have to track it down later if needed - always be prepared! Now if you need more details on how to backup, test or restore here is some more information for you. PLEASE NOTE YOU SHOULD NOT BE ATTEMPTING TO UPGRADE A LIVE SITE TO vBulletin 4.0! Section 2 - Patience is a virtue. 1. If your upgrading a live site please take the proper precautions such as testing in advance as listed above in Section 1. 2. You are allowed to run a vbtest under your license I suggest you install or upgrade a backup of your live site first to make sure it goes smoothly IF you are going to in fact upgrade, disregarding our warnings of upgrading a live site. More information on that is here: http://www.vbulletin.com/forum/showt...-READ-ME-FIRST 3. IF YOUR FORUM IS HEAVILY MODIFIED/CUSTOMIZED EITHER IN TERMS OF CUSTOM MODIFICATIONS AND OR STYLES AND YOUR DISREGARDING THE RECOMMENDATION NOT TO UPGRADE A LIVE SITE - I DO NOT RECOMMEND YOU UPGRADE AT THIS TIME, THAT IS STRICTLY IMO BUT I FEEL INEXPERIENCED OWNERS SHOULD NOT ATTEMPT UPGRADING A LIVE SITE THAT HAS BEEN HEAVILY CUSTOMIZED. Section 3 - Better Safe than Sorry. 1. Backup your Database and Files so you can restore to your current version on your live board now i.e. 3.5/3.6/3.7/3.8 etc if anything goes wrong or to use for making a test site. How to do this Mike? Database Backup - Cpanel? phpMyAdmin? Do you have any of these? If so let's review some options in each: Cpanel: There is an option to copy a database using Cpanel but I have not been successful on with it and found simply exporting using cPanel the using BigDump to import into a new databse saved me time trying to figure out other ways with each host being slightly different.To backup follow these steps: 1. Close your forum. 2. Use Cpanel to access your phpMyAdmin. 3. In phpMyAdmin, select the database you want to copy from the menu on the left. 4. Click export, then click choose "save as file" and save it you your computer along with your vbulletin files. MySQLDumper: Can be found here: http://www.mysqldumper.net/ & Special Thanks to FF|Skyrider for the reminder!! http://www.vbulletin.com/forum/showt...=1#post1840565) 1. Follow the information on installing it, run a backup and test a restore. Simple enough and secure using htaccess although I still find BigDump (listed below) to be easier. BigDump: Some host though have timeouts or limited sessions in place as mentioned above so you attempting to restore it will never work unless you use something like BIGDUMP. Here is some more info on automated backups (do this when you have time) which has links for BIGDUMP so you can upload a large Database. 1. See the info below, I like to give credit and that's where I found the reference on google. http://www.xoops.org/modules/smartfaq/faq.php?faqid=214 From that page, credit to XOOPS see post for details on author: Quote:
1a.Check out this information as well posted by Floris! Quote:
Quote:
Section 4 - Practice Makes Perfect. Now that you have made a test site (or if upgrading now on a live site) you need to do a few things first to make sure it all goes smoothly. You have backed up and either already rushed off and upgraded or you have restored a copy of your database and your ready to create a test environment for mods or to test an upgrade on! Let's see how to restore the files below: 1. If your making a backup of your site to test for mods or an upgrade copy the folder your forum is in and rename it then upload back to your server via FTP (i.e. Filezilla) or the Cpanel File Manager or Legacy File Manager (Retain a copy of the original files and do not alter them). Filezilla I find to be quicker than Cpanel file managers but long story short you want to make a backup all the files, every single folder and file. Why? Well if you have problems while upgrading to 4.0 you have already uploaded the new files so they will not work if you try to restore if the upgrade fails OR if making a test site you need ca copy of the original files to properly restore the site exactly as it is. Some FTP Clients do not automatically upload files in the correct mode, please read the install information provided by vBulletin to upload the correct files in the correct mode i.e. ASCII or Binary etc. 2. Download your current version (3.6 or 3.7/3.8 etc etc) and I mean the exact same version your forum is running now before the upgrade this will be needed to restore if required. Also retain an unaltered copy fo your entire forum folder on your computer as listed above in step 2. 3. Turn off ALL MODIFICATIONS. You can do this by disabling them all but the best and highly recommended way of doing this is by locating your config.php file and edit it (make a copy of it first and do not use notepad to edit use an external editor such as notepad ++ google it etc) and at the top below <php? add this: Code:
define('DISABLE_HOOKS', true); 3a. Revert back to your Default style, this is important and can be the difference between a viewable forum after your upgrade. If you do not have a default style or have modified it in some way please remember you can simply create a new fresh default style via the Style Manager. ** DELETE ALL OLD vBulletin 3.x Styles this can cause problems when upgrading if you do not! Only revert to default OR make a new Default for your 3.x before you upgrade!! 3b. While your in the config file of whatever site your upgrading be sure to change the database details to match the new database!!! 3c. In your browser navigate to your forums url i.e. http://www.yoursite.com/forum/install/upgrade.php provide your customer number and then follow the prompts on screen and upgrade! Did it work? If yes then great! Enjoy Quick Tips * Don't forget to turn back on the mods so your CMS and Blog will work, you can now uninstall unwanted 3.x mods one at a time until they are removed if you did not uninstall them before upgrading and remember to delete the files associated with the modifications as well. ** If your experiencing some problems with links not working properly or something seems funky try: (Thanks Birute for the Reminder!) a) Clear your cookies, CLOSE your browser and then launch your browser again i.e. Internet Explorer, Firefox, Safari, Opera etc etc. b) If that does not remedy it try: AdminCP > Maintenance > Update Counters and start updating! READ them all carefully as some can reset statistics you wish to retain and they will not be recoverable once the counters are updated unless you fall back to the most recent backup and possibly redo the upgrade process so be very careful and if anything refer to the older vBulletin 3 Manual as much of it stil pertains to the 4.0 version it just needs a bit of updating but for reference it's perfect: http://www.vbulletin.com/docs/html/ =================================== If the backup worked and your forum is upgraded and running fine please stop reading this guide now and go have fun with vBulletin 4.0! If you have any Bugs please confirm they are not specific to only you for some reason i.e. MySQL or PHP versions (Although you should have confirmed the minimum requirements were met before upgrading regardless). =================================== Section 5 - What a bloody mess... Continuing with this Guide from here down means you had a failed upgrade and wish to restore! Big forum or you just don't want your live site to stay down while you wait on a fix.. is there a fix? Frantic are you? Well simply restore back to your previous version if you saved a copy of your forum files and database as you were told to above! Depending on where the install script failed, it might not have modified you current database so you see errors because it's new files for 4.0 not communicating properly w/ the 3.x database . Simply re-upload your previous versions files as if you were updating and then run the upgrade script, there is an option to run it anyways please click that and proceed. If it did not alter the DB then you should see your live site back up! If it still shows errors then you might be in trouble and want to restore back to your previous version or if you did not make a backup now might be the time to submit a support ticket otherwise without a backup you will need to do a fresh install and have all your members re-register. Section 6 - The mop bucket. 1. You can try restoring your database via phpMyAdmin but some host have file upload or session limits/timeouts in place. You can ask them to restore it for you which is the quickest way. They won't restore or charge $$$.$$ ? Now you must do the rest plain and simple, buck up and let's get this done Good Sir! (or Lady ) 1a. Restore it yourself by using Cpanel, MySQLDumper, or BigDump as listed above in Section 3 - Better Safe than Sorry and remember when restoring to change the config file details to the new database and you might have to run the tools.php as listed above in Section 1 - Don't be stubborn, read the instructions a copy of it is located in your do_not_upload folder that came with your vBulletin forum or suite download. Again, in regards to restoring your Database, if your not having success and it's getting to you that bad simply contact your host and ask for their assistance. 1b. Your files... Upload all of them back to the same directory and all the files are as they were with the database now restored! Now check and see if it's restored? I hope it goes well for many of you, I had to save a 3.8 forum a while back from an owner who jumped then gun and tried to install herself http://www.vbulletin.com/forum/showt...of-upgrade-php so I thought I would post this up since many will be here for 4.0 ?'s and support just like many will only be on vbulletin.com! ______________________________ |
#22
|
|||
|
|||
Quote:
I may hold off until you have you see. |
#23
|
||||
|
||||
At the earliest this weekend otherwise first of next week.
|
#24
|
|||
|
|||
Top man!
Will wait. Cheers. Of course, feel free to use my vBulletin website if you need an example for the demo! |
#25
|
||||
|
||||
Great tut TLSman
Fallowed everything down to the letter and kind a worked ok until i removed the "define('DISABLE_HOOKS', true);" from the config! lol ended up with CALL errors Here's where i'm a bit confused, in the 3.8, i have like 28 plugins installed, now the proper way is to shut them off from whit in the options and then uninstalled them all one at a time and search from the FTP for the "uploaded files" of the plugins in question and delete them ! Yes? Once all plugins are removed, then upload the copy of the test V4 and overwrite every files in the root. Yes? OK, now in the ACP from the V4, we have the possibility to download from the "Plugins&Products" option at the bottom of it with the download/upload Plugins the plugins Hook location , ex: Hook Location : cache_templates , Hook Location : admindata_start etc etc. Do we have to download these also and reinstall them after or simply reinstall every plugins used from the test V4 without reuploading "vbulletin-plugins.xml" that we can download??? I think that this part of the TUTS should be a bit more defined, for the newbies like me Also, when making backup of the different styles that we have, normally every mods that we made in them for what ever reasons will be included in them , right? Do when making the backup in question, should both of these: Get customizations made only in this style /Get customizations made in this style and all parent styles be "on" when doing so? I have made lots of mods in the CSS for certain plugins and styles to be adapted to the board and don't want to start all over again Tks for the great help ! |
#26
|
|||
|
|||
I am currently using Cpanel to backup my home directory but this can be clunky as it can only backup the entire directory and not just parts of it.
Can anyone recommend me an alternative backup script that can backup specific directories (with permissions intact?)? I'm now looking for an alternative to cpanel's scripts which tend to be slow and timeout often (like I've now switched to mysqldumper instead of cpanel's sql backup). If there is something similar for files backup, that would be great! |
#27
|
||||
|
||||
Ok, i redid the whole test site starting from the 3.8 with latest database, then removed every plugins (FTP and all) overwrite it with my V4 test, upgraded, reinstalled every thing, plugins,styles, updates counters and repair fix tables
All seemed to be ok except none of the modifications that were made in the templates were back. So if i understood, i have to copy then paste in every CSS changes i made in the V4test to the new upgraded one, YES? Now , i imported the vbulletin-plugins XML that i backed up from the V4 test and got into a nice fatal error! Quote:
Anyway to fix this one or i should restart from beginning again? Also, there is no other way to save every mods i made in the template managers as i have 3 skins already and every one have modifcations for the smilies, shoutbox etc etc etc Lots of stuff to find back!! Tks again |
#28
|
|||||||
|
|||||||
Quote:
Here's the steps: 1) Review your mods on 3.8, in the Plugin & Products area of the admincp you can review the mods installed, that is those who had actual product files. If you had simple little template edits for a custom script etc it will be lost and or you will need to add it back in 4.0. 2) Most of the mods are clickable (or should be) click their links and see if the author OR site it linked to has released an update for 4.0. 3) If they have released an update then simply disable the mod because many will simply update the old mod data in your database however it can't if you uninstall it can it? 4) If there is not an update, uninstall the mod (bare in mind some authors may not have it completely 100% uninstalling so watch for the tables in the database and also remove any of the old files associated with that mod.) 5) After review of the mods and the ones you want to keep are disabled then disable them via the config file as well before the upgrade. 6) Backup your style too while your at it :P Now do all that other stuff but your issue was with old 3.8 mods coming back into play when you removed the disable hooks from the config plain and simple. You can't use many of the 3.x mods on 4.x it depends on how in-depth they were basically. Remember to install the new mod versions, read all their notes correctly before doing so and sometimes a review of the thread to see if other 4.x owners had an issue will help if one comes up for you. Quote:
Quote:
Quote:
Styles in 4.0 have changed dramatically especially with the introduction of the StyleVars system or the change I should say. Therefor based on that you should be aware that you;ll need to create a new style or download a free one from the Styles section, I recommend only using a style released in the same version as yours. Quote:
Quote:
Quote:
*Also if your reading the posts from here on out and you plan to reply, noticing I have not posted in a few days or a while then simply PM and say, "Can you take a look at your article?" and upon next login I'll be here. |
#29
|
||||
|
||||
a thousand tks my friend for the feed back
This is what you can call, major good support! I'll keep on working on those steps as it seems to me it's the most important part of upgrading from a live 3.8 to 4.xx . Still, i am a bit disappointed regarding the whole process that vbulletin put us threw with this upgraded version in relation with the transferring process! Maybe Impex should be revised and adjusted, therefor making the upgrade smoother between versions?!?! To be consider Merci mon ami! |
#30
|
||||
|
||||
Quote:
|
#31
|
||||
|
||||
hi TLSman, it looks like phpmyadmin had a little update and changed the template for the export function!!
Now, i tried to download and upload in my test a db but always end up with #1062 - Duplicate entry '1' for key 1 !!! I filled the info from your tut asper what i think should be right but seems like i'm missing something....or, i have a wrong configuration in my WHM?!? Tks Woody |
|
|
X vBulletin 3.8.12 by vBS Debug Information | |
---|---|
|
|
More Information | |
Template Usage:
Phrase Groups Available:
|
Included Files:
Hooks Called:
|