MvBlog Installation Guide

Requirements

  • PHP5 (tested with apache2 cgi and apache2 module)
  • PHP5 PostgreSQL module OR
  • PHP5 MySQL module
  • PEAR::DB
  • PEAR::HTTP_Request (optional, needed to send trackbacks)
  • PostgreSQL server (tested with 7.4 and 8.0) OR
  • MySQL server (tested with 5.0.22 and newer)

Installation

MvBlog can be used in 2 ways:

  1. Just one weblog
  2. Service for multiple weblogs on a server

Below you will find the installation guide for both uses.

1. Just one weblog

  • Unpack the .tar.gz in your DocumentRoot.
  • Create a database for the blog. You can also create an optional database-user for the blog-database
  • Import sql/[(mysql)|(postgres)]/mvblog.sql into the blog-database.
  • Edit the common/hosts.php file and fill in the correct user, password and database name.

Database creation and importing the sql file is left as exercise for the user.

Your blog can now be reached at the url associated with the DocumentRoot.

The Admin Interface can be accessed through the admin/folder in your url.

The default admin user/password is mvblog/mvblog I suggest you create a new user and disable the mvblog admin user as soon as possible.

You are now ready to enjoy MvBlog.

2. Service for multiple weblogs on a server

This feature will require more installation steps. Use this method when you think more weblogs will be needed on your webserver, for instance for customers, friends, etc.

As an example, the www.mvblog.org weblog is used, as it is installed and running on a webserver which hosts multiple customers and their blogs. If you want a different filesystem location, use those paths instead of the ones shown here.

  • Unpack the .tar.gz into /var/www/mvblog
  • Create a database user (e.g. mvblog)
  • Create database with a name that reflects the domain/website the blog is running on (e.g. mvblog_mvblog_org)
  • Create a directory that will serve as the DocumentRoot for your blog (e.g. /var/www/domains/mvblog.org/www)
  • Copy the /var/www/mvblog/style directory into the new style directory (e.g. /var/www/domains/mvblog.org/www/style)
  • Copy the /var/www/mvblog/index.php into the new directory
  • Copy the /var/www/mvblog/favicon.ico into the new directory
  • Change to the new directory (cd)
  • Now you will need to create some symlinks. Below are the commands used:

For version 1.0 and before:

$ cd /var/www/domains/mvblog.org/www
$ ln -s /var/www/mvblog/UserFiles
$ ln -s /var/www/mvblog/admin
$ ln -s /var/www/mvblog/common
$ ln -s /var/www/mvblog/fckeditor

For version after 1.0:

$ cd /var/www/domains/mvblog.org/www
$ ln -s /var/www/mvblog/admin
$ ln -s /var/www/mvblog/common
$ ln -s /var/www/mvblog/xinha

  • Edit the common/hosts.php file to list your hostname, etc.
  • Edit your webservers config to enable the domain

Database creation and importing the sql file is left as exercise for the user.

Your blog can now be reached at the url associated with the DocumentRoot.

The Admin Interface can be accessed through the admin/ folder in your url.

The default admin user/password is mvblog/mvblog I suggest you create a new user and disable the mvblog admin user as soon as possible.

You are now ready to enjoy MvBlog.