Remove Nodes From the Graph

Forgetting nodes means eliminating them from the flow.

Forgetting a file from the flow does not remove the file itself from the filesystem. It only tells FlowTracer to stop paying attention to the file. Consider vovblast to simultaneously forget and delete a file. A job that is RUNNING or RETRACING cannot be forgotten: you need to stop the job first.

In Accelerator, jobs can be forgotten automatically by setting the "autoForget" flag. The log files are also automatically forgotten. They are removed from the disk if their path contains the string "vnc_logs".

Forget Nodes using the CLI

The program to forget nodes from the flow is vovforget.

vovforget: Usage Message
      Forget objects from the project's vovserver.
      The objects are typically nodes (files or jobs) and are
      are passed by VovId or by file name.  
      The objects may also be users, sets, or selected by option.
      vovforget [options] [objectId] ...
      -help               -- Print this message.
      -silent             -- Do not print count of forgotten nodes.
      -v                  -- Increase verbosity.
      -elements <setName> -- Forget elements in given set.
      -dir      <dirname> -- Forget jobs in a directory.
      -subdirs  <dirname> -- Forget jobs in a directory and all subdirs.
      -set      <setName> -- Forget a set.
      -hier               -- When forgetting a set or its elements, 
                             also traverse the hierarchy of the subsets.
                             Technical note: The traversal is based on 
                             attachments of subsets, 
                             and not on the names of the subsets. 
      -allemptysets       -- Forget all empty sets older than 60s.
      -emptysets          -- Forget 'my' empty sets older than 60s.
      -blocking           -- Forget blocking files, i.e.
                             files with no inputs that are not VALID.
      -missing            -- Forget missing files.
      -idleusers          -- Forget users with no clients and no jobs.
      -isolated           -- Forget isolated files, i.e.
                             files with no inputs nor outputs.
      -sleeping           -- Forget all nodes with status SLEEPING
                             (they appear in black in the GUI).
      -alerts             -- Forget all alerts.
      -allalerts          -- Forget all alerts (same as -alerts).
      -allnodes           -- Forget all nodes.
      -allhosts           -- Forget all hosts.
      -allsets            -- Forget all sets (except System sets).
                                see also -allemptysets   and -emptysets
      -allresources       -- Forget all resource maps.
      -allreservations    -- Forget all reservations.
      -orphanreservations -- Forget all orphan reservations.
      -oldlimits          -- Forget all Limit:* resources that have not
                             not been used in the last 7 days.
      -idlelimits         -- Forget all Limit:* resources that are not
                             associated with any running or queued jobs.
      -preemptrules       -- Forget all preemption rules.
      % vovforget aa bb cc              -- Forget files by name.
      % vovforget 00023456              -- Forget objects by id.
      % vovforget -dir .                -- Forget jobs in current dir.
      % vovforget -subdirs .            -- Forget jobs in current dir 
                                           and all subdirs.
      % vovforget -allnodes  
      % vovforget -blocking 
      % vovforget -allemptysets        -- All empty sets, for all users.
      % vovforget -emptysets           -- My empty sets 
      % vovforget -hier -set FrontEnd
      % vovforget -hier -elements FrontEnd
      vsz                       -- To forget isolated nodes.
      vovset forget <set>       -- To forget sets.
  • To forget specific files or jobs, give either the name of a file or the VovId of a job as an argument. Examples:
    % vovforget fileAA
    % vovforget 00012345 00023456
  • To forget all elements in a set, use the -elements option. Example:
    % vovforget -elements "failed:jobs"
  • To forget all jobs in a directory, use the -dir option. Example:
    % vovforget -dir .
  • To forget all jobs in a directory and all of its subdirectories, use the -subdirs option. Example:
    % vovforget -subdirs .
  • To forget all blocking files, use:
    % vovforget -blocking

Forget Nodes

Forget Nodes using the GUI

To forget a single node, visualize it in the Set Viewer, right click on it and click Forget.

To forget many nodes, select them and then forget them using the pop-up menu.

Forget Nodes using the Browser Interface

The browser interface presents several entries to forget individual nodes or elements of a set. The link is normally associated with the icon . Confirmation will be requested.

Forget Nodes and Sets using the Tcl Interface

  • Forget a single node using vtk_node_forget $nodeId
  • Forget all nodes in a set with vtk_set_forget -elements $setId
  • Forget a set (not its elements) with vtk_set_forget $setId