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