Installation guide

1. Download Batavi

You can obtain the latest Batavi release from: http://sourceforge.net/projects/batavi/
Copy the tar.bz2 file into a working directory e.g.

 
$ cp batavi-*.tar.bz2 /tmp/batavi/

Change to the working directory e.g.

$ cd /tmp/batavi/

Extract the files e.g.

$ tar -xjvf batavi-*.tar.bz2

This will extract all Batavi files and directories. Move the contents of that directory into a directory within your web server's document root or your public HTML directory e.g.

$ mv /tmp/batavi/ /var/www/html

Alternatively if you downloaded the file to your computer and unpacked it locally use a FTP program to upload all files to your server. Make sure all PHP, HTML, CSS and JS files are sent in ASCII mode and image files (GIF, JPG, PNG) in BINARY mode.

2. Create Batavi Database

Batavi will currently only work with MySQL. In the following examples, "db_user" is an example MySQL user which has the CREATE and GRANT privileges. You will need to use the appropriate user name for your system. First, you must create a new database for your Batavi site e.g.

    $ mysqladmin -u db_user -p create batavi

MySQL will prompt for the 'db_user' database password and then create the initial database files. Next you must login and set the access database rights e.g.

   $ mysql -u db_user -p

Again, you will be asked for the 'db_user' database password. At the MySQL prompt, enter following command:

   GRANT ALL PRIVILEGES ON batavi.* TO nobody@localhost IDENTIFIED BY 'password';
   GRANT FILE ON *.* TO nobody@localhost IDENTIFIED BY 'password';

where:

   'batavi' is the name of your database
   'nobody@localhost' is the userid of your webserver MySQL account
   'password' is the password required to log in as the MySQL user

If successful, MySQL will reply with

   Query OK, 0 rows affected

to activate the new permissions you must enter the command

   FLUSH PRIVILEGES;

and then enter '\q' to exit MySQL. Alternatively you can use your web control panel or phpMyAdmin to create a database for Batavi.

3. Web installer

Finally point your web browser to http://www.mysite.com where the Batavi web based installer will guide you through the rest of the installation. Web-installation of Batavi e-commerce software is easy and should take only 10-15 minutes. It basically, consists of 3 major steps:

3.1. Web installer. Step 1

In order to begin the installation wizard, please, click 'Install' button.

You will be asked about your web-server configuration, but in 90% of the cases, default values will work okay.

3.2. Web installer. Step 2

On a second installer page, you will be required to enter MySQL database details.
(The database creation procedure is explained in point 2 of this guide).
Please, use MySQLi option (the default one) - as it will increase the performance on most configurations.

After entering all the required fields, please, hold on a bit and take a cup of coffee.
Database is being imported.

3.3. Web installer. Step 3

On a step 3 you will be asked about basic shop details. Here you will be able to create first administrating user. We do not recommend to skip import of sample data as it will populate the shop with basic demo configuration and will make start of using Batavi much easier.

After entering all the required fields, please, hold on a bit and take a cup of coffee.
Demo content for your webshop is being imported.

You should see the 'Success' message if all the steps were performed correct.

4. Configure Batavi

You can now launch your browser and point it to your Batavi site e.g.

   http://www.mysite.com -> Main Site
   http://www.mysite.com/admin -> Admin

5. Batavi Administration

Upon a new installation, your Batavi website defaults to a very basic configuration with only a few active components and modules. Use Admin to install and configure additional boxes, add users, select default language and much more.