Installing BitBlog

Download Here

1. Information Gathering
   First there is some information you are going to need to know. If you do not have this information allready then contact your hosting provider or system administrator. The following database information is needed
   • Data Base hostname -> The hostname of the MySQL machine
   • Data Base Name -> The Name of the database you wish to use
   • Data Base Username -> The username needed for connecting to the MySQL db.
   • Data Base password -> The password needed for connecting to the MySQL db.
   The second bit of information you need is the path to where you are going to install the main libraries that make up the BitBlog package. This is not the web path, it's the directory path on the server itself. This does NOT need to be in your httpdocs folder unless the server config is set with base directory restrictions. If possible this is in fact the recommended route. If you are unsure of the absolute path you can drop the following bit of code in a php file in your httpdocs folder and view it in a browser

   <?= getcwd(); ?>

   This should give you the path to your httpdocs folder and should look something like this

   /usr/vhosts/bitdamaged.com/httpdocs

2. Download/Unzip
   Now that you have this information, download the current bitBlog.zip or bitBlog.tar.gz file, uncompress and upload to the desired directory. While doing the ftp within the bitblog folder there is a file named "install.sql" save this to your local machine.
3. CHMOD
   PHP Files do not usually need to be chmod'd but you may need to modify the mogrify executable with in the magick folder (bitblog/magick/mogrify) to 755
4. Database Configuration
   This is perhaps the most difficult part of the installation. These instructions are for use with the phpMyAdmin tool. Ask your server administrator if you have this package installed. Otherwise you will have to configure the database from the command line I'm working on a tool to do this but it is currently unavailible.
   1. Login to phpmyadmin.
   2. Select your database
   3. Use the "browse" button next to the field that says "Or Location of the textfile :" to select the install.sql file you saved to your local machine.
   4. Press the "GO" button.
   You should now get a "Your SQL-query has been executed successfully" message (hopefully).
5. Configuration Settings
   Now download the file "config.php" from your bitblog directory.
   In this file you need to set the following settings
   • $base_path this is the absolute server filepath to the bitblog folder ususally something like

     /usr/vhosts/bitdamaged.com/bitblogs

   • $image_path the absolute server filepath to your images directory ususally something like

     /usr/vhosts/bitdamaged.com/httpdocs/images

   • $css_path the absolute server filepath to your css directory ususally something like

     /usr/vhosts/bitdamaged.com/httpdocs/css

   • $images_url The web url of your images directory (same as in an img tag) ususally something like

     /images

   • $css_url The web url of your images directory (same as in an img tag) ususally something like

     /css

   • secret This is a random string used for password encryption, set it and forget it NOTE: Changing this once BitBlog is installed will kill ALL passwords
   • db_host The hostname of your database (get from webhost/sysadmin)
   • db_name The name of your database (get from webhost/sysadmin)
   • db_user The username for your database (get from webhost/sysadmin)
   • db_pwd The password for your database (get from webhost/sysadmin)
   There are a few more settings that can be modified but this is the base set. Once done editing re-upload this file to your bitblog directory.
6. Index.php
   Now download and edit the index.php file from the bitblog directory. You need to reset the value in the first require_once setting to point to your config file. It should be the same as your basepath /config.php.

   Once done with that, reupload the file to wherever you want your blog to live in you httpdocs folder (if this is not in the same place you put the bitblog directory you can delete the index.php file there).

7. Login
   This is going to change -mike Now login by pointing your browser to the place you put index.php with the following in the query string:

   ?page=admin

   it should look like this:

   http://wherever.com/weblog/index.php?page=admin

   The default username is: superman default password is: 1superman1

   After logging in select the "user" menu item, select "superman" and change the username and password.

Begin Blogging!