This is an outdated version of the HTCondor Manual. You can find current documentation at http://htcondor.org/manual.

condor_cold_stop

reliably shut down and uninstall a running HTCondor instance

Synopsis

condor_cold_stop -help

condor_cold_stop [-force] [-basedir directory] [-localdir directory] [-runlocalconfig file] [-cleaninstall] [-cleanlocal] [-stop] [-logarchive archive] [-spoolarchive archive] [-execarchive archive] [-filelock] [-pid] [-artifact file] [-nogurl] [-globuslocation directory] -configfile file

Description

condor_cold_stop reliably shuts down and uninstall a running HTCondor instance. This program first uses condor_local_stop to reliably shut down the running HTCondor instance. It then uses condor_cleanup_local to create and store archives of the log, spool, and execute directories. Its last task is to uninstall the HTCondor binaries and libraries using cleanup_release.

Options

-artifact file

Uses file as the artifact file to determine whether the condor_master daemon is still alive.

-basedir directory

Directory where the HTCondor installation can be found. When not specified, the current working directory is assumed.

-cleaninstall

Remove the HTCondor installation. If none of the options -cleaninstall, -cleanlocal, or -stop are specified, the program behaves as though all of them have been provided.

-cleanlocal

The program will remove the log, spool, exec directories for this HTCondor instance. If none of the options -cleaninstall, -cleanlocal, or -stop are specified, the program behaves as though all of them have been provided.

-configfile file

The same configuration file path given to condor_cold_start. This program assumes the file is in the installation directory or the current working directory.

-execarchive archive

The program will create a tar'ed and gzip'ed archive of the execute directory and stores it as archive. The archive can be a file path or a grid-ftp url.

-filelock

Determine whether the condor_master daemon has exited using a file lock undertaker. This option must match the corresponding option given to condor_cold_start.

-force

Ignore the status of the condor_schedd daemon (whether it has jobs in the queue or not) when shutting down HTCondor.

-globuslocation directory

The directory containing the Globus installation. This option is required if any of the options of the form -*archive are used, and Globus is not installed in /opt/globus.

-localdir directory

Directory where the log, spool, and execute directories are stored for this running instance of HTCondor. Required if the -cleanlocal option is specified.

-logarchive archive

The program will create a tar'ed and gzip'ed archive of the log directory and stores it as archive. The archive can be a file path or a grid-ftp url.

-nogurl

Do not use globus-url-copy to store the archives. This implies that the archives can only be stored on mounted file systems.

-pid

Determine whether the condor_master daemon has exited using a unique process id undertaker. This option must match the corresponding option given to condor_cold_start.

-runlocalconfig file

Bind file into the configuration used by this instance of HTCondor. This option should the one provided to condor_cold_start.

-spoolarchive archive

The program will create a tar'ed and gzip'ed archive of the spool directory and stores it as archive. The archive can be a file path or a grid-ftp url.

-stop

The program will shut down this running instance of HTCondor. If none of the options -cleaninstall, -cleanlocal, or -stop are specified, the program behaves as though all of them have been provided.

Exit Status

condor_cold_stop will exit with a status value of 0 (zero) upon success, and non-zero otherwise.

Examples

To shut down a HTCondor instance on the target machine:

% condor_cold_stop -configfile condor_config.mobile

To shutdown an HTCondor instance and archive the log directory:

% condor_cold_stop -configfile condor_config.mobile \
  -logarchive /tmp/log.tar.gz

See Also

condor_cold_start (on page ), filelock_undertaker (on page ), uniq_pid_undertaker (on page ).

Author

Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

Copyright © 1990-2012 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.

See the HTCondor Version 7.8.8 Manual or http://research.cs.wisc.edu/htcondor/ for additional notices.