{subsection: Running Tests from HTCondor Source Tree}
1: Get the source code from any of the following locations:
-*: git on AFS: git clone ssh://emperor-02.cs.wisc.edu/p/condor/repository/CONDOR_SRC.git
-*: github: git clone https://github.com/htcondor/htcondor.git
-*: tarballs on HTCondor's website
+{code}
+git clone ssh://emperor-02.cs.wisc.edu/p/condor/repository/CONDOR_SRC.git # git on afs
+
+# OR From
+
+git clone https://github.com/htcondor/htcondor.git # github mirror, trails behind afs git by a few hours
+
+# Source code can also be obtained from tarballs on HTCondor's website
+{endcode}
-2: Compiling the code and running tests.(See {wiki: BuildingHtcondorOnLinux}
+
+2: Compiling the code and tests.(See {wiki: BuildingHtcondorOnLinux}
for more details on building the code and pre-requisites)
{code}
-
cd CONDOR_SRC # change directory to the root of source tree
./configure_uw
make install
make tests
-cd release_dir
-./condor_install --make-personal-condor
-source condor.sh
-cd ../src/condor_tests
+{endcode}
+
+3: Make Personal Condor in a new directory outside the source tree (lets call the directory personal_condor)
+{code}
+cd <personal_condor>
+<absolute path to CONDOR_SRC>/release_dir/condor_install --make-personal-condor --local-dir=`pwd` # Please follow the step as is and run this command from personal_condor directory only
+{endcode}
+
+4: Change <personal_condor>/etc/condor_config as follows-
+*:: Modify RELEASE_DIR to point to <Absolute path of personal_condor>
+*:: Modify LOCAL_DIR to point to <Absolute path of personal_condor>/local.$(HOSTNAME)
+*:: Modify LOCAL_CONFIG_FILE to point to <Absolute path for personal_condor>/local.$(HOSTNAME)/condor_config.local
+
+5: Ready to run the tests!
+{code}
+source condor.sh # condor.sh is in <personal_condor>
+
+cd <CONDOR_SRC>/condor_tests
./batch_test.pl -d . -t <test name>
# for example
# ./batch_test.pl -d . -t job_test_scheddrotation.run
-
{endcode}
+
Always run tests with batch_test.pl. Tests have a special flag({comment: what is it?}) which asks batch_test to start condor on behalf of the test, certain tests may not want to run condor or may want to change the condor's configuration file before running so they will start condor themselves. In any case, it should always be safe to run test via batch_test.pl. Also batch_test.pl only supports running single test at a time for now. To run multiple tests refer {wiki: BatLabTest}.
