Annotation of doc/loncapafiles/buildfiles.lpml, revision 1.24

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.24    ! raeburn     5: <!-- $Id: buildfiles.lpml,v 1.23 2008/12/26 22:59:53 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>
        !           174:   <source>doc/loncapafiles/sysv-rc-conf.piml</source>
        !           175:   <target dist='default'>sysv-rc-conf.piml</target>
        !           176:   <categoryname>system file</categoryname>
        !           177:   <description>
        !           178: Checks that the webserver and loncontrol are properly set to run at startup
        !           179:   </description>
        !           180:   <note>
        !           181:   </note>
        !           182: </file>
        !           183: <file>
        !           184:   <source>doc/loncapafiles/chkconfig.piml</source>
        !           185:   <target dist='default'>chkconfig.piml</target>
        !           186:   <categoryname>system file</categoryname>
        !           187:   <description>
        !           188: Checks that the webserver and loncontrol are properly set to run at startup
1.17      albertel  189:   </description>
                    190:   <note>
                    191:   </note>
                    192: </file>
                    193: <file>
                    194:   <source>doc/loncapafiles/html_parser_check.piml</source>
                    195:   <target dist='default'>html_parser_check.piml</target>
                    196:   <categoryname>system file</categoryname>
                    197:   <description>
                    198: Checks that the HTML::parser installation has the needed patches.
                    199:   </description>
                    200:   <note>
                    201:   </note>
                    202: </file>
                    203: <file>
1.20      albertel  204:   <source>doc/loncapafiles/math_random_check.piml</source>
                    205:   <target dist='default'>math_random_check.piml</target>
                    206:   <categoryname>system file</categoryname>
                    207:   <description>
                    208: Checks that the Math::Random installation has the correct phrase to 
                    209: seed generator.
                    210:   </description>
                    211:   <note>
                    212:   </note>
                    213: </file>
                    214: <file>
1.17      albertel  215:   <source>doc/loncapafiles/logcleanup.piml</source>
                    216:   <target dist='default'>logcleanup.piml</target>
                    217:   <categoryname>system file</categoryname>
                    218:   <description>
                    219: Cleans the .perm logs, removing useless spam messages
                    220:   </description>
                    221:   <note>
                    222:   </note>
                    223: </file>
                    224: <file>
1.8       matthew   225: <source>doc/loncapafiles/accesscount_seed.piml</source>
                    226: <target dist='default'>accesscount_seed.piml</target>
                    227: <categoryname>system file</categoryname>
                    228: <description>
                    229: Executes seed_accesscount.pl on each nohist_resevaldata.db file to move access
                    230: count data to nohist_accesscount.db and compact the nohist_resevaldata.db
                    231: file.
1.1       harris41  232: </description>
                    233: <note>
                    234: </note>
                    235: </file>
                    236: <file>
1.4       albertel  237: <source>doc/loncapafiles/clearoutoldspreadsheetcache.piml</source>
                    238: <target dist='default'>clearoutoldspreadsheetcache.piml</target>
                    239: <categoryname>system file</categoryname>
                    240: <description>
                    241: Deletes all of the old spreadsheet cache files, the ones generated prior 
                    242: to version 0.6 were incorrect
                    243: </description>
                    244: <note>
                    245: </note>
                    246: </file>
                    247: <file>
1.1       harris41  248: <source>doc/loncapafiles/sanitycheck.piml</source>
                    249: <target dist='default'>sanitycheck.piml</target>
1.2       harris41  250: <categoryname>system file</categoryname>
                    251: <description>
                    252: Checks LON-CAPA system for frequently occuring bugs.
1.10      matthew   253: </description>
                    254: <note>
                    255: </note>
                    256: </file>
                    257: <file>
1.12      albertel  258:   <source>doc/loncapafiles/cron_lpmlcheck.piml</source>
                    259:   <target dist='default'>cron_lpmlcheck.piml</target>
                    260:   <categoryname>system file</categoryname>
                    261:   <description>
                    262:     Checks that there is no lpmlsave file in the cron.d dir
                    263:   </description>
                    264: </file>
                    265: <file>
1.10      matthew   266: <source>doc/loncapafiles/ntpcheck.piml</source>
                    267: <target dist='default'>ntpcheck.piml</target>
                    268: <categoryname>system file</categoryname>
                    269: <description>
                    270: Checks server to determine status of ntpd.
1.11      matthew   271: </description>
                    272: <note>
                    273: </note>
                    274: </file>
                    275: <file>
                    276: <source>doc/loncapafiles/rpmcheck.piml</source>
                    277: <target dist='default'>rpmcheck.piml</target>
                    278: <categoryname>system file</categoryname>
                    279: <description>
                    280: Checks server for rpms known to conflict with LON-CAPA.
1.2       harris41  281: </description>
                    282: <note>
                    283: </note>
                    284: </file>
                    285: <file>
                    286: <source>doc/loncapafiles/updatequery.piml</source>
                    287: <target dist='default'>updatequery.piml</target>
1.1       harris41  288: <categoryname>system file</categoryname>
                    289: <description>
                    290: Checks LON-CAPA system for frequently occuring bugs.
