Return to buildfiles.lpml CVS log

Up to [LON-CAPA] / doc / loncapafiles

- Include script to check ProtectHome value for systemd service for web
  server, and modify/set new value as needed, when using ./UPDATE to
  install/update a LON-CAPA instance.

<!DOCTYPE lpml PUBLIC "-//TUX/DTD lpml 1.0 Final//EN"
 "http://lpml.sourceforge.net/DTD/lpml.dtd">
<!-- buildfiles.lpml -->

<!-- $Id: buildfiles.lpml,v 1.34 2024/07/28 19:40:59 raeburn Exp $ -->

<!--

Copyright Michigan State University Board of Trustees

This file is part of the LearningOnline Network with CAPA (LON-CAPA).

LON-CAPA is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

LON-CAPA is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with LON-CAPA; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

/home/httpd/html/adm/gpl.txt

http://www.lon-capa.org/

-->

<!-- Default values must be defined before specific values. -->
<!-- If no 'dist' attribute is specified, then it is always installed. -->
<!-- If 'dist' attribute is set to  'default', then the specification. -->
<!-- is accepted if an alternative distribution is not requested or not -->
<!-- defined. -->

<lpml>
<specialnotices>
<specialnotice dist='default'>
</specialnotice>
</specialnotices>
<targetroot>/build</targetroot>
<sourceroot>/home/user/loncapa/</sourceroot>
<categories>
<category name="system file" type="runtime">
  <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
  <abbreviation>systemfile</abbreviation>
</category>
<category name="system file" type="development">
  <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
  <abbreviation>systemfile</abbreviation>
</category>
<category name="standard" type="runtime">
  <chmod dist='default'>0755</chmod><chown dist='default'>root:root</chown>
  <abbreviation>directory</abbreviation>
</category>
<category name="standard" type="development">
  <chmod dist='default'>0755</chmod><chown dist='default'>root:root</chown>
  <abbreviation>directory</abbreviation>
</category>
</categories>
<directories>
</directories>
<files>
<file>
<source>loncom/build/Makefile</source>
<target dist='default'>Makefile</target>
<categoryname>system file</categoryname>
<description>
Makefile for LON-CAPA
</description>
<note>
</note>
<dependencies>
doc/loncapafiles/configurable.gif;
doc/loncapafiles/directory.gif;
doc/loncapafiles/emptydirectory.gif;
doc/loncapafiles/graphicfile.gif;
doc/loncapafiles/handler.gif;
doc/loncapafiles/interfacefile.gif;
doc/loncapafiles/link.gif;
doc/loncapafiles/rootscript.gif;
doc/loncapafiles/script.gif;
doc/loncapafiles/setuid.gif;
doc/loncapafiles/static.gif;
doc/loncapafiles/systemfile.gif
</dependencies>
</file>
<file>
<source>doc/loncapafiles/loncapafiles.lpml</source>
<target dist='default'>loncapafiles.lpml</target>
<categoryname>system file</categoryname>
<description>
Describes the files that implement LON-CAPA on the filesystem
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/buildfiles.lpml</source>
<target dist='default'>buildfiles.lpml</target>
<categoryname>system file</categoryname>
<description>
Describes the files that implement the building of LON-CAPA inside the source
file tree.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/installfiles.lpml</source>
<target dist='default'>installfiles.lpml</target>
<categoryname>system file</categoryname>
<description>
Describes the files that help automate LON-CAPA installations on specific
operating systems.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/modify_config_files.piml</source>
<target dist='default'>modify_config_files.piml</target>
<categoryname>system file</categoryname>
<description>
Post-installation of MySQL and yum config files
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/webserver.piml</source>
<target dist='default'>webserver.piml</target>
<categoryname>system file</categoryname>
<description>
Post-installation of web server configuration files
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/reseval_fixup.piml</source>
<target dist='default'>reseval_fixup.piml</target>
<categoryname>system file</categoryname>
<description>
Migrates reseval.db to nohist_eseval.db, deletes useless hist file
</description>
<note>
</note>
</file>
<file>
  <source>doc/loncapafiles/clean_file_permissions.piml</source>
  <target dist='default'>clean_file_permissions.piml</target>
  <categoryname>system file</categoryname>
  <description>
Executes clean_db.pl on each file_permisions.db file to remove erroneuos keys.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/chkconfig.piml</source>
  <target dist='default'>chkconfig.piml</target>
  <categoryname>system file</categoryname>
  <description>
Checks that the webserver and loncontrol are properly set to run at startup
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/html_parser_check.piml</source>
  <target dist='default'>html_parser_check.piml</target>
  <categoryname>system file</categoryname>
  <description>
Checks that the HTML::parser installation has the needed patches.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/math_random_check.piml</source>
  <target dist='default'>math_random_check.piml</target>
  <categoryname>system file</categoryname>
  <description>
Checks that the Math::Random installation has the correct phrase to 
seed generator.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/logcleanup.piml</source>
  <target dist='default'>logcleanup.piml</target>
  <categoryname>system file</categoryname>
  <description>
