Diff for /loncom/build/Makefile between versions 1.128 and 1.129

version 1.128, 2002/07/19 18:54:41 version 1.129, 2002/07/23 22:17:22
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
   
 # Scott Harrison  # Scott Harrison, your friendly neighborhood volunteer
 # $Id$  # $Id$
   
   # TYPICAL USAGE of this Makefile is primarily for two targets:
   # "make build" and "make install".
   # Many other targets and features are supported (see the initial
   # help targets).
   
   # ======================================= Default settings for Makefile options
 DISTPROBE=`perl ./distprobe`  DISTPROBE=`perl ./distprobe`
 DIST=$(DISTPROBE)  DIST=$(DISTPROBE)
 CATEGORY="development"  CATEGORY="development"
Line 20  MTARGET="" Line 26  MTARGET=""
 VERSION=0.4  VERSION=0.4
 DIRTARGET=loncapa-$(VERSION)  DIRTARGET=loncapa-$(VERSION)
   
   # =============================================== Help targets for the Makefile
   # If 'make' is run without any arguments, the 'help' target is called since
   # it is the first target.
 help:  help:
  @echo "*** You need to specify a valid target ***"   @echo "*** You need to specify a valid target ***"
  @echo "NOTE: You can specify options to your Makefile target."   @echo "To get a list of valid targets: \"make help_TARGETS\""
    @echo "To get a list of valid options: \"make help_OPTIONS\""
    @echo " "
    @echo "Typically invoked targets are:"
    @echo "    make build"
    @echo "    make install"
    @echo "    make test"
    @echo "    make clean"
   
   help_OPTIONS:
    @echo "* ADJUSTABLE OPTIONS *"
  @echo "(option) DIST can be redhat7, debian, redhat6.2, or default"   @echo "(option) DIST can be redhat7, debian, redhat6.2, or default"
  @echo "(option) CATEGORY can be runtime or development"   @echo "         You probably do not need to specify this; it is"
  @echo "(option) SOURCE is an absolute or relative directory path"   @echo "         automatically probed for."
  @echo "(option) TARGET is an absolute or relative directory path"   @echo "(option) CATEGORY can be 'runtime' or 'development'; currently"
  @echo "build: compile the CVS source tree"   @echo "         the 'development' setting is the most reliable;"
  @echo "install: install from a compiled CVS source tree to a "   @echo "         eventually, production machines should be using the"
  @echo "         specified TARGET destination on the filesystem"   @echo "         'runtime' settings"
  @echo "test: test different parts of the LON-CAPA system (TEST_*)"   @echo "(option) SOURCE is an absolute or relative directory path."
  @echo "TEST_lpml_scripts: make sure that the system can process "   @echo "         SOURCE corresponds to the root directory of the"
  @echo "                   the Linux Packaging Markup Language"   @echo "         loncapa source release"
    @echo "(option) TARGET is an absolute or relative directory path."
    @echo "         This is where files will be installed on your system."
    @echo "         Typically, this should be set to nothing (which"
    @echo "         corresponds to the '/' root of the entire filesystem)."
    @echo "(option) NORESTORECONF, when set to a non-zero value, stops"
    @echo "         filesystem upgrades from overwriting existing "
    @echo "         configuration files.  Ordinarily, NORESTORECONF=0, "
    @echo "         because the existing configuration files are safely"
    @echo "         dealt with (or so one hopes... :) )."
    @echo "(option) HOSTNAME specifies the name of a remote server for"
    @echo "         which a NET_* Makefile target should be launched"
    @echo "(option) VERSION; especially useful for the 'tardist' target"
    @echo "         this tags the tarball file and internal directories"
    @echo "         with a specific version string (conventionally "
    @echo "         numeric)"
   
   help_TARGETS:
    @echo "*** RUNNING TESTS TO ENSURE SOLID PERFORMANCE ***"
    @echo "test: test different parts of the LON-CAPA system (TEST_*)."
    @echo "      Makefile-dependent processes as well as horizontal and"
    @echo "      vertical aspects of the LON-CAPA system architecture"
    @echo "      are all tested."
    @echo "TEST_lpml_scripts: make sure that the system can process"
    @echo "                   the Linux Packaging Markup Language."
    @echo "                   This is neither horizontal or vertical"
    @echo "                   testing.  The idea is to make sure that"
    @echo "                   the installation software itself works"
    @echo "                   as expected."
  @echo "TEST_system_dependencies: make sure that all needed system "   @echo "TEST_system_dependencies: make sure that all needed system "
  @echo "                          components are active and present "   @echo "                          components are active and present "
  @echo "                          on the server such as perl modules"   @echo "                          on the server such as perl modules"
  @echo "                          and the MySQL database"   @echo "                          and the MySQL database"
  @echo "TEST_web_layer: mimic a login and various system actions on "   @echo "                          (horizontal testing)"
    @echo "TEST_web_layer: mimic a login and various vertical actions on "
  @echo "                a LON-CAPA system"   @echo "                a LON-CAPA system"
    @echo "TEST_hosts_tab: make sure that a loncapa/loncom/hosts.tab"
    @echo "                file is specified for installation"
    @echo "TEST_html2ps: test for the presence of html2ps which is needed"
    @echo "              for making a PDF compilation for pdfdoc"
    @echo "*** GENERAL TARGETS SUCH AS 'build' AND 'install' ***"
    @echo "build: compile the source tree"
    @echo "buildflag: a semaphore that helps educate the user to run"
    @echo "           'make build' first before running 'make install'"
    @echo "configinstall: install configuration files and restore with"
    @echo "               prior information"
    @echo "install: install from a ***compiled*** source tree
    @echo "         (see make build) to a specified TARGET destination"
    @echo "         on the filesystem (default setting is TARGET=/)."
    @echo "rawinstall: just install files, links and directories without"
    @echo "            any bells or whistles (e.g. double-checking"
    @echo "            configurations, fine-tuning webserver, etc.)"
    @echo "hosts_tab: install the hosts.tab to the filesystem"
    @echo "webserverconf: fine-tune the web server configuration;"
    @echo "               make sure the proper 'Include' statements"
    @echo "               are appended to httpd.conf"
    @echo "vanillatar: generate top-level files such as README, UPDATE,"
    @echo "            CHECKRPMS, and TEST (needed by tardist)"
    @echo "tardist: build a tarball that will upgrade the software on a "
    @echo "         system"
    @echo "sanitycheck: probe for common errors and recommend fixes to"
    @echo "             the user"
    @echo "updatequery: solicit the user for machine configuration"
    @echo "             information; to be incorporated during an update"
    @echo "             procedure (via the UPDATE command)"
    @echo "postinstall: double-check things after installation"
    @echo "VERSION: tag the filesystem with version information inside"
    @echo "         /etc/loncapa-release"
    @echo "aboutVERSION: place version information inside about.html"
    @echo "*** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml ***"
    @echo "Makefile.configinstall: generate a Makefile for configuration"
    @echo "                        files; built dynamically from"
    @echo "                        loncapafiles.lpml"
    @echo "Makefile.build: generate a Makefile for compiling"
    @echo "                files inside the source directory; "
    @echo "                Makefile.build is generated from"
    @echo "                loncapafiles.lpml"
    @echo "Makefile.install: generate a Makefile for installing"
    @echo "                  files; built dynamically from"
    @echo "                  loncapafiles.lpml"
    @echo "*** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK ***"
    @echo "lpmladm: coordinates username=lpmladm mediated secure shell"
    @echo "         processes; needed for the NET_* targets"
    @echo "NET_hosts_tab: install the hosts.tab to a filesystem elsewhere"
    @echo "               on the network"
    @echo "NET_webserverconf: fine-tune the web server configuration on a"
    @echo "                   filesystem elsewhere on the network"
    @echo "NET_rawinstall: launch the rawinstall target on a filesystem"
    @echo "                elsewhere on the network"
    @echo "*** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES ***"
    @echo "MANIFEST_all: generate a list of all files to be included in"
    @echo "              the distributed tarball"
    @echo "MANIFEST_cvs: essentially a list of all CVS/Entries files used"
    @echo "              for 'time-checking' intelligence"
    @echo "MANIFEST_lpml: a list of all LON-CAPA files to be installed,
    @echo "               compile from, used as building software, and"
    @echo "               testing"
    @echo "MANIFEST_vanillatar: 'README'-type top-level files that a user"
    @echo "                     of the distributed tarball would first"
    @echo "                     look at and work with"
    @echo "*** STATUS REPORT TARGETS ***"
    @echo "warningnote: analyze the WARNINGS file and produce a synopsis"
    @echo "             and recommended action to the user"
  @echo "HTML: generate an HTML-formatted description of the LON-CAPA"   @echo "HTML: generate an HTML-formatted description of the LON-CAPA"
  @echo "      CVS files"   @echo "      source files"
  @echo "documentation_tree: compiles a documentation tree from the "   @echo "status: compare the TARGET filesystem with a compiled loncapa "
  @echo "                    CVS:doc directory"  
  @echo "status: compare the TARGET filesystem with a compiled CVS "  
  @echo "        source directory"   @echo "        source directory"
  @echo "statuspost: post the results of "make status" to "   @echo "statuspost: post the results of "make status" to "
  @echo "            TARGET/home/httpd/html/lon-status/filestatus.html"   @echo "            TARGET/home/httpd/html/lon-status/filestatus.html"
  @echo "rpmstatus: compare the rpms on a system to defined lists "   @echo "rpmstatus: compare the rpms on a system to defined lists "
  @echo "           CVS:doc/otherfiles/cd_rpms and "   @echo "           loncapa/doc/otherfiles/cd_rpms and "
  @echo "           CVS:doc/otherfiles/rpm_list.txt"   @echo "           loncapa/doc/otherfiles/rpm_list.txt"
  @echo "rpmstatuspost: post the results of "make rpmstatus" to "   @echo "rpmstatuspost: post the results of 'make rpmstatus' to "
  @echo "            TARGET/home/httpd/html/lon-status/rpmstatus.html"   @echo "            TARGET/home/httpd/html/lon-status/rpmstatus.html"
  @echo "RPM: build LON-CAPA-base RPM from CVS repository"   @echo "*** ALTERNATIVE PACKAGING TARGETS ***"
  @echo "setup_RPM: build LON-CAPA-setup RPM from CVS repository"   @echo "RPM: build LON-CAPA-base RPM from loncapa source repository"
  @echo "           handy for CD-ROM generation"   @echo "     (still under development)"
  @echo "tardist: build a tarball that will upgrade the software on a "   @echo "DPKG: build a loncapa Debian package from loncapa source"
  @echo "         system"   @echo "      repository (still under development)"
    @echo "base_rpm_file_list: create a file listing to be used for"
    @echo "                    generating an RPM software package"
    @echo "BinaryRoot: create a BinaryRoot directory to be used for"
    @echo "            generating an RPM software package"
    @echo "*** MASTER DOCUMENTATION TARGETS ***"
    @echo "doc: generate web-page documentation for install.lon-capa.org"
    @echo "     (and eventually for documentation on installed machines)"
    @echo "pdfdoc: make a PDF-formatted compilation of all installation"
    @echo "        documentation"
    @echo "*** KEEPING THINGS CLEAN ***"
    @echo "clean: remove any files that might (even by remote chance)"
    @echo "       interfere with rebuilding/recompiling software"
    @echo "reallyclean: remove all files that were generated during"
    @echo "             building or compilation of the software"
    @echo "*** A HELPFUL DEPENDENCY ***"
    @echo "alwaysrun: blank target that is a dependency for targets"
    @echo "           that should \"always run\""
   
   # =========================== *** RUNNING TESTS TO ENSURE SOLID PERFORMANCE ***
   
 test: TEST_lpml_scripts TEST_system_dependencies TEST_web_layer  test: TEST_lpml_scripts TEST_system_dependencies TEST_web_layer
  @echo "ALL SYSTEM DEPENDENCY TESTS SUCCESSFUL"   @echo "ALL SYSTEM DEPENDENCY TESTS SUCCESSFUL"
