update setup instructions for nightly tests
README info for setting up and running the nightly build/test for SUNDIALS
-Initial setup:
- The SUNDIALS devtest directory should be exported from svn (currently into
- /usr/casc/sundials on the Tux system)
- > cd /usr/casc/sundials
- > svn export file:///usr/casc/sundials/svnrepo/trunk/devtest
+Initial setup (will overwrite files if they already exist):
+ Export the contents of the SUNDIALS devtest directory from the most recent
+ commit to the git repo into the local devtest directory:
+ > cd /usr/casc/sundials/devtest
+ > git archive --remote=ssh://git@mystash.llnl.gov:7999/sundials/sunrepo.git HEAD:devtest | tar -x
- Change group ownership to nsde:
+ The previous commands should create a copy the bin directory from devtest
+ in the git repo in the local devtest directory.
+
+ Change group ownership of bin and its contents to nsde:
+ > cd ..
> chgrp -R nsde devtest
Set group id to enable inheritance of group ownership:
> chmod -R g+s devtest
- Make sunbuild.py executable:
+ Make sunbuild.py and sunset.sh are executable:
> chmod +x devtest/bin/sunbuild.py
+ > chmod +x devtest/bin/sunset.sh
+
+ The sunbuild.py script - will attempt to clone, build, and test the most recent
+ commit to the sundials development branch in the git repo.
- The sunbuild.py script - will attempt to extract, build, and test the current
- revision from the sundials repo trunk.
To run the build manually:
> source /usr/casc/sundials/devtest/bin/sunset.sh
> /usr/casc/sundials/devtest/bin/sunbuild.py
-
To run script automatically every night from cron:
Edit your personal crontab:
> crontab -e
- Add entry to run the sunbuild.py script (example runs at 2:15 AM every day)
- 15 2 * * * . /usr/casc/sundials/devtest/bin/sunset.sh;
- /usr/casc/sundials/devtest/bin/sunbuild.py
-
+ Add an entry to run the sunbuild.py script (example runs at 2:15 AM every day)
+ 15 2 * * * . /usr/casc/sundials/devtest/bin/sunset.sh; /usr/casc/sundials/devtest/bin/sunbuild.py
NOTES:
The 'nightly' directory on same level as bin, is required to exist by the script.
- This directory will have all the revision checkouts and builds.
-
-Installing a new version of sunbuild.py and/or sunset.sh:
- The SUNDIALS devtest directory must be exported with the 'force' option to
- overwrite the files:
- > cd /usr/casc/sundials
- > svn export --force file:///usr/casc/sundials/svnrepo/trunk/devtest
-
- Both sunset.sh and sunbuild.py are marked as executable in SVN. If not:
- > chmod +x devtest/bin/sunset.sh
- > chmod +x devtest/bin/sunbuild.py
+ This directory will have all the clones and builds of the git repo.
\ No newline at end of file
