--- loncom/build/Makefile 2002/01/06 04:23:11 1.52 +++ loncom/build/Makefile 2002/10/13 17:35:04 1.136 @@ -1,45 +1,205 @@ # The LearningOnline Network with CAPA -# Scott Harrison -# $Id: Makefile,v 1.52 2002/01/06 04:23:11 harris41 Exp $ +# Scott Harrison, your friendly neighborhood volunteer +# $Id: Makefile,v 1.136 2002/10/13 17:35:04 harris41 Exp $ -DIST="default" +# TYPICAL USAGE of this Makefile is primarily for two targets: +# "make build" and "make install". +# Many other targets and features are supported (see the initial +# help targets). + +# ======================================= Default settings for Makefile options +DISTPROBE=`perl ./distprobe` +DIST=$(DISTPROBE) CATEGORY="development" -SOURCE="../.." +SOURCE=../.. TARGET="" - -all: +NORESTORECONF="0" +HOSTNAME="" +LAUNCH=| perl +QUERYLAUNCH=> /tmp/loncapa_query.pl; perl /tmp/loncapa_query.pl +OUTSTREAM=> +SAVE=program.pl.$(TIMESTAMP) +LAUNCHSAVE=$(OUTSTREAM) $(SAVE) +METAMTARGET="" +MTARGET="" +VERSION=0.5 +DIRTARGET=loncapa-$(VERSION) + +# =============================================== Help targets for the Makefile +# If 'make' is run without any arguments, the 'help' target is called since +# it is the first target. +help: @echo "*** You need to specify a valid target ***" - @echo "NOTE: You can specify options to your Makefile target." - @echo "(option) DIST can be redhat7.1, debian, redhat6.2, or default" - @echo "(option) CATEGORY can be runtime or development" - @echo "(option) SOURCE is an absolute or relative directory path" - @echo "(option) TARGET is an absolute or relative directory path" - @echo "(option) DIST can be redhat7.1, debian, redhat6.2, or default" - @echo "build: compile the CVS source tree" - @echo "install: install from a compiled CVS source tree to a " - @echo " specified TARGET destination on the filesystem" - @echo "test: test different parts of the LON-CAPA system (TEST_*)" - @echo "TEST_lpml_scripts: make sure that the system can process " - @echo " the Linux Packaging Markup Language" + @echo "To get a list of valid targets: \"make help_TARGETS\"" + @echo "To get a list of valid options: \"make help_OPTIONS\"" + @echo " " + @echo "Typically invoked targets are:" + @echo " make build" + @echo " make install" + @echo " make test" + @echo " make clean" + +help_OPTIONS: + @echo "* ADJUSTABLE OPTIONS *" + @echo "(option) DIST can be redhat7, debian, redhat6.2, or default" + @echo " You probably do not need to specify this; it is" + @echo " automatically probed for." + @echo "(option) CATEGORY can be 'runtime' or 'development'; currently" + @echo " the 'development' setting is the most reliable;" + @echo " eventually, production machines should be using the" + @echo " 'runtime' settings" + @echo "(option) SOURCE is an absolute or relative directory path." + @echo " SOURCE corresponds to the root directory of the" + @echo " loncapa source release" + @echo "(option) TARGET is an absolute or relative directory path." + @echo " This is where files will be installed on your system." + @echo " Typically, this should be set to nothing (which" + @echo " corresponds to the '/' root of the entire filesystem)." + @echo "(option) NORESTORECONF, when set to a non-zero value, stops" + @echo " filesystem upgrades from overwriting existing " + @echo " configuration files. Ordinarily, NORESTORECONF=0, " + @echo " because the existing configuration files are safely" + @echo " dealt with (or so one hopes... :) )." + @echo "(option) HOSTNAME specifies the name of a remote server for" + @echo " which a NET_* Makefile target should be launched" + @echo "(option) VERSION; especially useful for the 'tardist' target" + @echo " this tags the tarball file and internal directories" + @echo " with a specific version string (conventionally " + @echo " numeric)" + +help_TARGETS: + @echo "*** RUNNING TESTS TO ENSURE SOLID PERFORMANCE ***" + @echo "test: test different parts of the LON-CAPA system (TEST_*)." + @echo " Makefile-dependent processes as well as horizontal and" + @echo " vertical aspects of the LON-CAPA system architecture" + @echo " are all tested." + @echo "TEST_lpml_scripts: make sure that the system can process" + @echo " the Linux Packaging Markup Language." + @echo " This is neither horizontal or vertical" + @echo " testing. The idea is to make sure that" + @echo " the installation software itself works" + @echo " as expected." @echo "TEST_system_dependencies: make sure that all needed system " @echo " components are active and present " @echo " on the server such as perl modules" @echo " and the MySQL database" - @echo "TEST_web_layer: mimic a login and various system actions on " + @echo " (horizontal testing)" + @echo "TEST_web_layer: mimic a login and various vertical actions on " @echo " a LON-CAPA system" + @echo "TEST_hosts_tab: make sure that a loncapa/loncom/hosts.tab" + @echo " file is specified for installation" + @echo "TEST_html2ps: test for the presence of html2ps which is needed" + @echo " for making a PDF compilation for pdfdoc" + @echo "*** GENERAL TARGETS SUCH AS 'build' AND 'install' ***" + @echo "build: compile the source tree" + @echo "buildflag: a semaphore that helps educate the user to run" + @echo " 'make build' first before running 'make install'" + @echo "configinstall: install configuration files and restore with" + @echo " prior information" + @echo "install: install from a ***compiled*** source tree" + @echo " (see make build) to a specified TARGET destination" + @echo " on the filesystem (default setting is TARGET=/)." + @echo "rawinstall: just install files, links and directories without" + @echo " any bells or whistles (e.g. double-checking" + @echo " configurations, fine-tuning webserver, etc.)" + @echo "hosts_tab: install the hosts.tab to the filesystem" + @echo "webserverconf: fine-tune the web server configuration;" + @echo " make sure the proper 'Include' statements" + @echo " are appended to httpd.conf" + @echo "vanillatar: generate top-level files such as README, UPDATE," + @echo " CHECKRPMS, and TEST (needed by tardist)" + @echo "tardist: build a tarball that will upgrade the software on a " + @echo " system" + @echo "sanitycheck: probe for common errors and recommend fixes to" + @echo " the user" + @echo "updatequery: solicit the user for machine configuration" + @echo " information; to be incorporated during an update" + @echo " procedure (via the UPDATE command)" + @echo "postinstall: double-check things after installation" + @echo "VERSION: tag the filesystem with version information inside" + @echo " /etc/loncapa-release" + @echo "aboutVERSION: place version information inside about.html" + @echo "*** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml ***" + @echo "Makefile.configinstall: generate a Makefile for configuration" + @echo " files; built dynamically from" + @echo " loncapafiles.lpml" + @echo "Makefile.build: generate a Makefile for compiling" + @echo " files inside the source directory; " + @echo " Makefile.build is generated from" + @echo " loncapafiles.lpml" + @echo "Makefile.install: generate a Makefile for installing" + @echo " files; built dynamically from" + @echo " loncapafiles.lpml" + @echo "*** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK ***" + @echo "lpmladm: coordinates username=lpmladm mediated secure shell" + @echo " processes; needed for the NET_* targets" + @echo "NET_hosts_tab: install the hosts.tab to a filesystem elsewhere" + @echo " on the network" + @echo "NET_webserverconf: fine-tune the web server configuration on a" + @echo " filesystem elsewhere on the network" + @echo "NET_rawinstall: launch the rawinstall target on a filesystem" + @echo " elsewhere on the network" + @echo "*** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES ***" + @echo "MANIFEST_all: generate a list of all files to be included in" + @echo " the distributed tarball" + @echo "MANIFEST_cvs: essentially a list of all CVS/Entries files used" + @echo " for 'time-checking' intelligence" + @echo "MANIFEST_lpml: a list of all LON-CAPA files to be installed," + @echo " compile from, used as building software, and" + @echo " testing" + @echo "MANIFEST_vanillatar: 'README'-type top-level files that a user" + @echo " of the distributed tarball would first" + @echo " look at and work with" + @echo "*** STATUS REPORT TARGETS ***" + @echo "warningnote: analyze the WARNINGS file and produce a synopsis" + @echo " and recommended action to the user" @echo "HTML: generate an HTML-formatted description of the LON-CAPA" - @echo " CVS files" - @echo "status: compare the TARGET filesystem with a compiled CVS " + @echo " source files" + @echo "status: compare the TARGET filesystem with a compiled loncapa " @echo " source directory" @echo "statuspost: post the results of "make status" to " @echo " TARGET/home/httpd/html/lon-status/filestatus.html" @echo "rpmstatus: compare the rpms on a system to defined lists " - @echo " CVS:doc/otherfiles/cd_rpms and " - @echo " CVS:doc/otherfiles/rpm_list.txt" - @echo "rpmstatuspost: post the results of "make rpmstatus" to " + @echo " loncapa/doc/otherfiles/cd_rpms and " + @echo " loncapa/doc/otherfiles/rpm_list.txt" + @echo "rpmstatuspost: post the results of 'make rpmstatus' to " @echo " TARGET/home/httpd/html/lon-status/rpmstatus.html" - @echo "cvsreport: look at the latest changes over the last week" + @echo "*** ALTERNATIVE PACKAGING TARGETS ***" + @echo "RPM: build LON-CAPA-base RPM from loncapa source repository" + @echo " (still under development)" + @echo "DPKG: build a loncapa Debian package from loncapa source" + @echo " repository (still under development)" + @echo "base_rpm_file_list: create a file listing to be used for" + @echo " generating an RPM software package" + @echo "BinaryRoot: create a BinaryRoot directory to be used for" + @echo " generating an RPM software package" + @echo "*** MASTER DOCUMENTATION TARGETS ***" + @echo "doc: generate web-page documentation for install.lon-capa.org" + @echo " (and eventually for documentation on installed machines)" + @echo "pdfdoc: make a PDF-formatted compilation of all installation" + @echo " documentation" + @echo "*** KEEPING THINGS CLEAN ***" + @echo "clean: remove any files that might (even by remote chance)" + @echo " interfere with rebuilding/recompiling software" + @echo "reallyclean: remove all files that were generated during" + @echo " building or compilation of the software" + @echo "uninstall: remove all directories that do not contain files" + @echo " from other software packages and that do not contain" + @echo " student and instructor data; NOTE THAT THIS IS" + @echo " INTERACTIVE--you will be given a final chance" + @echo " to look at what will and will not be deleted." + @echo " Still, be careful. This is a very new target and is" + @echo " an alpha-level software feature for now." + @echo "backup: rolls a tarball backup of all important student and " + @echo " instructor data (NOT YET IMPLEMENTED)" + @echo "restore: reseeds a LON-CAPA server with tarball backups " + @echo " generated by \"make backup\" (NOT YET IMPLEMENTED)" + @echo "*** A HELPFUL DEPENDENCY ***" + @echo "alwaysrun: blank target that is a dependency for targets" + @echo " that should \"always run\"" + +# =========================== *** RUNNING TESTS TO ENSURE SOLID PERFORMANCE *** test: TEST_lpml_scripts TEST_system_dependencies TEST_web_layer @echo "ALL SYSTEM DEPENDENCY TESTS SUCCESSFUL" @@ -53,48 +213,299 @@ TEST_lpml_scripts: cd ../test; perl filecomparetest.pl TEST_web_layer: - @echo "Testing of web layers is not yet implemented." + @echo "TESTING WEB LAYER" + cd weblayer_test; make -HTML: - install -d HTML - cp ../../doc/loncapafiles/*.gif HTML - perl parse.pl ../../doc/loncapafiles/loncapafiles.html HTML > \ - HTML/index.html +TEST_hosts_tab: + @echo "Testing hosts.tab" + @if (test -e ../hosts.tab); then \ + echo "there is a defined link or file; assume okay"; \ + else echo "**** ERROR **** hosts.tab not defined!" && \ + echo -n "You need to do one of the following within your " && \ + echo "CVS repository (cd loncapa/loncom)" && \ + echo " 1) ln -s production_hosts.tab hosts.tab" && \ + echo " 2) ln -s development_hosts.tab hosts.tab" && \ + echo "or 3) ln -s rawhide_hosts.tab hosts.tab" && \ + echo "(you most likely want option #1, production_hosts.tab)" && \ + exit 1; \ + fi -status: - install -d HTML - cp ../../doc/loncapafiles/*.gif HTML - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl html $(CATEGORY) $(DIST) "../.." "" | \ - perl lpml_html_posteval.pl > \ - HTML/filestatus.html +TEST_html2ps: + @if (test -e /usr/local/html2ps/bin/html2ps); then \ + echo "I can find html2ps; assume okay"; \ + else \ + echo "**** ERROR **** cannot find /usr/local/html2ps/bin/html2ps!" && \ + echo "Please visit http://www.tdb.uu.se/~jan/html2ps.html" && \ + exit 1; \ + fi -statuspost: status - cp ../../doc/loncapafiles/*.gif $(TARGET)/home/httpd/html/lon-status - cp HTML/filestatus.html \ - $(TARGET)/home/httpd/html/lon-status/filestatus.html +# ======================= *** GENERAL TARGETS SUCH AS 'build' AND 'install' *** -rpmstatus: - install -d RPMSTATUS - rpm -qa --queryformat \ - '%{NAME}\t%{VERSION}\t%{RELEASE}\t%{BUILDTIME}\n' | sort > \ - RPMSTATUS/current.tmp - cat ../../doc/otherfiles/cd_rpms.txt > RPMSTATUS/standard.tmp - cat ../../doc/otherfiles/rpm_list.txt > RPMSTATUS/expected.tmp - perl rpmparse.pl RPMSTATUS/standard.tmp RPMSTATUS/current.tmp \ - RPMSTATUS/expected.tmp > RPMSTATUS/rpmstatus.html +build: Makefile.build pod2html.sh pod2man.sh + install -d $(SOURCE)/doc/man + install -d $(SOURCE)/doc/scripts + install -d $(SOURCE)/doc/lib/perl/Apache + echo -n "" > WARNINGS + make -f Makefile.build all + echo '1' > buildflag + make warningnote -rpmstatuspost: rpmstatus - cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html +buildflag: + @echo "**** ERROR **** You need to run 'make build' first" > WARNINGS + make warningnote + @need_to_run_make_build_first 2>/dev/null configinstall: Makefile.configinstall - make -f Makefile.configinstall SOURCE="../.." TARGET="" configfiles - perl loncaparestoreconfigurations suffix .lpmlnew + make -f Makefile.configinstall SOURCE="$(SOURCE)" TARGET="$(TARGET)" \ + configfiles + if (test "0" = $(NORESTORECONF)); then \ + perl loncaparestoreconfigurations suffix .lpmlnew; fi + +install: buildflag VERSION TEST_hosts_tab Makefile.install Makefile + echo -n "" > WARNINGS + make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \ + directories + make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files + make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links + make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \ + NORESTORECONF="$(NORESTORECONF)" configinstall + make postinstall + make warningnote + echo "You can run 'make test' to see if your system is ready to go!" + echo "NOTE THAT YOUR SYSTEM MUST HAVE MYSQL WITH A USER=\"www\" AND" + echo -n "PASSWORD=\"localhostkey\" FOR www\@localhost" + echo -n "(YOU MAY NEED TO REINITIALIZE YOUR MYSQL www\@localhost USER)" + echo -n "Please see http://install.lon-capa.org/ for more information" + +rawinstall: VERSION Makefile.install Makefile + echo -n "" > WARNINGS + make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \ + directories + make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files + make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links + make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \ + NORESTORECONF="$(NORESTORECONF)" configinstall + +hosts_tab: TEST_hosts_tab + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl xfml_parse.pl $(SOURCE)/doc/loncapafiles/valid_hosts.xfml | \ + perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \ + "$(TARGET)" > Makefile.install + make -f Makefile.install directories + make -f Makefile.install files + @echo "If hosts.tab has changed, restart httpd and loncontrol:" + @echo " /etc/rc.d/init.d/httpd restart" + @echo " /etc/rc.d/init.d/loncontrol restart" + +webserverconf: + cat $(SOURCE)/doc/loncapafiles/webserver.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) + +# ---------------- Top-level files such as README, UPDATE, CHECKRPMS, and TEST +vanillatar: + # --------------------------- Point UPDATE to the internal make process + echo '#!/bin/sh' > $(SOURCE)/UPDATE + echo 'touch loncom/build/WARNINGS' >> $(SOURCE)/UPDATE; + echo 'ln -s loncom/build/WARNINGS WARNINGS' >> $(SOURCE)/UPDATE; + echo 'cd loncom/build; make build' >> $(SOURCE)/UPDATE + echo 'make rawinstall' >> $(SOURCE)/UPDATE + echo 'make configinstall' >> $(SOURCE)/UPDATE + echo 'make updatequery' >> $(SOURCE)/UPDATE + echo 'make hosts_tab' >> $(SOURCE)/UPDATE + echo 'make postinstall' >> $(SOURCE)/UPDATE + echo 'make aboutVERSION' >> $(SOURCE)/UPDATE + echo 'make warningnote' >> $(SOURCE)/UPDATE + # ----------------------------- Point TEST to the internal make process + echo '#!/bin/sh' > $(SOURCE)/TEST + echo 'cd loncom/build; make test' >> $(SOURCE)/TEST + echo 'cd system_dependencies || cd loncom/build/system_dependencies; cp -v CPAN_STATUS_REPORT ../../../CPAN_STATUS_REPORT' >> $(SOURCE)/TEST + # ----------------------------- Copy CHECKRPMS to the vanilla top-level + cp -v $(SOURCE)/loncom/build/CHECKRPMS $(SOURCE)/CHECKRPMS + # ----------------------- vanilla executables must indeed be executable + chmod a+rx $(SOURCE)/UPDATE + chmod a+rx $(SOURCE)/TEST + chmod a+rx $(SOURCE)/CHECKRPMS + # -------------------------------- Copy README to the vanilla top-level + cp -v $(SOURCE)/doc/shortest_path_redhat7.2.txt $(SOURCE)/README + +tardist: + make MANIFEST_all + make vanillatar + # -------------------------------------------------------- Make tardist + @cd $(SOURCE); \ + if (test -h $(DIRTARGET)); then \ + echo "$(DIRTARGET) link already defined; assume okay"; \ + else \ + ln -s . $(DIRTARGET); \ + fi + cp -v $(SOURCE)/loncom/license/about.html \ + $(SOURCE)/loncom/license/about.html.orig + make aboutVERSION + cd $(SOURCE); \ + tar --no-recursion --numeric-owner --files-from MANIFEST \ + -h -czf $(DIRTARGET).tar.gz 2>tar_WARNINGS || [ "0" == "0" ] + mv -v $(SOURCE)/loncom/license/about.html.orig \ + $(SOURCE)/loncom/license/about.html + cat $(SOURCE)/tar_WARNINGS | \ + xargs --replace=XXX echo '**** WARNING **** XXX' > WARNINGS + rm -f $(SOURCE)/tar_WARNINGS + make warningnote + +sanitycheck: + cat $(SOURCE)/doc/loncapafiles/sanitycheck.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +updatequery: + cat $(SOURCE)/doc/loncapafiles/updatequery.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(QUERYLAUNCH) + +reseval_fixup: + cat $(SOURCE)/doc/loncapafiles/reseval_fixup.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +sendmail_fix: + cat $(SOURCE)/doc/loncapafiles/sendmail_fix.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +postinstall: + make webserverconf + make reseval_fixup + make sanitycheck + make sendmail_fix + +VERSION: + install -d $(TARGET)/etc + echo -n "LON-CAPA release $(VERSION)-" > $(TARGET)/etc/loncapa-release + date +"%Y%m%d" >> $(TARGET)/etc/loncapa-release + +aboutVERSION: + cat $(SOURCE)/loncom/license/about.html | \ + perl -e '$$d=`date +"%Y%m%d"`;chomp($$d);while(<>){s/\<\!\-\- VERSION \-\-\>/$(VERSION)-$$d/; print;}' > \ + $(SOURCE)/loncom/license/about.html.new + mv -v $(SOURCE)/loncom/license/about.html.new \ + $(SOURCE)/loncom/license/about.html + +# ========= *** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml *** + +Makefile.configinstall: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml \ + lpml_parse.pl + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "$(SOURCE)" \ + "$(TARGET)" > Makefile.configinstall + +Makefile.build: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml lpml_parse.pl + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl build $(CATEGORY) $(DIST) "$(SOURCE)" "$(TARGET)" \ + > Makefile.build + +Makefile.install: alwaysrun + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \ + "$(TARGET)" > Makefile.install -Makefile.configinstall: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "../.." "" > \ - Makefile.configinstall +# ============= *** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK *** + +lpmladm: + @if (test $(METAMTARGET) = "TRANSPORT"); then \ + echo "Transporting to $(HOSTNAME)"; \ + sudo make DIST=$(DIST) CATEGORY=$(CATEGORY) \ + SOURCE="$(SOURCE)" \ + TARGET="lpmladm.$(TIMESTAMP)" \ + NORESTORECONF="$(NORESTORECONF)" "$(MTARGET)"; \ + cd lpmladm.$(TIMESTAMP); \ + sudo tar czvf ../tarball$(TIMESTAMP).tar.gz .; \ + cd ..; scp tarball$(TIMESTAMP).tar.gz \ + lpmladm@$(HOSTNAME):~/tarball$(TIMESTAMP).tar.gz; \ + ssh lpmladm@$(HOSTNAME) sudo mv tarball$(TIMESTAMP).tar.gz /; \ + ssh lpmladm@$(HOSTNAME) sudo tar -x -z -v -C / \ + -p --same-owner -f \ + /tarball$(TIMESTAMP).tar.gz; \ + ssh lpmladm@$(HOSTNAME) sudo rm -f \ + /tarball$(TIMESTAMP).tar.gz; \ + elif (test $(METAMTARGET) = "LAUNCH"); then \ + echo "Launching process on $(HOSTNAME)"; \ + LAUNCHSAVE=$(OUTSTREAM) $(SAVE); \ + make DIST=$(DIST) CATEGORY=$(CATEGORY) SOURCE="$(SOURCE)" \ + TARGET="$(TARGET)" NORESTORECONF="$(NORESTORECONF)" \ + LAUNCH="$(LAUNCHSAVE)" "$(MTARGET)"; \ + scp $(SAVE) lpmladm@$(HOSTNAME):~/$(SAVE); \ + ssh lpmladm@$(HOSTNAME) sudo perl $(SAVE); \ + ssh lpmladm@$(HOSTNAME) sudo rm -f $(SAVE); \ + else \ + echo "**** ERROR **** Incorrect METAMTARGET"; \ + fi + +NET_hosts_tab: + make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \ + MTARGET="hosts_tab" HOSTNAME="$(HOSTNAME)" lpmladm + +NET_webserverconf: + make TIMESTAMP=`date +"%s"` METAMTARGET="LAUNCH" \ + MTARGET="webserverconf" HOSTNAME="$(HOSTNAME)" lpmladm + +NET_rawinstall: + make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \ + MTARGET="rawinstall" HOSTNAME="$(HOSTNAME)" lpmladm + +# ============== *** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES *** + +MANIFEST_all: + # --------------------------------------------------------- start clean + rm -f $(SOURCE)/MANIFEST + make MANIFEST_lpml + make MANIFEST_vanillatar + make MANIFEST_cvs + # ---------------------------------- might as well include the MANIFEST + echo 'MANIFEST' >> $(SOURCE)/MANIFEST + # ------------------------------------------ hosts.tab are belong to us + echo 'loncom/rawhide_hosts.tab' >> $(SOURCE)/MANIFEST + echo 'loncom/production_hosts.tab' >> $(SOURCE)/MANIFEST + echo 'loncom/development_hosts.tab' >> $(SOURCE)/MANIFEST + # ------------------ Files needed for dynamically generated directories + echo 'doc/man' >> $(SOURCE)/MANIFEST + echo 'doc/lib' >> $(SOURCE)/MANIFEST + echo 'doc/lib/perl' >> $(SOURCE)/MANIFEST + echo 'doc/lib/perl/Apache' >> $(SOURCE)/MANIFEST + echo 'doc/scripts' >> $(SOURCE)/MANIFEST + # --------------------------------------------------- Clean up MANIFEST + cd $(SOURCE); \ + sort MANIFEST | perl -nle 'print "$(DIRTARGET)/$$_"' | \ + perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \ + perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \ + perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \ + perl -nle 's/\/\.\//\//g;print' | sort | uniq > \ + MANIFEST_loncapa + cd $(SOURCE); mv -v MANIFEST_loncapa MANIFEST + +# --------------- MANIFEST files with important CVS versioning/date information +MANIFEST_cvs: + # ------ CVS/Entries directories to retain 'time-checking' intelligence + cd $(SOURCE); find . -type f -name 'Entries' | grep 'CVS/Entries' >> \ + MANIFEST + +# ------------------- MANIFEST the building, testing and standard loncapa files +MANIFEST_lpml: + cat $(SOURCE)/doc/loncapafiles/buildfiles.lpml | \ + perl lpml_parse.pl MANIFEST development default \ + '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST + cat $(SOURCE)/doc/loncapafiles/testfiles.lpml | \ + perl lpml_parse.pl MANIFEST development default \ + '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl MANIFEST development default \ + '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST + +# ------------ Files for top-level (the vanilla layer that the user first sees) +MANIFEST_vanillatar: + echo 'README' >> $(SOURCE)/MANIFEST + echo 'UPDATE' >> $(SOURCE)/MANIFEST + echo 'TEST' >> $(SOURCE)/MANIFEST + echo 'CHECKRPMS' >> $(SOURCE)/MANIFEST + +# =============================================== *** STATUS REPORT TARGETS *** warningnote: @if (test -s WARNINGS); then \ @@ -108,153 +519,262 @@ warningnote: echo "!!!! Please read the WARNINGS file !!!!"; \ echo "!!!! to make sure everything is !!!!"; \ echo "!!!! correct and taken care of !!!!"; \ - echo "!!!! (it is output below here) !!!!"; \ echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \ - cat WARNINGS; \ fi -install: Makefile.install Makefile - echo -n "" > WARNINGS - make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \ - directories - make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files - make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links - make configinstall - make warningnote +HTML: + install -d HTML + cp $(SOURCE)/doc/loncapafiles/*.gif HTML + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl html development default "$(SOURCE)" '$(TARGET)' \ + > HTML/index.html -Makefile.install: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \ - "$(TARGET)" > Makefile.install +status: + install -d HTML + cp $(SOURCE)/doc/loncapafiles/*.gif HTML + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl html $(CATEGORY) $(DIST) "$(SOURCE)" "($TARGET)" | \ + perl lpml_html_posteval.pl > \ + HTML/filestatus.html -build: Makefile.build pod2html.sh pod2man.sh - echo -n "" > WARNINGS - make -f Makefile.build all - make warningnote +statuspost: status + cp $(SOURCE)/doc/loncapafiles/*.gif \ + $(TARGET)/home/httpd/html/lon-status + cp HTML/filestatus.html \ + $(TARGET)/home/httpd/html/lon-status/filestatus.html -Makefile.build: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl build $(CATEGORY) $(DIST) "../.." "" > \ - Makefile.build - -RPM: BinaryRoot - cat base_file_list.txt | perl make_rpm.pl base 3.1 '' '' BinaryRoot - cat setup_file_list.txt | perl make_rpm.pl setup 3.1 '' '' BinaryRoot - -BinaryRoot: - perl parse.pl ../../doc/loncapafiles/loncapafiles.html BinaryRoot - -loncapaconfig: - rm -Rf LoncapaconfigRoot - install -d LoncapaconfigRoot/usr/src/ - install -d LoncapaconfigRoot/usr/lib/python1.5/site-packages - install /usr/lib/python1.5/site-packages/kudzumodule.so \ - LoncapaconfigRoot/usr/lib/python1.5/site-packages/kudzumodule.so - cd LoncapaconfigRoot/usr/src; cp -pR /mnt/drive/loncapaconfig . - install -d LoncapaconfigRoot/usr/sbin - @echo -e "#!/bin/sh\ncd /usr/src/loncapaconfig/usr/bin; \ - ./loncapaconfig\n" > LoncapaconfigRoot/usr/sbin/loncapaconfig - chmod u+x LoncapaconfigRoot/usr/sbin/loncapaconfig - find LoncapaconfigRoot -type d | xargs chmod o-wxr - find LoncapaconfigRoot -type f | xargs chmod o-wxr - find LoncapaconfigRoot/ -type d | grep 'src/lon' > \ - loncapaconfig_file_list.txt - find LoncapaconfigRoot/ -type d | grep \ - '^LoncapaconfigRoot/usr/lib/python1.5/site-packages' >> \ - loncapaconfig_file_list.txt - find LoncapaconfigRoot/ -type f >> loncapaconfig_file_list.txt - cat loncapaconfig_file_list.txt | perl make_rpm.pl loncapaconfig 3.1 \ - '' '' LoncapaconfigRoot - cp LON-CAPA-loncapaconfig-3.1-1.i386.rpm \ - /mnt/drive/install.lon-capa.org/3.1/currentcdsource/RedHat/RPMS/. +rpmstatus: + install -d RPMSTATUS + rpm -qa --queryformat \ + '%{NAME}\t%{VERSION}\t%{RELEASE}\t%{BUILDTIME}\n' | sort > \ + RPMSTATUS/current.tmp + cat $(SOURCE)/doc/otherfiles/cd_rpms.txt > RPMSTATUS/standard.tmp + cat $(SOURCE)/doc/otherfiles/rpm_list.txt > RPMSTATUS/expected.tmp + perl rpmparse.pl RPMSTATUS/standard.tmp RPMSTATUS/current.tmp \ + RPMSTATUS/expected.tmp > RPMSTATUS/rpmstatus.html + +rpmstatuspost: rpmstatus + cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html + +# ======================================= *** ALTERNATIVE PACKAGING TARGETS *** + +RPM: BinaryRoot base_rpm_file_list + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl make_rpm $(CATEGORY) $(DIST) $(SOURCE) $(TARGET) \ + > base_customizerpm.xml + cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 '' '' \ + BinaryRoot base_customizerpm.xml + +DPKG: + make TARGET='lon-capa-$(VERSION)' NORESTORECONF='1' install + @echo "You will next need to follow instructions at:" + @echo "http://people.debian.org/~jaldhar/make_package1.html" + @echo "A directory with a snapshot of the debian package files" + @echo "is LON-CAPA-base." +# What DPKG steps need to happen (for future implementation): +# export EMAIL="" ... probably sharrison@mail.lon-capa.org +# deb-make +# edit debian/control +# make debian/dirs file +# make debian/copyright file +# debian/README.debian... point them to LON-CAPA URLS +# debian/changelog +# debian/conffiles +# debuild +# and maybe do some GPG-related steps around here + +base_rpm_file_list: + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl rpm_file_list $(CATEGORY) $(DIST) $(SOURCE) \ + 'BinaryRoot' | sort > base_rpm_file_list.txt -install.lon-capa.org: cvsreport +BinaryRoot: base_rpm_file_list + make TARGET='BinaryRoot' NORESTORECONF='1' install + +# ======================================== *** MASTER DOCUMENTATION TARGETS *** + +# Generates CVS:loncom/build/docs; root location of install.lon-capa.org +doc: install -d docs - install ../../doc/build/cvsreport.html docs/cvsreport.html - install ../../doc/build/doc.html docs/index.html - install -d docs/hardware - install ../../doc/hardware/hardware.html docs/hardware/hardware.html - install -d docs/3.1 - install ../../doc/build/install.html docs/3.1/index.html - install ../../doc/build/instructions_with_cd.html \ - docs/3.1/instructions_with_cd.html - install ../../doc/build/libraryserverconfiguration.gif \ - docs/3.1/libraryserverconfiguration.gif - install ../../doc/build/librarysystemsettings.gif \ - docs/3.1/librarysystemsettings.gif - install -d docs/cvsupgrade - install ../../doc/build/cvsupgrade.html docs/cvsupgrade/index.html - install -d docs/upgrade - install ../../doc/build/upgrade.html docs/upgrade/index.html - install -d docs/reconfig - install ../../doc/build/reconfig.html docs/reconfig/index.html - install -d docs/3.1/otherfiles - install ../../doc/otherfiles/rpm_list.txt \ - docs/3.1/otherfiles/rpm_list.txt - install ../../doc/build/loncapanetwork.html docs/loncapanetwork.html - install ../../doc/build/loncapanfs.html docs/loncapanfs.html - install ../../doc/build/loncapaappleshares.html \ - docs/loncapaappleshares.html - install ../../doc/build/loncapasqldatabase.html \ - docs/loncapasqldatabase.html - install ../../doc/build/loncapapasswords.html \ - docs/loncapapasswords.html - install ../../doc/build/loncapapasswordauthentication.html \ - docs/loncapapasswordauthentication.html - install ../../doc/build/loncapatimesync.html docs/loncapatimesync.html - install ../../doc/build/loncapamathequivalency.html \ - docs/loncapamathequivalency.html - tar czvf install.lon-capa.org_docs.tar.gz docs - rm -Rf docs + @if (test -e installation_manual.pdf); then \ + cp -vf installation_manual.pdf docs/.; \ + else \ + touch docs/installation_manual.pdf; \ + fi + install -m 0755 -d docs/icons + install -m 0644 $(SOURCE)/doc/icons/[^C][^V]* docs/icons + install -m 0755 -d docs/reconfig + cd docs; ln -fs installation_manual.pdf index.pdf + cd docs/reconfig; ln -fs ../installation_manual.pdf index.pdf + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/reconfig.html > docs/reconfig/index.html + install -m 0755 -d docs/reconfig/confexamples + install -m 0644 $(SOURCE)/doc/build/confexamples/[^C][^V]* \ + docs/reconfig/confexamples + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/installindex.html > docs/index.html + install -m 0755 -d docs/license + cd docs/license; ln -fs ../installation_manual.pdf index.pdf + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/license.html > docs/license/index.html + install -m 0755 -d docs/contact + cd docs/contact; ln -fs ../installation_manual.pdf index.pdf + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/contact.html > docs/contact/index.html + install -m 0755 -d docs/faq + cd docs/faq; ln -fs ../installation_manual.pdf index.pdf + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/faq.html > docs/faq/index.html + install -m 0755 -d docs/downloads + cd docs/downloads; ln -fs ../installation_manual.pdf download.pdf + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/download.html > docs/downloads/index.html + install -m 0755 -d docs/install + cd docs/install; ln -fs ../installation_manual.pdf install.pdf + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/install.html > docs/install/index.html + cp -v $(SOURCE)/doc/install/redhat7.3/new_install_rh73.html \ + docs/install/rh73.html + cp -v $(SOURCE)/doc/install/redhat7.3/new_install_rh73.html \ + docs/downloads/rh73.html + install -m 0755 -d docs/upgrade + cd docs/upgrade; ln -fs ../installation_manual.pdf upgrade.pdf + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/upgrade.html > docs/upgrade/index.html + cd docs; tar czvpf ../docs.tar.gz . + +pdfdoc: TEST_html2ps + install -d pdfdoc + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/installindex_noform.html > pdfdoc/installindex.ps + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/reconfig.html | \ + perl -nle 's/\[EXAMPLE\]/\[EXAMPLE \(at end of document\)\]/g;print' \ + > pdfdoc/reconfig.ps + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/install.html > pdfdoc/install.ps + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/upgrade.html > pdfdoc/upgrade.ps + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/faq.html > pdfdoc/faq.ps + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/download.html > pdfdoc/download.ps + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/contact.html > pdfdoc/contact.ps + /usr/local/html2ps/bin/html2ps -D \ + $(SOURCE)/doc/build/license.html > pdfdoc/license.ps +# This creates a bad confexamples.ps... so take the long way around +# cd $(SOURCE)/doc/build/confexamples; \ +# mpage -P- -1 -H [^C]* > ../../../loncom/build/pdfdoc/confexamples.ps + install -d pdfdoc/confexamples + cd $(SOURCE)/doc/build/confexamples; \ + find . -type f | cut -b3- | grep -v '^C' | grep -v 'keyword' | \ + perl -nle \ + '`mpage -P- -1 -H $$_ > ../../../loncom/build/pdfdoc/confexamples/$$_.ps`;' + echo '' > pdfdoc/contents.txt + echo '' >> pdfdoc/contents.txt + echo ' The Learning Online Network' >> pdfdoc/contents.txt + echo ' with the' >> pdfdoc/contents.txt + echo ' Computer-Assisted Personalized Approach' >> \ + pdfdoc/contents.txt + echo '' >> pdfdoc/contents.txt + echo '' >> pdfdoc/contents.txt + echo 'CONTENTS' >> pdfdoc/contents.txt + echo '--------' >> pdfdoc/contents.txt + echo 'Opening' >> pdfdoc/contents.txt + echo 'Configuration' >> pdfdoc/contents.txt + echo 'Installation' >> pdfdoc/contents.txt + echo 'Upgrading a LON-CAPA Server' >> pdfdoc/contents.txt + echo 'FAQ' >> pdfdoc/contents.txt + echo 'Download' >> pdfdoc/contents.txt + echo 'Contact Information' >> pdfdoc/contents.txt + echo 'License Information' >> pdfdoc/contents.txt + echo 'Configuration Examples' >> pdfdoc/contents.txt + mpage -P- -1 \ + pdfdoc/contents.txt \ + pdfdoc/installindex.ps \ + pdfdoc/reconfig.ps \ + pdfdoc/install.ps \ + pdfdoc/upgrade.ps \ + pdfdoc/faq.ps \ + pdfdoc/download.ps \ + pdfdoc/contact.ps \ + pdfdoc/license.ps \ + pdfdoc/confexamples/*.ps \ + > pdfdoc/installation_manual.ps + ps2pdf pdfdoc/installation_manual.ps pdfdoc/installation_manual.pdf + mv -vf pdfdoc/installation_manual.pdf . -cvsreport: - # Header - echo "
Number of altered files:" >> ../../doc/build/cvsreport.html - cd ../..; cvs log -d ">`date --date='8 days ago' +\"%Y-%m-%d\"`" \ - loncom CAPA doc packaging 2>/dev/null | perl \ - loncom/build/cvsfilter.pl | grep '^Working file:' | cut -b15- | \ - wc -l >> doc/build/cvsreport.html - # Listing of Altered Files - echo "
Altered files:
" >> \ - ../../doc/build/cvsreport.html - cd ../..; cvs log -d ">`date --date='8 days ago' +\"%Y-%m-%d\"`" \ - loncom CAPA doc packaging 2>/dev/null | \ - perl loncom/build/cvsfilter.pl | grep '^Working file:' | cut -b15- \ - >> doc/build/cvsreport.html - # Log entries for loncom - echo "
Log entries for loncom:
" >> \ - ../../doc/build/cvsreport.html - cd ../../loncom; cvs log -d ">`date --date='8 days ago' \ - +\"%Y-%m-%d\"`" . 2>/dev/null | perl ../loncom/build/cvsfilter.pl >> \ - ../doc/build/cvsreport.html - # Log entries for CAPA - echo "
Log entries for CAPA:
" >> \ - ../../doc/build/cvsreport.html - cd ../../CAPA; cvs log -d ">`date --date='8 days ago' \ - +\"%Y-%m-%d\"`" . 2>/dev/null | perl ../loncom/build/cvsfilter.pl >> \ - ../doc/build/cvsreport.html - # Log entries for doc - echo "
Log entries for doc:
" >> \ - ../../doc/build/cvsreport.html - cd ../../doc; cvs log -d ">`date --date='8 days ago' \ - +\"%Y-%m-%d\"`" . 2>/dev/null | perl ../loncom/build/cvsfilter.pl >> \ - ../doc/build/cvsreport.html - # Log entries for packaging - echo "
Log entries for packaging:
" >> \ - ../../doc/build/cvsreport.html - cd ../../packaging; cvs log -d ">`date --date='8 days ago' \ - +\"%Y-%m-%d\"`" . 2>/dev/null | perl ../loncom/build/cvsfilter.pl >> \ - ../doc/build/cvsreport.html - echo "" >> ../../doc/build/cvsreport.html +# ================================================ *** KEEPING THINGS CLEAN *** clean: + rm -f buildflag + rm -Rf HTML + rm -f installation_manual.pdf + rm -f Makefile.build + rm -f Makefile.install + rm -f Makefile.configinstall + rm -Rf BinaryRoot + rm -Rf SetupBinaryRoot + rm -Rf LON-CAPA-base + rm -f base_rpm_file_list.txt + rm -f base_customizerpm.xml + rm -f setup_rpm_file_list.txt + rm -f docs.tar.gz + rm -Rf docs + rm -Rf pdfdoc + rm -f program.pl* + rm -Rf lpmladm.* + rm -f WARNINGS + rm -f CPAN_STATUS_REPORT + rm -f $(SOURCE)/loncom/build/hosts.tab + +reallyclean: + rm -f buildflag + rm -f $(SOURCE)/README + rm -f $(SOURCE)/UPDATE + rm -f $(SOURCE)/TEST + rm -f $(SOURCE)/MANIFEST + rm -f $(SOURCE)/MANIFEST_loncapa + rm -f $(SOURCE)/loncapa + rm -f $(SOURCE)/loncom/build/hosts.tab + rm -f $(SOURCE)/loncapa.tar.gz rm -Rf HTML + rm -f installation_manual.pdf rm -f Makefile.build rm -f Makefile.install + rm -f Makefile.configinstall + rm -Rf BinaryRoot + rm -Rf SetupBinaryRoot + rm -Rf LON-CAPA-base + rm -f base_rpm_file_list.txt + rm -f base_customizerpm.xml + rm -f setup_rpm_file_list.txt + rm -f docs.tar.gz + rm -Rf docs + rm -Rf pdfdoc + rm -f program.pl* + rm -Rf lpmladm.* + make -f Makefile.cvs clean + rm -f WARNINGS + +uninstall: + rm -f UNINSTALL_SHELL_COMMANDS + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl uninstall_shell_commands $(CATEGORY) $(DIST) \ + "$(SOURCE)" "$(TARGET)" > UNINSTALL_SHELL_COMMANDS + @echo -n "**** NOTE **** A file \"UNINSTALL_SHELL_COMMANDS\" has been " + @echo "generated." + @echo "First, you should view the contents of this file." + @echo "If you are happy with the 'rm -Rf'! commands (or at least" + @echo "have another job lined up in case of catastrophe), then you " + @echo "can execute the following: sh ./UNINSTALL_SHELL_COMMANDS" + +backup: + @echo "Not yet implemented" + +restore: + @echo "Not yet implemented" + +# ================================================ *** A HELPFUL DEPENDENCY *** +alwaysrun: