Annotation of doc/loncapafiles/buildfiles.lpml, revision 1.34
1.1 harris41 1: <!DOCTYPE lpml PUBLIC "-//TUX/DTD lpml 1.0 Final//EN"
2: "http://lpml.sourceforge.net/DTD/lpml.dtd">
3: <!-- buildfiles.lpml -->
4:
1.34 ! raeburn 5: <!-- $Id: buildfiles.lpml,v 1.33 2024/07/09 01:25:07 raeburn Exp $ -->
1.1 harris41 6:
7: <!--
8:
9: Copyright Michigan State University Board of Trustees
10:
11: This file is part of the LearningOnline Network with CAPA (LON-CAPA).
12:
13: LON-CAPA is free software; you can redistribute it and/or modify
14: it under the terms of the GNU General Public License as published by
15: the Free Software Foundation; either version 2 of the License, or
16: (at your option) any later version.
17:
18: LON-CAPA is distributed in the hope that it will be useful,
19: but WITHOUT ANY WARRANTY; without even the implied warranty of
20: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21: GNU General Public License for more details.
22:
23: You should have received a copy of the GNU General Public License
24: along with LON-CAPA; if not, write to the Free Software
25: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26:
27: /home/httpd/html/adm/gpl.txt
28:
29: http://www.lon-capa.org/
30:
31: -->
32:
33: <!-- Default values must be defined before specific values. -->
34: <!-- If no 'dist' attribute is specified, then it is always installed. -->
35: <!-- If 'dist' attribute is set to 'default', then the specification. -->
36: <!-- is accepted if an alternative distribution is not requested or not -->
37: <!-- defined. -->
38:
39: <lpml>
40: <specialnotices>
41: <specialnotice dist='default'>
42: </specialnotice>
43: </specialnotices>
44: <targetroot>/build</targetroot>
45: <sourceroot>/home/user/loncapa/</sourceroot>
46: <categories>
47: <category name="system file" type="runtime">
48: <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
49: <abbreviation>systemfile</abbreviation>
50: </category>
51: <category name="system file" type="development">
52: <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
53: <abbreviation>systemfile</abbreviation>
54: </category>
55: <category name="standard" type="runtime">
56: <chmod dist='default'>0755</chmod><chown dist='default'>root:root</chown>
57: <abbreviation>directory</abbreviation>
58: </category>
59: <category name="standard" type="development">
60: <chmod dist='default'>0755</chmod><chown dist='default'>root:root</chown>
61: <abbreviation>directory</abbreviation>
62: </category>
63: </categories>
64: <directories>
65: </directories>
66: <files>
67: <file>
68: <source>loncom/build/Makefile</source>
69: <target dist='default'>Makefile</target>
70: <categoryname>system file</categoryname>
71: <description>
72: Makefile for LON-CAPA
73: </description>
74: <note>
75: </note>
1.5 albertel 76: <dependencies>
77: doc/loncapafiles/configurable.gif;
78: doc/loncapafiles/directory.gif;
79: doc/loncapafiles/emptydirectory.gif;
80: doc/loncapafiles/graphicfile.gif;
81: doc/loncapafiles/handler.gif;
82: doc/loncapafiles/interfacefile.gif;
83: doc/loncapafiles/link.gif;
84: doc/loncapafiles/rootscript.gif;
85: doc/loncapafiles/script.gif;
86: doc/loncapafiles/setuid.gif;
87: doc/loncapafiles/static.gif;
88: doc/loncapafiles/systemfile.gif
89: </dependencies>
1.1 harris41 90: </file>
91: <file>
92: <source>doc/loncapafiles/loncapafiles.lpml</source>
93: <target dist='default'>loncapafiles.lpml</target>
94: <categoryname>system file</categoryname>
95: <description>
96: Describes the files that implement LON-CAPA on the filesystem
97: </description>
98: <note>
99: </note>
100: </file>
101: <file>
102: <source>doc/loncapafiles/buildfiles.lpml</source>
103: <target dist='default'>buildfiles.lpml</target>
104: <categoryname>system file</categoryname>
105: <description>
106: Describes the files that implement the building of LON-CAPA inside the source
107: file tree.
1.6 harris41 108: </description>
109: <note>
110: </note>
111: </file>
112: <file>
113: <source>doc/loncapafiles/installfiles.lpml</source>
114: <target dist='default'>installfiles.lpml</target>
115: <categoryname>system file</categoryname>
116: <description>
117: Describes the files that help automate LON-CAPA installations on specific
118: operating systems.
1.1 harris41 119: </description>
120: <note>
121: </note>
122: </file>
123: <file>
1.14 albertel 124: <source>doc/loncapafiles/modify_config_files.piml</source>
125: <target dist='default'>modify_config_files.piml</target>
126: <categoryname>system file</categoryname>
127: <description>
128: Post-installation of MySQL and yum config files
129: </description>
130: <note>
131: </note>
132: </file>
133: <file>
1.1 harris41 134: <source>doc/loncapafiles/webserver.piml</source>
135: <target dist='default'>webserver.piml</target>
136: <categoryname>system file</categoryname>
137: <description>
138: Post-installation of web server configuration files
1.3 albertel 139: </description>
140: <note>
141: </note>
142: </file>
143: <file>
144: <source>doc/loncapafiles/reseval_fixup.piml</source>
145: <target dist='default'>reseval_fixup.piml</target>
146: <categoryname>system file</categoryname>
147: <description>
148: Migrates reseval.db to nohist_eseval.db, deletes useless hist file
1.8 matthew 149: </description>
150: <note>
151: </note>
152: </file>
153: <file>
1.15 albertel 154: <source>doc/loncapafiles/clean_file_permissions.piml</source>
155: <target dist='default'>clean_file_permissions.piml</target>
156: <categoryname>system file</categoryname>
157: <description>
158: Executes clean_db.pl on each file_permisions.db file to remove erroneuos keys.
159: </description>
160: <note>
161: </note>
162: </file>
163: <file>
1.17 albertel 164: <source>doc/loncapafiles/chkconfig.piml</source>
165: <target dist='default'>chkconfig.piml</target>
166: <categoryname>system file</categoryname>
167: <description>
1.24 raeburn 168: Checks that the webserver and loncontrol are properly set to run at startup
169: </description>
170: <note>
171: </note>
172: </file>
173: <file>
1.17 albertel 174: <source>doc/loncapafiles/html_parser_check.piml</source>
175: <target dist='default'>html_parser_check.piml</target>
176: <categoryname>system file</categoryname>
177: <description>
178: Checks that the HTML::parser installation has the needed patches.
179: </description>
180: <note>
181: </note>
182: </file>
183: <file>
1.20 albertel 184: <source>doc/loncapafiles/math_random_check.piml</source>
185: <target dist='default'>math_random_check.piml</target>
186: <categoryname>system file</categoryname>
187: <description>
188: Checks that the Math::Random installation has the correct phrase to
189: seed generator.
190: </description>
191: <note>
192: </note>
193: </file>
194: <file>
1.17 albertel 195: <source>doc/loncapafiles/logcleanup.piml</source>
196: <target dist='default'>logcleanup.piml</target>
197: <categoryname>system file</categoryname>
198: <description>
199: Cleans the .perm logs, removing useless spam messages
200: </description>
201: <note>
202: </note>
203: </file>
204: <file>
1.8 matthew 205: <source>doc/loncapafiles/accesscount_seed.piml</source>
206: <target dist='default'>accesscount_seed.piml</target>
207: <categoryname>system file</categoryname>
208: <description>
209: Executes seed_accesscount.pl on each nohist_resevaldata.db file to move access
210: count data to nohist_accesscount.db and compact the nohist_resevaldata.db
211: file.
1.1 harris41 212: </description>
213: <note>
214: </note>
215: </file>
216: <file>
1.4 albertel 217: <source>doc/loncapafiles/clearoutoldspreadsheetcache.piml</source>
218: <target dist='default'>clearoutoldspreadsheetcache.piml</target>
219: <categoryname>system file</categoryname>
220: <description>
221: Deletes all of the old spreadsheet cache files, the ones generated prior
222: to version 0.6 were incorrect
223: </description>
224: <note>
225: </note>
226: </file>
227: <file>
1.1 harris41 228: <source>doc/loncapafiles/sanitycheck.piml</source>
229: <target dist='default'>sanitycheck.piml</target>
1.2 harris41 230: <categoryname>system file</categoryname>
231: <description>
232: Checks LON-CAPA system for frequently occuring bugs.
1.10 matthew 233: </description>
234: <note>
235: </note>
236: </file>
237: <file>
1.12 albertel 238: <source>doc/loncapafiles/cron_lpmlcheck.piml</source>
239: <target dist='default'>cron_lpmlcheck.piml</target>
240: <categoryname>system file</categoryname>
241: <description>
242: Checks that there is no lpmlsave file in the cron.d dir
243: </description>
244: </file>
245: <file>
1.10 matthew 246: <source>doc/loncapafiles/ntpcheck.piml</source>
247: <target dist='default'>ntpcheck.piml</target>
248: <categoryname>system file</categoryname>
249: <description>
250: Checks server to determine status of ntpd.
1.11 matthew 251: </description>
252: <note>
253: </note>
254: </file>
255: <file>
256: <source>doc/loncapafiles/rpmcheck.piml</source>
257: <target dist='default'>rpmcheck.piml</target>
258: <categoryname>system file</categoryname>
259: <description>
260: Checks server for rpms known to conflict with LON-CAPA.
1.2 harris41 261: </description>
262: <note>
263: </note>
264: </file>
265: <file>
266: <source>doc/loncapafiles/updatequery.piml</source>
267: <target dist='default'>updatequery.piml</target>
1.1 harris41 268: <categoryname>system file</categoryname>
269: <description>
270: Checks LON-CAPA system for frequently occuring bugs.
1.4 albertel 271: </description>
272: <note>
273: </note>
274: </file>
275: <file>
276: <source>doc/loncapafiles/sendmail_fix.piml</source>
277: <target dist='default'>sendmail_fix.piml</target>
278: <categoryname>system file</categoryname>
279: <description>
280: Checks LON-CAPA system for sendmail permissions error.
1.9 www 281: </description>
282: <note>
283: </note>
284: </file>
285: <file>
286: <source>doc/loncapafiles/ownership_fix.piml</source>
287: <target dist='default'>ownership_fix.piml</target>
288: <categoryname>system file</categoryname>
289: <description>
290: Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
1.1 harris41 291: </description>
292: <note>
293: </note>
294: </file>
295: <file>
1.13 albertel 296: <source>doc/loncapafiles/run_searchcat.piml</source>
297: <target dist='default'>run_searchcat.piml</target>
298: <categoryname>system file</categoryname>
299: <description>
300: Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
301: </description>
302: <note>
303: </note>
304: </file>
305: <file>
1.18 albertel 306: <source>doc/loncapafiles/update_queue_slots.piml</source>
307: <target dist='default'>update_queue_slots.piml</target>
308: <categoryname>system file</categoryname>
309: <description>
310: Update the slots definitons from havin @ to having :
311: </description>
312: <note>
313: </note>
314: </file>
315: <file>
1.16 albertel 316: <source>doc/loncapafiles/wrap_setuid.piml</source>
317: <target dist='default'>wrap_setuid.piml</target>
318: <categoryname>system file</categoryname>
319: <description>
320: Wraps the setuid perl scripts into a binary excutable wrapper.
321: </description>
322: <note>
323: </note>
324: </file>
325: <file>
1.21 raeburn 326: <source>doc/loncapafiles/latex_fixup.piml</source>
327: <target dist='default'>latex_fixup.piml</target>
328: <categoryname>system file</categoryname>
329: <description>
330: Runs /usr/bin/mktexlsr so LaTeX sees files added to texmf/tex/latex/base
331: </description>
332: <note>
333: </note>
334: </file>
335: <file>
1.22 raeburn 336: <source>doc/loncapafiles/picins_check.piml</source>
337: <target dist='default'>picins_check.piml</target>
338: <categoryname>system file</categoryname>
339: <description>
340: If picins.sty is absent, retrieves from CTAN and runs texinfo rehash
341: and fmtutil-sys --missing.
342: </description>
343: <note>
344: </note>
345: </file>
346: <file>
1.32 raeburn 347: <source>doc/loncapafiles/langcheck.piml</source>
348: <target dist='default'>langcheck.piml</target>
349: <categoryname>system file</categoryname>
350: <description>
351: Check language used for root bash and OS, and warn if language other
352: than English is in use.
353: </description>
354: <note>
355: </note>
356: </file>
357: <file>
1.23 raeburn 358: <source>doc/loncapafiles/mimetex_version_check.piml</source>
359: <target dist='default'>mimetex_version_check.piml</target>
360: <categoryname>system file</categoryname>
361: <description>
362: If mimeTeX cgi has been updated will update version number in
363: /home/httpd/lonTabs/mimetex-version and remove any .gif files from
364: /home/httpd/cgi-bin/mimtexcache/
365: </description>
366: <note>
367: </note>
368: </file>
369: <file>
1.26 raeburn 370: <source>doc/loncapafiles/verify_domconfiguser.piml</source>
371: <target dist='default'>verify_domconfiguser.piml</target>
372: <categoryname>system file</categoryname>
373: <description>
374: Determine if current machine is the primary library server for any domains.
375: If it is create the $dom-domainconfig user for any of these domains if it is absent, create /home/httpd/lonUsers/$dom/1/2/3/$dom-domainconfig directory, assign author role if required, and create /home/$dom-domconfig/public_html directory, if required.
376: </description>
377: <note>
378: </note>
379: </file>
380: <file>
1.27 raeburn 381: <source>doc/loncapafiles/latex_fmtutil.piml</source>
382: <target dist='default'>latex_fmtutil.piml</target>
383: <categoryname>system file</categoryname>
384: <description>
385: Runs "/usr/bin/fmtutil-sys --missing" to create any missing TeX format files.
386: </description>
387: <note>
388: </note>
389: </file>
390: <file>
1.30 raeburn 391: <source>doc/loncapafiles/removenolongerused.piml</source>
392: <target dist='default'>removenolongerused.piml</target>
393: <categoryname>system file</categoryname>
394: <description>
395: Check for files and/or directories installed by earlier versions of LON-CAPA which are no longer used by the version being installed. Prompt the user to confirm deletion for each file and each directory, before deleting them.
396: </description>
397: <note>
398: </note>
399: </file>
400: <file>
1.33 raeburn 401: <source>doc/loncapafiles/bash_config_check.piml</source>
402: <target dist='default'>bash_config_check.piml</target>
403: <categoryname>system file</categoryname>
404: <description>
405: Check for distros with readline 8.1 or newer whether bash for user www has bracketed paste mode enabled,
406: and, if so, include advice in WARNINGS to disable it by modifying /home/www/.inputrc.
407: If no change is made from the default for such distros, R commands sent to the lonr daemon will not be processed.
408: </description>
409: <note>
410: </note>
411: </file>
412: <file>
1.34 ! raeburn 413: <source>doc/loncapafiles/systemd_config_check.piml</source>
! 414: <target dist='default'>systemd_config_check.piml</target>
! 415: <categoryname>system file</categoryname>
! 416: <description>
! 417: Check for distros/versions which use systemctl, and check if ProtectHome property is set to readonly or yes
! 418: for web server (httpd.service or apache2.service, depending on distro). If so, attempt to set ProtectHome=no
! 419: in /etc/systemd/httpd.service.d/override.conf or /etc/systemd/apache2.service.d/override.conf, as appropriate.
! 420: </description>
! 421: <note>
! 422: </note>
! 423: </file>
! 424: <file>
1.31 raeburn 425: <source>doc/loncapafiles/lcmathcomplex.piml</source>
426: <target dist='default'>lcmathcomplex.piml</target>
427: <categoryname>system file</categoryname>
428: <description>
429: Use perl core module Config.pm to determine nvsize and set value for this scalar in /home/httpd/lib/perl/LONCAPA/LCMathComplex.pm. LCMathComplex.pm is used instead of the core perl module Math::Complex in Safe Space, because the dependency on Config.pm is eliminated.
430: </description>
431: <note>
432: </note>
433: </file>
434: <file>
1.1 harris41 435: <source>doc/loncapafiles/valid_hosts.xfml</source>
436: <target dist='default'>valid_hosts.xfml</target>
437: <categoryname>system file</categoryname>
438: <description>
439: Useful for extracting (and pushing/pulling) information relevant
440: to hosts.tab.
441: </description>
442: <note>
443: </note>
444: </file>
445: <file>
446: <source>loncom/build/check-rpms</source>
447: <target dist='default'>check-rpms</target>
448: <categoryname>system file</categoryname>
449: <description>
450: script for checking RPMS against an RPM repository
451: </description>
452: <note>
453: </note>
454: </file>
455: <file>
456: <source>loncom/build/distprobe</source>
457: <target dist='default'>distprobe</target>
458: <categoryname>system file</categoryname>
459: <description>
460: for probing operating system flavor and version
461: </description>
462: <note>
463: </note>
464: </file>
465: <file>
466: <source>loncom/build/doc_template.pl</source>
467: <target dist='default'>doc_template.pl</target>
468: <categoryname>system file</categoryname>
469: <description>
470: for making fancy install.lon-capa.org pages
471: </description>
472: <note>
473: </note>
474: </file>
475: <file>
476: <source>loncom/build/filecompare.pl</source>
477: <target dist='default'>filecompare.pl</target>
478: <categoryname>system file</categoryname>
479: <description>
480: rigorously compare many different values associated between files
481: </description>
482: <note>
483: </note>
484: </file>
485: <file>
1.29 raeburn 486: <source>loncom/build/getcvsdate.pl</source>
487: <target dist='default'>getcvsdate.pl</target>
488: <categoryname>system file</categoryname>
489: <description>
490: script to get CVS commit date/time for a file from file's entry in
491: CVS/Entries for directory containing the file
492: </description>
493: <note>
494: </note>
495: </file>
496:
497: <file>
1.1 harris41 498: <source>loncom/build/loncaparestoreconfigurations</source>
499: <target dist='default'>loncaparestoreconfigurations</target>
500: <categoryname>system file</categoryname>
501: <description>
502: intelligently restore configuration values
503: </description>
504: <note>
505: </note>
506: </file>
507: <file>
508: <source>loncom/build/lpml.dtd</source>
509: <target dist='default'>lpml.dtd</target>
510: <categoryname>system file</categoryname>
511: <description>
512: DocumentType for LPML
513: </description>
514: <note>
515: </note>
516: </file>
517: <file>
518: <source>loncom/build/lpml_html_posteval.pl</source>
519: <target dist='default'>lpml_html_posteval.pl</target>
520: <categoryname>system file</categoryname>
521: <description>
522: </description>
523: <note>
524: </note>
525: </file>
526: <file>
527: <source>loncom/build/lpml_parse.pl</source>
528: <target dist='default'>lpml_parse.pl</target>
529: <categoryname>system file</categoryname>
530: <description>
531: parse apart the loncapafiles.lpml and buildfiles.lpml
532: </description>
533: <note>
534: </note>
535: </file>
536: <file>
537: <source>loncom/build/make_domain_coordinator.pl</source>
538: <target dist='default'>make_domain_coordinator.pl</target>
539: <categoryname>system file</categoryname>
540: <description>
541: make a domain coordinator on a new LON-CAPA system
542: </description>
543: <note>
544: </note>
545: </file>
546: <file>
1.19 albertel 547: <source>loncom/build/add_domain_coordinator_privilege.pl</source>
548: <target dist='default'>add_domain_coordinator_privilege.pl</target>
549: <categoryname>system file</categoryname>
550: <description>
551: add domain coordinator privilege to and exisiting local LON-CAPA user
552: </description>
553: <note>
554: </note>
555: </file>
556: <file>
1.28 raeburn 557: <source>loncom/build/expire_DC_role.pl</source>
558: <target dist='default'>expire_DC_role.pl</target>
559: <categoryname>system file</categoryname>
560: <description>
561: expire domain coordinator role for exisiting local LON-CAPA user
562: </description>
563: <note>
564: </note>
565: </file>
566: <file>
1.1 harris41 567: <source>loncom/build/piml.dtd</source>
568: <target dist='default'>piml.dtd</target>
569: <categoryname>system file</categoryname>
570: <description>
571: DocumentType definition for PIML (part of the LPML system)
572: </description>
573: <note>
574: </note>
575: </file>
576: <file>
577: <source>loncom/build/piml_parse.pl</source>
578: <target dist='default'>piml_parse.pl</target>
579: <categoryname>system file</categoryname>
580: <description>
581: parse a PIML file
582: </description>
583: <note>
584: </note>
585: </file>
586: <file>
587: <source>loncom/build/pod2html.sh</source>
588: <target dist='default'>pod2html.sh</target>
589: <categoryname>system file</categoryname>
590: <description>
591: make HTML documentation pages
592: </description>
593: <note>
594: </note>
595: </file>
596: <file>
597: <source>loncom/build/pod2man.sh</source>
598: <target dist='default'>pod2man.sh</target>
599: <categoryname>system file</categoryname>
600: <description>
601: make UNIX-style manual pages
602: </description>
603: <note>
604: </note>
605: </file>
606: <file>
607: <source>loncom/build/verify.pl</source>
608: <target dist='default'>verify.pl</target>
609: <categoryname>system file</categoryname>
610: <description>
611: wraps around filecompare.pl for posteval LPML statements
612: </description>
613: <note>
614: </note>
615: </file>
616: <file>
617: <source>loncom/build/verifymodown.pl</source>
618: <target dist='default'>verifymodown.pl</target>
619: <categoryname>system file</categoryname>
620: <description>
621: double-checks modification and ownership on files
622: </description>
623: <note>
624: </note>
625: </file>
626: <file>
627: <source>loncom/build/xfml.dtd</source>
628: <target dist='default'>xfml.dtd</target>
629: <categoryname>system file</categoryname>
630: <description>
631: DocumentType definition for XFML (part of the LPML system)
632: </description>
633: <note>
634: </note>
635: </file>
636: <file>
637: <source>loncom/build/xfml_parse.pl</source>
638: <target dist='default'>xfml_parse.pl</target>
639: <categoryname>system file</categoryname>
640: <description>
641: parses XFML files
642: </description>
643: <note>
644: </note>
645: </file>
646: </files>
647: </lpml>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>