Cleans the .perm logs, removing useless spam messages
  </description>
  <note>
  </note>
</file>
<file>
<source>doc/loncapafiles/accesscount_seed.piml</source>
<target dist='default'>accesscount_seed.piml</target>
<categoryname>system file</categoryname>
<description>
Executes seed_accesscount.pl on each nohist_resevaldata.db file to move access
count data to nohist_accesscount.db and compact the nohist_resevaldata.db
file.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/clearoutoldspreadsheetcache.piml</source>
<target dist='default'>clearoutoldspreadsheetcache.piml</target>
<categoryname>system file</categoryname>
<description>
Deletes all of the old spreadsheet cache files, the ones generated prior 
to version 0.6 were incorrect
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/sanitycheck.piml</source>
<target dist='default'>sanitycheck.piml</target>
<categoryname>system file</categoryname>
<description>
Checks LON-CAPA system for frequently occuring bugs.
</description>
<note>
</note>
</file>
<file>
  <source>doc/loncapafiles/cron_lpmlcheck.piml</source>
  <target dist='default'>cron_lpmlcheck.piml</target>
  <categoryname>system file</categoryname>
  <description>
    Checks that there is no lpmlsave file in the cron.d dir
  </description>
</file>
<file>
<source>doc/loncapafiles/ntpcheck.piml</source>
<target dist='default'>ntpcheck.piml</target>
<categoryname>system file</categoryname>
<description>
Checks server to determine status of ntpd.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/rpmcheck.piml</source>
<target dist='default'>rpmcheck.piml</target>
<categoryname>system file</categoryname>
<description>
Checks server for rpms known to conflict with LON-CAPA.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/updatequery.piml</source>
<target dist='default'>updatequery.piml</target>
<categoryname>system file</categoryname>
<description>
Checks LON-CAPA system for frequently occuring bugs.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/sendmail_fix.piml</source>
<target dist='default'>sendmail_fix.piml</target>
<categoryname>system file</categoryname>
<description>
Checks LON-CAPA system for sendmail permissions error.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/ownership_fix.piml</source>
<target dist='default'>ownership_fix.piml</target>
<categoryname>system file</categoryname>
<description>
Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
</description>
<note>
</note>
</file>
<file>
<source>doc/loncapafiles/run_searchcat.piml</source>
<target dist='default'>run_searchcat.piml</target>
<categoryname>system file</categoryname>
<description>
Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
</description>
<note>
</note>
</file>
<file>
  <source>doc/loncapafiles/update_queue_slots.piml</source>
  <target dist='default'>update_queue_slots.piml</target>
  <categoryname>system file</categoryname>
  <description>
Update the slots definitons from havin @ to having :
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/wrap_setuid.piml</source>
  <target dist='default'>wrap_setuid.piml</target>
  <categoryname>system file</categoryname>
  <description>
Wraps the setuid perl scripts into a binary excutable wrapper.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/latex_fixup.piml</source>
  <target dist='default'>latex_fixup.piml</target>
  <categoryname>system file</categoryname>
  <description>
Runs /usr/bin/mktexlsr so LaTeX sees files added to texmf/tex/latex/base
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/picins_check.piml</source>
  <target dist='default'>picins_check.piml</target>
  <categoryname>system file</categoryname>
  <description>
If picins.sty is absent, retrieves from CTAN and runs texinfo rehash 
and fmtutil-sys --missing.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/langcheck.piml</source>
  <target dist='default'>langcheck.piml</target>
  <categoryname>system file</categoryname>
  <description>
Check language used for root bash and OS, and warn if language other
than English is in use. 
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/mimetex_version_check.piml</source>
  <target dist='default'>mimetex_version_check.piml</target>
  <categoryname>system file</categoryname>
  <description>
If mimeTeX cgi has been updated will update version number in 
/home/httpd/lonTabs/mimetex-version and remove any .gif files from 
/home/httpd/cgi-bin/mimtexcache/
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/verify_domconfiguser.piml</source>
  <target dist='default'>verify_domconfiguser.piml</target>
  <categoryname>system file</categoryname>
  <description>
Determine if current machine is the primary library server for any domains.
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.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/latex_fmtutil.piml</source>
  <target dist='default'>latex_fmtutil.piml</target>
  <categoryname>system file</categoryname>
  <description>
Runs "/usr/bin/fmtutil-sys --missing" to create any missing TeX format files.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/removenolongerused.piml</source>
  <target dist='default'>removenolongerused.piml</target>
  <categoryname>system file</categoryname>
  <description>
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.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/bash_config_check.piml</source>
  <target dist='default'>bash_config_check.piml</target>
  <categoryname>system file</categoryname>
  <description>
Check for distros with readline 8.1 or newer whether bash for user www has bracketed paste mode enabled,
and, if so, include advice in WARNINGS to disable it by modifying /home/www/.inputrc.
If no change is made from the default for such distros, R commands sent to the lonr daemon will not be processed.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/systemd_config_check.piml</source>
  <target dist='default'>systemd_config_check.piml</target>
  <categoryname>system file</categoryname>
  <description>
