condor_cold_stop

reliably shut down and uninstall a running Condor 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/SPAN>file

Description

condor_cold_stop reliably shuts down and uninstall a running Condor instance. This program first uses condor_local_stop to reliably shut down the running Condor 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 Condor binaries and libraries using cleanup_release.

Options

[-artifact/SPAN>file] Uses file as the artifact file to determine whether the condor_master daemon is still alive.
[-basedir/SPAN>directory] Directory where the Condor installation can be found. When not specified, the current working directory is assumed.
[-cleaninstall] Remove the Condor 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 Condor instance. If none of the options -cleaninstall, -cleanlocal, or -stop are specified, the program behaves as though all of them have been provided.
[-configfile/SPAN>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/SPAN>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 Condor.
[-globuslocation/SPAN>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/SPAN>directory] Directory where the log, spool, and execute directories are stored for this running instance of Condor. Required if the -cleanlocal option is specified.
[-logarchive/SPAN>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/SPAN>file] Bind file into the configuration used by this instance of Condor. This option should the one provided to condor_cold_start.
[-spoolarchive/SPAN>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 Condor. 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 Condor instance on the target machine:

% condor_cold_stop -configfile condor_config.mobile

To shutdown a Condor 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

Condor Team, University of Wisconsin-Madison

Copyright

Copyright ©990-2010 Condor Team, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.

See the Condor Version 7.5.6 or http://www.condorproject.org/license for additional notices.