Home
Altair FlowTracer Administrator Guide
This manual is aimed at the person who will be the administrator for FlowTracer. This person will be responsible for configuring the network resources, setting up the licensing, and establishing security and access rules for the system.
IT Administrator Topics
Annotations
Annotations are text strings which may be attached to VOV objects. These are typically used to provide additional information about objects in the project's graph. The text must be less than 32k characters.

Welcome
What's New
View new features for FlowTracer 2025.1.0.
FlowTracer Overview
An advanced mission critical dependency management platform for developing and executing flows.
FlowTracer Tutorials
Discover FlowTracer functionality with interactive tutorials.
Altair FlowTracer User Guide
FlowTracer is a complete system to create, manage, and execute design flows.
Altair FlowTracer Administrator Guide
This manual is aimed at the person who will be the administrator for FlowTracer. This person will be responsible for configuring the network resources, setting up the licensing, and establishing security and access rules for the system.
- FlowTracer Roles
  When using FlowTracer in large deployments, three main roles emerge: Administrator, Developer and User. In smaller organizations, a given person may have multiple roles, but the duties of each role still exist.
- Enable CLI Access on UNIX
  This section explains how to set up a UNIX user's shell environment to have a proper context for the user to run installed Altair Accelerator programs from the command line. The programs that are run from the command line are called the CLI commands.
- Enable CLI Access on Windows
  This section explains how to set up a Window user's command prompt environment to have the proper context for the user to run installed Altair Accelerator programs from the command line. The programs that are run from the command line are called the CLI commands.
- User Interfaces
- Use FlowTracer Help
  FlowTracer documentation is available in HTML and PDF format.
- Projects
- Server Working Directory
  When a project is created, a server working directory (.swd directory) is created to hold configuration and state information about the project.
- Alerts
  VOV issues an "alert" when an event requires attention. An alert can range from information that does not require action to an urgent fault that requires immediate action.
- Manage the Server for a Project
- Security
  The VOV security model consists of assigning a Security Code to each client or client group (VovUser Group) and granting the permission to execute critical tasks only to clients with the appropriate security level.
- Taskers
  A tasker is a VOV client that provides computing resources, specifically CPU cycles, to the vovserver.
- Interfaces to Accelerator, SGE, LSF, and Others
  FlowTracer can be used also as a front end to an existing batch processing system (BPS), for example, Accelerator, LSF, SGE, SGEEE, etc.
- Configuration for Elastic Computing
- Configuration for Altair Accelerator
- Configure a Failover Server Replacement
  If a server crashes suddenly, VOV has the capability to start a replacement server on a pre-selected host. This capability requires that the pre-selected host is configured as a failover server.
- Advanced Information
- Multi-User Altair FlowTracer
  FlowTracer now supports a "multi-user" mode of operation, as a Beta feature. In the multi-user mode, many different users can share the same project, in terms of modifying a flow as well as running different compoments of the flow.
- IT Administrator Topics
  - SSH Setup
    If you use SSH to login onto certain machines in your LAN that you want to use as taskers, you need to setup SSH so that it will not ask for your password.
  - Network Conditioning
    Each computer has its own clock. Clocks on different computers in the same network might not be synchronized. The system administrator should keep all clocks in the network synchronized.
  - File System Offsets
    The file system that contains the design files may reside on a machine that is not the same as the one where the vovserver is running. The clocks in the two machines may be different, resulting in an offset. These offsets can be easily avoided. Here we show what can be done to work with an unsynchronized network.
  - NFS and VOV
    Before you can use NFS, be it as server or client, you must make sure your kernel has NFS support compiled in.
  - Using PAM (Pluggable Authentication Modules) for Browser Authentication
  - Known Issues
  - Health Monitoring and vovnotifyd
  - Check All Files in a Project
    When you request a run, the FlowTracer server checks the timestamp of all primary inputs in the upcone of the target.
  - vovcleanup
    The utility vovcleanup is used to clean old log files from /tmp and from the server working directory.
  - GUI Customization
    Both the vovconsole's main GUI and its Node Editor GUI can be customized with the gui.tcl file.
  - Annotations
    Annotations are text strings which may be attached to VOV objects. These are typically used to provide additional information about objects in the project's graph. The text must be less than 32k characters.
  - Ignore Links into the DesignSync Cache
    If you use DesignSync, you want to ignore links to the DesignSync cache.
- Special Issues
- Miscellaneous
Altair FlowTracer Developer Guide

View All Altair Accelerator Help

Annotations

Annotations are text strings which may be attached to VOV objects. These are typically used to provide additional information about objects in the project's graph. The text must be less than 32k characters.

You may attach annotations to any VOV element in the dependency graph. Use annotations to explain either why you did something or the meaning of a file.

Add Annotations

You may add annotations to VOV objects from the VOV console GUI, or programmatically when the flow is built. At this point, there is no support to add annotations using the browser interface.

VOV Console

Use the Property dialog to add annotations. Double-click on a node in the grid view, then click on the Annotations & Properties tab of the Node Editor after it is displayed.

An annotation is itself a VOV object with its own VovId.

Annotations in the Flow Definition File

You may attach annotations to objects in your flow at the time it is built by using the A statement in the Flow Definition File. Refer to FDL Procedures Reference for additional information.

Example of attaching an annotation to a job:

J vw cp aa bb
A "this is a simple job"

Annotation Support in the Tcl API

You may programmatically attach, modify, and delete annotations at any time using procedures in the vtk_ application programming interface.


Annotation procedures	Description
vtk_annotation_count	Gets an integer count of the number of annotations on a VOV object
vtk_annotation_get vovid index	Gets data of an annotation in list form
vtk_annotation_del	Deletes an annotation
vtk_annotation_modify	Modifies data of an annotation
vtk_annotation_add vovid string	Adds 'string' as an annotation to 'vovid'