
CONTENTS OF THIS FILE
---------------------

 * Requirements
 * Installation
 * More Information

REQUIREMENTS
------------

BibAmin requires a web server, PHP (4.3.3 or greater)
 (http://www.php.net/) and  MySQL (http://www.mysql.com/).

NOTE: the Apache web server is the one I've tested;
 other web server and database combinations might work
 with some code changes.


QUICK-INSTALL
------------
   Just edit the parameters.php file and set variables values.


INSTALLATION
------------

1. DOWNLOAD BibAdmin

   You can obtain the latest BibAdmin release from 
   http://gforge.inria.fr/projects/bibadmin/.
   The files are in .tar.gz format and can be extracted using most
   compression tools. On a typical Unix command line, use:

     tar -zxvf bibadmin-x.x.tar.gz

   This will create a new directory bibadmin-x.x/ containing all
   files and directories. Move the contents of that directory
   into a directory within your web server's document root or your
   public HTML directory:

     mv bibadmin-x.x/* /var/www/html

2. CREATE THE BibAdmin DATABASE

   This step is only necessary if you don't already have a database
   set-up (e.g. by your host). If you control your databases through a
   web-based control panel, check its documentation for creating databases,
   as the following instructions are for the command-line only.

  Note: I recommend phpMyAdmin (http://www.phpmyadmin.net/) for DB managing

   These instructions are for MySQL. In the following examples,
   'db_user' is an example MySQL user which has the CREATE and GRANT
   privileges. Use the appropriate user name for your system 
   ('root' for example).

   First, you must create a new database for your BibAdmin site
   (here, 'biblio' is the name of the new database):

     mysqladmin -u db_user -p create biblio

   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:

     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 biblio.*
        TO www_user@localhost IDENTIFIED BY 'password';

   where

    'biblio' is the name of your database
    'www_user@localhost' is the username 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.

3. SET YOUR SCRIPT PARAMETERS

   Edit using your favourite editor (e.g. xemacs) the file parameters.php
   found in your BibAdmin root directory (/var/www/html/bibadmin-x.x).
   

4. CREATE THE BibAdmin TABLES

   Once you have a database, you can access your BibAdmin URL
   (in http://myserver/bibadmin-x.x/).
   
   The main script will ask you to click on a link to create tables.
   Make sure that the MySQL user specified in your parameters.php has
   create table privileges (also SELECT, INSERT, DELETE).

   An administrator account 'admin' will be created when the script
   will create the tables. You must login with this user and set 
   your email and change your default password.
   
   The file fc_team.php contains a function returning the actual members
   of your team. You might wanna edit this file if you want to determine 
   which authors will be indexed (the actual and past team members). If 
   you don't edit this file all new authors inserted when uploading a 
   file or a text will be by default actual team members (indexed). For 
   a reference server (litterature references) you should not edit this file.

5. LOADING PUBLICATIONS

   After you are logged in, go to Add then browse for your .bib file and
   upload it to the server.


IMPORTANT INFORMATION
----------------

   Read the README.txt file.