1.4       albertel  291: </description>
                    292: <note>
                    293: </note>
                    294: </file>
                    295: <file>
                    296: <source>doc/loncapafiles/sendmail_fix.piml</source>
                    297: <target dist='default'>sendmail_fix.piml</target>
                    298: <categoryname>system file</categoryname>
                    299: <description>
                    300: Checks LON-CAPA system for sendmail permissions error.
1.9       www       301: </description>
                    302: <note>
                    303: </note>
                    304: </file>
                    305: <file>
                    306: <source>doc/loncapafiles/ownership_fix.piml</source>
                    307: <target dist='default'>ownership_fix.piml</target>
                    308: <categoryname>system file</categoryname>
                    309: <description>
                    310: Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
1.1       harris41  311: </description>
                    312: <note>
                    313: </note>
                    314: </file>
                    315: <file>
1.13      albertel  316: <source>doc/loncapafiles/run_searchcat.piml</source>
                    317: <target dist='default'>run_searchcat.piml</target>
                    318: <categoryname>system file</categoryname>
                    319: <description>
                    320: Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
                    321: </description>
                    322: <note>
                    323: </note>
                    324: </file>
                    325: <file>
1.18      albertel  326:   <source>doc/loncapafiles/update_queue_slots.piml</source>
                    327:   <target dist='default'>update_queue_slots.piml</target>
                    328:   <categoryname>system file</categoryname>
                    329:   <description>
                    330: Update the slots definitons from havin @ to having :
                    331:   </description>
                    332:   <note>
                    333:   </note>
                    334: </file>
                    335: <file>
1.16      albertel  336:   <source>doc/loncapafiles/wrap_setuid.piml</source>
                    337:   <target dist='default'>wrap_setuid.piml</target>
                    338:   <categoryname>system file</categoryname>
                    339:   <description>
                    340: Wraps the setuid perl scripts into a binary excutable wrapper.
                    341:   </description>
                    342:   <note>
                    343:   </note>
                    344: </file>
                    345: <file>
1.21      raeburn   346:   <source>doc/loncapafiles/latex_fixup.piml</source>
                    347:   <target dist='default'>latex_fixup.piml</target>
                    348:   <categoryname>system file</categoryname>
                    349:   <description>
                    350: Runs /usr/bin/mktexlsr so LaTeX sees files added to texmf/tex/latex/base
                    351:   </description>
                    352:   <note>
                    353:   </note>
                    354: </file>
                    355: <file>
1.22      raeburn   356:   <source>doc/loncapafiles/picins_check.piml</source>
                    357:   <target dist='default'>picins_check.piml</target>
                    358:   <categoryname>system file</categoryname>
                    359:   <description>
                    360: If picins.sty is absent, retrieves from CTAN and runs texinfo rehash 
                    361: and fmtutil-sys --missing.
                    362:   </description>
                    363:   <note>
                    364:   </note>
                    365: </file>
                    366: <file>
1.23      raeburn   367:   <source>doc/loncapafiles/mimetex_version_check.piml</source>
                    368:   <target dist='default'>mimetex_version_check.piml</target>
                    369:   <categoryname>system file</categoryname>
                    370:   <description>
                    371: If mimeTeX cgi has been updated will update version number in 
                    372: /home/httpd/lonTabs/mimetex-version and remove any .gif files from 
                    373: /home/httpd/cgi-bin/mimtexcache/
                    374:   </description>
                    375:   <note>
                    376:   </note>
                    377: </file>
                    378: <file>
