vtk_server_config
This section explains the usage of vtk_server_config. Only an
ADMIN is allowed to use this API.
% vovsh -x 'vtk_server_config KEYWORD VALUE'
All configuration parameters can be controlled via this interface. In addition, the
following keywords are understood.
KEYWORD (case-insensitive) | VALUE | Description |
---|---|---|
allowcoredump | boolean | If the vovserver encounters a serious error, it may dump its core if the flag is set. |
autoshutdown | time_spec | Control the auto-shut-down time for the vovserver. The vovserver shuts down when the specified time elapses after the last executed job. If the value is 0, auto-shut-down is disabled. |
chdir | directory_path | Change working directory of the vovserver. This can be useful if the OS loses the notion of where the vovserver is running (seen on some old systems). |
checkbarrier | ignored | Run a sanity check for barriers, including the barrier-invalid flags. Only useful for FlowTracer. |
checklogchecklogs | size | Check the size of the vovserver log and rotate it if it is larger than the specified size. |
clearsymlinks | ignored | Force clearing of the caches for symlinks. See also printsymlinks. |
clientfdoffset | integer | DEBUG: do not use (default is 40). |
closeclientbyhost | hostname | Close all clients on the specified host. You can see the
connected clients with vovshow -clients . This
can be used, for example, when the OS is refusing to shut-down a
socket even when a machine is down. See also
closeclientsbyindex. |
closeclientbyindex | integer | Close the specified client. The value is the index of the
client. You can see the connected clients with vovshow
-clients . This can be used, for example, when the
OS is refusing to shut-down a socket even when a machine is
down. See also closeclientsbyhost |
dumphalfattachments | ignore | DEBUG: Create a file called ha.dump to show where the half-attachment memory is being spent. |
enablepam | boolean | |
enableldap | boolean | |
enterpriselicensecoresslots | integer | "off" | "auto" | "full" | Control the use of the enterprise license. See also "refreshlicense" below for more interaction with licensing. |
flushlogs | ignore | Force flushing of all journals and logs. (normally all logs are flushed once a second). |
graceperiod | time_spec | DEBUG ONLY: set the grace period for when the license expires. The default value is 5d, the range is between 1m and 5d. |
httpsecure | boolean | If the flag is 1 (which is the default), one must authenticate to use the browser interface. Otherwise everyone can login and browse using READ_ONLY credentials. See also environment variable VOV_HTTP_UNSECURE. |
idmgmt | vovid | Test the insertion of an object with specified VovId. If the VovId is large, this will likely trigger the recycling of VovIds. Used mostly for testing. |
idrange | lowId-highId | Specify the range of VovId recycling. |
liverecorder | "on" or "off" or PID of vovserver | Controls the live recording capability provided by Undo Software. Turning live recorder on is quick, turning it off requires a relatively long time (about 30s if you have 200k jobs in the system) |
maxclients | integer | DEBUG: used to test the behavior of system when a small number of clients are allowed. Reduces the total number of usable clients. Internal levels are enforced. |
maxlevel | integer | Used in FlowTracer. Set the maximum level for the flow. The default value is 4095. The range is 3 to 4095. |
maxjobarray | integer | Used in Accelerator. Set the maximum size of a job array. The default is 10,000. The range is 10..100,000. |
maxnormalclients | integer | |
maxnotifyclients | integer |
Maximum number of notify clients per user. This is a protection against denial-of-service attacks by a single user. The 'notify' clients are those that tap into the event stream. They are used for example in waiting for jobs to finish and to update the GUI. |
maxresmap | integer | |
maxbuffersize | integer | |
minhw | string | Set the value of the minimum hardware resources that every job needs to request. The default value is "RAM/20 CORES/1 SLOTS/1 PERCENT/1". |
netinfo | boolean | Control whether the system is supposed to collect network information from all its taskers. |
preemptionfairshare | "on" | "off" | time_spec | Enable or disable the computation to support FairShare of preemption. |
printcodes | ignored | Force printing usage of RPC codes (debugging only). Output goes to the vovserver log. |
printsymlinks | ignored | Force printing of content of symlink cache (debugging only). Output is in vovserver log. See also clearsymlinks. |
product | lm lms nc mq la ft rm | Set the product of vovserver. |
readonlyport | integer | Control the read-only port for vovserver. If the integer is 0, the read-only port is closed. If in the range 1000...32000, the specified port is opened, if possible. If the port cannot be opened, then the port is closed again. |
reset_debug_flag | flag-name | DEBUG: turn OFF the named debug flag. The list of flags is not published. See also set_debug_flag. |
reopenlogs | ignore | Close and reopen all journals and logs. See also checklogs, flushlogs, and rotateserverlog. |
rotateserverlog | boolean | Rotation of the server logs, but only if the boolean is true. |
scheduler | command | Request a scheduler cycle. If the command is the word "suspend", then the scheduler is suspended, meaning no jobs are dispatched. If the command is "request", then the scheduler is called once, while remaining suspended or active. If the command is "unsuspend", then the scheduler is reactivated. If the command is anything else, the scheduler is reactivated and called once. |
set_debug_flag | flag-name | DEBUG: turn ON the named debug flag. The list of flags is not published. See also reset_debug_flag. |
taskerheartbeat | num_seconds | Set the expected heart beat of the taskers. If a tasker is not reporting an update after 3*taskerheartbeat, it is considered SICK. The range for this is between 10 and 86400(1day). |
trace_debug_flag | bit-mask | DEBUG: Set some debug flags in VovTrace. Default value is 0. See also VOV_DEBUG_FLAGS. |
type | string | Set the project type. |
usrtmp | directory | Specify the directory to be used for temporary files. Default is /usr/tmp or /tmp. |