--- loncom/build/Makefile 2002/03/03 04:30:00 1.75 +++ loncom/build/Makefile 2004/08/31 18:37:09 1.162.2.11 @@ -1,56 +1,224 @@ # The LearningOnline Network with CAPA -# Scott Harrison -# $Id: Makefile,v 1.75 2002/03/03 04:30:00 harris41 Exp $ +# $Id: Makefile,v 1.162.2.11 2004/08/31 18:37:09 albertel 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="" 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="" - -help: +VERSION=1.2.0 +# The current working definition for "RELEASE" is: changes not in the software, +# but in the operating system dependent packaging of the software. Thus, the +# generic tarball releases do not need to have a release number specified. +RELEASE=1 # As a general rule for now, this is always being set to "1". +DIRTARGET=loncapa-$(VERSION) +LOCALAUTHPATH=/home/httpd/lib/perl + +# =============================================== 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 "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_and_domain_tab: make sure that a " + @echo " loncapa/loncom/hosts.tab and loncapa/loncom/domain.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_and_domain_tab: install the hosts.tab and domain.tab" + @echo " 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 "accesscount_seed: Migrate the access counting mechanism from " + @echo " nohist_reseval.db to nohist_accesscount.db." + @echo "modify_config_files: Perform automatic update of the " + @echo " configuration files for yum and MySQL." + @echo "ntpcheck: test to see if ntp is installed and running." + @echo "cron_lpmlcheck: remove cron file /etc/cron.d/loncapa.lpml." + @echo "rpmcheck: test to see if rpms known to confict are installed." + @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 and" + @echo " /home/httpd/html/lon-status/version.txt" + @echo "aboutVERSION: place version information inside about.html" + @echo " and loncapa_apache.conf" + @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_and_domain_tab: install the hosts.tab and domain.tab" + @echo " 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 "documentation_tree: compiles a documentation tree from the " - @echo " CVS:doc directory" - @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 "RPM: build LON-CAPA-base RPM from CVS repository" - @echo "setup_RPM: build LON-CAPA-setup RPM from CVS repository" - @echo " handy for CD-ROM generation" + @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 "*** AUXILIARY TESTS ***" + @echo "localauth: tests to see if localauth exists or not and run" + @echo " appropriate tests" + @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" @@ -64,37 +232,276 @@ 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 TEST_hosts_tab: @echo "Testing hosts.tab" - @if (test -h ../hosts.tab); then \ - echo "there is a defined link; assume okay"; \ + @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" && \ - echo " 1) cd ../; ln -s production_hosts.tab hosts.tab" && \ - echo " 2) cd ../; ln -s development_hosts.tab hosts.tab" && \ - echo "or 3) cd ../; ln -s rawhide_hosts.tab hosts.tab" && \ + 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 -NET_hosts_tab: - make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \ - MTARGET="hosts_tab" HOSTNAME="$(HOSTNAME)" lpmladm +TEST_domain_tab: + @echo "Testing domain.tab" + @if (test -e ../domain.tab); then \ + echo "there is a defined link or file; assume okay"; \ + else echo "**** ERROR **** domain.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_domain.tab domain.tab" && \ + echo " 2) ln -s development_domain.tab domain.tab" && \ + echo "or 3) ln -s rawhide_domain.tab domain.tab" && \ + echo "(you most likely want option #1, production_domain.tab)" && \ + exit 1; \ + fi + +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 + +# ======================= *** GENERAL TARGETS SUCH AS 'build' AND 'install' *** + +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 + +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="$(SOURCE)" TARGET="$(TARGET)" \ + configfiles + if (test "0" = $(NORESTORECONF)); then \ + perl loncaparestoreconfigurations suffix .lpmlnew; fi + +install: buildflag VERSION TEST_hosts_tab TEST_domain_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 now 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 ../../doc/loncapafiles/loncapafiles.lpml | \ - perl xfml_parse.pl ../../doc/loncapafiles/valid_hosts.xfml | \ +hosts_and_domain_tab: TEST_hosts_tab TEST_domain_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 "If hosts.tab or domain.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) | \ + tee -a WARNINGS + +# ---------------- 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_and_domain_tab' >> $(SOURCE)/UPDATE + echo 'make postinstall' >> $(SOURCE)/UPDATE + echo 'make run_searchcat' >> $(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 + cp -v $(SOURCE)/loncom/loncapa_apache.conf \ + $(SOURCE)/loncom/loncapa_apache.conf.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 + mv -v $(SOURCE)/loncom/loncapa_apache.conf.orig \ + $(SOURCE)/loncom/loncapa_apache.conf + cat $(SOURCE)/tar_WARNINGS | \ + xargs --replace=XXX echo '**** WARNING **** XXX' > WARNINGS + rm -f $(SOURCE)/tar_WARNINGS + make warningnote + +ntpcheck: + cat $(SOURCE)/doc/loncapafiles/ntpcheck.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +cron_lpmlcheck: + cat $(SOURCE)/doc/loncapafiles/cron_lpmlcheck.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + + +rpmcheck: + cat $(SOURCE)/doc/loncapafiles/rpmcheck.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +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) + +run_searchcat: + cat $(SOURCE)/doc/loncapafiles/run_searchcat.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(QUERYLAUNCH) + +accesscount_seed: + cat $(SOURCE)/doc/loncapafiles/accesscount_seed.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +modify_config_files: + cat $(SOURCE)/doc/loncapafiles/modify_config_files.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +reseval_fixup: + cat $(SOURCE)/doc/loncapafiles/reseval_fixup.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +clearoutoldspreadsheetcache: + cat $(SOURCE)/doc/loncapafiles/clearoutoldspreadsheetcache.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 + +ownership_fix: + cat $(SOURCE)/doc/loncapafiles/ownership_fix.piml | \ + perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \ + tee -a WARNINGS + +postinstall: + make webserverconf + make reseval_fixup + make accesscount_seed + make modify_config_files + make clearoutoldspreadsheetcache + make rpmcheck + make ntpcheck + make cron_lpmlcheck + make sanitycheck + make sendmail_fix + make ownership_fix + +VERSION: + install -d $(TARGET)/etc + echo -n "LON-CAPA release $(VERSION)-" > $(TARGET)/etc/loncapa-release + date +"%Y%m%d" >> $(TARGET)/etc/loncapa-release + install -d $(TARGET)/home/httpd/html/lon-status + echo -n "$(VERSION)-" > $(TARGET)/home/httpd/html/lon-status/version.txt + date +"%Y%m%d" >> $(TARGET)/home/httpd/html/lon-status/version.txt + +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 + cat $(SOURCE)/loncom/loncapa_apache.conf | \ + perl -e '$$d=`date +"%Y%m%d"`;chomp($$d);while(<>){s/\<\!\-\- VERSION \-\-\>/$(VERSION)-$$d/; print;}' > \ + $(SOURCE)/loncom/loncapa_apache.conf.new + mv -v $(SOURCE)/loncom/loncapa_apache.conf.new \ + $(SOURCE)/loncom/loncapa_apache.conf + +# ========= *** 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 + +# ============= *** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK *** + lpmladm: @if (test $(METAMTARGET) = "TRANSPORT"); then \ echo "Transporting to $(HOSTNAME)"; \ @@ -125,48 +532,79 @@ lpmladm: echo "**** ERROR **** Incorrect METAMTARGET"; \ fi -HTML: - install -d HTML - cp ../../doc/loncapafiles/*.gif HTML - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl html development default ../.. '' > HTML/index.html - -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 +NET_hosts_and_domain_tab: + make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \ + MTARGET="hosts_and_domain_tab" HOSTNAME="$(HOSTNAME)" lpmladm -statuspost: status - cp ../../doc/loncapafiles/*.gif $(TARGET)/home/httpd/html/lon-status - cp HTML/filestatus.html \ - $(TARGET)/home/httpd/html/lon-status/filestatus.html +NET_webserverconf: + make TIMESTAMP=`date +"%s"` METAMTARGET="LAUNCH" \ + MTARGET="webserverconf" HOSTNAME="$(HOSTNAME)" lpmladm -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 +NET_rawinstall: + make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \ + MTARGET="rawinstall" HOSTNAME="$(HOSTNAME)" lpmladm -rpmstatuspost: rpmstatus - cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html +# ============== *** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES *** -configinstall: Makefile.configinstall - make -f Makefile.configinstall SOURCE="$(SOURCE)" TARGET="$(TARGET)" \ - configfiles - if (test "0" = $(NORESTORECONF)); then \ - perl loncaparestoreconfigurations suffix .lpmlnew; fi +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 + echo 'loncom/production_domain.tab' >> $(SOURCE)/MANIFEST + echo 'loncom/development_domain.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 $(DIST) \ + '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST + cat $(SOURCE)/doc/loncapafiles/testfiles.lpml | \ + perl lpml_parse.pl MANIFEST development $(DIST) \ + '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST + cat $(SOURCE)/doc/loncapafiles/installfiles.lpml | \ + perl lpml_parse.pl MANIFEST development $(DIST) \ + '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ + perl lpml_parse.pl MANIFEST development $(DIST) \ + '$(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 -Makefile.configinstall: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "$(SOURCE)" \ - "$(TARGET)" > Makefile.configinstall +# =============================================== *** STATUS REPORT TARGETS *** warningnote: @if (test -s WARNINGS); then \ @@ -183,157 +621,225 @@ warningnote: echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \ fi -NET_webserverconf: - make TIMESTAMP=`date +"%s"` METAMTARGET="LAUNCH" \ - MTARGET="webserverconf" HOSTNAME="$(HOSTNAME)" lpmladm - -webserverconf: - cat ../../doc/loncapafiles/webserver.piml | \ - perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) - -sanitycheck: - cat ../../doc/loncapafiles/sanitycheck.piml | \ - perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) +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 -postinstall: - make webserverconf - make sanitycheck +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 -install: 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 +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.install: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \ - "$(TARGET)" > Makefile.install +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 -build: Makefile.build pod2html.sh pod2man.sh - echo -n "" > WARNINGS - make -f Makefile.build all - make warningnote +rpmstatuspost: rpmstatus + cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html -Makefile.build: ../../doc/loncapafiles/loncapafiles.lpml lpml_parse.pl - cat ../../doc/loncapafiles/loncapafiles.lpml | \ - perl lpml_parse.pl build $(CATEGORY) $(DIST) "../.." "" > \ - Makefile.build +# ======================================= *** ALTERNATIVE PACKAGING TARGETS *** RPM: BinaryRoot base_rpm_file_list - cat ../../doc/loncapafiles/loncapafiles.lpml | \ + 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 - -setup_RPM: - echo "SetupBinaryRoot/etc/passwd" > setup_rpm_file_list.txt - echo "SetupBinaryRoot/etc/group" >> setup_rpm_file_list.txt - echo "SetupBinaryRoot/etc/hosts.deny" >> setup_rpm_file_list.txt - echo "SetupBinaryRoot/home/www" >> setup_rpm_file_list.txt - echo "SetupBinaryRoot/etc/pam.d/passwd" >> setup_rpm_file_list.txt - echo "SetupBinaryRoot/etc/pam.d/login" >> setup_rpm_file_list.txt - perl setup_rpm_binaryroot.pl - cat setup_rpm_file_list.txt | perl make_rpm.pl setup 3.2 '' '' \ - SetupBinaryRoot customizerpm.xml + cat base_rpm_file_list.txt | perl make_rpm.pl base $(VERSION) \ + $(RELEASE) '' '' BinaryRoot base_customizerpm.xml DPKG: - make TARGET='LON-CAPA-base' NORESTORECONF='1' install + 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 ../../doc/loncapafiles/loncapafiles.lpml | \ + cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \ perl lpml_parse.pl rpm_file_list $(CATEGORY) $(DIST) $(SOURCE) \ 'BinaryRoot' | sort > base_rpm_file_list.txt 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 + @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 ../../doc/icons/[^C][^V]* docs/icons + install -m 0644 $(SOURCE)/doc/icons/[^C][^V]* docs/icons install -m 0755 -d docs/reconfig - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/reconfig.html > docs/reconfig/index.html + 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 ../../doc/build/confexamples/[^C][^V]* \ + install -m 0644 $(SOURCE)/doc/build/confexamples/[^C][^V]* \ docs/reconfig/confexamples - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/installindex.html > docs/index.html + perl doc_template.pl $(SOURCE)/doc/templates/template.html \ + $(SOURCE)/doc/build/installindex.html > docs/index.html install -m 0755 -d docs/license - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/license.html > docs/license/index.html + 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 - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/contact.html > docs/contact/index.html + 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 - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/faq.html > docs/faq/index.html + 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 - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/download.html > docs/downloads/index.html + 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 - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/install.html > docs/install/index.html + 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 - perl doc_template.pl ../../doc/templates/template.html \ - ../../doc/build/upgrade.html > docs/upgrade/index.html + 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 . -documentation_tree: cvsreport - 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 +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: +# ================================================ *** 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 @@ -345,6 +851,44 @@ clean: 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" + +# ===================================================== *** AUXILIARY TESTS *** +localauth: + @if (test -e $(LOCALAUTHPATH)/localauth.pm) && \ + !(diff $(LOCALAUTHPATH)/localauth-std.pm \ + $(LOCALAUTHPATH)/localauth.pm > /dev/null); then \ + echo "**** WARNING **** $(LOCALAUTHPATH)/localauth.pm is different than the $(LOCALAUTHPATH)/localauth-std.pm; if you have not customized localauth.pm, then please manually overwrite localauth.pm (rm $(LOCALAUTHPATH)/localauth.pm; ln -s $(LOCALAUTHPATH)/localauth-std.pm $(LOCALAUTHPATH)/localauth.pm); if you have customized localauth.pm, then please double-check to see that your customized localauth.pm is compatible with any localauth-std.pm changes for this version of LON-CAPA"| tee -a WARNINGS; \ + elif (test -e $(LOCALAUTHPATH)/localauth.pm) && \ + (diff $(LOCALAUTHPATH)/localauth-std.pm \ + $(LOCALAUTHPATH)/localauth.pm > /dev/null); then \ + echo "**** NOTE **** LOCAL AUTH IS IDENTICAL WITH STANDARD TEMPLATE"| tee -a WARNINGS; \ + elif !(test -e $(LOCALAUTHPATH)/localauth.pm) && \ + (test -e $(LOCALAUTHPATH)/localauth-std.pm); then \ + ln -s $(LOCALAUTHPATH)/localauth-std.pm $(LOCALAUTHPATH)/localauth.pm; \ + fi + +# ================================================ *** A HELPFUL DEPENDENCY *** +alwaysrun: