Configuration of BES Modules: Difference between revisions

From OPeNDAP Documentation
⧼opendap2-jumptonavigation⧽
mNo edit summary
mNo edit summary
Line 39: Line 39:
using the trusty cut and paste and prefixing them all with 'modules/'
using the trusty cut and paste and prefixing them all with 'modules/'
* autotest tests are special...
* autotest tests are special...
** Make a bes.conf.modules.in from bes.conf.in
** Hack it so that it uses lines like the following:
<source lang="bash">
BES.modules=dap,cmd,csv
BES.module.dap=@abs_top_builddir@/dap/.libs/libdap_module.so
BES.module.cmd=@abs_top_builddir@/xmlcommand/.libs/libdap_xml_module.so
BES.module.csv=@abs_top_builddir@/modules/csv_handler/.libs/libcsv_module.so
BES.Catalog.catalog.RootDirectory=@abs_top_srcdir@/modules/csv_handler
</source>
** Modify the bes configure so that it builds bes.conf using the bes.conf.moduels.in if DAP_MODULES is true
** modify the Makefile.am so it does not write the bes.conf
** modify the handler's configure.ac so that it makes the bes.conf from the bes.conf.in (preserves the local build)
* Scan the module's configure.ac and transfer any tests the Makefile.am will need to the bes' configure.ac
* Scan the module's configure.ac and transfer any tests the Makefile.am will need to the bes' configure.ac

Revision as of 23:14, 21 November 2014

Under construction 11/20/14

Use the 'modules' branch of 'bes'

For each module to be added:

  • check it out in the bes/modules dir using "submodule add <github repo>"
  • Add it to modules/Makefile.am
  • Hack the module's Makefile.am so that CPPFLAGS and LIBADD reference the correct places given that the code will build w/o bes first being installed
if DAP_MODULES
AM_CPPFLAGS = -I$(top_srcdir)/dispatch -I$(top_srcdir)/dap $(DAP_CFLAGS)
LIBADD = $(DAP_SERVER_LIBS) $(DAP_CLIENT_LIBS)
else
AM_CPPFLAGS = $(BES_CPPFLAGS) # or wahtever was set here or in ..._CPPFLAGS
LIBADD = $(BES_DAP_LIBS)      # and ..._LIBADD
endif

then

# comment this out to force use of AM_CPPFLAGS libcsv_module_la_CPPFLAGS = ...
libcsv_module_la_LIBADD = $(LIBADD)
  • For unit-test code you may need to add some of the bes code to the link line. To do that, use the shell variables:
    • BES_DISPATCH_LIB
    • BES_XML_CMD_LIB
    • BES_PPT_LIB
    • BES_EXTRA_LIBS

where you almost certainly want to use $BES_DISPATCH_LIB $BES_EXTRA_LIBS

  • Add "AM_CONDITIONAL([DAP_MODULES], [false])" to the modules configure.ac
  • Add files to be build by configure:
    modules/dap-server/Makefile
    modules/dap-server/asciival/Makefile
    modules/dap-server/asciival/unit-tests/Makefile
    modules/dap-server/asciival/unit-tests/test_config.h
    modules/dap-server/www-interface/Makefile])
    AC_CONFIG_FILES([modules/dap-server/www-interface/js2h.pl], [chmod +x modules/dap-server/www-interface/js2h.pl])

using the trusty cut and paste and prefixing them all with 'modules/'

  • autotest tests are special...
    • Make a bes.conf.modules.in from bes.conf.in
    • Hack it so that it uses lines like the following:
BES.modules=dap,cmd,csv
BES.module.dap=@abs_top_builddir@/dap/.libs/libdap_module.so
BES.module.cmd=@abs_top_builddir@/xmlcommand/.libs/libdap_xml_module.so
BES.module.csv=@abs_top_builddir@/modules/csv_handler/.libs/libcsv_module.so

BES.Catalog.catalog.RootDirectory=@abs_top_srcdir@/modules/csv_handler
    • Modify the bes configure so that it builds bes.conf using the bes.conf.moduels.in if DAP_MODULES is true
    • modify the Makefile.am so it does not write the bes.conf
    • modify the handler's configure.ac so that it makes the bes.conf from the bes.conf.in (preserves the local build)
  • Scan the module's configure.ac and transfer any tests the Makefile.am will need to the bes' configure.ac