Line 76  TEST_web_layer: Line 208  TEST_web_layer:
 TEST_hosts_tab:  TEST_hosts_tab:
  @echo "Testing hosts.tab"   @echo "Testing hosts.tab"
  @if (test -e ../hosts.tab); then \   @if (test -e ../hosts.tab); then \
  echo "there is a defined link; assume okay"; \   echo "there is a defined link or file; assume okay"; \
  else echo "**** ERROR **** hosts.tab not defined!" && \   else echo "**** ERROR **** hosts.tab not defined!" && \
      echo -n "You need to do one of the following within your " && \       echo -n "You need to do one of the following within your " && \
      echo "CVS repository (cd loncapa/loncom)" && \       echo "CVS repository (cd loncapa/loncom)" && \
Line 87  TEST_hosts_tab: Line 219  TEST_hosts_tab:
      exit 1; \       exit 1; \
  fi   fi
   
 NET_hosts_tab:  TEST_html2ps:
  make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \   @if (test -e /usr/local/html2ps/bin/html2ps); then \
  MTARGET="hosts_tab" HOSTNAME="$(HOSTNAME)" lpmladm   echo "I can find html2ps; assume okay"; \
    else \
    echo "**** ERROR **** cannot find /usr/local/html2ps/bin/html2ps!" && \
           echo "Please visit http://www.tdb.uu.se/~jan/html2ps.html" && \
    exit 1; \
    fi
   
   # ======================= *** GENERAL TARGETS SUCH AS 'build' AND 'install' ***
   
   build: Makefile.build pod2html.sh pod2man.sh
    install -d $(SOURCE)/doc/man
    install -d $(SOURCE)/doc/scripts
    install -d $(SOURCE)/doc/lib/perl/Apache
    echo -n "" > WARNINGS
    make -f Makefile.build all
    echo '1' > buildflag
    make warningnote
   
   buildflag:
    @echo "**** ERROR **** You need to run 'make build' first" > WARNINGS
    make warningnote
    @need_to_run_make_build_first 2>/dev/null
   
   configinstall: Makefile.configinstall
    make -f Makefile.configinstall SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    configfiles
    if (test "0" = $(NORESTORECONF)); then \
    perl loncaparestoreconfigurations suffix .lpmlnew; fi
   
   install: buildflag VERSION TEST_hosts_tab Makefile.install Makefile
    echo -n "" > WARNINGS
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    directories
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links
    make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    NORESTORECONF="$(NORESTORECONF)" configinstall
    make postinstall
    make warningnote
    echo "You can run 'make test' to see if your system is ready to go!"
    echo "NOTE THAT YOUR SYSTEM MUST HAVE MYSQL WITH A USER=\"www\" AND"
    echo -n "PASSWORD=\"localhostkey\" FOR www\@localhost"
    echo -n "(YOU MAY NEED TO REINITIALIZE YOUR MYSQL www\@localhost USER)"
    echo -n "Please see http://install.lon-capa.org/ for more information"
   
   rawinstall: VERSION Makefile.install Makefile
    echo -n "" > WARNINGS
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    directories
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files
    make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links
    make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \
    NORESTORECONF="$(NORESTORECONF)" configinstall
   
 hosts_tab: TEST_hosts_tab  hosts_tab: TEST_hosts_tab
  cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \   cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
