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

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.31    ! raeburn     5: <!-- $Id: buildfiles.lpml,v 1.30 2013/08/07 18:20:22 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.23      raeburn   347:   <source>doc/loncapafiles/mimetex_version_check.piml</source>
                    348:   <target dist='default'>mimetex_version_check.piml</target>
                    349:   <categoryname>system file</categoryname>
                    350:   <description>
                    351: If mimeTeX cgi has been updated will update version number in 
                    352: /home/httpd/lonTabs/mimetex-version and remove any .gif files from 
                    353: /home/httpd/cgi-bin/mimtexcache/
                    354:   </description>
                    355:   <note>
                    356:   </note>
                    357: </file>
                    358: <file>
1.26      raeburn   359:   <source>doc/loncapafiles/verify_domconfiguser.piml</source>
                    360:   <target dist='default'>verify_domconfiguser.piml</target>
                    361:   <categoryname>system file</categoryname>
                    362:   <description>
                    363: Determine if current machine is the primary library server for any domains.
                    364: 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.
                    365:   </description>
                    366:   <note>
                    367:   </note>
                    368: </file>
                    369: <file>
1.27      raeburn   370:   <source>doc/loncapafiles/latex_fmtutil.piml</source>
                    371:   <target dist='default'>latex_fmtutil.piml</target>
                    372:   <categoryname>system file</categoryname>
                    373:   <description>
                    374: Runs "/usr/bin/fmtutil-sys --missing" to create any missing TeX format files.
                    375:   </description>
                    376:   <note>
                    377:   </note>
                    378: </file>
                    379: <file>
1.30      raeburn   380:   <source>doc/loncapafiles/removenolongerused.piml</source>
                    381:   <target dist='default'>removenolongerused.piml</target>
                    382:   <categoryname>system file</categoryname>
                    383:   <description>
                    384: 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.
                    385:   </description>
                    386:   <note>
                    387:   </note>
                    388: </file>
                    389: <file>
1.31    ! raeburn   390:   <source>doc/loncapafiles/lcmathcomplex.piml</source>
        !           391:   <target dist='default'>lcmathcomplex.piml</target>
        !           392:   <categoryname>system file</categoryname>
        !           393:   <description>
        !           394: 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.
        !           395:   </description>
        !           396:   <note>
        !           397:   </note>
        !           398: </file>
        !           399: <file>
1.1       harris41  400: <source>doc/loncapafiles/valid_hosts.xfml</source>
                    401: <target dist='default'>valid_hosts.xfml</target>
                    402: <categoryname>system file</categoryname>
                    403: <description>
                    404: Useful for extracting (and pushing/pulling) information relevant
                    405: to hosts.tab.
                    406: </description>
                    407: <note>
                    408: </note>
                    409: </file>
                    410: <file>
                    411: <source>loncom/build/check-rpms</source>
                    412: <target dist='default'>check-rpms</target>
                    413: <categoryname>system file</categoryname>
                    414: <description>
                    415: script for checking RPMS against an RPM repository
                    416: </description>
                    417: <note>
                    418: </note>
                    419: </file>
                    420: <file>
                    421: <source>loncom/build/distprobe</source>
                    422: <target dist='default'>distprobe</target>
                    423: <categoryname>system file</categoryname>
                    424: <description>
                    425: for probing operating system flavor and version
                    426: </description>
                    427: <note>
                    428: </note>
                    429: </file>
                    430: <file>
                    431: <source>loncom/build/doc_template.pl</source>
                    432: <target dist='default'>doc_template.pl</target>
                    433: <categoryname>system file</categoryname>
                    434: <description>
                    435: for making fancy install.lon-capa.org pages
                    436: </description>
                    437: <note>
                    438: </note>
                    439: </file>
                    440: <file>
                    441: <source>loncom/build/filecompare.pl</source>
                    442: <target dist='default'>filecompare.pl</target>
                    443: <categoryname>system file</categoryname>
                    444: <description>
                    445: rigorously compare many different values associated between files
                    446: </description>
                    447: <note>
                    448: </note>
                    449: </file>
                    450: <file>
1.29      raeburn   451: <source>loncom/build/getcvsdate.pl</source>
                    452: <target dist='default'>getcvsdate.pl</target>
                    453: <categoryname>system file</categoryname>
                    454: <description>
                    455: script to get CVS commit date/time for a file from file's entry in
                    456: CVS/Entries for directory containing the file
                    457: </description>
                    458: <note>
                    459: </note>
                    460: </file>
                    461: 
                    462: <file>
