Upgrade Instructions:

These are general instructions on how to upgrade your existing YaBB forum from ANY previous version of YaBB. Please follow all 4 steps!

Step 1 - Configure Settings, Template, and Language Pack
First open 'YaBB.pl', 'Reminder.pl', and 'PrintPage.pl'. Each of those files contains a path to your server's Perl location. Generally, this setting is correct, but Perl is installed in different locations. For example on a Windows or WinNT machine, your Perl path should probably be set to #!C:/Perl/Bin. Check your server for the proper path and change accordingly.

Open 'Settings.pl' and set the variables inside as follows:
Required Settings--> 

   require "english.lng"        Change to language pack you want to use
   $mbname			The name of your YaBB forum
   $boardurl			URL of your board's folder (without trailing '/') - where YaBB.pl is located
   $cookieusername		Name of the username cookie (no change necessary)
   $cookiepassword		Name of the password cookie (no change necessary)
   $mailprog			Location of your sendmail program (generally "/usr/sbin/sendmail" or similar)
   $webmaster_email		Your e-mail address (must have the slash in it as shown "webmaster\@mysite.com")

   $boarddir			Absolute path to the board's folder (usually can be left as '.')
   $datadir			Directory with messages (can be left alone unless you wish to move elsewhere)
   $memberdir			Directory with member files (can be left alone unless you wish to move elsewhere)
   $boardsdir			Directory with board data files (can be left alone unless you wish to move elsewhere)
   $sourcedir			Directory with YaBB source files (can be left alone unless you wish to move elsewhere)
   $vardir			Directory with variable files (can be left alone unless you wish to move elsewhere)

   $facesurl			URL to your avatars folder (without trailing '/')
   $facesdir		        Absolute Path to your avatars directory
   $imagesdir			URL to your images folder (without trailing '/')
   $helpfile			URL to your help index file (http://www.mysite.com/yabbhelp/index.html)
The remaining settings in Settings.pl are not required, but are only feature and layout variables. It is recommended that you do not change them until you get YaBB working! After that, have fun.... This new Settings.pl file is required because there are many new settings.

Open 'template.html' and modify the layout as you wish (to make it look like your site). Important Step-> if you wish to use your existing template, you MUST add the tag "<yabb copyright>" or you will get an illegal copy notice error on your forum! Note: the tags beginning with "<yabb " MUST REMAIN in the template.html file. You may move them around as you wish as long as you keep those tags on lines BY THEMSELVES. The tag "<yabbnews>" has been removed in this version, in favor of the NewsFader script. You may insert this tag if you would like the old text news format back on your YaBB. (But be sure to set $ShowNewsFader to '0' before you put that tag back in, or you'll have the news twice on the Board Index.) It is recommended that you do not change template.html either until you get YaBB working!

** Open 'english.lng', or the language pack you wish to use, and edit the text strings as you wish. The new language file is REQUIRED because there are approximately 200 new strings from the last release of YaBB.

Step 2 - Upload the script/image files
Place the files from the downloaded zip into the directories as shown below (and please not that the directory names as show may be different from the ones you actually use):

------- NON cgi-bin section --------- 

   /ubbc.js
   /fader.js
   /yabbhelp/			*.*             (Upload in Ascii)
   /yabbhelp/images		*.*             (Upload in Binary!)
   /yabbimages/                 *.gif all files (Upload in Binary!)
   /yabbimages/avatars		*.* all files 	(Upload in Binary!)
------- CGI-BIN section (all files in ASCII) --------- 
   /yabb/                             drwxrwxrwx (chmod 777)
   /yabb/YaBB.pl                      -rwxr-xr-x (chmod 755)
   /yabb/Printpage.pl                 -rwxr-xr-x (chmod 755)
   /yabb/Reminder.pl                  -rwxr-xr-x (chmod 755)
   /yabb/Settings.pl                  drwxrwxrwx (chmod 777)
   /yabb/template.html                drwxrwxrwx (chmod 777)
   /yabb/english.lng                  -rw-r--r-- (leave as is) # or another language file

   /yabb/Sources                      drwxrwxrwx (chmod 777)                
   /yabb/Sources/Admin.pl             -rw-r--r-- (leave as is)           
   /yabb/Sources/BoardIndex.pl        -rw-r--r-- (leave as is)              
   /yabb/Sources/Display.pl           -rw-r--r-- (leave as is)		
   /yabb/Sources/ICQPager.pl          -rwxr-xr-x (chmod 755)       
   /yabb/Sources/InstantMessage.pl    -rw-r--r-- (leave as is)
   /yabb/Sources/Load.pl              -rw-r--r-- (leave as is)        
   /yabb/Sources/LockThread.pl        -rw-r--r-- (leave as is)             
   /yabb/Sources/LogInOut.pl          -rw-r--r-- (leave as is)
   /yabb/Sources/Maintenance.pl       -rw-r--r-- (leave as is)
   /yabb/Sources/ManageBoards.pl      -rw-r--r-- (leave as is)
   /yabb/Sources/ManageCats.pl        -rw-r--r-- (leave as is)
   /yabb/Sources/Memberlist.pl        -rw-r--r-- (leave as is)
   /yabb/Sources/MessageIndex.pl      -rw-r--r-- (leave as is)
   /yabb/Sources/ModifyMessage.pl     -rw-r--r-- (leave as is)
   /yabb/Sources/MoveThread.pl        -rw-r--r-- (leave as is)
   /yabb/Sources/Notify.pl            -rw-r--r-- (leave as is)
   /yabb/Sources/Post.pl              -rw-r--r-- (leave as is)
   /yabb/Sources/Profile.pl           -rw-r--r-- (leave as is)
   /yabb/Sources/Recent.pl            -rwxr-xr-x (chmod 755)
   /yabb/Sources/Register.pl          -rw-r--r-- (leave as is)
   /yabb/Sources/RemoveOldThreads.pl  -rw-r--r-- (leave as is)
   /yabb/Sources/RemoveThread.pl      -rw-r--r-- (leave as is)
   /yabb/Sources/Search.pl            -rw-r--r-- (leave as is)
   /yabb/Sources/Security.pl          -rw-r--r-- (leave as is)
   /yabb/Sources/Subs.pl              -rw-r--r-- (leave as is)

Step 3 - Delete Extra Files
Next, you will need to delete Search.pl from you /yabb (or your board's directory). It has been replaced by the /Sources/Search.pl. If you are upgrading from Y1G - Beta 4 and below, you'll need to also delete /Sources/SearchResults.pl.


Step 4 - Running Maintenance Upgrade Links
You will notice a new "Y1Gold Upgrade" section in the Admin Center when logged in as an Administrator. You must click (one at a time of course) both of these links so YaBB updates it's totals files. When you first upgrade, it has to create these files anew....

You will next need to go into the Admin Center and click the "Edit Membergroups" link. Most likely, you'll have to reorder your membergroups (especially if you had custom ones) and edit the text. When finished and saved, go back to the Admin Center and click the "modify your settings/colors" link. Scroll down to the section that asks for # of posts to be in a certain membergroup. Either specify your own #'s, or click save and some default values (50, 100, 250, 500) will be used.


back to top