Annotation of loncom/build/Makefile, revision 1.129
1.48 harris41 1: # The LearningOnline Network with CAPA
2:
1.129 ! harris41 3: # Scott Harrison, your friendly neighborhood volunteer
! 4: # $Id: Makefile,v 1.128 2002/07/19 18:54:41 harris41 Exp $
1.1 harris41 5:
1.129 ! harris41 6: # TYPICAL USAGE of this Makefile is primarily for two targets:
! 7: # "make build" and "make install".
! 8: # Many other targets and features are supported (see the initial
! 9: # help targets).
! 10:
! 11: # ======================================= Default settings for Makefile options
1.79 harris41 12: DISTPROBE=`perl ./distprobe`
13: DIST=$(DISTPROBE)
1.39 harris41 14: CATEGORY="development"
1.80 harris41 15: SOURCE=../..
1.51 harris41 16: TARGET=""
1.55 harris41 17: NORESTORECONF="0"
1.66 harris41 18: HOSTNAME=""
19: LAUNCH=| perl
1.106 harris41 20: QUERYLAUNCH=> /tmp/loncapa_query.pl; perl /tmp/loncapa_query.pl
1.66 harris41 21: OUTSTREAM=>
22: SAVE=program.pl.$(TIMESTAMP)
23: LAUNCHSAVE=$(OUTSTREAM) $(SAVE)
24: METAMTARGET=""
25: MTARGET=""
1.124 albertel 26: VERSION=0.4
1.126 harris41 27: DIRTARGET=loncapa-$(VERSION)
1.12 harris41 28:
1.129 ! harris41 29: # =============================================== Help targets for the Makefile
! 30: # If 'make' is run without any arguments, the 'help' target is called since
! 31: # it is the first target.
1.105 harris41 32: help:
1.52 harris41 33: @echo "*** You need to specify a valid target ***"
1.129 ! harris41 34: @echo "To get a list of valid targets: \"make help_TARGETS\""
! 35: @echo "To get a list of valid options: \"make help_OPTIONS\""
! 36: @echo " "
! 37: @echo "Typically invoked targets are:"
! 38: @echo " make build"
! 39: @echo " make install"
! 40: @echo " make test"
! 41: @echo " make clean"
! 42:
! 43: help_OPTIONS:
! 44: @echo "* ADJUSTABLE OPTIONS *"
1.105 harris41 45: @echo "(option) DIST can be redhat7, debian, redhat6.2, or default"
1.129 ! harris41 46: @echo " You probably do not need to specify this; it is"
! 47: @echo " automatically probed for."
! 48: @echo "(option) CATEGORY can be 'runtime' or 'development'; currently"
! 49: @echo " the 'development' setting is the most reliable;"
! 50: @echo " eventually, production machines should be using the"
! 51: @echo " 'runtime' settings"
! 52: @echo "(option) SOURCE is an absolute or relative directory path."
! 53: @echo " SOURCE corresponds to the root directory of the"
! 54: @echo " loncapa source release"
! 55: @echo "(option) TARGET is an absolute or relative directory path."
! 56: @echo " This is where files will be installed on your system."
! 57: @echo " Typically, this should be set to nothing (which"
! 58: @echo " corresponds to the '/' root of the entire filesystem)."
! 59: @echo "(option) NORESTORECONF, when set to a non-zero value, stops"
! 60: @echo " filesystem upgrades from overwriting existing "
! 61: @echo " configuration files. Ordinarily, NORESTORECONF=0, "
! 62: @echo " because the existing configuration files are safely"
! 63: @echo " dealt with (or so one hopes... :) )."
! 64: @echo "(option) HOSTNAME specifies the name of a remote server for"
! 65: @echo " which a NET_* Makefile target should be launched"
! 66: @echo "(option) VERSION; especially useful for the 'tardist' target"
! 67: @echo " this tags the tarball file and internal directories"
! 68: @echo " with a specific version string (conventionally "
! 69: @echo " numeric)"
! 70:
! 71: help_TARGETS:
! 72: @echo "*** RUNNING TESTS TO ENSURE SOLID PERFORMANCE ***"
! 73: @echo "test: test different parts of the LON-CAPA system (TEST_*)."
! 74: @echo " Makefile-dependent processes as well as horizontal and"
! 75: @echo " vertical aspects of the LON-CAPA system architecture"
! 76: @echo " are all tested."
! 77: @echo "TEST_lpml_scripts: make sure that the system can process"
! 78: @echo " the Linux Packaging Markup Language."
! 79: @echo " This is neither horizontal or vertical"
! 80: @echo " testing. The idea is to make sure that"
! 81: @echo " the installation software itself works"
! 82: @echo " as expected."
1.52 harris41 83: @echo "TEST_system_dependencies: make sure that all needed system "
84: @echo " components are active and present "
85: @echo " on the server such as perl modules"
86: @echo " and the MySQL database"
1.129 ! harris41 87: @echo " (horizontal testing)"
! 88: @echo "TEST_web_layer: mimic a login and various vertical actions on "
1.52 harris41 89: @echo " a LON-CAPA system"
1.129 ! harris41 90: @echo "TEST_hosts_tab: make sure that a loncapa/loncom/hosts.tab"
! 91: @echo " file is specified for installation"
! 92: @echo "TEST_html2ps: test for the presence of html2ps which is needed"
! 93: @echo " for making a PDF compilation for pdfdoc"
! 94: @echo "*** GENERAL TARGETS SUCH AS 'build' AND 'install' ***"
! 95: @echo "build: compile the source tree"
! 96: @echo "buildflag: a semaphore that helps educate the user to run"
! 97: @echo " 'make build' first before running 'make install'"
! 98: @echo "configinstall: install configuration files and restore with"
! 99: @echo " prior information"
! 100: @echo "install: install from a ***compiled*** source tree
! 101: @echo " (see make build) to a specified TARGET destination"
! 102: @echo " on the filesystem (default setting is TARGET=/)."
! 103: @echo "rawinstall: just install files, links and directories without"
! 104: @echo " any bells or whistles (e.g. double-checking"
! 105: @echo " configurations, fine-tuning webserver, etc.)"
! 106: @echo "hosts_tab: install the hosts.tab to the filesystem"
! 107: @echo "webserverconf: fine-tune the web server configuration;"
! 108: @echo " make sure the proper 'Include' statements"
! 109: @echo " are appended to httpd.conf"
! 110: @echo "vanillatar: generate top-level files such as README, UPDATE,"
! 111: @echo " CHECKRPMS, and TEST (needed by tardist)"
! 112: @echo "tardist: build a tarball that will upgrade the software on a "
! 113: @echo " system"
! 114: @echo "sanitycheck: probe for common errors and recommend fixes to"
! 115: @echo " the user"
! 116: @echo "updatequery: solicit the user for machine configuration"
! 117: @echo " information; to be incorporated during an update"
! 118: @echo " procedure (via the UPDATE command)"
! 119: @echo "postinstall: double-check things after installation"
! 120: @echo "VERSION: tag the filesystem with version information inside"
! 121: @echo " /etc/loncapa-release"
! 122: @echo "aboutVERSION: place version information inside about.html"
! 123: @echo "*** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml ***"
! 124: @echo "Makefile.configinstall: generate a Makefile for configuration"
! 125: @echo " files; built dynamically from"
! 126: @echo " loncapafiles.lpml"
! 127: @echo "Makefile.build: generate a Makefile for compiling"
! 128: @echo " files inside the source directory; "
! 129: @echo " Makefile.build is generated from"
! 130: @echo " loncapafiles.lpml"
! 131: @echo "Makefile.install: generate a Makefile for installing"
! 132: @echo " files; built dynamically from"
! 133: @echo " loncapafiles.lpml"
! 134: @echo "*** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK ***"
! 135: @echo "lpmladm: coordinates username=lpmladm mediated secure shell"
! 136: @echo " processes; needed for the NET_* targets"
! 137: @echo "NET_hosts_tab: install the hosts.tab to a filesystem elsewhere"
! 138: @echo " on the network"
! 139: @echo "NET_webserverconf: fine-tune the web server configuration on a"
! 140: @echo " filesystem elsewhere on the network"
! 141: @echo "NET_rawinstall: launch the rawinstall target on a filesystem"
! 142: @echo " elsewhere on the network"
! 143: @echo "*** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES ***"
! 144: @echo "MANIFEST_all: generate a list of all files to be included in"
! 145: @echo " the distributed tarball"
! 146: @echo "MANIFEST_cvs: essentially a list of all CVS/Entries files used"
! 147: @echo " for 'time-checking' intelligence"
! 148: @echo "MANIFEST_lpml: a list of all LON-CAPA files to be installed,
! 149: @echo " compile from, used as building software, and"
! 150: @echo " testing"
! 151: @echo "MANIFEST_vanillatar: 'README'-type top-level files that a user"
! 152: @echo " of the distributed tarball would first"
! 153: @echo " look at and work with"
! 154: @echo "*** STATUS REPORT TARGETS ***"
! 155: @echo "warningnote: analyze the WARNINGS file and produce a synopsis"
! 156: @echo " and recommended action to the user"
1.52 harris41 157: @echo "HTML: generate an HTML-formatted description of the LON-CAPA"
1.129 ! harris41 158: @echo " source files"
! 159: @echo "status: compare the TARGET filesystem with a compiled loncapa "
1.52 harris41 160: @echo " source directory"
161: @echo "statuspost: post the results of "make status" to "
162: @echo " TARGET/home/httpd/html/lon-status/filestatus.html"
163: @echo "rpmstatus: compare the rpms on a system to defined lists "
1.129 ! harris41 164: @echo " loncapa/doc/otherfiles/cd_rpms and "
! 165: @echo " loncapa/doc/otherfiles/rpm_list.txt"
! 166: @echo "rpmstatuspost: post the results of 'make rpmstatus' to "
1.52 harris41 167: @echo " TARGET/home/httpd/html/lon-status/rpmstatus.html"
1.129 ! harris41 168: @echo "*** ALTERNATIVE PACKAGING TARGETS ***"
! 169: @echo "RPM: build LON-CAPA-base RPM from loncapa source repository"
! 170: @echo " (still under development)"
! 171: @echo "DPKG: build a loncapa Debian package from loncapa source"
! 172: @echo " repository (still under development)"
! 173: @echo "base_rpm_file_list: create a file listing to be used for"
! 174: @echo " generating an RPM software package"
! 175: @echo "BinaryRoot: create a BinaryRoot directory to be used for"
! 176: @echo " generating an RPM software package"
! 177: @echo "*** MASTER DOCUMENTATION TARGETS ***"
! 178: @echo "doc: generate web-page documentation for install.lon-capa.org"
! 179: @echo " (and eventually for documentation on installed machines)"
! 180: @echo "pdfdoc: make a PDF-formatted compilation of all installation"
! 181: @echo " documentation"
! 182: @echo "*** KEEPING THINGS CLEAN ***"
! 183: @echo "clean: remove any files that might (even by remote chance)"
! 184: @echo " interfere with rebuilding/recompiling software"
! 185: @echo "reallyclean: remove all files that were generated during"
! 186: @echo " building or compilation of the software"
! 187: @echo "*** A HELPFUL DEPENDENCY ***"
! 188: @echo "alwaysrun: blank target that is a dependency for targets"
! 189: @echo " that should \"always run\""
! 190:
! 191: # =========================== *** RUNNING TESTS TO ENSURE SOLID PERFORMANCE ***
1.1 harris41 192:
1.52 harris41 193: test: TEST_lpml_scripts TEST_system_dependencies TEST_web_layer
1.41 harris41 194: @echo "ALL SYSTEM DEPENDENCY TESTS SUCCESSFUL"
195:
196: TEST_system_dependencies:
1.52 harris41 197: @echo "TESTING SYSTEM DEPENDENCIES"
1.41 harris41 198: cd system_dependencies; make
1.44 harris41 199:
200: TEST_lpml_scripts:
1.52 harris41 201: @echo "TESTING LPML INSTALLATION CODE"
1.44 harris41 202: cd ../test; perl filecomparetest.pl
1.41 harris41 203:
1.52 harris41 204: TEST_web_layer:
1.77 harris41 205: @echo "TESTING WEB LAYER"
206: cd weblayer_test; make
1.2 harris41 207:
1.63 harris41 208: TEST_hosts_tab:
209: @echo "Testing hosts.tab"
1.120 albertel 210: @if (test -e ../hosts.tab); then \
1.129 ! harris41 211: echo "there is a defined link or file; assume okay"; \
1.63 harris41 212: else echo "**** ERROR **** hosts.tab not defined!" && \
213: echo -n "You need to do one of the following within your " && \
1.92 harris41 214: echo "CVS repository (cd loncapa/loncom)" && \
215: echo " 1) ln -s production_hosts.tab hosts.tab" && \
216: echo " 2) ln -s development_hosts.tab hosts.tab" && \
217: echo "or 3) ln -s rawhide_hosts.tab hosts.tab" && \
1.63 harris41 218: echo "(you most likely want option #1, production_hosts.tab)" && \
219: exit 1; \
220: fi
1.64 harris41 221:
1.129 ! harris41 222: TEST_html2ps:
! 223: @if (test -e /usr/local/html2ps/bin/html2ps); then \
! 224: echo "I can find html2ps; assume okay"; \
! 225: else \
! 226: echo "**** ERROR **** cannot find /usr/local/html2ps/bin/html2ps!" && \
! 227: echo "Please visit http://www.tdb.uu.se/~jan/html2ps.html" && \
! 228: exit 1; \
! 229: fi
! 230:
! 231: # ======================= *** GENERAL TARGETS SUCH AS 'build' AND 'install' ***
! 232:
! 233: build: Makefile.build pod2html.sh pod2man.sh
! 234: install -d $(SOURCE)/doc/man
! 235: install -d $(SOURCE)/doc/scripts
! 236: install -d $(SOURCE)/doc/lib/perl/Apache
! 237: echo -n "" > WARNINGS
! 238: make -f Makefile.build all
! 239: echo '1' > buildflag
! 240: make warningnote
! 241:
! 242: buildflag:
! 243: @echo "**** ERROR **** You need to run 'make build' first" > WARNINGS
! 244: make warningnote
! 245: @need_to_run_make_build_first 2>/dev/null
! 246:
! 247: configinstall: Makefile.configinstall
! 248: make -f Makefile.configinstall SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
! 249: configfiles
! 250: if (test "0" = $(NORESTORECONF)); then \
! 251: perl loncaparestoreconfigurations suffix .lpmlnew; fi
! 252:
! 253: install: buildflag VERSION TEST_hosts_tab Makefile.install Makefile
! 254: echo -n "" > WARNINGS
! 255: make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
! 256: directories
! 257: make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files
! 258: make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links
! 259: make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
! 260: NORESTORECONF="$(NORESTORECONF)" configinstall
! 261: make postinstall
! 262: make warningnote
! 263: echo "You can run 'make test' to see if your system is ready to go!"
! 264: echo "NOTE THAT YOUR SYSTEM MUST HAVE MYSQL WITH A USER=\"www\" AND"
! 265: echo -n "PASSWORD=\"localhostkey\" FOR www\@localhost"
! 266: echo -n "(YOU MAY NEED TO REINITIALIZE YOUR MYSQL www\@localhost USER)"
! 267: echo -n "Please see http://install.lon-capa.org/ for more information"
! 268:
! 269: rawinstall: VERSION Makefile.install Makefile
! 270: echo -n "" > WARNINGS
! 271: make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
! 272: directories
! 273: make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files
! 274: make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links
! 275: make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
! 276: NORESTORECONF="$(NORESTORECONF)" configinstall
1.66 harris41 277:
1.64 harris41 278: hosts_tab: TEST_hosts_tab
1.80 harris41 279: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
280: perl xfml_parse.pl $(SOURCE)/doc/loncapafiles/valid_hosts.xfml | \
1.64 harris41 281: perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \
282: "$(TARGET)" > Makefile.install
1.66 harris41 283: make -f Makefile.install directories
1.64 harris41 284: make -f Makefile.install files
285: @echo "If hosts.tab has changed, restart httpd and loncontrol:"
286: @echo " /etc/rc.d/init.d/httpd restart"
287: @echo " /etc/rc.d/init.d/loncontrol restart"
288:
1.129 ! harris41 289: webserverconf:
! 290: cat $(SOURCE)/doc/loncapafiles/webserver.piml | \
! 291: perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH)
! 292:
! 293: # ---------------- Top-level files such as README, UPDATE, CHECKRPMS, and TEST
! 294: vanillatar:
! 295: # --------------------------- Point UPDATE to the internal make process
! 296: echo '#!/bin/sh' > $(SOURCE)/UPDATE
! 297: echo 'touch loncom/build/WARNINGS' >> $(SOURCE)/UPDATE;
! 298: echo 'ln -s loncom/build/WARNINGS WARNINGS' >> $(SOURCE)/UPDATE;
! 299: echo 'cd loncom/build; make build' >> $(SOURCE)/UPDATE
! 300: echo 'make rawinstall' >> $(SOURCE)/UPDATE
! 301: echo 'make configinstall' >> $(SOURCE)/UPDATE
! 302: echo 'make updatequery' >> $(SOURCE)/UPDATE
! 303: echo 'make hosts_tab' >> $(SOURCE)/UPDATE
! 304: echo 'make postinstall' >> $(SOURCE)/UPDATE
! 305: echo 'make aboutVERSION' >> $(SOURCE)/UPDATE
! 306: echo 'make warningnote' >> $(SOURCE)/UPDATE
! 307: # ----------------------------- Point TEST to the internal make process
! 308: echo '#!/bin/sh' > $(SOURCE)/TEST
! 309: echo 'cd loncom/build; make test' >> $(SOURCE)/TEST
! 310: # ----------------------------- Copy CHECKRPMS to the vanilla top-level
! 311: cp -v $(SOURCE)/loncom/build/CHECKRPMS $(SOURCE)/CHECKRPMS
! 312: # ----------------------- vanilla executables must indeed be executable
! 313: chmod a+rx $(SOURCE)/UPDATE
! 314: chmod a+rx $(SOURCE)/TEST
! 315: chmod a+rx $(SOURCE)/CHECKRPMS
! 316: # -------------------------------- Copy README to the vanilla top-level
! 317: cp -v $(SOURCE)/doc/shortest_path_redhat7.2.txt $(SOURCE)/README
! 318:
! 319: tardist:
! 320: make MANIFEST_all
! 321: make vanillatar
! 322: # -------------------------------------------------------- Make tardist
! 323: @cd $(SOURCE); \
! 324: if (test -h $(DIRTARGET)); then \
! 325: echo "$(DIRTARGET) link already defined; assume okay"; \
! 326: else \
! 327: ln -s . $(DIRTARGET); \
! 328: fi
! 329: cp -v $(SOURCE)/loncom/license/about.html \
! 330: $(SOURCE)/loncom/license/about.html.orig
! 331: make aboutVERSION
! 332: cd $(SOURCE); \
! 333: tar --no-recursion --numeric-owner --files-from MANIFEST \
! 334: -h -czf $(DIRTARGET).tar.gz 2>tar_WARNINGS || [ "0" == "0" ]
! 335: mv -v $(SOURCE)/loncom/license/about.html.orig \
! 336: $(SOURCE)/loncom/license/about.html
! 337: cat $(SOURCE)/tar_WARNINGS | \
! 338: xargs --replace=XXX echo '**** WARNING **** XXX' > WARNINGS
! 339: rm -f $(SOURCE)/tar_WARNINGS
! 340: make warningnote
! 341:
! 342: sanitycheck:
! 343: cat $(SOURCE)/doc/loncapafiles/sanitycheck.piml | \
! 344: perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \
! 345: tee -a WARNINGS
! 346:
! 347: updatequery:
! 348: cat $(SOURCE)/doc/loncapafiles/updatequery.piml | \
! 349: perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(QUERYLAUNCH)
! 350:
! 351: postinstall:
! 352: make webserverconf
! 353: make sanitycheck
! 354:
! 355: VERSION:
! 356: install -d $(TARGET)/etc
! 357: echo -n "LON-CAPA release $(VERSION)-" > $(TARGET)/etc/loncapa-release
! 358: date +"%Y%m%d" >> $(TARGET)/etc/loncapa-release
! 359:
! 360: aboutVERSION:
! 361: cat $(SOURCE)/loncom/license/about.html | \
! 362: perl -e '$$d=`date +"%Y%m%d"`;chomp($$d);while(<>){s/\<\!\-\- VERSION \-\-\>/$(VERSION)-$$d/; print;}' > \
! 363: $(SOURCE)/loncom/license/about.html.new
! 364: mv -v $(SOURCE)/loncom/license/about.html.new \
! 365: $(SOURCE)/loncom/license/about.html
! 366:
! 367: # ========= *** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml ***
! 368:
! 369: Makefile.configinstall: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml \
! 370: lpml_parse.pl
! 371: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
! 372: perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "$(SOURCE)" \
! 373: "$(TARGET)" > Makefile.configinstall
! 374:
! 375: Makefile.build: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml lpml_parse.pl
! 376: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
! 377: perl lpml_parse.pl build $(CATEGORY) $(DIST) "$(SOURCE)" "$(TARGET)" \
! 378: > Makefile.build
! 379:
! 380: Makefile.install: alwaysrun
! 381: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
! 382: perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \
! 383: "$(TARGET)" > Makefile.install
! 384:
! 385: # ============= *** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK ***
! 386:
1.66 harris41 387: lpmladm:
388: @if (test $(METAMTARGET) = "TRANSPORT"); then \
389: echo "Transporting to $(HOSTNAME)"; \
390: sudo make DIST=$(DIST) CATEGORY=$(CATEGORY) \
391: SOURCE="$(SOURCE)" \
392: TARGET="lpmladm.$(TIMESTAMP)" \
393: NORESTORECONF="$(NORESTORECONF)" "$(MTARGET)"; \
394: cd lpmladm.$(TIMESTAMP); \
395: sudo tar czvf ../tarball$(TIMESTAMP).tar.gz .; \
396: cd ..; scp tarball$(TIMESTAMP).tar.gz \
397: lpmladm@$(HOSTNAME):~/tarball$(TIMESTAMP).tar.gz; \
398: ssh lpmladm@$(HOSTNAME) sudo mv tarball$(TIMESTAMP).tar.gz /; \
399: ssh lpmladm@$(HOSTNAME) sudo tar -x -z -v -C / \
400: -p --same-owner -f \
401: /tarball$(TIMESTAMP).tar.gz; \
402: ssh lpmladm@$(HOSTNAME) sudo rm -f \
403: /tarball$(TIMESTAMP).tar.gz; \
404: elif (test $(METAMTARGET) = "LAUNCH"); then \
405: echo "Launching process on $(HOSTNAME)"; \
406: LAUNCHSAVE=$(OUTSTREAM) $(SAVE); \
407: make DIST=$(DIST) CATEGORY=$(CATEGORY) SOURCE="$(SOURCE)" \
408: TARGET="$(TARGET)" NORESTORECONF="$(NORESTORECONF)" \
409: LAUNCH="$(LAUNCHSAVE)" "$(MTARGET)"; \
410: scp $(SAVE) lpmladm@$(HOSTNAME):~/$(SAVE); \
411: ssh lpmladm@$(HOSTNAME) sudo perl $(SAVE); \
412: ssh lpmladm@$(HOSTNAME) sudo rm -f $(SAVE); \
413: else \
414: echo "**** ERROR **** Incorrect METAMTARGET"; \
415: fi
416:
1.129 ! harris41 417: NET_hosts_tab:
! 418: make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \
! 419: MTARGET="hosts_tab" HOSTNAME="$(HOSTNAME)" lpmladm
! 420:
! 421: NET_webserverconf:
! 422: make TIMESTAMP=`date +"%s"` METAMTARGET="LAUNCH" \
! 423: MTARGET="webserverconf" HOSTNAME="$(HOSTNAME)" lpmladm
! 424:
! 425: NET_rawinstall:
! 426: make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \
! 427: MTARGET="rawinstall" HOSTNAME="$(HOSTNAME)" lpmladm
! 428:
! 429: # ============== *** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES ***
! 430:
! 431: MANIFEST_all:
! 432: # --------------------------------------------------------- start clean
! 433: rm -f $(SOURCE)/MANIFEST
! 434: make MANIFEST_lpml
! 435: make MANIFEST_vanillatar
! 436: make MANIFEST_cvs
! 437: # ---------------------------------- might as well include the MANIFEST
! 438: echo 'MANIFEST' >> $(SOURCE)/MANIFEST
! 439: # ------------------------------------------ hosts.tab are belong to us
! 440: echo 'loncom/rawhide_hosts.tab' >> $(SOURCE)/MANIFEST
! 441: echo 'loncom/production_hosts.tab' >> $(SOURCE)/MANIFEST
! 442: echo 'loncom/development_hosts.tab' >> $(SOURCE)/MANIFEST
! 443: # ------------------ Files needed for dynamically generated directories
! 444: echo 'doc/man' >> $(SOURCE)/MANIFEST
! 445: echo 'doc/lib' >> $(SOURCE)/MANIFEST
! 446: echo 'doc/lib/perl' >> $(SOURCE)/MANIFEST
! 447: echo 'doc/lib/perl/Apache' >> $(SOURCE)/MANIFEST
! 448: echo 'doc/scripts' >> $(SOURCE)/MANIFEST
! 449: # --------------------------------------------------- Clean up MANIFEST
! 450: cd $(SOURCE); \
! 451: sort MANIFEST | perl -nle 'print "$(DIRTARGET)/$$_"' | \
! 452: perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
! 453: perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
! 454: perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
! 455: perl -nle 's/\/\.\//\//g;print' | sort | uniq > \
! 456: MANIFEST_loncapa
! 457: cd $(SOURCE); mv -v MANIFEST_loncapa MANIFEST
! 458:
! 459: # --------------- MANIFEST files with important CVS versioning/date information
! 460: MANIFEST_cvs:
! 461: # ------ CVS/Entries directories to retain 'time-checking' intelligence
! 462: cd $(SOURCE); find . -type f -name 'Entries' | grep 'CVS/Entries' >> \
! 463: MANIFEST
! 464:
! 465: # ------------------- MANIFEST the building, testing and standard loncapa files
! 466: MANIFEST_lpml:
! 467: cat $(SOURCE)/doc/loncapafiles/buildfiles.lpml | \
! 468: perl lpml_parse.pl MANIFEST development default \
! 469: '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
! 470: cat $(SOURCE)/doc/loncapafiles/testfiles.lpml | \
! 471: perl lpml_parse.pl MANIFEST development default \
! 472: '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
! 473: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
! 474: perl lpml_parse.pl MANIFEST development default \
! 475: '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
! 476:
! 477: # ------------ Files for top-level (the vanilla layer that the user first sees)
! 478: MANIFEST_vanillatar:
! 479: echo 'README' >> $(SOURCE)/MANIFEST
! 480: echo 'UPDATE' >> $(SOURCE)/MANIFEST
! 481: echo 'TEST' >> $(SOURCE)/MANIFEST
! 482: echo 'CHECKRPMS' >> $(SOURCE)/MANIFEST
! 483:
! 484: # =============================================== *** STATUS REPORT TARGETS ***
! 485:
! 486: warningnote:
! 487: @if (test -s WARNINGS); then \
! 488: W=`grep -c '\*\*\*\* WARNING' WARNINGS`; \
! 489: E=`grep -c '\*\*\*\* ERROR' WARNINGS`; \
! 490: N=`grep -c '\*\*\*\* NOTE' WARNINGS`; \
! 491: echo "---> $$W WARNINGS ENCOUNTERED! "; \
! 492: echo "---> $$E ERRORS ENCOUNTERED! "; \
! 493: echo "---> $$N NOTES ENCOUNTERED! "; \
! 494: echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \
! 495: echo "!!!! Please read the WARNINGS file !!!!"; \
! 496: echo "!!!! to make sure everything is !!!!"; \
! 497: echo "!!!! correct and taken care of !!!!"; \
! 498: echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \
! 499: fi
! 500:
1.3 harris41 501: HTML:
502: install -d HTML
1.80 harris41 503: cp $(SOURCE)/doc/loncapafiles/*.gif HTML
504: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
505: perl lpml_parse.pl html development default "$(SOURCE)" '$(TARGET)' \
506: > HTML/index.html
1.3 harris41 507:
1.8 harris41 508: status:
1.7 harris41 509: install -d HTML
1.80 harris41 510: cp $(SOURCE)/doc/loncapafiles/*.gif HTML
511: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
512: perl lpml_parse.pl html $(CATEGORY) $(DIST) "$(SOURCE)" "($TARGET)" | \
1.49 harris41 513: perl lpml_html_posteval.pl > \
1.39 harris41 514: HTML/filestatus.html
1.48 harris41 515:
1.22 harris41 516: statuspost: status
1.80 harris41 517: cp $(SOURCE)/doc/loncapafiles/*.gif \
518: $(TARGET)/home/httpd/html/lon-status
1.52 harris41 519: cp HTML/filestatus.html \
520: $(TARGET)/home/httpd/html/lon-status/filestatus.html
1.22 harris41 521:
1.33 harris41 522: rpmstatus:
523: install -d RPMSTATUS
1.52 harris41 524: rpm -qa --queryformat \
525: '%{NAME}\t%{VERSION}\t%{RELEASE}\t%{BUILDTIME}\n' | sort > \
526: RPMSTATUS/current.tmp
1.80 harris41 527: cat $(SOURCE)/doc/otherfiles/cd_rpms.txt > RPMSTATUS/standard.tmp
528: cat $(SOURCE)/doc/otherfiles/rpm_list.txt > RPMSTATUS/expected.tmp
1.52 harris41 529: perl rpmparse.pl RPMSTATUS/standard.tmp RPMSTATUS/current.tmp \
530: RPMSTATUS/expected.tmp > RPMSTATUS/rpmstatus.html
1.33 harris41 531:
532: rpmstatuspost: rpmstatus
533: cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html
534:
1.129 ! harris41 535: # ======================================= *** ALTERNATIVE PACKAGING TARGETS ***
1.8 harris41 536:
1.55 harris41 537: RPM: BinaryRoot base_rpm_file_list
1.80 harris41 538: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
1.63 harris41 539: perl lpml_parse.pl make_rpm $(CATEGORY) $(DIST) $(SOURCE) $(TARGET) \
540: > base_customizerpm.xml
1.55 harris41 541: cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 '' '' \
542: BinaryRoot base_customizerpm.xml
543:
1.60 harris41 544: DPKG:
1.82 harris41 545: make TARGET='lon-capa-$(VERSION)' NORESTORECONF='1' install
1.60 harris41 546: @echo "You will next need to follow instructions at:"
547: @echo "http://people.debian.org/~jaldhar/make_package1.html"
548: @echo "A directory with a snapshot of the debian package files"
549: @echo "is LON-CAPA-base."
1.82 harris41 550: # What DPKG steps need to happen (for future implementation):
551: # export EMAIL="" ... probably sharrison@mail.lon-capa.org
552: # deb-make
553: # edit debian/control
554: # make debian/dirs file
555: # make debian/copyright file
556: # debian/README.debian... point them to LON-CAPA URLS
557: # debian/changelog
558: # debian/conffiles
559: # debuild
560: # and maybe do some GPG-related steps around here
1.55 harris41 561:
562: base_rpm_file_list:
1.80 harris41 563: cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
1.55 harris41 564: perl lpml_parse.pl rpm_file_list $(CATEGORY) $(DIST) $(SOURCE) \
565: 'BinaryRoot' | sort > base_rpm_file_list.txt
1.6 harris41 566:
1.55 harris41 567: BinaryRoot: base_rpm_file_list
568: make TARGET='BinaryRoot' NORESTORECONF='1' install
1.23 harris41 569:
1.129 ! harris41 570: # ======================================== *** MASTER DOCUMENTATION TARGETS ***
! 571:
1.62 harris41 572: # Generates CVS:loncom/build/docs; root location of install.lon-capa.org
573: doc:
574: install -d docs
1.99 harris41 575: @if (test -e installation_manual.pdf); then \
576: cp -vf installation_manual.pdf docs/.; \
577: else \
578: touch docs/installation_manual.pdf; \
579: fi
1.62 harris41 580: install -m 0755 -d docs/icons
1.80 harris41 581: install -m 0644 $(SOURCE)/doc/icons/[^C][^V]* docs/icons
1.62 harris41 582: install -m 0755 -d docs/reconfig
1.99 harris41 583: cd docs; ln -fs installation_manual.pdf index.pdf
584: cd docs/reconfig; ln -fs ../installation_manual.pdf index.pdf
1.80 harris41 585: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
586: $(SOURCE)/doc/build/reconfig.html > docs/reconfig/index.html
1.62 harris41 587: install -m 0755 -d docs/reconfig/confexamples
1.80 harris41 588: install -m 0644 $(SOURCE)/doc/build/confexamples/[^C][^V]* \
1.62 harris41 589: docs/reconfig/confexamples
1.80 harris41 590: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
591: $(SOURCE)/doc/build/installindex.html > docs/index.html
1.67 harris41 592: install -m 0755 -d docs/license
1.99 harris41 593: cd docs/license; ln -fs ../installation_manual.pdf index.pdf
1.80 harris41 594: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
595: $(SOURCE)/doc/build/license.html > docs/license/index.html
1.67 harris41 596: install -m 0755 -d docs/contact
1.99 harris41 597: cd docs/contact; ln -fs ../installation_manual.pdf index.pdf
1.80 harris41 598: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
599: $(SOURCE)/doc/build/contact.html > docs/contact/index.html
1.68 harris41 600: install -m 0755 -d docs/faq
1.99 harris41 601: cd docs/faq; ln -fs ../installation_manual.pdf index.pdf
1.80 harris41 602: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
603: $(SOURCE)/doc/build/faq.html > docs/faq/index.html
1.69 harris41 604: install -m 0755 -d docs/downloads
1.99 harris41 605: cd docs/downloads; ln -fs ../installation_manual.pdf download.pdf
1.80 harris41 606: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
607: $(SOURCE)/doc/build/download.html > docs/downloads/index.html
1.69 harris41 608: install -m 0755 -d docs/install
1.99 harris41 609: cd docs/install; ln -fs ../installation_manual.pdf install.pdf
1.80 harris41 610: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
611: $(SOURCE)/doc/build/install.html > docs/install/index.html
1.125 harris41 612: cp -v $(SOURCE)/doc/install/redhat7.3/new_install_rh73.html \
613: docs/install/rh73.html
1.127 harris41 614: cp -v $(SOURCE)/doc/install/redhat7.3/new_install_rh73.html \
1.128 harris41 615: docs/downloads/rh73.html
1.69 harris41 616: install -m 0755 -d docs/upgrade
1.99 harris41 617: cd docs/upgrade; ln -fs ../installation_manual.pdf upgrade.pdf
1.80 harris41 618: perl doc_template.pl $(SOURCE)/doc/templates/template.html \
619: $(SOURCE)/doc/build/upgrade.html > docs/upgrade/index.html
1.62 harris41 620: cd docs; tar czvpf ../docs.tar.gz .
621:
1.99 harris41 622: pdfdoc: TEST_html2ps
623: install -d pdfdoc
624: /usr/local/html2ps/bin/html2ps -D \
625: $(SOURCE)/doc/build/installindex_noform.html > pdfdoc/installindex.ps
626: /usr/local/html2ps/bin/html2ps -D \
627: $(SOURCE)/doc/build/reconfig.html | \
628: perl -nle 's/\[EXAMPLE\]/\[EXAMPLE \(at end of document\)\]/g;print' \
629: > pdfdoc/reconfig.ps
630: /usr/local/html2ps/bin/html2ps -D \
631: $(SOURCE)/doc/build/install.html > pdfdoc/install.ps
632: /usr/local/html2ps/bin/html2ps -D \
633: $(SOURCE)/doc/build/upgrade.html > pdfdoc/upgrade.ps
634: /usr/local/html2ps/bin/html2ps -D \
635: $(SOURCE)/doc/build/faq.html > pdfdoc/faq.ps
636: /usr/local/html2ps/bin/html2ps -D \
637: $(SOURCE)/doc/build/download.html > pdfdoc/download.ps
638: /usr/local/html2ps/bin/html2ps -D \
639: $(SOURCE)/doc/build/contact.html > pdfdoc/contact.ps
640: /usr/local/html2ps/bin/html2ps -D \
641: $(SOURCE)/doc/build/license.html > pdfdoc/license.ps
642: # This creates a bad confexamples.ps... so take the long way around
643: # cd $(SOURCE)/doc/build/confexamples; \
644: # mpage -P- -1 -H [^C]* > ../../../loncom/build/pdfdoc/confexamples.ps
645: install -d pdfdoc/confexamples
646: cd $(SOURCE)/doc/build/confexamples; \
1.129 ! harris41 647: find . -type f | cut -b3- | grep -v '^C' | grep -v 'keyword' | \
! 648: perl -nle \
1.99 harris41 649: '`mpage -P- -1 -H $$_ > ../../../loncom/build/pdfdoc/confexamples/$$_.ps`;'
650: echo '' > pdfdoc/contents.txt
651: echo '' >> pdfdoc/contents.txt
652: echo ' The Learning Online Network' >> pdfdoc/contents.txt
653: echo ' with the' >> pdfdoc/contents.txt
654: echo ' Computer-Assisted Personalized Approach' >> \
655: pdfdoc/contents.txt
656: echo '' >> pdfdoc/contents.txt
657: echo '' >> pdfdoc/contents.txt
658: echo 'CONTENTS' >> pdfdoc/contents.txt
659: echo '--------' >> pdfdoc/contents.txt
660: echo 'Opening' >> pdfdoc/contents.txt
661: echo 'Configuration' >> pdfdoc/contents.txt
662: echo 'Installation' >> pdfdoc/contents.txt
663: echo 'Upgrading a LON-CAPA Server' >> pdfdoc/contents.txt
664: echo 'FAQ' >> pdfdoc/contents.txt
665: echo 'Download' >> pdfdoc/contents.txt
666: echo 'Contact Information' >> pdfdoc/contents.txt
667: echo 'License Information' >> pdfdoc/contents.txt
668: echo 'Configuration Examples' >> pdfdoc/contents.txt
669: mpage -P- -1 \
670: pdfdoc/contents.txt \
671: pdfdoc/installindex.ps \
672: pdfdoc/reconfig.ps \
673: pdfdoc/install.ps \
674: pdfdoc/upgrade.ps \
675: pdfdoc/faq.ps \
676: pdfdoc/download.ps \
677: pdfdoc/contact.ps \
678: pdfdoc/license.ps \
679: pdfdoc/confexamples/*.ps \
680: > pdfdoc/installation_manual.ps
681: ps2pdf pdfdoc/installation_manual.ps pdfdoc/installation_manual.pdf
682: mv -vf pdfdoc/installation_manual.pdf .
683:
1.129 ! harris41 684: # ================================================ *** KEEPING THINGS CLEAN ***
1.52 harris41 685:
1.1 harris41 686: clean:
1.129 ! harris41 687: rm -f buildflag
1.112 harris41 688: rm -Rf HTML
689: rm -f installation_manual.pdf
690: rm -f Makefile.build
691: rm -f Makefile.install
692: rm -f Makefile.configinstall
693: rm -Rf BinaryRoot
694: rm -Rf SetupBinaryRoot
695: rm -Rf LON-CAPA-base
696: rm -f base_rpm_file_list.txt
697: rm -f base_customizerpm.xml
698: rm -f setup_rpm_file_list.txt
699: rm -f docs.tar.gz
700: rm -Rf docs
701: rm -Rf pdfdoc
702: rm -f program.pl*
703: rm -Rf lpmladm.*
704: rm -f WARNINGS
1.114 harris41 705: rm -f $(SOURCE)/loncom/build/hosts.tab
1.112 harris41 706:
707: reallyclean:
1.129 ! harris41 708: rm -f buildflag
1.80 harris41 709: rm -f $(SOURCE)/README
710: rm -f $(SOURCE)/UPDATE
711: rm -f $(SOURCE)/TEST
1.105 harris41 712: rm -f $(SOURCE)/MANIFEST
1.129 ! harris41 713: rm -f $(SOURCE)/MANIFEST_loncapa
1.105 harris41 714: rm -f $(SOURCE)/loncapa
1.114 harris41 715: rm -f $(SOURCE)/loncom/build/hosts.tab
1.80 harris41 716: rm -f $(SOURCE)/loncapa.tar.gz
1.3 harris41 717: rm -Rf HTML
1.99 harris41 718: rm -f installation_manual.pdf
1.8 harris41 719: rm -f Makefile.build
720: rm -f Makefile.install
1.57 harris41 721: rm -f Makefile.configinstall
1.55 harris41 722: rm -Rf BinaryRoot
723: rm -Rf SetupBinaryRoot
1.62 harris41 724: rm -Rf LON-CAPA-base
1.56 harris41 725: rm -f base_rpm_file_list.txt
1.58 harris41 726: rm -f base_customizerpm.xml
1.56 harris41 727: rm -f setup_rpm_file_list.txt
1.62 harris41 728: rm -f docs.tar.gz
729: rm -Rf docs
1.99 harris41 730: rm -Rf pdfdoc
1.66 harris41 731: rm -f program.pl*
732: rm -Rf lpmladm.*
1.67 harris41 733: make -f Makefile.cvs clean
1.80 harris41 734: rm -f WARNINGS
1.115 harris41 735:
1.129 ! harris41 736: # ================================================ *** A HELPFUL DEPENDENCY ***
1.115 harris41 737: alwaysrun:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>