vovservermgr

The vovservermgr command is added for system administrators. The vovservermgr command is the easiest way to modify configuration parameter settings, environment variable settings, and certain other features in the running vovserver. This command acts relative to the VOV-project enabled in the shell where it is issued.

This command has several subcommands, which provide an easier way to set vovserver configuration and environment variables other than vtk_server_config, et al. Other subcommands interface to memory chunking and scheduler tuning controls.

VovScope

VovScope provides insights into events (system call, network communications) happening at a particular instant while VOV is running. It is primarily meant for debugging, and can slow down the vovserver significantly.

Start and stop the VovScope process with the following processes:
Start:
vovservermgr configure set_debug_flag VovScope

Stop:
vovservermgr configure reset_debug_flag VovScope
  • VovScope currently logs information about the primary server.
  • VovScope logs information about all clients (FDs), including vovresourced and vovdbd. Anything that is returned by vovshow -clients can be read.
  • vovserver receives events, while VovScope logs the events that VovScope is currently processing. For example, event: GetProperty (event code 189).
  • Currently all the bytes written to FD, are reported by VovScope as well. Some of the bytes may or may not be printable.

The profiling records are written in the logs folder under the server working directory. The profiling records have filenames that start with prefix vovscope.

vovservermgr

vovservermgr: Usage Message

  DESCRIPTION:
      Modify settings and modes in running vovserver.

  USAGE:
      vovservermgr <COMMAND> [OPTIONS] [command arguments]

  COMMANDS:
      config <Param> <Value>[-|+]
          Send a request to the server to set the configuration parameter Param
          to Value.  Similar to the vovsh vtk_server_config command.
          If Value is numeric, appending - prevents the request if the current
          value is already less than Value or appending + prevents the request
          if the current value is already greater than Value.
          In all cases, minimum, maximum, or other validation constraints may be
          applied at the server depending on the parameter.
          The token "DEFAULT" may be used for Value to specify the server default value.
      setenv <Var> <Value>
          Set vovserver environment variable Var to Value. Similar to the
          vovsh vtk_server_setenv command.
      unsetenv <Var>
          Unset vovserver environment variable Var. Similar to the vovsh
          vtk_server_unsetenv command.
      mem
          Same as the reducememory command.
      reducememory
          Hint to vovserver to perform memory allocation bookeeping and
          optimizations now.
      scheduler <suspend|resume|unsuspend|request|quick|update>
          Equivalent to vovservermgr config scheduler <subcommand>
              suspend   - the scheduler stops dispatching jobs
              resume    - the scheduler resumes normal operation
              unsuspend - same as resume
              quick     - request scheduler in quick mode
              update    - request scheduler in update mode (rebuild buckets)
              request   - same as update

      eventserver <show|start|stop>
          Control the vovserver event multiplexing monitor.
          The subcommand has the following meaning:
              start - start the vovserver event monitor.
              show  - display port to which the event monitor is connected.
              stop  - stop the vovserver event monitor.
  OPTIONS:
      -h            -- Show usage message.
      -v            -- Increase verbosity.

  EXAMPLES:
      % vovservermgr reducemem
      % vovservermgr setenv VOV_HOST_HTTP_NAME vncsrv.internal.mycompany.com
      % vovservermgr unsetenv VOV_HOST_HTTP_NAME
      % vovservermgr scheduler suspend
      % vovservermgr scheduler resume
      % vovservermgr config maxNotifyClients 1000+
      % vovservermgr config useepoll 1

  SEE ALSO:
       vovshow -policy
       vtk_server_config
       vtk_server_setenv
       vtk_server_unsetenv