Check for distros/versions which use systemctl, and check if ProtectHome property is set to readonly or yes 
for web server (httpd.service or apache2.service, depending on distro). If so, attempt to set ProtectHome=no  
in /etc/systemd/httpd.service.d/override.conf or /etc/systemd/apache2.service.d/override.conf, as appropriate.
  </description>
  <note>
  </note>
</file>
<file>
  <source>doc/loncapafiles/lcmathcomplex.piml</source>
  <target dist='default'>lcmathcomplex.piml</target>
  <categoryname>system file</categoryname>
  <description>
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.
  </description>
  <note>
  </note>
</file>
<file>
<source>doc/loncapafiles/valid_hosts.xfml</source>
<target dist='default'>valid_hosts.xfml</target>
<categoryname>system file</categoryname>
<description>
Useful for extracting (and pushing/pulling) information relevant
to hosts.tab.
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/check-rpms</source>
<target dist='default'>check-rpms</target>
<categoryname>system file</categoryname>
<description>
script for checking RPMS against an RPM repository
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/distprobe</source>
<target dist='default'>distprobe</target>
<categoryname>system file</categoryname>
<description>
for probing operating system flavor and version
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/doc_template.pl</source>
<target dist='default'>doc_template.pl</target>
<categoryname>system file</categoryname>
<description>
for making fancy install.lon-capa.org pages
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/filecompare.pl</source>
<target dist='default'>filecompare.pl</target>
<categoryname>system file</categoryname>
<description>
rigorously compare many different values associated between files
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/getcvsdate.pl</source>
<target dist='default'>getcvsdate.pl</target>
<categoryname>system file</categoryname>
<description>
script to get CVS commit date/time for a file from file's entry in
CVS/Entries for directory containing the file
</description>
<note>
</note>
</file>

<file>
<source>loncom/build/loncaparestoreconfigurations</source>
<target dist='default'>loncaparestoreconfigurations</target>
<categoryname>system file</categoryname>
<description>
intelligently restore configuration values
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/lpml.dtd</source>
<target dist='default'>lpml.dtd</target>
<categoryname>system file</categoryname>
<description>
DocumentType for LPML
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/lpml_html_posteval.pl</source>
<target dist='default'>lpml_html_posteval.pl</target>
<categoryname>system file</categoryname>
<description>
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/lpml_parse.pl</source>
<target dist='default'>lpml_parse.pl</target>
<categoryname>system file</categoryname>
<description>
parse apart the loncapafiles.lpml and buildfiles.lpml
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/make_domain_coordinator.pl</source>
<target dist='default'>make_domain_coordinator.pl</target>
<categoryname>system file</categoryname>
<description>
make a domain coordinator on a new LON-CAPA system
</description>
<note>
</note>
</file>
<file>
  <source>loncom/build/add_domain_coordinator_privilege.pl</source>
  <target dist='default'>add_domain_coordinator_privilege.pl</target>
  <categoryname>system file</categoryname>
  <description>
add domain coordinator privilege to and exisiting local LON-CAPA user
  </description>
  <note>
  </note>
</file>
<file>
  <source>loncom/build/expire_DC_role.pl</source>
  <target dist='default'>expire_DC_role.pl</target>
  <categoryname>system file</categoryname>
  <description>
expire domain coordinator role for exisiting local LON-CAPA user
  </description>
  <note>
  </note>
</file>
<file>
<source>loncom/build/piml.dtd</source>
<target dist='default'>piml.dtd</target>
<categoryname>system file</categoryname>
<description>
DocumentType definition for PIML (part of the LPML system)
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/piml_parse.pl</source>
<target dist='default'>piml_parse.pl</target>
<categoryname>system file</categoryname>
<description>
parse a PIML file
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/pod2html.sh</source>
<target dist='default'>pod2html.sh</target>
<categoryname>system file</categoryname>
<description>
make HTML documentation pages
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/pod2man.sh</source>
<target dist='default'>pod2man.sh</target>
<categoryname>system file</categoryname>
<description>
make UNIX-style manual pages
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/verify.pl</source>
<target dist='default'>verify.pl</target>
<categoryname>system file</categoryname>
<description>
wraps around filecompare.pl for posteval LPML statements
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/verifymodown.pl</source>
<target dist='default'>verifymodown.pl</target>
<categoryname>system file</categoryname>
<description>
double-checks modification and ownership on files
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/xfml.dtd</source>
<target dist='default'>xfml.dtd</target>
<categoryname>system file</categoryname>
<description>
DocumentType definition for XFML (part of the LPML system)
</description>
<note>
</note>
</file>
<file>
<source>loncom/build/xfml_parse.pl</source>
<target dist='default'>xfml_parse.pl</target>
<categoryname>system file</categoryname>
<description>
parses XFML files
</description>
<note>
</note>
</file>
</files>
</lpml>