Line 102  hosts_tab: TEST_hosts_tab Line 286  hosts_tab: TEST_hosts_tab
  @echo "   /etc/rc.d/init.d/httpd restart"   @echo "   /etc/rc.d/init.d/httpd restart"
  @echo "   /etc/rc.d/init.d/loncontrol restart"   @echo "   /etc/rc.d/init.d/loncontrol restart"
   
   webserverconf:
    cat $(SOURCE)/doc/loncapafiles/webserver.piml | \
    perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH)
   
   # ---------------- Top-level files such as README, UPDATE, CHECKRPMS, and TEST
   vanillatar:
    # --------------------------- Point UPDATE to the internal make process
    echo '#!/bin/sh' > $(SOURCE)/UPDATE
    echo 'touch loncom/build/WARNINGS' >> $(SOURCE)/UPDATE;
    echo 'ln -s loncom/build/WARNINGS WARNINGS' >> $(SOURCE)/UPDATE;
    echo 'cd loncom/build; make build' >> $(SOURCE)/UPDATE
    echo 'make rawinstall' >> $(SOURCE)/UPDATE
    echo 'make configinstall' >> $(SOURCE)/UPDATE
    echo 'make updatequery' >> $(SOURCE)/UPDATE
    echo 'make hosts_tab' >> $(SOURCE)/UPDATE
    echo 'make postinstall' >> $(SOURCE)/UPDATE
    echo 'make aboutVERSION' >> $(SOURCE)/UPDATE
    echo 'make warningnote' >> $(SOURCE)/UPDATE
    # ----------------------------- Point TEST to the internal make process
    echo '#!/bin/sh' > $(SOURCE)/TEST
    echo 'cd loncom/build; make test' >> $(SOURCE)/TEST
    # ----------------------------- Copy CHECKRPMS to the vanilla top-level
    cp -v $(SOURCE)/loncom/build/CHECKRPMS $(SOURCE)/CHECKRPMS
    # ----------------------- vanilla executables must indeed be executable
    chmod a+rx $(SOURCE)/UPDATE
    chmod a+rx $(SOURCE)/TEST
    chmod a+rx $(SOURCE)/CHECKRPMS
    # -------------------------------- Copy README to the vanilla top-level
    cp -v $(SOURCE)/doc/shortest_path_redhat7.2.txt $(SOURCE)/README
   
   tardist:
    make MANIFEST_all
    make vanillatar
    # -------------------------------------------------------- Make tardist
    @cd $(SOURCE); \
    if (test -h $(DIRTARGET)); then \
    echo "$(DIRTARGET) link already defined; assume okay"; \
    else \
    ln -s . $(DIRTARGET); \
    fi
    cp -v $(SOURCE)/loncom/license/about.html \
    $(SOURCE)/loncom/license/about.html.orig
    make aboutVERSION
    cd $(SOURCE); \
    tar --no-recursion --numeric-owner --files-from MANIFEST \
    -h -czf $(DIRTARGET).tar.gz 2>tar_WARNINGS || [ "0" == "0" ]
    mv -v $(SOURCE)/loncom/license/about.html.orig \
    $(SOURCE)/loncom/license/about.html
    cat $(SOURCE)/tar_WARNINGS | \
    xargs --replace=XXX echo '**** WARNING **** XXX' > WARNINGS
    rm -f $(SOURCE)/tar_WARNINGS
    make warningnote
   
   sanitycheck:
    cat $(SOURCE)/doc/loncapafiles/sanitycheck.piml | \
    perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \
    tee -a WARNINGS
   
   updatequery:
    cat $(SOURCE)/doc/loncapafiles/updatequery.piml | \
    perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(QUERYLAUNCH)
   
   postinstall:
    make webserverconf
    make sanitycheck
   
   VERSION:
    install -d $(TARGET)/etc
    echo -n "LON-CAPA release $(VERSION)-" > $(TARGET)/etc/loncapa-release
    date +"%Y%m%d" >> $(TARGET)/etc/loncapa-release
   
   aboutVERSION:
    cat $(SOURCE)/loncom/license/about.html | \
    perl -e '$$d=`date +"%Y%m%d"`;chomp($$d);while(<>){s/\<\!\-\- VERSION \-\-\>/$(VERSION)-$$d/; print;}' > \
    $(SOURCE)/loncom/license/about.html.new
    mv -v $(SOURCE)/loncom/license/about.html.new \
    $(SOURCE)/loncom/license/about.html
   
   # ========= *** Makefile.* TARGETS BUILT DYNAMICALLY FROM loncapafiles.lpml ***
   
   Makefile.configinstall: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml \
                           lpml_parse.pl
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "$(SOURCE)" \
    "$(TARGET)" > Makefile.configinstall
   
   Makefile.build: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml lpml_parse.pl
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl lpml_parse.pl build $(CATEGORY) $(DIST) "$(SOURCE)" "$(TARGET)" \
    > Makefile.build
   
   Makefile.install: alwaysrun
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \
    "$(TARGET)" > Makefile.install
   
   # ============= *** TARGETS FOR OPERATING ON FILESYSTEMS ACROSS THE NETWORK ***
   
 lpmladm:  lpmladm:
  @if (test $(METAMTARGET) = "TRANSPORT"); then \   @if (test $(METAMTARGET) = "TRANSPORT"); then \
  echo "Transporting to $(HOSTNAME)"; \   echo "Transporting to $(HOSTNAME)"; \
