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

DESCRIPTION:
    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.

USAGE:
    vovforget [options] [objectId] ...

OPTIONS:

    -alerts             -- Forget all alerts.
    -allalerts          -- Forget all alerts (same as -alerts).
    -allemptysets       -- Forget all empty sets older than 60s.
                           (Command is only supported for Accelerator, Accelerator Plus, and Hero products.)
    -allnodes           -- Forget all nodes.
    -allhosts           -- Forget all hosts.
    -allsets            -- Forget all sets (except System sets).
                              see also -allemptysets   and -emptysets
                           (Command is only supported for FlowTracer, Allocator, and Monitor products.)
    -allresources       -- Forget all resource maps.
    -rdsresources       -- Forget all resource maps created by RDS.
    -allreservations    -- Forget all reservations.
    -blocking           -- Forget blocking files, i.e.
                           files with no inputs that are not VALID.
    -dir      <dirname> -- Forget jobs in a directory.
    -elements <setName> -- Forget elements in given set.
    -emptysets          -- Forget 'my' empty sets older than X seconds
                           X = 0s for FlowTracer, Allocator, and Monitor products.
                           X = 60s  for Accelerator, Accelerator Plus, and Hero products.
    -emptysets -hier    -- Forget 'my' empty sets (and their subsets) older than 0s (default).
                           (Command is only supported for FlowTracer, Allocator, and Monitor products.)
    -h
    -help               -- Help usage message.
    -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.
    -idlelimits         -- Forget all Limit:* resources that are not
                           associated with any running or queued jobs.
    -idleusers          -- Forget users with no clients and no jobs.
    -isolated           -- Forget isolated files, i.e.
                           files with no inputs nor outputs.
    -missing            -- Forget missing files.
    -orphanreservations -- Forget all orphan reservations.
    -oldlimits          -- Forget all Limit:* resources that have not
                           not been used in the last 7 days.
    -preemptrules       -- Forget all preemption rules.
    -q
    -s
    -set      <setName> -- Forget a set.
    -silent             -- Do not print count of forgotten nodes.
    -sleeping           -- Forget all nodes with status SLEEPING
                           (they appear in black in the GUI).
    -subdirs  <dirname> -- Forget jobs in a directory and all subdirs.
    -v                  -- Increase verbosity.

EXAMPLES:
    % 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 -emptysets -age 10s  -- My empty sets older than 10s

    % vovforget -hier -set FrontEnd
    % vovforget -hier -elements FrontEnd

SEE ALSO:
    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