Frequently asked question

What is the format of the Service.txt file?

Last Published: June 28, 2024

Answer

In ArcGIS License Manager, a service.txt file usually begins with a SERVER line followed by a VENDOR line and then a FEATURE line.

SERVER line

The SERVER line specifies the host name and hostid of the license server system and the TCP/IP port number of the license server manager (lmgrd).

The format of the SERVER line is:

SERVER host hostid [port]

Field

Description

Esri Default

host

The system host name or IP address.

this_host

hostid

The host identifiers for the machine hosting the license manager.

ANY

<lmgrd port>

TCP/IP port number of the license manager daemon

27000

Example of Esri Default

SERVER this_host ANY 27000

Elements that can be modified:

  • Hostname
  • TCP/IP port number

VENDOR line

The VENDOR line specifies the daemon name and path. lmgrd uses this line to start the vendor daemon, and the vendor daemon reads it to find its options file.

The format of the VENDOR line is:

VENDOR vendor [vendor_daemon_path] [[OPTIONS=]options_file_path] [[PORT=]port]

Field

Description

Esri Default

vendor

Name of the vendor daemon used to serve some feature(s) in the file. This name cannot be changed by the administrator.

ARCGIS

vendor_daemon_path

Optional path to the executable for this daemon. Generally, the license administrator is free to install the daemon in any directory. (It is recommended, however, that it be installed in a local directory on the license server machine.)

If omitted, lmgrd looks for the vendor daemon binary in

  • the current directory
  • the path specified in lmgrd's $PATH environment variable
  • in the directory where lmgrd is located

If vendor_daemon_path is blank, then any options or TCP/IP port number specifications require the OPTIONS= and PORT= strings.

options_file_

path

Full path to the end-user options file for this daemon. FLEXnet Licensing does not require an options file.

If omitted, the vendor daemon, by default, looks for a file called vendor.opt (where vendor is the vendor daemon name) located in the same directory as the license file.

Using the Options file—License Manager Guide | Documentation (arcgis.com)

port

Vendor daemon TCP/IP port number.

The default, if port is not specified, is chosen by the operating system at run-time. Sites with firewalls need to specify the TCP/IP port number the daemon uses.

Configure ArcGIS License Manager to work through a firewall—License Manager Guide | Documentation

 

Example of Esri Default

VENDOR ARCGIS

Elements that can be modified:

  • Vendor Daemon path
  • Options file paths
  • Port

FEATURE line

A FEATURE line describes the license required to use a product.

The format of the FEATURE line is:

FEATURE feature vendor feat_version exp_date num_lic SIGN=sign [optional_attributes]

Field

Description

Esri Default

feature

Name given to the feature by the vendor.

ACT

vendor

Name of the vendor daemon; also found in the VENDOR line. The specified daemon serves this feature.

ARCGIS

feat_version

Version of this feature that is supported by this license.

1

exp_date

Expiration date of license in the format dd-mmm-yyyy, e.g., 07-may-2024. Note: If exp_date is the string "permanent" or the year is 0 (or 00, 000, 0000) then the license never expires.

permanent

num_lic

Number of concurrent licenses for this feature. If the num_lic is set to the string "uncounted" or 0, the licenses for this feature are uncounted and no lmgrd is required but a hostid on the FEATURE line is required.

1

vendor_info="..."

Additional information provided by the software vendor.

vendor_info=7KNJDRHFHBK4CFDMJ214

SIGN=sign

SIGN= signature to authenticate this FEATURE line.

SIGN="052E ABFC 32DD \

                2473 DEFD E276 4BF3 E0DB 87EB 2203 5A30 C014 19A1 C35E 2154 \

                08B1 9460 A2B9 6701 DC4D CAF2 E2FE 1347 0E36 90FA 4F3B E864 \

                BEC8 D3A2 A615"

Example of Esri Default

FEATURE ACT ARCGIS 1 permanent 1 vendor_info=7KNJDRHFHBK4CFDMJ214 SIGN="052E ABFC 32DD \

                2473 DEFD E276 4BF3 E0DB 87EB 2203 5A30 C014 19A1 C35E 2154 \

                08B1 9460 A2B9 6701 DC4D CAF2 E2FE 1347 0E36 90FA 4F3B E864 \

                BEC8 D3A2 A615"

Note:
Use the "\" line-continuation character to break up long lines.

Article ID:000032982

Software:
  • ArcGIS Enterprise

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options