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

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.32    ! raeburn     5: <!-- $Id: buildfiles.lpml,v 1.31 2013/10/29 21:01:10 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.31      raeburn   401:   <source>doc/loncapafiles/lcmathcomplex.piml</source>
                    402:   <target dist='default'>lcmathcomplex.piml</target>
                    403:   <categoryname>system file</categoryname>
                    404:   <description>
                    405: 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.
                    406:   </description>
                    407:   <note>
                    408:   </note>
                    409: </file>
                    410: <file>
1.1       harris41  411: <source>doc/loncapafiles/valid_hosts.xfml</source>
                    412: <target dist='default'>valid_hosts.xfml</target>
                    413: <categoryname>system file</categoryname>
                    414: <description>
                    415: Useful for extracting (and pushing/pulling) information relevant
                    416: to hosts.tab.
                    417: </description>
                    418: <note>
                    419: </note>
                    420: </file>
                    421: <file>
                    422: <source>loncom/build/check-rpms</source>
                    423: <target dist='default'>check-rpms</target>
                    424: <categoryname>system file</categoryname>
                    425: <description>
                    426: script for checking RPMS against an RPM repository
                    427: </description>
                    428: <note>
                    429: </note>
                    430: </file>
                    431: <file>
                    432: <source>loncom/build/distprobe</source>
                    433: <target dist='default'>distprobe</target>
                    434: <categoryname>system file</categoryname>
                    435: <description>
                    436: for probing operating system flavor and version
                    437: </description>
                    438: <note>
                    439: </note>
                    440: </file>
                    441: <file>
                    442: <source>loncom/build/doc_template.pl</source>
                    443: <target dist='default'>doc_template.pl</target>
                    444: <categoryname>system file</categoryname>
                    445: <description>
                    446: for making fancy install.lon-capa.org pages
                    447: </description>
                    448: <note>
                    449: </note>
                    450: </file>
                    451: <file>
                    452: <source>loncom/build/filecompare.pl</source>
                    453: <target dist='default'>filecompare.pl</target>
                    454: <categoryname>system file</categoryname>
                    455: <description>
                    456: rigorously compare many different values associated between files
                    457: </description>
                    458: <note>
                    459: </note>
                    460: </file>
                    461: <file>
1.29      raeburn   462: <source>loncom/build/getcvsdate.pl</source>
                    463: <target dist='default'>getcvsdate.pl</target>
                    464: <categoryname>system file</categoryname>
                    465: <description>
                    466: script to get CVS commit date/time for a file from file's entry in
                    467: CVS/Entries for directory containing the file
                    468: </description>
                    469: <note>
                    470: </note>
                    471: </file>
                    472: 
                    473: <file>
1.1       harris41  474: <source>loncom/build/loncaparestoreconfigurations</source>
                    475: <target dist='default'>loncaparestoreconfigurations</target>
                    476: <categoryname>system file</categoryname>
                    477: <description>
                    478: intelligently restore configuration values
                    479: </description>
                    480: <note>
                    481: </note>
                    482: </file>
                    483: <file>
                    484: <source>loncom/build/lpml.dtd</source>
                    485: <target dist='default'>lpml.dtd</target>
                    486: <categoryname>system file</categoryname>
                    487: <description>
                    488: DocumentType for LPML
                    489: </description>
                    490: <note>
                    491: </note>
                    492: </file>
                    493: <file>
                    494: <source>loncom/build/lpml_html_posteval.pl</source>
                    495: <target dist='default'>lpml_html_posteval.pl</target>
                    496: <categoryname>system file</categoryname>
                    497: <description>
                    498: </description>
                    499: <note>
                    500: </note>
                    501: </file>
                    502: <file>
                    503: <source>loncom/build/lpml_parse.pl</source>
                    504: <target dist='default'>lpml_parse.pl</target>
                    505: <categoryname>system file</categoryname>
                    506: <description>
                    507: parse apart the loncapafiles.lpml and buildfiles.lpml
                    508: </description>
                    509: <note>
                    510: </note>
                    511: </file>
                    512: <file>
                    513: <source>loncom/build/make_domain_coordinator.pl</source>
                    514: <target dist='default'>make_domain_coordinator.pl</target>
                    515: <categoryname>system file</categoryname>
                    516: <description>
                    517: make a domain coordinator on a new LON-CAPA system
                    518: </description>
                    519: <note>
                    520: </note>
                    521: </file>
                    522: <file>