Line 132  lpmladm: Line 414  lpmladm:
  echo "**** ERROR **** Incorrect METAMTARGET"; \   echo "**** ERROR **** Incorrect METAMTARGET"; \
  fi   fi
   
   NET_hosts_tab:
    make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \
    MTARGET="hosts_tab" HOSTNAME="$(HOSTNAME)" lpmladm
   
   NET_webserverconf:
    make TIMESTAMP=`date +"%s"` METAMTARGET="LAUNCH" \
    MTARGET="webserverconf" HOSTNAME="$(HOSTNAME)" lpmladm
   
   NET_rawinstall:
    make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \
    MTARGET="rawinstall" HOSTNAME="$(HOSTNAME)" lpmladm
   
   # ============== *** TARGETS FOR MAKING LISTS (MANIFESTS) OF LON-CAPA FILES ***
   
   MANIFEST_all:
    # --------------------------------------------------------- start clean
    rm -f $(SOURCE)/MANIFEST
    make MANIFEST_lpml
    make MANIFEST_vanillatar
    make MANIFEST_cvs
    # ---------------------------------- might as well include the MANIFEST
    echo 'MANIFEST' >> $(SOURCE)/MANIFEST
    # ------------------------------------------ hosts.tab are belong to us
    echo 'loncom/rawhide_hosts.tab' >> $(SOURCE)/MANIFEST
    echo 'loncom/production_hosts.tab' >> $(SOURCE)/MANIFEST
    echo 'loncom/development_hosts.tab' >> $(SOURCE)/MANIFEST
    # ------------------ Files needed for dynamically generated directories
    echo 'doc/man' >> $(SOURCE)/MANIFEST
    echo 'doc/lib' >> $(SOURCE)/MANIFEST
    echo 'doc/lib/perl' >> $(SOURCE)/MANIFEST
    echo 'doc/lib/perl/Apache' >> $(SOURCE)/MANIFEST
    echo 'doc/scripts' >> $(SOURCE)/MANIFEST
    # --------------------------------------------------- Clean up MANIFEST
    cd $(SOURCE); \
    sort MANIFEST | perl -nle 'print "$(DIRTARGET)/$$_"' | \
    perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
    perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
    perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \
    perl -nle 's/\/\.\//\//g;print' | sort | uniq > \
    MANIFEST_loncapa
    cd $(SOURCE); mv -v MANIFEST_loncapa MANIFEST
   
   # --------------- MANIFEST files with important CVS versioning/date information
   MANIFEST_cvs:
    # ------ CVS/Entries directories to retain 'time-checking' intelligence
    cd $(SOURCE); find . -type f -name 'Entries' | grep 'CVS/Entries' >> \
    MANIFEST
   
   # ------------------- MANIFEST the building, testing and standard loncapa files
   MANIFEST_lpml:
    cat $(SOURCE)/doc/loncapafiles/buildfiles.lpml | \
    perl lpml_parse.pl MANIFEST development default \
    '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
    cat $(SOURCE)/doc/loncapafiles/testfiles.lpml | \
    perl lpml_parse.pl MANIFEST development default \
    '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
    cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
    perl lpml_parse.pl MANIFEST development default \
    '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST
   
   # ------------ Files for top-level (the vanilla layer that the user first sees)
   MANIFEST_vanillatar:
    echo 'README' >> $(SOURCE)/MANIFEST
    echo 'UPDATE' >> $(SOURCE)/MANIFEST
    echo 'TEST' >> $(SOURCE)/MANIFEST
    echo 'CHECKRPMS' >> $(SOURCE)/MANIFEST
   
   # =============================================== *** STATUS REPORT TARGETS ***
   
   warningnote:
    @if (test -s WARNINGS); then \
    W=`grep -c '\*\*\*\* WARNING' WARNINGS`; \
    E=`grep -c '\*\*\*\* ERROR' WARNINGS`; \
    N=`grep -c '\*\*\*\* NOTE' WARNINGS`; \
    echo "--->  $$W WARNINGS ENCOUNTERED!       "; \
    echo "--->  $$E ERRORS ENCOUNTERED!         "; \
    echo "--->  $$N NOTES ENCOUNTERED!          "; \
    echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \
    echo "!!!!  Please read the WARNINGS file !!!!"; \
    echo "!!!!   to make sure everything is   !!!!"; \
    echo "!!!!    correct and taken care of   !!!!"; \
    echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \
    fi
   
 HTML:  HTML:
  install -d HTML   install -d HTML
  cp $(SOURCE)/doc/loncapafiles/*.gif HTML   cp $(SOURCE)/doc/loncapafiles/*.gif HTML
Line 166  rpmstatus: Line 532  rpmstatus:
 rpmstatuspost: rpmstatus  rpmstatuspost: rpmstatus
  cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html   cp RPMSTATUS/rpmstatus.html /home/httpd/html/lon-status/rpmstatus.html
   
 configinstall: Makefile.configinstall  # ======================================= *** ALTERNATIVE PACKAGING TARGETS ***
  make -f Makefile.configinstall SOURCE="$(SOURCE)" TARGET="$(TARGET)" \  
  configfiles  
  if (test "0" = $(NORESTORECONF)); then \  
  perl loncaparestoreconfigurations suffix .lpmlnew; fi  
   
 Makefile.configinstall: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml lpml_parse.pl  
  cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \  
  perl lpml_parse.pl configinstall $(CATEGORY) $(DIST) "$(SOURCE)" \  
  "$(TARGET)" > Makefile.configinstall  
   
 warningnote:  
  @if (test -s WARNINGS); then \  
  W=`grep -c '\*\*\*\* WARNING' WARNINGS`; \  
  E=`grep -c '\*\*\*\* ERROR' WARNINGS`; \  
  N=`grep -c '\*\*\*\* NOTE' WARNINGS`; \  
  echo "--->  $$W WARNINGS ENCOUNTERED!       "; \  
  echo "--->  $$E ERRORS ENCOUNTERED!         "; \  
  echo "--->  $$N NOTES ENCOUNTERED!          "; \  
  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \  
  echo "!!!!  Please read the WARNINGS file !!!!"; \  
  echo "!!!!   to make sure everything is   !!!!"; \  
  echo "!!!!    correct and taken care of   !!!!"; \  
  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"; \  
  fi  
   
 NET_webserverconf:  
  make TIMESTAMP=`date +"%s"` METAMTARGET="LAUNCH" \  
  MTARGET="webserverconf" HOSTNAME="$(HOSTNAME)" lpmladm  
   
 webserverconf:  
  cat $(SOURCE)/doc/loncapafiles/webserver.piml | \  
  perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH)  
   
 sanitycheck:  
  cat $(SOURCE)/doc/loncapafiles/sanitycheck.piml | \  
  perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(LAUNCH) | \  
  tee -a WARNINGS  
   
 updatequery:  
  cat $(SOURCE)/doc/loncapafiles/updatequery.piml | \  
  perl piml_parse.pl $(CATEGORY) $(DIST) "$(TARGET)" $(QUERYLAUNCH)  
   
 postinstall:  
  make webserverconf  
  make sanitycheck  
   
 NET_rawinstall:  
  make TIMESTAMP=`date +"%s"` METAMTARGET="TRANSPORT" \  
  MTARGET="rawinstall" HOSTNAME="$(HOSTNAME)" lpmladm  
   
 VERSION:  
  install -d $(TARGET)/etc  
  echo -n "LON-CAPA release $(VERSION)-" > $(TARGET)/etc/loncapa-release  
  date +"%Y%m%d" >> $(TARGET)/etc/loncapa-release  
   
 aboutVERSION:  
  cat $(SOURCE)/loncom/license/about.html | \  
  perl -e '$$d=`date +"%Y%m%d"`;chomp($$d);while(<>){s/\<\!\-\- VERSION \-\-\>/$(VERSION)-$$d/; print;}' > \  
  $(SOURCE)/loncom/license/about.html.new  
  mv -v $(SOURCE)/loncom/license/about.html.new \  
  $(SOURCE)/loncom/license/about.html  
   
 install: VERSION TEST_hosts_tab Makefile.install Makefile  
  echo -n "" > WARNINGS  
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \  
  directories  
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files  
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links  
  make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \  
  NORESTORECONF="$(NORESTORECONF)" configinstall  
  make postinstall  
  make warningnote  
  echo "You can run 'make test' to see if your system is ready to go!"  
  echo "NOTE THAT YOUR SYSTEM MUST HAVE MYSQL WITH A USER=\"www\" AND"  
  echo -n "PASSWORD=\"localhostkey\" FOR www\@localhost"  
  echo -n "(YOU MAY NEED TO REINITIALIZE YOUR MYSQL www\@localhost USER)"  
  echo -n "Please see http://install.lon-capa.org/ for more information"  
   
 rawinstall: VERSION Makefile.install Makefile  
  echo -n "" > WARNINGS  
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" \  
  directories  
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" files  
  make -f Makefile.install SOURCE="$(SOURCE)" TARGET="$(TARGET)" links  
  make SOURCE="$(SOURCE)" TARGET="$(TARGET)" \  
  NORESTORECONF="$(NORESTORECONF)" configinstall  
   
 Makefile.install: alwaysrun  
  cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \  
  perl lpml_parse.pl install $(CATEGORY) $(DIST) "$(SOURCE)" \  
  "$(TARGET)" > Makefile.install  
   
 build: Makefile.build pod2html.sh pod2man.sh  
  install -d $(SOURCE)/doc/man  
  install -d $(SOURCE)/doc/scripts  
  install -d $(SOURCE)/doc/lib/perl/Apache  
  echo -n "" > WARNINGS  
  make -f Makefile.build all  
  make warningnote  
   
 Makefile.build: $(SOURCE)/doc/loncapafiles/loncapafiles.lpml lpml_parse.pl  
  cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \  
  perl lpml_parse.pl build $(CATEGORY) $(DIST) "$(SOURCE)" "$(TARGET)" \  
  > Makefile.build  
   
 RPM: BinaryRoot base_rpm_file_list  RPM: BinaryRoot base_rpm_file_list
  cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \   cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \
Line 279  RPM: BinaryRoot base_rpm_file_list Line 541  RPM: BinaryRoot base_rpm_file_list
  cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 '' '' \   cat base_rpm_file_list.txt | perl make_rpm.pl base 3.2 '' '' \
  BinaryRoot base_customizerpm.xml   BinaryRoot base_customizerpm.xml
   
 setup_RPM:  
  echo "SetupBinaryRoot/etc/passwd" > setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/group" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/hosts.deny" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/home/www" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/pam.d/passwd" >> setup_rpm_file_list.txt  
  echo "SetupBinaryRoot/etc/pam.d/login" >> setup_rpm_file_list.txt  
  perl setup_rpm_binaryroot.pl  
  cat setup_rpm_file_list.txt | perl make_rpm.pl setup 3.2 '' '' \  
  SetupBinaryRoot customizerpm.xml  
   
 DPKG:  DPKG:
  make TARGET='lon-capa-$(VERSION)' NORESTORECONF='1' install   make TARGET='lon-capa-$(VERSION)' NORESTORECONF='1' install
  @echo "You will next need to follow instructions at:"   @echo "You will next need to follow instructions at:"
Line 316  base_rpm_file_list: Line 567  base_rpm_file_list:
 BinaryRoot: base_rpm_file_list  BinaryRoot: base_rpm_file_list
  make TARGET='BinaryRoot' NORESTORECONF='1' install   make TARGET='BinaryRoot' NORESTORECONF='1' install
   
   # ======================================== *** MASTER DOCUMENTATION TARGETS ***
   
 # Generates CVS:loncom/build/docs; root location of install.lon-capa.org  # Generates CVS:loncom/build/docs; root location of install.lon-capa.org
 doc:  doc:
  install -d docs   install -d docs
Line 391  pdfdoc: TEST_html2ps Line 644  pdfdoc: TEST_html2ps
 # mpage -P- -1 -H [^C]* > ../../../loncom/build/pdfdoc/confexamples.ps  # mpage -P- -1 -H [^C]* > ../../../loncom/build/pdfdoc/confexamples.ps
  install -d pdfdoc/confexamples   install -d pdfdoc/confexamples
  cd $(SOURCE)/doc/build/confexamples; \   cd $(SOURCE)/doc/build/confexamples; \
  find . -type f | cut -b3- | grep -v '^C' | grep -v 'keyword' | perl -nle \   find . -type f | cut -b3- | grep -v '^C' | grep -v 'keyword' | \
    perl -nle \
  '`mpage -P- -1 -H $$_ > ../../../loncom/build/pdfdoc/confexamples/$$_.ps`;'   '`mpage -P- -1 -H $$_ > ../../../loncom/build/pdfdoc/confexamples/$$_.ps`;'
  echo '' > pdfdoc/contents.txt   echo '' > pdfdoc/contents.txt
  echo '' >> pdfdoc/contents.txt   echo '' >> pdfdoc/contents.txt
Line 427  pdfdoc: TEST_html2ps Line 681  pdfdoc: TEST_html2ps
  ps2pdf pdfdoc/installation_manual.ps pdfdoc/installation_manual.pdf   ps2pdf pdfdoc/installation_manual.ps pdfdoc/installation_manual.pdf
  mv -vf pdfdoc/installation_manual.pdf .   mv -vf pdfdoc/installation_manual.pdf .
   
 TEST_html2ps:  # ================================================ *** KEEPING THINGS CLEAN ***
  @if (test -e /usr/local/html2ps/bin/html2ps); then \  
  echo "I can find html2ps; assume okay"; \  
  else \  
  echo "**** ERROR **** cannot find /usr/local/html2ps/bin/html2ps!" && \  
         echo "Please visit http://www.tdb.uu.se/~jan/html2ps.html" && \  
  exit 1; \  
  fi  
   
 tardist:  
  # ----------- MANIFEST the building, testing and standard loncapa files  
  cat $(SOURCE)/doc/loncapafiles/buildfiles.lpml | \  
  perl lpml_parse.pl MANIFEST development default \  
  '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' > $(SOURCE)/MANIFEST  
  cat $(SOURCE)/doc/loncapafiles/testfiles.lpml | \  
  perl lpml_parse.pl MANIFEST development default \  
  '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST  
  cat $(SOURCE)/doc/loncapafiles/loncapafiles.lpml | \  
  perl lpml_parse.pl MANIFEST development default \  
  '$(SOURCE)' '$(TARGET)' | grep '[[:alnum:]]' >> $(SOURCE)/MANIFEST  
  # ------ CVS/Entries directories to retain 'time-checking' intelligence  
  cd $(SOURCE); find . -type f -name 'Entries' | grep 'CVS/Entries' >> \  
  MANIFEST  
  # ---- Files for top-level (the vanilla layer that the user first sees)  
  echo 'README' >> $(SOURCE)/MANIFEST  
  echo 'UPDATE' >> $(SOURCE)/MANIFEST  
  echo 'TEST' >> $(SOURCE)/MANIFEST  
  echo 'CHECKRPMS' >> $(SOURCE)/MANIFEST  
  # ---------------------------------- might as well include the MANIFEST  
  echo 'MANIFEST' >> $(SOURCE)/MANIFEST  
  # ------------------------------------------ hosts.tab are belong to us  
  echo 'loncom/rawhide_hosts.tab' >> $(SOURCE)/MANIFEST  
  echo 'loncom/production_hosts.tab' >> $(SOURCE)/MANIFEST  
  echo 'loncom/development_hosts.tab' >> $(SOURCE)/MANIFEST  
  # ------------------ Files needed for dynamically generated directories  
  echo 'doc/man' >> $(SOURCE)/MANIFEST  
  echo 'doc/lib' >> $(SOURCE)/MANIFEST  
  echo 'doc/lib/perl' >> $(SOURCE)/MANIFEST  
  echo 'doc/lib/perl/Apache' >> $(SOURCE)/MANIFEST  
  echo 'doc/scripts' >> $(SOURCE)/MANIFEST  
  # --------------------------- Point UPDATE to the internal make process  
  echo '#!/bin/sh' > $(SOURCE)/UPDATE  
  echo 'touch loncom/build/WARNINGS' >> $(SOURCE)/UPDATE;  
  echo 'ln -s loncom/build/WARNINGS WARNINGS' >> $(SOURCE)/UPDATE;  
  echo 'cd loncom/build; make build' >> $(SOURCE)/UPDATE  
  echo 'make rawinstall' >> $(SOURCE)/UPDATE  
  echo 'make configinstall' >> $(SOURCE)/UPDATE  
  echo 'make updatequery' >> $(SOURCE)/UPDATE  
  echo 'make hosts_tab' >> $(SOURCE)/UPDATE  
  echo 'make postinstall' >> $(SOURCE)/UPDATE  
  echo 'make aboutVERSION' >> $(SOURCE)/UPDATE  
  echo 'make warningnote' >> $(SOURCE)/UPDATE  
  # ----------------------------- Point TEST to the internal make process  
  echo '#!/bin/sh' > $(SOURCE)/TEST  
  echo 'cd loncom/build; make test' >> $(SOURCE)/TEST  
  # ----------------------------- Copy CHECKRPMS to the vanilla top-level  
  cp $(SOURCE)/loncom/build/CHECKRPMS $(SOURCE)/CHECKRPMS  
  # ----------------------- vanilla executables must indeed be executable  
  chmod a+rx $(SOURCE)/UPDATE  
  chmod a+rx $(SOURCE)/TEST  
  chmod a+rx $(SOURCE)/CHECKRPMS  
  # -------------------------------- Copy README to the vanilla top-level  
  cp $(SOURCE)/doc/shortest_path_redhat7.2.txt $(SOURCE)/README  
  # --------------------------------------------------- Clean up MANIFEST  
  cd $(SOURCE); \  
  sort MANIFEST | perl -nle 'print "$(DIRTARGET)/$$_"' | \  
  perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \  
  perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \  
  perl -nle 's/\w+\/\.\.\///g;s/\w+\/\.\.\///g;print' | \  
  perl -nle 's/\/\.\//\//g;print' | sort | uniq > \  
  MANIFEST_loncapa  
  # -------------------------------------------------------- Make tardist  
  @cd $(SOURCE); \  
  if (test -h $(DIRTARGET)); then \  
  echo "$(DIRTARGET) link already defined; assume okay"; \  
  else \  
  ln -s . $(DIRTARGET); \  
  fi  
  cp -v $(SOURCE)/loncom/license/about.html \  
  $(SOURCE)/loncom/license/about.html.orig  
  make aboutVERSION  
  cd $(SOURCE); \  
  tar --no-recursion --numeric-owner --files-from MANIFEST_loncapa \  
  -h -czf $(DIRTARGET).tar.gz 2>WARNINGS || [ "0" == "0" ]  
  mv -v $(SOURCE)/loncom/license/about.html.orig \  
  $(SOURCE)/loncom/license/about.html  
  cat $(SOURCE)/WARNINGS | \  
  xargs --replace=XXX echo '**** WARNING **** XXX' > WARNINGS  
  rm -f $(SOURCE)/WARNINGS  
  make warningnote  
   
 clean:  clean:
    rm -f buildflag
  rm -Rf HTML   rm -Rf HTML
  rm -f installation_manual.pdf   rm -f installation_manual.pdf
  rm -f Makefile.build   rm -f Makefile.build
Line 539  clean: Line 705  clean:
  rm -f $(SOURCE)/loncom/build/hosts.tab   rm -f $(SOURCE)/loncom/build/hosts.tab
   
 reallyclean:  reallyclean:
    rm -f buildflag
  rm -f $(SOURCE)/README   rm -f $(SOURCE)/README
  rm -f $(SOURCE)/UPDATE   rm -f $(SOURCE)/UPDATE
  rm -f $(SOURCE)/TEST   rm -f $(SOURCE)/TEST
  rm -f $(SOURCE)/MANIFEST   rm -f $(SOURCE)/MANIFEST
    rm -f $(SOURCE)/MANIFEST_loncapa
  rm -f $(SOURCE)/loncapa   rm -f $(SOURCE)/loncapa
  rm -f $(SOURCE)/loncom/build/hosts.tab   rm -f $(SOURCE)/loncom/build/hosts.tab
  rm -f $(SOURCE)/loncapa.tar.gz   rm -f $(SOURCE)/loncapa.tar.gz
Line 565  reallyclean: Line 733  reallyclean:
  make -f Makefile.cvs clean   make -f Makefile.cvs clean
  rm -f WARNINGS   rm -f WARNINGS
   
   # ================================================ *** A HELPFUL DEPENDENCY ***
 alwaysrun:  alwaysrun:

Removed from v.1.128  
changed lines
  Added in v.1.129


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