--- loncom/build/readme.html 2011/01/09 19:01:23 1.23 +++ loncom/build/readme.html 2011/03/01 03:43:32 1.24 @@ -1,7 +1,7 @@ - + @@ -11,7 +11,7 @@

LON-CAPA Software Developer Guide

Created: January 17, 2001 -
Last updated: January 9, 2011 +
Last updated: February 28, 2011

  1. Using CVS @@ -28,6 +28,7 @@ Created: January 17, 2001
  2. Compiling the software (make build)
  3. Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.lpml)
  4. +
  5. Updating the LON-CAPA Version number
  6. Configurable files versus non-configurable files
  7. Updating the non-configurable files on your @@ -467,7 +468,49 @@ well. The lpml_parse.pl-loncapafiles.lpml combination has been highly efficient and error-free.

    -
  8. +
  9. +
  10. +

    Updating files containing version number on your machine (make aboutVERSION)

    +Commands +

    +cd loncom/build +
    make aboutVERSION +

    +

    +General description of what happens +

    +

    +This is the actual make target code. +

    +
    +
    +aboutVERSION:
    +        cat $(SOURCE)/loncom/license/about.html | \
    +        perl -e '$$d=`date +"%Y%m%d%H"`;chomp($$d);while(<>){s/(\<\!\-\- VERSION \-\-\>|\d+\.\d+\.CVS_HEAD\-\d{10})/$(SHOWVERSION)-$$d/; print;}' > \
    +        $(SOURCE)/loncom/license/about.html.new
    +        mv -v $(SOURCE)/loncom/license/about.html.new \
    +        $(SOURCE)/loncom/license/about.html
    +        cat $(SOURCE)/loncom/loncapa_apache.conf | \
    +        perl -e '$$d=`date +"%Y%m%d%H"`;chomp($$d);while(<>){s/(\<\!\-\- VERSION \-\-\>|\d+\.\d+\.CVS_HEAD\-\d{10})/$(SHOWVERSION)-$$d/; print;}' > \
    +        $(SOURCE)/loncom/loncapa_apache.conf.new
    +        mv -v $(SOURCE)/loncom/loncapa_apache.conf.new \
    +        $(SOURCE)/loncom/loncapa_apache.conf
    +
    +
    +

    +The LON-CAPA Version number is updated in the following files: +

      +
    • loncom/license/about.html
    • +
    • loncom/loncapa_apache.conf
    • +
    +

    +

    +Updating the version information in these files means that visitors to the static HTML page: "About LON-CAPA" on your server will see which version of LON-CAPA you are running. The same information is also displayed on the dynamic log-in page generated by lonlogin.pm. Furthermore, the version of LON-CAPA running on your server can determine which course roles may be selectable on that server, if a course contains resource(s) and/or parameter(s) which require a specific version (or newer) of LON-CAPA. It is also possible for Domain Coordinators in another domain to configure their domain to limit hosting of sessions for users from their own domain to LON-CAPA servers in other domains which are running a specific LON-CAPA version (or newer). +

    +

    On a development server, i.e., one where LON-CAPA is built and installed from a CVS checkout, running make aboutVERSION will cause the version number to be set to something of the form: M.N.CVS_HEAD-YYYYMMDDHH, where M.N will be the version number of the next stable (major) release (e.g., if the current stable release is 3.1; the next release would be 3.2), and YYYYMMDDHH is the datestamp when make aboutVERSION was last run. Note: make aboutVERSION will update the about.html and loncapa_apache.conf in the installation directory tree; it is not until make install is run that files served directly by the web server (or used for configuration) are updated with the versions in that tree. +

    +
  11. +
  12. Configurable files versus non-configurable files

    Machine-specific information is the difference