next up previous contents index
Next: condor_compile Up: 11. Command Reference Manual Previous: condor_cold_start   Contents   Index

Subsections


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-2013 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.9.6 Manual or http://research.cs.wisc.edu/htcondor/ for additional notices.


next up previous contents index
Next: condor_compile Up: 11. Command Reference Manual Previous: condor_cold_start   Contents   Index
htcondor-admin@cs.wisc.edu