Home
Altair Allocator Administrators Guide
Allocator works in conjunction with license monitoring and workload scheduling solutions such as Monitor and Accelerator.
View Allocation Details
Command Shell Output
Allocations made by Allocator and other details related to the allocation can be viewed on the command line of a shell where the Allocator project has been enabled.

Welcome
What's New
View new features for Allocator 2025.1.2.
Allocator Overview
Discover the available Altair Allocator guides.
Allocator Tutorials
Examine the Case Study for a complex Allocator example.
Altair Allocator Administrators Guide
Allocator works in conjunction with license monitoring and workload scheduling solutions such as Monitor and Accelerator.
- Introduction
  Allocator works in conjunction with license monitoring and workload scheduling solutions such as Monitor and Accelerator.
- Start, Stop and Monitor Allocator
- Sharing Licenses Across Multiple Sites
- Configure Allocator
  To configure Allocator, you need to create a file called config.tcl. This is the only file required for configuring Allocator.
- Allocator Procedures
  In this section, the procedures that may be used in the Allocator configuration file are described.
- Procedures Backward Compatibility
  The previous section described the procedures that may be used in the Allocator configuration file. The new procedures are under the Tcl namespace LA; they should be prefixed with LA::
- Allocator Usage Examples
  This section contains simple examples about using Allocator to solve common problems of sharing licenses between sites.
- Map Host Names
  In several points in the systems, it is useful to get the host name for a checkout, for a job, for a daemon, etc. Since every machine may be known by different names, it is important to provide the expert user with the ability to map host names to some canonical form of the host name.
- Resource Groups
  The notion of a "resource group" in Allocator is useful when you have a resource that is derived from multiple sources.
- Allocator and TIMEVAR
  To make the weights of Allocator change as a function of time, you can use the procedure TIMEVAR.
- Passive Mode
- License Overbooking
- Overbooking in Allocator
- Debugging
- View Allocation Details
  - Web Interface
    The primary access to Allocator is through its web browser interace.
  - Standalone User Interface
    Allocator also provides a standalone graphical user interface that can be run from the shell command line.
  - Command Shell Output
    Allocations made by Allocator and other details related to the allocation can be viewed on the command line of a shell where the Allocator project has been enabled.
  - Failover Server Candidates
    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.
- Multiple Queues
- PBS and Other Queues
  Allocator can allocate licenses across multiple schedulers, including Accelerator queues, PBS clusters and others. In this section we discuss how to integrate Allocator and PBS.

View All Altair Accelerator Help

Command Shell Output

Allocations made by Allocator and other details related to the allocation can be viewed on the command line of a shell where the Allocator project has been enabled.

Note: This is a very raw output. To get a more useful view and functionality, it is recommended to use the browser interface, described in an earlier section.

In a shell, use the following command:

vovshow -la

This will display the allocation details in a tabular format, as shown below. For each resource, this output will give a total summary across all sites, as well as details of individual sites identified by their nickname. For each site, it shows 3 values as r/a/q: running/allocated/queued.

% vovshow -la
LMSITE 000097801 licmon
NCSITE 000103532 SC
NCSITE 000106903 IN
NCSITE 000110274 CN
RESOURCE_NAME                        TOTAL UNALLOC INFLIGHT SC   r/a/q   IN   r/a/q   CN   r/a/q
License:111                              7       0       0   0/  6/  0    0/  1/  0    0/  0/  0
License:940                              1       0       0   0/  1/  0    0/  0/  0    0/  0/  0
License:945                              1       0       0   0/  1/  0    0/  0/  0    0/  0/  0
License:AAA                             62       0       0   0/ 52/  0    0/ 10/  0    0/  0/  0
License:AEMv8_RAVEN                    400       0       0   0/334/  0    0/ 66/  0    0/  0/  0
License:AdvancedAMSDebug                 3       0       0   0/  3/  0    0/  0/  0    0/  0/  0
License:Affirma_AMS_distrib_p           60       0       0   0/ 50/  0    0/ 10/  0    0/  0/  0
License:Affirma_sim_analysis_env         5       0       0   0/  5/  0    0/  0/  0    0/  0/  0
...
...

You can choose to see only a specific column for each site by specifying the name of that column on the vovshow command line. The available columns are inuse, alloc, queued, or all. If no column is specified, it defaults to showing all columns.

vovshow -la alloc

You can see details of only a specific resource as shown below:

vovshow -lares License:workflowsim