Groupee’s ubb.classic™ software
Upgrade from 5.x Series to 6.x Series
ã Groupee, Inc.
2401 Fourth Ave, Ste 500 • Seattle WA 98121
Phone 206.283.5999 • Fax 206.283.6616
TUpgrade from 5.x Series to 6.x Series
1. Turn off Your UBB.classic™ 5.x Board
7. Use “Upgrade Your UBB” Option
Start your upgrade by downloading the full licensed version zip file from the UBB.classic™ Member Area.
Please note that your UBB.classic™ 5 series board must be running and operating normally before you upgrade. Do not attempt to upgrade if your current board does not function correctly.
CAUTIONS: It is very important to follow the instructions step by step and in order, especially steps 6 through 13.
All files must be uploaded in ASCII mode (text mode in the Fetch FTP client), EXCEPT for the files that end in .jpg or .gif that are in your non-CGI directory.
You cannot upgrade to UBB.classic™ 6.x from the older UBB.classic™ freeware versions 5.10 to 2000d or from older versions of the licensed UBB.classic™ 5.x series; you must first update to the latest full UBB.classic™ 5.x series - 5.47e - then update to UBB.classic™ 6.x. The latest UBB.classic™ 5 series is available in the Members Area at http://www.ubbcentral.com
Go into your existing UBB.classic™ 5.x control panel and turn your UBB.classic™ message board off. This option is listed under General Settings >> Miscellaneous Options.
Upload all files in the "cgi-bin" folder of the zip file into the directory your UBB.classic™ software currently uses (it may or may not be called "cgi-bin"). If you are installing on a UNIX system, permissions for all of these files and your cgi directory must be 755. If you are unsure of the location of your CGI directory, go into the Primary Settings>>Configuration portion of your existing control panel. There, you will see the name of the current cgi directory your UBB.classic™ is using.
NOTE: All files that you upload to the cgi directory must be uploaded in ASCII mode. Do not use your FTP client automatic mode. Use only ASCII mode.
What do “777” and “755” permissions mean?
The 777 setting means that the Owner, Group, and Others have read, write, and execute permission for that particular file. 755 means that the Owner has read, write, and execute permission, but Group and Others only have read and execute access. Setting these permissions correctly is important, because the UBB.classic™ software requires certain access rights on the server before it can function properly.
Upload the contents of the variables folder (just the contents, not the folder itself) from your zip file into your UBB.classic™ CGI directory. If you are installing on a UNIX system, the permissions on these files need to be 777.
NOTE: All files that you upload to the UBB.classic™ variables directory must be uploaded in ASCII mode. Do not use your FTP client automatic mode. Use only ASCII mode.
Upload all files (including the subdirectories shown) in the "noncgi" zip file folder into the non-CGI directory that your UBB.classic™ software currently uses. (The location of your current non-CGI directory is also noted in the Primary Settings>>Configuration portion of your existing UBB.classic™ control panel.) These files do not need to have special permissions set.
NOTE: All files that you upload to the UBB.classic™ noncgi directory that end in ".jpg" and ".gif" must be uploaded in Binary mode. All files that you upload to the UBB.classic™ noncgi directory that end in ".pl" and ".html" must be uploaded in ASCII mode. Do not use your FTP client automatic mode.
****Do not upload the contents of the Members directory.****
Check Perl paths for these files: ultimatebb.cgi, cp.cgi, ubb_upgrade.cgi, and hello.cgi. None of the other cgi files requires a Perl path. Use the same Perl path that your current UBB.classic™ scripts use.
You can test your permissions now by uploading ubb6_test.cgi (located in the help directory of your zip file) in ASCII to your UBB.classic™ cgi directory and running the tests. There is more documentation on this file located in the help directory "ReadMe.txt" file, including information on troubleshooting errors it may produce.
Open a browser and run ubb_upgrade.cgi in your UBB.classic™ cgi directory. Once this script completes successfully, you will be prompted to log into your new control panel. Use your existing administrator user name and password.
Use your existing administrator user name and password to log into the control panel. Under the Maintenance drop-down menu, select the "Upgrade your UBB™" option. Read the information on the screen that appears. This Upgrade function performs basic checks to ensure your board is operating properly, and updates the Wordlet™ text lists with new entries.
Hit the "Upgrade Your UBB" button at the bottom of the page.
If you have archives and you want to import them, click on "Miscellaneous," then click on Import UBB5 Archives. Read the cautions and when you are ready, click the import button. You will be prompted to run the “Rebuild Forum Stat Files” and “Update Member Post Histories” maintenance functions when the import has completed. Please do so now.
You must now review and configure all of the Primary Settings, under the Primary Settings drop-down menu. Read, review, and set all of the Primary Settings carefully and in order top to bottom. There are eleven different options. If you do not see all of the options in the drop-down menu, use the scroll bar on the drop-down menu.
You will be prompted after each configuration screen if you forgot to finish a required item.
Note: The Configurations Settings screen should already be accurate. Please check it just in case.
Your board is now set up and functional. You can continue to navigate around the control panel, make forum settings changes, customize your Wordlet™ text lists, and review the rest of the features. You can visit the new location of your board by clicking the link in the upper left corner of the control panel, labeled with the name you have given your board in Primary >> Configuration Settings. (This text is immediately below the Groupee light bulb and logo.)
The UBB.classic™ 6.x software has two new URLs for the control panel and board. To access the board, use ultimatebb.cgi. To access your control panel, use cp.cgi.
Inside your help directory you will find a "movekit" directory. You will find an Ultimate.cgi and forumdisplay.cgi script that you can use to redirect your users from your old board to your new board. Open these two scripts in a text editor, put the new URL into the field marked $newurl, save, and upload both in ASCII to your UBB.classic™ CGI directory.
You can delete the following files immediately after you confirm that your new board is running correctly:
· noncgi/*.html (except index.html)
· noncgi/Forum*/ANNC/
· noncgi/Forum*/forum*.threads (but not forum_*.threads)
· noncgi/Forum*/private-*/ANNC/
· noncgi/Forum*/private-*/forum*.threads
· noncgi/forumindex*.cgi
· noncgi/dailyindex-*.file
· noncgi/Archives/*
· noncgi/ubbdiagnostic.file
· members/pindex/
· members/OldMembers/
You may also delete the following files:
· cgi-bin/UltBB.setup
· cgi-bin/mods.file
· cgi-bin/forums.cgi
· cgi-bin/Styles.file
After your UBB.classic™ 6.x community has been running and you are sure anyone that has bookmarked threads has been redirected, you can delete all of the old HTML files. This will save you a lot of space.
· noncgi/Forum*/HTML/
· noncgi/Forum*/private-*/HTML