Changeset 42992

Timestamp:

Apr 22, 2026, 10:00:30 AM (2 weeks ago)

Author:

eugene

Message:

update configure.ac to install apache cgi code

Location:

branches/eam_branches/ipp-pstamp-20260421/DataStoreServer

Files:

• Makefile.am (modified) (1 diff)
• configure.ac (modified) (2 diffs)
• notes.txt (modified) (2 diffs)
• web/cgi/Makefile.am (added)
• web/cgi/dsfsindex (moved) (moved from branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/scripts/dsfsindex )
• web/cgi/dsprodindex (moved) (moved from branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/scripts/dsprodindex )
• web/cgi/dsrootindex (moved) (moved from branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/scripts/dsrootindex )
• web/cgi/index.txt (added)

branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/Makefile.am

@@ -1 @@
-SUBDIRS = scripts
+SUBDIRS = scripts web/cgi
 
 CLEANFILES = *~ core core.*
+
+cgi:
+        $(MAKE) -C web/cgi cgi
+
+install-cgi:
+        $(MAKE) -C web/cgi install-cgi
+
+uninstall-cgi:
+        $(MAKE) -C web/cgi uninstall-cgi
+

branches/eam_branches/ipp-pstamp-20260421/DataStoreServer/configure.ac

@@ -2 +2 @@
 
 AC_INIT([DataStoreServer], [1.0.0], [ipp-support@ifa.hawaii.edu])
+
+# this checks for a working C compiler, but is only needed is
+# we build *.c files, which we do not in DataStoreServer
+# AC_PROG_CC
+
 AC_CONFIG_SRCDIR([scripts])
 
@@ -9 +14 @@
 AC_PROG_INSTALL
 
+AC_ARG_WITH([cgidir],
+  [AS_HELP_STRING([--with-cgidir=DIR],
+                  [directory for CGI programs])],
+  [cgidir="$withval"],
+  [cgidir=""])
+
+AC_ARG_WITH([dsroot],
+  [AS_HELP_STRING([--with-dsroot=DIR],
+                  [directory for web data files])],
+  [dsroot="$withval"],
+  [dsroot=""])
+
+AC_SUBST([cgidir])
+AC_SUBST([dsroot])
+
 AC_CONFIG_FILES([
   Makefile
+  web/cgi/Makefile
   scripts/Makefile
 ])

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
-
-----------
-