.\"Man page for condor_config_val .\"Generated by makeman on Tue May 29 00:38:53 2018 .TH condor_config_val 1 "May 2018" .SH Name .P condor_config_val Query \- or set a given HTCondor configuration variable .P .SH Synopsis condor_config_val .P condor_config_val[] .P condor_config_val[] [] vars .P condor_config_valusecategory[:template_name] [-expand] .P .SH Description .P 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. .P 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. .P Each daemon remembers settings made by a successful invocation of condor_config_val. The configuration fileis not modified. .P 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. .P In general, modifying a host's configuration with condor_config_valrequires the CONFIG access 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_ (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. .P 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. .P .SH Options .P .B -help .IP "" 3 (help option) Print usage information and exit. .IP "" 3 .P .B -version .IP "" 3 (help option) Print the HTCondor version information and exit. .IP "" 3 .P .B -set "var = value" .IP "" 3 (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. .IP "" 3 .P .B -unset var .IP "" 3 (edit option) Each of the persistent configuration variables listed reverts to its previous value. .IP "" 3 .P .B -rset "var = value" .IP "" 3 (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. .IP "" 3 .P .B -runset var .IP "" 3 (edit option) Each of the configuration variables listed reverts to its previous value as long as the daemon continues running. .IP "" 3 .P .B -dump .IP "" 3 (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. .IP "" 3 .P .B -default .IP "" 3 (view option) Default values are displayed. .IP "" 3 .P .B -expand .IP "" 3 (view option) Expanded values are displayed. This is the default. .IP "" 3 .P .B -raw .IP "" 3 (view option) Raw values are displayed. .IP "" 3 .P .B -verbose .IP "" 3 (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. .IP "" 3 .P .B -debug[:] .IP "" 3 (view option) Send output to stderr , overriding a set value of TOOL_DEBUG . .IP "" 3 .P .B -evaluate .IP "" 3 (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. .IP "" 3 .P .B -used .IP "" 3 (view option) Applied only when a location optionspecifies a daemon. Modifies which variables are displayed to only those used by the specified daemon. .IP "" 3 .P .B -unused .IP "" 3 (view option) Applied only when a location optionspecifies a daemon. Modifies which variables are displayed to only those notused by the specified daemon. .IP "" 3 .P .B -config .IP "" 3 (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. .IP "" 3 .P .B -writeconfig[:upgrade] filename .IP "" 3 (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. .IP "" 3 .P .B -mixedcase .IP "" 3 (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. .IP "" 3 .P .B -local-name .IP "" 3 (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. .IP "" 3 .P .B -subsystem .IP "" 3 (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 TOOL subsystem. .IP "" 3 .P .B -address .IP "" 3 (location option) Connect to the given IP address and port number. .IP "" 3 .P .B -pool centralmanagerhostname[:portnumber] .IP "" 3 (location option) Use the given central manager and an optional port number to find daemons. .IP "" 3 .P .B -name .IP "" 3 (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. .IP "" 3 .P .B -master | -schedd | -startd | -collector | -negotiator .IP "" 3 (location option) The specific daemon to query. .IP "" 3 .P .B usecategory[:set name] [-expand] .IP "" 3 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. .IP "" 3 .IP "" 3 .P .SH Exit Status .P condor_config_valwill exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. .P .SH Examples .P 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_RUNNING configuration variable: .P .br % condor_config_val -name perdita -schedd MAX_JOBS_RUNNING .br 500 .P To request the condor_schedddaemon on host perdita to set the value of the MAX_JOBS_RUNNING configuration variable to the value 10. .P .br % condor_config_val -name perdita -schedd -set "MAX_JOBS_RUNNING = 10" .br Successfully set configuration "MAX_JOBS_RUNNING = 10" on .br schedd perdita.cs.wisc.edu <128.105.73.32:52067>. .P A command that will implement the change just set in the previous example. .P .br % condor_reconfig -schedd perdita .br Sent "Reconfig" command to schedd perdita.cs.wisc.edu .P A re-check of the configuration variable reflects the change implemented: .P .br % condor_config_val -name perdita -schedd MAX_JOBS_RUNNING .br 10 .P To set the configuration variable MAX_JOBS_RUNNING back to what it was before the command to set it to 10: .P .br % condor_config_val -name perdita -schedd -unset MAX_JOBS_RUNNING .br Successfully unset configuration "MAX_JOBS_RUNNING" on .br schedd perdita.cs.wisc.edu <128.105.73.32:52067>. .P A command that will implement the change just set in the previous example. .P .br % condor_reconfig -schedd perdita .br Sent "Reconfig" command to schedd perdita.cs.wisc.edu .P A re-check of the configuration variable reflects that variable has gone back to is value before initial set of the variable: .P .br % condor_config_val -name perdita -schedd MAX_JOBS_RUNNING .br 500 .P Getting a list of template_names for the roleconfiguration template category: .P .br % condor_config_val use role .br use ROLE accepts .br CentralManager .br Execute .br Personal .br Submit .P Getting the definition of role:personalconfiguration template: .P .br % condor_config_val use role:personal .br use ROLE:Personal is .br CONDOR_HOST=127.0.0.1 .br COLLECTOR_HOST=$(CONDOR_HOST):0 .br DAEMON_LIST=MASTER COLLECTOR NEGOTIATOR STARTD SCHEDD .br RunBenchmarks=0 .P .SH Author Center for High Throughput Computing, University of Wisconsin-Madison .SH Copyright Copyright (C) 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.