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