1.1       harris41  379: <source>doc/loncapafiles/valid_hosts.xfml</source>
                    380: <target dist='default'>valid_hosts.xfml</target>
                    381: <categoryname>system file</categoryname>
                    382: <description>
                    383: Useful for extracting (and pushing/pulling) information relevant
                    384: to hosts.tab.
                    385: </description>
                    386: <note>
                    387: </note>
                    388: </file>
                    389: <file>
                    390: <source>loncom/build/check-rpms</source>
                    391: <target dist='default'>check-rpms</target>
                    392: <categoryname>system file</categoryname>
                    393: <description>
                    394: script for checking RPMS against an RPM repository
                    395: </description>
                    396: <note>
                    397: </note>
                    398: </file>
                    399: <file>
                    400: <source>loncom/build/distprobe</source>
                    401: <target dist='default'>distprobe</target>
                    402: <categoryname>system file</categoryname>
                    403: <description>
                    404: for probing operating system flavor and version
                    405: </description>
                    406: <note>
                    407: </note>
                    408: </file>
                    409: <file>
                    410: <source>loncom/build/doc_template.pl</source>
                    411: <target dist='default'>doc_template.pl</target>
                    412: <categoryname>system file</categoryname>
                    413: <description>
                    414: for making fancy install.lon-capa.org pages
                    415: </description>
                    416: <note>
                    417: </note>
                    418: </file>
                    419: <file>
                    420: <source>loncom/build/filecompare.pl</source>
                    421: <target dist='default'>filecompare.pl</target>
                    422: <categoryname>system file</categoryname>
                    423: <description>
                    424: rigorously compare many different values associated between files
                    425: </description>
                    426: <note>
                    427: </note>
                    428: </file>
                    429: <file>
                    430: <source>loncom/build/loncaparestoreconfigurations</source>
                    431: <target dist='default'>loncaparestoreconfigurations</target>
                    432: <categoryname>system file</categoryname>
                    433: <description>
                    434: intelligently restore configuration values
                    435: </description>
                    436: <note>
                    437: </note>
                    438: </file>
                    439: <file>
                    440: <source>loncom/build/lpml.dtd</source>
                    441: <target dist='default'>lpml.dtd</target>
                    442: <categoryname>system file</categoryname>
                    443: <description>
                    444: DocumentType for LPML
                    445: </description>
                    446: <note>
                    447: </note>
                    448: </file>
                    449: <file>
                    450: <source>loncom/build/lpml_html_posteval.pl</source>
                    451: <target dist='default'>lpml_html_posteval.pl</target>
                    452: <categoryname>system file</categoryname>
                    453: <description>
                    454: </description>
                    455: <note>
                    456: </note>
                    457: </file>
                    458: <file>
                    459: <source>loncom/build/lpml_parse.pl</source>
                    460: <target dist='default'>lpml_parse.pl</target>
                    461: <categoryname>system file</categoryname>
                    462: <description>
                    463: parse apart the loncapafiles.lpml and buildfiles.lpml
                    464: </description>
                    465: <note>
                    466: </note>
                    467: </file>
                    468: <file>
                    469: <source>loncom/build/make_domain_coordinator.pl</source>
                    470: <target dist='default'>make_domain_coordinator.pl</target>
                    471: <categoryname>system file</categoryname>
                    472: <description>
                    473: make a domain coordinator on a new LON-CAPA system
                    474: </description>
                    475: <note>
                    476: </note>
                    477: </file>
                    478: <file>
1.19      albertel  479:   <source>loncom/build/add_domain_coordinator_privilege.pl</source>
                    480:   <target dist='default'>add_domain_coordinator_privilege.pl</target>
                    481:   <categoryname>system file</categoryname>
                    482:   <description>
                    483: add domain coordinator privilege to and exisiting local LON-CAPA user
                    484:   </description>
                    485:   <note>
                    486:   </note>
                    487: </file>
                    488: <file>
1.1       harris41  489: <source>loncom/build/piml.dtd</source>
                    490: <target dist='default'>piml.dtd</target>
                    491: <categoryname>system file</categoryname>
                    492: <description>
                    493: DocumentType definition for PIML (part of the LPML system)
                    494: </description>
                    495: <note>
                    496: </note>
                    497: </file>
                    498: <file>
                    499: <source>loncom/build/piml_parse.pl</source>
                    500: <target dist='default'>piml_parse.pl</target>
                    501: <categoryname>system file</categoryname>
                    502: <description>
                    503: parse a PIML file
                    504: </description>
                    505: <note>
                    506: </note>
                    507: </file>
                    508: <file>
                    509: <source>loncom/build/pod2html.sh</source>
                    510: <target dist='default'>pod2html.sh</target>
                    511: <categoryname>system file</categoryname>
                    512: <description>
                    513: make HTML documentation pages
                    514: </description>
                    515: <note>
                    516: </note>
                    517: </file>
                    518: <file>
                    519: <source>loncom/build/pod2man.sh</source>
                    520: <target dist='default'>pod2man.sh</target>
                    521: <categoryname>system file</categoryname>
                    522: <description>
                    523: make UNIX-style manual pages
                    524: </description>
                    525: <note>
                    526: </note>
                    527: </file>
                    528: <file>
                    529: <source>loncom/build/verify.pl</source>
                    530: <target dist='default'>verify.pl</target>
                    531: <categoryname>system file</categoryname>
                    532: <description>
                    533: wraps around filecompare.pl for posteval LPML statements
                    534: </description>
                    535: <note>
                    536: </note>
                    537: </file>
                    538: <file>
                    539: <source>loncom/build/verifymodown.pl</source>
                    540: <target dist='default'>verifymodown.pl</target>
                    541: <categoryname>system file</categoryname>
                    542: <description>
                    543: double-checks modification and ownership on files
                    544: </description>
                    545: <note>
                    546: </note>
                    547: </file>
                    548: <file>
                    549: <source>loncom/build/xfml.dtd</source>
                    550: <target dist='default'>xfml.dtd</target>
                    551: <categoryname>system file</categoryname>
                    552: <description>
                    553: DocumentType definition for XFML (part of the LPML system)
                    554: </description>
                    555: <note>
                    556: </note>
                    557: </file>
                    558: <file>
                    559: <source>loncom/build/xfml_parse.pl</source>
                    560: <target dist='default'>xfml_parse.pl</target>
                    561: <categoryname>system file</categoryname>
                    562: <description>
                    563: parses XFML files
                    564: </description>
                    565: <note>
                    566: </note>
                    567: </file>
                    568: </files>
                    569: </lpml>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>