
How to create a new installation of the IPP DATASTORE:

* Build an installation of the IPP code, e.g.:
  # psconfig ipp-pstamp
  * sets the build / install environment for code below which does not go into
    the apache server cgi location

* Create a database to host the relevant tables:
  * create a mysql user (this is needed generically for all IPP tools):
  > create user 'ipp'@'localhost' identified by 'XXX'
  > grant all on *.* to 'ipp'@'localhost'

  * in mysql, create the DATASTORE database:
  > create database datastore;

  Note: the database name, user, etc can be arbitrary but they must
  match the entries in site.config such as DS_DBNAME.  

  * create the tables:
  # mysql -h localhost -u ipp -p datastore < IPP/DataStoreServer/scripts/tabledefs.sql

  This generates the tables needed by the datastore web pages and tools

* in IPP/psconfig, to install additional perl libraries needed by PSTAMP & DATASTORE:
  # pscheckperl pstamp-ubuntu -build

* in IPP/DataStoreServer, to install the apache CGI elements:
  # ./autogen.sh --with-cgidir=/MY/DATASTORE/ds-cgi --with-dsroot=/MY/DATASTORE/dsroot
  # make cgi
  * then edit /MY/DATASTORE/ds-cgi/dsshellconfig
    ** supply the perl path of the user built to support the datastore
    ** supply the database server information
    ** supply the dsroot location

* install the apache vhost configuration file:
  * NOTE: this likely needs root access
  * cp IPP/DataStoreServer/web/conf/ubuntu-datastore.conf /etc/apache2/sites-available
  * edit to match location of datastore/dsroot and ds-cgi
  * enable the new site (a2ensite)
  * enable required modules: rewrite, cgi, includes
  * start or restart the apache server

