Installing YaBB on Macintosh OSX through MAMP: Part V
V: YaBB
Download the latest version of YaBB and put it in your account folder. Under OSX, double clicking the icon will extract the folders and files from the YaBB.zip file (currently at this time it is: YaBB_2.5_AE.zip) in a folder labeled: YaBB_2.5_AE. Opening this folder will give you the files README.txt and VERSION.txt, and folders Quick-Guide, cgi-bin and public_html. It is these last two folders cgi-bin and public_html that has YaBB in them and you need to pay attention to them.
Double-click on public_html and it will open showing another folder: yabbfiles. Hold down the ‘ctrl’ keyboard button while moving the mouse and click on the yabbfiles folder. A menu will open, scroll down to COPY to copy the folder into memory for the time being.
Now open by double clicking your hard drive icon and then the ‘Applications’ folder. There you will see a list of application folders, double-click the MAMP folder. There you will see a folder named or labled ‘htdocs’, double click this folder and past the yabbfiles folder in there. When done, you have completed 30% of the process to install YaBB on MAMP for OSX.
The next step is to go back to the YaBB folder where you copied the yabbfiles folder from, and double-click the cgi-bin folder. When the cgi-bin folder is open, there is a ‘yabb2’ folder in there. Hold down the ‘ctrl’ keyboard button while moving the mouse and click on the yabbfiles folder. A menu will open, scroll down to COPY to copy the folder into memory for the time being.
Now go back to the MAMP folder where the cgi-bin and htdocs folders are in. Double click the cgi-bin folder and paste the yabb2 folder in there. Once the copying is done, you are now 60% done installing YaBB on your Mac with MAMP. The next part is the hard part and is divided in two sections.
Perl’s shebang line for Mac OSX/OSX Server is’ #!/usr/bin/perl’; the same as it is on the the YaBB files. This means that you do not have to go into the files and change them. It is already done for you. This means now 80% of the work is done.
In browser, open page to localhost/cgi-bin/yabb/Setup.pl When asked for password, type in ‘admin’
In setting the paths for YaBB, click the ‘Insert’ button for Absolute Path and then click on ‘Autofill the forms below’. Make sure that all entries have a full directory and full urls with your domain name in it on the right side. Finally at the bottom of the page, click on ‘Save Settings’.
Give it a while to process.
Note: if you get a blank page at this section, it means that your files and folders are not writable. You need to check your YaBB folders and file permissions and change them into read/writeable files with the chmod command in the terminal. If you get an error like te dreaded “Internal Server Error”, you need to check the FixFile.pl, YaBB.pl, AdminIndex.pl, Paths.pl, and Setup.pl files and make them read/write/executable files. Refreshing the page should bring the section that did not loaded.
Also Note: if you do not have your domain name setup yet, you can use ‘localhost’ as a domain name (not localhost.com, localhost.org, localhost.net, just ‘localhost’). When you get your domain name and have the site online, you can change ‘localhost’ to your domain name in the forum’s administration panel under ‘Path Settings’.
Next page will show you the installed modules on both Perl and YaBB. If there are missing modules, you can always add them later through the Perl CPan Library. With the set up I have, these are the missing modules found:
Net::SMTP:TLS - used to send emails through SMTP:TLS, and not needed to run YaBB unless you want to send emails through Perl. You can use another email system like ‘sendmail’ in OSX to send emails for YaBB. You would need to configure that in the Adminstration Panel later on.
Compress:Bzip2 – used for the back up feature. Its does not effect the forum itself but as a forum administrator and owner, you will need to back up your forum, mainly the: Boards, Members, Messages, Modules, Sources Templates and Variables folders. You also need to back up the Paths.pl and YaBB.pl files.
LWP::UserAgent, HTTP::Request::Common, and Crypt::SSLeay - used for YaBB Spell Checker’s “GoogieSpell.” Without these modules, it just means that your members must do their own spell checking. This does not effect the over forum.
After saving this page, the next page is System Set up. Fill in the options you have for your forum: Forum Name/Title, your email, domain name (if any at this time), etc.
The next page is ‘Checking System Files’ where the forum’s set up is checked. If there is an error or issues, you will be alerted to fix them and maybe hinted on how to fix them. In my installation, there were no issues to fix. Click on the ‘Continue’ button to do ‘Forum Settings’.
Next page will be the forum itself, saying that it is in Maintenance Mode, and asking you to log back in as the administrator. User = admin , Password = admin. Once logged in, you will see the forum as it is - blank. Click on the ‘Admin’ button on the button bar. At this point YaBB is running. You will need to go to the Admin Panel to make changes to the forum and get it out of Maintenance Mode. Also go to the ‘View/Delete Members’ page in the admin panel and give the admin user a new password!
Congratulations – It’s A YaBB Forum Done On MAMP for Mac OSX!
But it is a blank forum. All you have to do is make and shape the forum and its sections with the Forum Configurations and add forum sections and posts to get it stated. Put it online, make a few adjustments like adding the domain name in the administration panel, and tells your friends about it. Then watch it grow. All you have to do is administer it. As its owner, you can give administration and moderator rights to those you trust to help you run the site. At this point do a chmod in the terminal on the YaBB files and the Admin, Modules, Sources, Help folders and set them to ‘Read-only’.
And that’s it.
|