LSF Version 7.3 - Platform LSF Configuration Reference

LOCAL_TO
Syntax
LOCAL_TO=cluster_name | location_name(cluster_name [cluster_name ...])
Description
Configures token locality for the license feature. You must configure different feature sections
for same feature based on their locality. By default, If LOCAL_TO is not defined, the feature
is available to all clients and is not restricted by geographical location. When LOCAL_TO is
configured, for a feature, License Scheduler treats license features served to different locations
as different token names, and distributes the tokens to projects according the distribution and
allocation policies for the feature.
LOCAL_TO allows you to limit features from different service domains to specific clusters,
so License Scheduler only grants tokens of a feature to jobs from clusters that are entitled to
them.
For example, if your license servers restrict the serving of license tokens to specific geographical
locations, use LOCAL_TO to specify the locality of a license token if any feature cannot be
shared across all the locations. This avoids having to define different distribution and
allocation policies for different service domains, and allows hierarchical group configurations.
License Scheduler manages features with different localities are different resources. Use
blinfo and blstat to see the different resource information for the features depending on
their cluster locality.
License features with different localities must be defined in different feature sections. The same
Service Domain can appear only once in the configuration for a given license feature.
A configuration like LOCAL_TO=Site1(clusterA clusterB) configures the feature for
more than one cluster.
A configuration like LOCAL_TO=clusterA configures locality for only one cluster. This is
the same as LOCAL_TO=clusterA(clusterA).
Cluster names must be the names of clusters defined in the Clusters section of
lsf.licensescheduler.
Examples
Begin Feature
NAME = hspice
DISTRIBUTION = SD1 (Lp1 1 Lp2 1)
LOCAL_TO = siteUS(clusterA clusterB)
End Feature
Begin Feature
NAME = hspice
DISTRIBUTION = SD2 (Lp1 1 Lp2 1)
LOCAL_TO = clusterA
End Feature
Begin Feature
NAME = hspice
DISTRIBUTION = SD3 (Lp1 1 Lp2 1) SD4 (Lp1 1 Lp2 1)
End Feature
Or use the hierarchical group configuration (GROUP_DISTRIBUTION):
Begin Feature
NAME = hspice
GROUP_DISTRIBUTION = group1
lsf.licensescheduler
Platform LSF Configuration Reference 517