1.19      albertel  523:   <source>loncom/build/add_domain_coordinator_privilege.pl</source>
                    524:   <target dist='default'>add_domain_coordinator_privilege.pl</target>
                    525:   <categoryname>system file</categoryname>
                    526:   <description>
                    527: add domain coordinator privilege to and exisiting local LON-CAPA user
                    528:   </description>
                    529:   <note>
                    530:   </note>
                    531: </file>
                    532: <file>
1.28      raeburn   533:   <source>loncom/build/expire_DC_role.pl</source>
                    534:   <target dist='default'>expire_DC_role.pl</target>
                    535:   <categoryname>system file</categoryname>
                    536:   <description>
                    537: expire domain coordinator role for exisiting local LON-CAPA user
                    538:   </description>
                    539:   <note>
                    540:   </note>
                    541: </file>
                    542: <file>
1.1       harris41  543: <source>loncom/build/piml.dtd</source>
                    544: <target dist='default'>piml.dtd</target>
                    545: <categoryname>system file</categoryname>
                    546: <description>
                    547: DocumentType definition for PIML (part of the LPML system)
                    548: </description>
                    549: <note>
                    550: </note>
                    551: </file>
                    552: <file>
                    553: <source>loncom/build/piml_parse.pl</source>
                    554: <target dist='default'>piml_parse.pl</target>
                    555: <categoryname>system file</categoryname>
                    556: <description>
                    557: parse a PIML file
                    558: </description>
                    559: <note>
                    560: </note>
                    561: </file>
                    562: <file>
                    563: <source>loncom/build/pod2html.sh</source>
                    564: <target dist='default'>pod2html.sh</target>
                    565: <categoryname>system file</categoryname>
                    566: <description>
                    567: make HTML documentation pages
                    568: </description>
                    569: <note>
                    570: </note>
                    571: </file>
                    572: <file>
                    573: <source>loncom/build/pod2man.sh</source>
                    574: <target dist='default'>pod2man.sh</target>
                    575: <categoryname>system file</categoryname>
                    576: <description>
                    577: make UNIX-style manual pages
                    578: </description>
                    579: <note>
                    580: </note>
                    581: </file>
                    582: <file>
                    583: <source>loncom/build/verify.pl</source>
                    584: <target dist='default'>verify.pl</target>
                    585: <categoryname>system file</categoryname>
                    586: <description>
                    587: wraps around filecompare.pl for posteval LPML statements
                    588: </description>
                    589: <note>
                    590: </note>
                    591: </file>
                    592: <file>
                    593: <source>loncom/build/verifymodown.pl</source>
                    594: <target dist='default'>verifymodown.pl</target>
                    595: <categoryname>system file</categoryname>
                    596: <description>
                    597: double-checks modification and ownership on files
                    598: </description>
                    599: <note>
                    600: </note>
                    601: </file>
                    602: <file>
                    603: <source>loncom/build/xfml.dtd</source>
                    604: <target dist='default'>xfml.dtd</target>
                    605: <categoryname>system file</categoryname>
                    606: <description>
                    607: DocumentType definition for XFML (part of the LPML system)
                    608: </description>
                    609: <note>
                    610: </note>
                    611: </file>
                    612: <file>
                    613: <source>loncom/build/xfml_parse.pl</source>
                    614: <target dist='default'>xfml_parse.pl</target>
                    615: <categoryname>system file</categoryname>
                    616: <description>
                    617: parses XFML files
                    618: </description>
                    619: <note>
                    620: </note>
                    621: </file>
                    622: </files>
                    623: </lpml>

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