E-Blah SQL Installation

From Blahdocs Wiki

Jump to: navigation, search

E-Blah SQL is currently in beta testing. It was forked from the "main" flat-text version of E-Blah between version 10.2 and 10.2.5. The calendar and portal were removed from the SQL version of E-Blah. The purpose of the SQL version is, among other things, creating a more manageable system back end for administrators that is both speedier and more organized, while making things simple. The SQL version does not succeed the flat-text version, but rather gives Administrators more options in using E-Blah.

Contents

Install the latest SQL version

This section of the Blahdoc.com Wiki is for new installations of an E-Blah SQL forum. This section will only cover how to install the latest version of E-Blah SQL. We do this because the latest version of E-Blah is always better than the previous version, and almost always contains bug fixes. For those two reasons, you should always install the latest version when performing a new installation.

Step 1 - Setup your MySQL or SQLite database

Before you can begin installation of E-Blah SQL, you will have to have a mySQL or SQLite database installed on your webserver. After you have the database setup, write down the database information. You will need this when you run the Install script in step four below.


Step 2 - Upload the folders / files to your server

There are two directories that you MUST upload to your web server for E-Blah to function. They are:

  • The forum directory.
  • The blahdocs directory.

These two directories MUST be uploaded in the right MODE for your forum to fuction properly. These modes are:

  • ASCII Mode.
  • Binary Mode.

The forum directory (including sub-directories and files) MUST be uploaded in ANSCII mode to your cgi-bin directory. If you don't have a cgi-bin directory, ask yourself these two questions:

  • Does my host support Perl or cgi scripts?
  • Does my host allow Perl or cgi scripts to be run outside of the cgi-bin folder?

If you answer YES to one or both of those questions, then you have two options. If the answer is NO, then you probably won't be abot to run E-Blah on your server.

  • You can create a cgi-bin directory and upload the forum directory inside it.
  • You can up the forum directory to your web server's root directory.

*** NOTE *** We suggest that you create a cgi-bin directory and put your forum directory inside it. Not doing this could cause the mod_rewrite fuction (if you choose to use it) to not work properly.

The blahdocs directory (including sub-directories and files) MUST be uploaded in Binary mode to your web server's root directory. Your root directory is your web sites home directory. It is sometimes (but not always) named htdocs, or public_html.

*** WARNING *** Many FTP programs have a AUTO transfer mode and a MANUAL transfer mode. AUTO means that the program chooses which files are uploaded in ASCII mode and which files are uploaded in Binary mode. MANUAL means that you tell the program which mode to use while uploading. We stongly suggest that you use the MANUAL mode when uploading the E-Blah files to your server. This will ensure that the forum directory is uloaded in ASCII mode, and the blahdocs directory is uploaded in Binary mode.


Step 3 - Set directory and file permissions

Below are two tables. The left table contains a list of the directories and files that you must chmod correctly on UNIX servers. The right table contains the permission settings for a windows server. Not setting these permissions correctly could cause your forum not to function properly. If a directory or file is not included in this list then you do not have to set the permissions!


UNIX CHMOD SETTINGS
DIR / FILE CHMOD COMMENT
/cgi-bin/forum 755 If there is an error then set it to 777
/cgi-bin/forum/Blah.pl 755 -----
/cgi-bin/forum/database.db 666 -----
/cgi-bin/forum/Install.pl 755 -----
/cgi-bin/forum/Settings.pl 666 -----
/cgi-bin/forum/EBlah 755 -----
/cgi-bin/forum/Prefs 777 If there is an error then set it to 755
/cgi-bin/forum/Prefs/cache 777 If there is an error then set it to 755
/cgi-bin/forum/Prefs/Sessions 777 If there is an error then set it to 755
/blahdocs/Random 777 -----
/blahdocs/template 777 CHMOD all sub directories too
/blahdocs/uploads 777 Used for uploading files
/blahdocs/uploads/thumbnails 777 Used for image resizing
WINDOWS SECURITY SETTINGS
DIR / FILE SETTING
/cgi-bin/forum List Folder Contents | Read
/cgi-bin/forum/Blah.pl Read & Execute | Read
/cgi-bin/forum/database.db Write
/cgi-bin/forum/Install.pl Read & Execute | Read
/cgi-bin/forum/Settings.pl Write
/cgi-bin/forum/EBlah Read & Execute | Read
/cgi-bin/forum/Prefs Write
/cgi-bin/forum/Prefs/cache Read | Write
/cgi-bin/forum/Prefs/Sessions Write
/blahdocs/Random Read | Write
/blahdocs/template Write
/blahdocs/uploads Read | Write
/blahdocs/uploads/thumbnails Write


Step 4 - Run the Setup script

Now that you have uploaded and set your directory and file permissions, it is time to run the E-Blah SQL Install Script. To do this, type in the web address to the Install.pl file. Typically, this address is like the one below.

http://www.yoursite.com/cgi-bin/forum/Install.pl

The E-Blah SQL Install script will guide you through the remainder of the installation. When setup is complete, follow the link to your forum and login using the username and the password that you chose during the setup process. If you didn't change the default login information, then your username will be Administrator and your password will be admin. If you did leave the password as admin, you should change it when you first log into your forum for security reasons.


Upgrade to the latest SQL version

This section will guide you through upgrading your current E-Blah SQL forum to the latest version. The latest version of E-Blah is always better than the previous version, and almost always contains bug fixes. For those two reasons, you should always install the latest version when it is realeased. Note that this document does not cover converting your flat file version to the SQL version. That is covered in the Forum Converters document.

Personal tools
Downloads