Contact developer File a bug or feature request                                                     RSS

Installation

  • Windows Xampp All-In-One Version
  • Short instructions:

    1) Unzip xampplite-plasmidb_all-in-one.zip in C:\.
    Plasmi::db is now installed!

    Detailed instructions:

    1) Download xampplite-plasmidb_all-in-one.zip
    2) Unzip the file plasmidb-xampplite-all_in_one.zip in C:\
    3) Go to C:\xampplite
    4) Click on xampp-control (Fig1.png)
    5) The control panel should open. Click on "start" for apache and for Mysql (Fig2.png).
    6) Go to http://localhost/plasmidb/
    7) Log in with the username: "test@example.com", password: "password". Everything should now work (Fig3.png)
    (The database is empty apart from one item I added just to show you how it works.)

  • Unix / Linux / MacOS X
  • Download the latest release, consisting of a the PHP web interface and SQL to provide the underlying database. 

    Short Instructions

    1) You can find the PHP web interface here: Plasmidb-0.9.1.zip

    2) Download the empty database, which is here: plasmidb.sql

    3) Untar the web interface & put it under your Apache DOCUMENT_ROOT, for example:
    % tar -zxvf Plasmidb-0.9.1.zip
    % mv Plasmidb/* /var/www/html
    4) Install the MySQL database & make sure its running (see below for more detailed instructions)

    5) Install the SQL database:
    % mysql -u root
    mysql> CREATE DATABASE plasmidb2_development;
    mysql> quit;
    % mysql -u root -c plasmidb2_development < plasmidb.sql

    6) Create plasmidb users with passwords (e.g. using PHPMyAdmin).
    There is a 'guest' user with password 'guest' in the example database.

    7) Check the file "plasmidb/config/db.conf" and "plasmidb/config/app.conf" to make sure the passwords and directories are set up properly

    8) Install PEAR packages from the command line:
    $ sudo pear help 
    $ sudo pear channel-update pear.php.net
    $ sudo pear install DB # things should downloading and installing automatically
    $ sudo pear install DB_DataObject
    $ sudo pear install HTML_Table
    $ sudo pear install HTML_QuickForm
    

    9) Browse to http://localhost/plasmidb/ to log in and start adding information.

    Long Instructions

    Install the web server, php and mod_php

    $ apt-get install php5-cli php-pear php5 php5-mysqli php5-common libapache2-mod-php5 mysql-server
    

    Install PEAR components (http:\\pear.php.net\)

    $ sudo pear help # allows us to see how to get started
    $ sudo pear channel-update pear.php.net 
    $ sudo pear install DB # things should downloading and installing automatically
    $ sudo pear install DB_DataObject
    $ sudo pear install HTML_Table
    $ sudo pear install HTML_QuickForm
    

    Download everything (from CVS this time!)

    $ sudo apt-get install cvs
    $ cvs -d:pserver:anonymous@plasmidb.cvs.sourceforge.net:/cvsroot/plasmidb login
    $ cvs -z3 -d:pserver:anonymous@plasmidb.cvs.sourceforge.net:/cvsroot/plasmidb co -P plasmidb
    $ cvs -z3 -d:pserver:anonymous@plasmidb.cvs.sourceforge.net:/cvsroot/plasmidb co -P Phly
    $ cvs -z3 -d:pserver:anonymous@plasmidb.cvs.sourceforge.net:/cvsroot/plasmidb co -P Bio
    $ cvs -z3 -d:pserver:anonymous@plasmidb.cvs.sourceforge.net:/cvsroot/plasmidb co -P Html
    $ cd plasmidb/config
    $ vi db.conf # Set up your DB information & password here
    $ vi app.conf # Check that the directories are set up OK
    

    Set up the DB in MySQL

    $ mysql -u root
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 7 to server version: 5.0.22-Debian_0ubuntu6.06.2-log
    
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
    
    mysql> create DATABASE plasmidb2_development;
    Query OK, 1 row affected (0.02 sec)
    
    mysql> Bye # Control-D exits mysql
    
    $mysql -u root  plasmidb2_development < ~/plasmidb_dev.sql
    

    If you have problems installing PEAR components, here is a good introduction from O'Reilly.