FreeBSD Manual Pages
just-man-pages/condor_configGeneral Commandjust-man-pages/condor_config_val(1) 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 Description condor_config_val can 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 vars argument, condor_config_val will report what each of these variables is currently set to. If a given variable is not defined, condor_config_val will halt on that variable, and report that it is not defined. By default, condor_config_val looks 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 . Raw output of condor_config_val displays 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 expanded one. 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 con- dor_config_val . The configuration file is not modified. condor_config_val can be used to persistently set or unset configura- tion variables for a specific daemon on a given machine using a -set or -unset edit option . Persistent settings remain when the daemon is restarted. Configuration variables for a specific daemon on a given ma- chine may be set or unset for the time period that the daemon continues to run using a -rset or -runset edit option . These runtime settings will override persistent settings until the daemon is restarted. Any changes made will not take effect until condor_reconfig is invoked. In general, modifying a host's configuration with condor_config_val re- quires the CONFIG access level, which is disabled on all hosts by de- fault. Administrators have more fine-grained control over which access levels can modify which settings. See section on page for more details on security settings. Further, security considerations require proper settings of configuration variables SETTABLE_ATTRS_<PERMISSION-LEVEL> (see ), ENABLE_PERSISTENT_CONFIG (see ), and HOSTALLOW... (see ) in order to use condor_config_val to 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_val can 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 vari- ables. 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 spa- ces. -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 spa- ces. -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 vars listed. If no vars are listed, then print all configuration variables and their values. The -expand , -default , and -evaluate options take precedence over this -dump option, 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 val- ues 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 option specifies a dae- mon. The value of the requested parameter will be evaluated with re- spect to the ClassAd of that daemon. -used (view option) Applied only when a location option specifies a dae- mon. Modifies which variables are displayed to only those used by the specified daemon. -unused (view option) Applied only when a location option specifies a dae- mon. Modifies which variables are displayed to only those not used by the specified daemon. -config (view option) Applied only when the configuration is read from files (the default), and not when 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 filename all configuration variables. Values that are the same as internal, compile-time defaults will be preceded by the comment character. If the :upgrade o ption is specified, then values that are the same as the internal, compile-time defaults are omit- ted. 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 not when applied to a specific daemon. Print variable names with the same letter case used in the variable's def- inition. -local-name _name_ (view option) Applied only when the configuration is read from files (the default), and not when 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 particu- lar daemon running. -subsystem _daemon_ (view option) Applied only when the configuration is read from files (the default), and not when applied to a specific daemon. Specifies the subsystem or daemon name to query, with a default value of the TOOL subsystem. -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_master daemon 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. Exit Status condor_config_val will exit with a status value of 0 (zero) upon suc- cess, 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 con- dor_config_val . To request the condor_schedd daemon on host perdita to display the value of the MAX_JOBS_RUNNING configuration variable: % condor_config_val -name perdita -schedd MAX_JOBS_RUNNING 500 To request the condor_schedd daemon on host perdita to set the value of the MAX_JOBS_RUNNING configuration 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 exam- ple. % condor_reconfig -schedd perdita Sent "Reconfig" command to schedd perdita.cs.wisc.edu A re-check of the configuration variable reflects the change imple- mented: % condor_config_val -name perdita -schedd MAX_JOBS_RUNNING 10 To set the configuration variable MAX_JOBS_RUNNING back 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 exam- ple. % 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 Author Center for High Throughput Computing, University of Wisconsin-Madison Copyright Copyright (C) 1990-2015 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. date just-man-pages/condor_config_val(1)
Name | Synopsis | Description | Options | Exit Status | Examples | Author | Copyright
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=condor_config_val&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>