Changeset 42992 for branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/notes.txt

Timestamp:

Apr 22, 2026, 10:00:30 AM (3 months ago)

Author:

eugene

Message:

update configure.ac to install apache cgi code

File:

• branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/notes.txt (modified) (2 diffs)

branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/notes.txt

@@ +1 @@
+
+How to create a new installation of the IPP datastore:
+
+* create a database to host the relevant tables:
+  * create a mysql user:
+  > create user 'ipp'@'localhost' identified by 'XXX'
+  > grant all on *.* to 'ipp'@'localhost'
+
+  * in mysql, create the test database:
+  > create database datastore;
+
+  * create the tables:
+  # mysql -h localhost -u ipp -p datastore < scripts/tabledefs.sql
+
+  This generates the tables needed by the datastore web pages and tools
+
+* in 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 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
+
+==============================================================
+
+* datastore apache elements consist of CGI scripts and the directory hierarchy for data products
+
+* Things to be installed in ds-cgi:
+  * dsindex.cgi
+  * dstxtindex.cgi
+  * dsgetindex
+  * dsfsindex
+  * dsprodindex
+  * dsrootindex
+  * dsshellconfig -- NEEDS to be modified to define the configuration
+
+* Things needed in the user build by the apache server:
+  * dsdbh.pm in PERL
+  * DBD/mysql.pm
+
+* Things installed as user tools:
+  * dsreg
+  * dsprodtool
+
+*
+
+----------
 
 Here is the current (2026.04.11) directory listing of /export/ipp113.0/datastore/ds-cgi:
@@ -48 +104 @@
 ---------
 
-How to set up a local database to host the IPP datastore:
-
-* create a database to host the relevant tables:
-  in mysql, create the test database:
-  > create database test_datastore;
-  create the tables:
-  # mysql -h localhost -u ipp -p test_datastore < scripts/tabledefs.sql
-
-  This generates the tables needed by the datastore web pages and tools
-
-----------
-