1.1       harris41  463: <source>loncom/build/loncaparestoreconfigurations</source>
                    464: <target dist='default'>loncaparestoreconfigurations</target>
                    465: <categoryname>system file</categoryname>
                    466: <description>
                    467: intelligently restore configuration values
                    468: </description>
                    469: <note>
                    470: </note>
                    471: </file>
                    472: <file>
                    473: <source>loncom/build/lpml.dtd</source>
                    474: <target dist='default'>lpml.dtd</target>
                    475: <categoryname>system file</categoryname>
                    476: <description>
                    477: DocumentType for LPML
                    478: </description>
                    479: <note>
                    480: </note>
                    481: </file>
                    482: <file>
                    483: <source>loncom/build/lpml_html_posteval.pl</source>
                    484: <target dist='default'>lpml_html_posteval.pl</target>
                    485: <categoryname>system file</categoryname>
                    486: <description>
                    487: </description>
                    488: <note>
                    489: </note>
                    490: </file>
                    491: <file>
                    492: <source>loncom/build/lpml_parse.pl</source>
                    493: <target dist='default'>lpml_parse.pl</target>
                    494: <categoryname>system file</categoryname>
                    495: <description>
                    496: parse apart the loncapafiles.lpml and buildfiles.lpml
                    497: </description>
                    498: <note>
                    499: </note>
                    500: </file>
                    501: <file>
                    502: <source>loncom/build/make_domain_coordinator.pl</source>
                    503: <target dist='default'>make_domain_coordinator.pl</target>
                    504: <categoryname>system file</categoryname>
                    505: <description>
                    506: make a domain coordinator on a new LON-CAPA system
                    507: </description>
                    508: <note>
                    509: </note>
                    510: </file>
                    511: <file>
1.19      albertel  512:   <source>loncom/build/add_domain_coordinator_privilege.pl</source>
                    513:   <target dist='default'>add_domain_coordinator_privilege.pl</target>
                    514:   <categoryname>system file</categoryname>
                    515:   <description>
                    516: add domain coordinator privilege to and exisiting local LON-CAPA user
                    517:   </description>
                    518:   <note>
                    519:   </note>
                    520: </file>
                    521: <file>
1.28      raeburn   522:   <source>loncom/build/expire_DC_role.pl</source>
                    523:   <target dist='default'>expire_DC_role.pl</target>
                    524:   <categoryname>system file</categoryname>
                    525:   <description>
                    526: expire domain coordinator role for exisiting local LON-CAPA user
                    527:   </description>
                    528:   <note>
                    529:   </note>
                    530: </file>
                    531: <file>
1.1       harris41  532: <source>loncom/build/piml.dtd</source>
                    533: <target dist='default'>piml.dtd</target>
                    534: <categoryname>system file</categoryname>
                    535: <description>
                    536: DocumentType definition for PIML (part of the LPML system)
                    537: </description>
                    538: <note>
                    539: </note>
                    540: </file>
                    541: <file>
                    542: <source>loncom/build/piml_parse.pl</source>
                    543: <target dist='default'>piml_parse.pl</target>
                    544: <categoryname>system file</categoryname>
                    545: <description>
                    546: parse a PIML file
                    547: </description>
                    548: <note>
                    549: </note>
                    550: </file>
                    551: <file>
                    552: <source>loncom/build/pod2html.sh</source>
                    553: <target dist='default'>pod2html.sh</target>
                    554: <categoryname>system file</categoryname>
                    555: <description>
                    556: make HTML documentation pages
                    557: </description>
                    558: <note>
                    559: </note>
                    560: </file>
                    561: <file>
                    562: <source>loncom/build/pod2man.sh</source>
                    563: <target dist='default'>pod2man.sh</target>
                    564: <categoryname>system file</categoryname>
                    565: <description>
                    566: make UNIX-style manual pages
                    567: </description>
                    568: <note>
                    569: </note>
                    570: </file>
                    571: <file>
                    572: <source>loncom/build/verify.pl</source>
                    573: <target dist='default'>verify.pl</target>
                    574: <categoryname>system file</categoryname>
                    575: <description>
                    576: wraps around filecompare.pl for posteval LPML statements
                    577: </description>
                    578: <note>
                    579: </note>
                    580: </file>
                    581: <file>
                    582: <source>loncom/build/verifymodown.pl</source>
                    583: <target dist='default'>verifymodown.pl</target>
                    584: <categoryname>system file</categoryname>
                    585: <description>
                    586: double-checks modification and ownership on files
                    587: </description>
                    588: <note>
                    589: </note>
                    590: </file>
                    591: <file>
                    592: <source>loncom/build/xfml.dtd</source>
                    593: <target dist='default'>xfml.dtd</target>
                    594: <categoryname>system file</categoryname>
                    595: <description>
                    596: DocumentType definition for XFML (part of the LPML system)
                    597: </description>
                    598: <note>
                    599: </note>
                    600: </file>
                    601: <file>
                    602: <source>loncom/build/xfml_parse.pl</source>
                    603: <target dist='default'>xfml_parse.pl</target>
                    604: <categoryname>system file</categoryname>
                    605: <description>
                    606: parses XFML files
                    607: </description>
                    608: <note>
                    609: </note>
                    610: </file>
                    611: </files>
                    612: </lpml>

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