This is for the new BATLab (submit-*.batlab.org).  For the obsolete, pre-2012 BATLab (nmi-s00*.cs.wisc.edu), see NmiBuild.

{section: Building a HTCondor workspace in NMI}

{subsection: Automatically from Linux}

Try /afs/cs.wisc.edu/u/a/d/adesmet/bin/submit-workspace .  Run it from the top of your workspace.  You'll want to have public-key authentication configured for the current primary BaTLab submit host.  You'll be asked for your private key password once at the start.  The script will create a directory on the remote side named after the branch and the current date and time.  The script does _not_ delete the copy after it's no longer necessary; remember to clean up occasionally.

Just in case, the script is attached.

If things go wrong, fall back to "Manually from Linux," below.  The script is basically implementing those steps.


{subsection: Manually from Linux}

Here is a common scenario: You would like to do a build on some platform or set of platforms in order to ensure that you haven't broken the build process. What are your options? You could check in the code and wait for the nightly builds, but you may well break the build and receive fifty lashes with a wet noodle. A better solution is to *not* check in your code, but use NMI to build it on any platform that you like.

Before you start, make sure that you have an account on submit-3.batlab.org.

From your usual machine,

{code}
  % ssh submit-3.batlab.org mkdir workspace
  % exit
  % cd to top of clone(CONDOR_SRC)
  % git write-tree
  % git archive xxxxxx(hash created by git write-tree) | ssh submit-3.batlab.org cd workspace '&&' tar xf -
For Windows execute below command,
  % git archive xxxxxx(hash created by git write-tree) | ssh USERNAME@submit-3.batlab.org cd workspace ; tar xf -

{endcode}

Then, log into submit-3.batlab.org, and run the following commands

{code}
  % cd workspace
  % cd nmi_tools
  % ./condor_nmi_submit --build --git --workspace=../ --platforms=all --notify-fail-only --desc="A Description"
{endcode}

If you're trying to build something older than 7.7, you'll need to do the following before the condor_nmi_submit. It's not necessary for 7.7 and later.
{code}
  % git --git-dir=/space/git/CONDOR_DOC.git archive origin/master | tar xf -
{endcode}

Some important options:

*: =--without-tests= suppresses the automatic submission of tests when the build is done.
*: =--platforms= takes a comma separated list of platforms. "all" is a good default. For a list of available platforms, see "Platforms" below.  You must specify the platforms you want.  (This is a change from the old BATLab.)  You can find a list of available platforms at http://submit-3.batlab.org/nmi/pool/status , look for "Pool usage by platform" in the left column. At the moment (2014-10-30) the set of platforms that we do nightly and rolling builds on is:
*:: x86_64_Debian0,x86_64_Debian6,x86_64_Debian7,x86_64_Fedora19,x86_64_Fedora20,x86_64_MacOSX7,x86_64_MacOSX8,x86_64_RedHat5,x86_64_RedHat6,x86_64_RedHat7,x86_64_SL6,x86_64_Solaris11,x86_64_Ubuntu10,x86_64_Ubuntu12,x86_64_Ubuntu14,x86_64_Windows7,x86_64_Windows8,x86_RedHat5,x86_RedHat6,x86_SL5
*: =--use-externals-cache= uses cached externals to speed the build. *May not work in new BATLab.* If you're testing a new external, do *not* use this option.
*: =--release-only= builds the dynamic binaries, but doesn't package or return them. If you're just doing a compile test and don't need the binaries, this will speed the build by about 45 minutes. If you need to generate a package to give to a user (or to submit for testing), omit this option.
*: =--desc= specifies a description that appears in the NMI web pages and can help identify your build.
*: =--workspace=../= is the location of your workspace. *Warning:* due to a bug in condor_nmi_submit, as of 2006-02-14 the only valid option is "=../=" as given in the example.
*: =--append 'append_requirements=Machine!="exec3.batlab.org"'= Blacklist exec3 from the hosts you will build on.
{endcode}

The script has a couple of other options. run condor_nmi_submit without options for a summary.

{section: Checking your build's status}

*:{link:http://submit-3.batlab.org/results/ HTCondor-specific status page} (Maintained by  at  (Maintained by Scot K. as of 2012-01).
*:{link:http://submit-3.batlab.org/nmi/results/overview Metronome status page} (Maintained by Todd M. as of 2012-01.)