Provided by: htcondor_8.6.8~dfsg.1-2ubuntu1_amd64 
Name
condor_config_val Query - or set a given HTCondor configuration variable
Synopsis
condor_config_val <help option>
condor_config_val[<location options>] <edit option>
condor_config_val[<location options>] [<view options>] vars
condor_config_valusecategory[:template_name] [-expand]
Description
condor_config_valcan be used to quickly see what the current HTCondor configuration is on any given
machine. Given a space separated set of configuration variables with the varsargument,
condor_config_valwill report what each of these variables is currently set to. If a given variable is not
defined, condor_config_valwill halt on that variable, and report that it is not defined. By default,
condor_config_vallooks in the local machine's configuration files in order to evaluate the variables.
Variables and values may instead be queried from a daemon specified using a location option.
Rawoutput of condor_config_valdisplays the string used to define the configuration variable. This is what
is on the right hand side of the equals sign (=) in a configuration file for a variable. The default
output is an expandedone. Expanded output recursively replaces any macros within the raw definition of a
variable with the macro's raw definition.
Each daemon remembers settings made by a successful invocation of condor_config_val. The configuration
fileis not modified.
condor_config_valcan be used to persistently set or unset configuration variables for a specific daemon
on a given machine using a -setor -unsetedit option. Persistent settings remain when the daemon is
restarted. Configuration variables for a specific daemon on a given machine may be set or unset for the
time period that the daemon continues to run using a -rsetor -runsetedit option. These runtime settings
will override persistent settings until the daemon is restarted. Any changes made will not take effect
until condor_reconfigis invoked.
In general, modifying a host's configuration with condor_config_valrequires the CONFIGaccess level, which
is disabled on all hosts by default. Administrators have more fine-grained control over which access
levels can modify which settings. See section 3.8.1on page for more details on security settings.
Further, security considerations require proper settings of configuration variables
SETTABLE_ATTRS_<PERMISSION-LEVEL>(see 3.5.3), ENABLE_PERSISTENT_CONFIG(see 3.5.3), and HOSTALLOW...(see
3.5.3) in order to use condor_config_valto change any configuration variable.
It is generally wise to test a new configuration on a single machine to ensure that no syntax or other
errors in the configuration have been made before the reconfiguration of many machines. Having bad syntax
or invalid configuration settings is a fatal error for HTCondor daemons, and they will exit. It is far
better to discover such a problem on a single machine than to cause all the HTCondor daemons in the pool
to exit. condor_config_valcan help with this type of testing.
Options
-help
(help option) Print usage information and exit.
-version
(help option) Print the HTCondor version information and exit.
-set var = value
(edit option) Sets one or more persistent configuration file variables. The new value remains if the
daemon is restarted. One or more variables can be set; the syntax requires double quote marks to
identify the pairing of variable name to value, and to permit spaces.
-unset var
(edit option) Each of the persistent configuration variables listed reverts to its previous value.
-rset var = value
(edit option) Sets one or more configuration file variables. The new value remains as long as the
daemon continues running. One or more variables can be set; the syntax requires double quote marks to
identify the pairing of variable name to value, and to permit spaces.
-runset var
(edit option) Each of the configuration variables listed reverts to its previous value as long as the
daemon continues running.
-dump
(view option) Display the raw value of all varslisted. If no varsare listed, then print all
configuration variables and their values. The -expand, -default, and -evaluateoptions take precedence
over this -dumpoption, such that the output will not be raw.
-default
(view option) Default values are displayed.
-expand
(view option) Expanded values are displayed. This is the default.
-raw
(view option) Raw values are displayed.
-verbose
(view option) Display configuration file name and line number where the variable is set, along with
the raw, expanded, and default values of the variable.
-debug[:<opts>]
(view option) Send output to stderr, overriding a set value of TOOL_DEBUG.
-evaluate
(view option) Applied only when a location optionspecifies a daemon. The value of the requested
parameter will be evaluated with respect to the ClassAd of that daemon.
-used
(view option) Applied only when a location optionspecifies a daemon. Modifies which variables are
displayed to only those used by the specified daemon.
-unused
(view option) Applied only when a location optionspecifies a daemon. Modifies which variables are
displayed to only those notused by the specified daemon.
-config
(view option) Applied only when the configuration is read from files (the default), and notwhen
applied to a specific daemon. Display the current configuration file that set the variable.
-writeconfig[:upgrade] filename
(view option) For the configuration read from files (the default), write to file filenameall
configuration variables. Values that are the same as internal, compile-time defaults will be preceded
by the comment character. If the :upgrade option is specified, then values that are the same as the
internal, compile-time defaults are omitted. Variables are in the same order as the they were read
from the original configuration files.
-mixedcase
(view option) Applied only when the configuration is read from files (the default), and notwhen
applied to a specific daemon. Print variable names with the same letter case used in the variable's
definition.
-local-name <name>
(view option) Applied only when the configuration is read from files (the default), and notwhen
applied to a specific daemon. Inspect the values of attributes that use local names, which is useful
to distinguish which daemon when there is more than one of the particular daemon running.
-subsystem <daemon>
(view option) Applied only when the configuration is read from files (the default), and notwhen
applied to a specific daemon. Specifies the subsystem or daemon name to query, with a default value of
the TOOLsubsystem.
-address <ip:port>
(location option) Connect to the given IP address and port number.
-pool centralmanagerhostname[:portnumber]
(location option) Use the given central manager and an optional port number to find daemons.
-name <machine_name>
(location option) Query the specified machine's condor_masterdaemon for its configuration. Does not
function together with any of the options: -dump, -config, or -verbose.
-master |-schedd |-startd |-collector |-negotiator
(location option) The specific daemon to query.
usecategory[:set name] [-expand]
Display information about configuration templates (see 3.4). Specifying only a categorywill list the
template_namesavailable for that category. Specifying a categoryand a template_namewill display the
definition of that configuration template. Adding the -expandoption will display the expanded
definition (with macro substitutions). (-expandhas no effect if a template_nameis not specified.) Note
that there is no dash before useand that spaces are not allowed next to the colon character separating
categoryand template_name.
Exit Status
condor_config_valwill exit with a status value of 0 (zero) upon success, and it will exit with the value
1 (one) upon failure.
Examples
Here is a set of examples to show a sequence of operations using condor_config_val. To request the
condor_schedddaemon on host perdita to display the value of the MAX_JOBS_RUNNINGconfiguration variable:
% condor_config_val -name perdita -schedd MAX_JOBS_RUNNING
500
To request the condor_schedddaemon on host perdita to set the value of the MAX_JOBS_RUNNINGconfiguration
variable to the value 10.
% condor_config_val -name perdita -schedd -set "MAX_JOBS_RUNNING = 10"
Successfully set configuration "MAX_JOBS_RUNNING = 10" on
schedd perdita.cs.wisc.edu <128.105.73.32:52067>.
A command that will implement the change just set in the previous example.
% condor_reconfig -schedd perdita
Sent "Reconfig" command to schedd perdita.cs.wisc.edu
A re-check of the configuration variable reflects the change implemented:
% condor_config_val -name perdita -schedd MAX_JOBS_RUNNING
10
To set the configuration variable MAX_JOBS_RUNNINGback to what it was before the command to set it to 10:
% condor_config_val -name perdita -schedd -unset MAX_JOBS_RUNNING
Successfully unset configuration "MAX_JOBS_RUNNING" on
schedd perdita.cs.wisc.edu <128.105.73.32:52067>.
A command that will implement the change just set in the previous example.
% condor_reconfig -schedd perdita
Sent "Reconfig" command to schedd perdita.cs.wisc.edu
A re-check of the configuration variable reflects that variable has gone back to is value before initial
set of the variable:
% condor_config_val -name perdita -schedd MAX_JOBS_RUNNING
500
Getting a list of template_names for the roleconfiguration template category:
% condor_config_val use role
use ROLE accepts
CentralManager
Execute
Personal
Submit
Getting the definition of role:personalconfiguration template:
% condor_config_val use role:personal
use ROLE:Personal is
CONDOR_HOST=127.0.0.1
COLLECTOR_HOST=$(CONDOR_HOST):0
DAEMON_LIST=MASTER COLLECTOR NEGOTIATOR STARTD SCHEDD
RunBenchmarks=0
Author
Center for High Throughput Computing, University of Wisconsin–Madison
Copyright
Copyright © 1990-2016 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.
January 2020 condor_config_val(1)