License Key Management

Introduction

Sigasi Visual HDL (SVH) license key management system is based on the well known FlexNet (a.k.a. FlexLM) license manager. SVH supports both node-locked and floating license keys. The SVH edition is controlled by the license key.

This page explains how to configure your Sigasi license in SVH on Eclipse. There is a separate page documenting License Server Management.

Node locked licenses

If you have a node-locked license, you can enter your license key directly in SVH.

  1. Open the SVH License Key preference page: Window > Preferences > Sigasi > License Key
  2. Click Edit License File
  3. paste your key in the dialog

An example node-locked license looks like this. Note that the first line starts with INCREMENT

INCREMENT com.sigasi.hdt sigasi 2.0 18-nov-2012 uncounted \
        VENDOR_STRING="company:www.example.com;mac:10f2dd92c5ac;name:John \
        Doe;type:trial" HOSTID=ANY ISSUER=Sigasi ISSUED=21-Oct-2012 \
        START=21-Oct-2012 SIGN="0CCC 87EA 9BB6 256E 7D81 E49D B2A6 \
        E53D 1CA5 41D4 63DF 8671 5695 EF82 0E30 1028 732D DED3 0999 \
        FD11 8B97 42B0 7CF2 F51F 20A0 DA6E 7F54 9D64 FF29 49AB"

Floating licenses

If you have a floating license key, you need to configure both a license server and SVH.

An example floating license looks like this. Note that the first line starts with SERVER or DAEMON:

DAEMON sigasi port=27001
SERVER your_server_name1 BD41FCF5DE27 27000
INCREMENT com.sigasi.hdt sigasi 2.0 18-nov-2012 4 \
        VENDOR_STRING="company:www.example.com;mac:10f2dd92c5ac;name:John \
        Doe;type:trial" HOSTID=ANY ISSUER=Sigasi ISSUED=21-Oct-2012 \
        START=21-Oct-2012 SIGN="0960 9728 7193 4DA5 15C2 3652 21E1 \
        EF82 1060 8FC1 9EA6 0C43 4842 C50B 684F E4DA 8EEF 37E9 5384 \
        8DF4 106C 52B4 EECE 0A69 CBAC 0CF2 47E2 00F2 A244 E22F"

Configuring Floating license in SVH (FlexNet Client)

In order to use a floating license, SVH needs to know how to contact the server. The license server can be configured in SVH or using an environment variable.

Configure the license server in SVH

In SVH, navigate to the License Key preference page via: Window > Preferences > Sigasi > License Key. Next enter <portnumber>@<servername> in the License key path. For example:

27000@myserver.example.com

If you have redundant license servers, enter each of the license servers separated using “,”. It is recommended to specify the primary server first in the list. For example:

27000@myserver1.example.com,27000@myserver2.example.com,27000@myserver3.example.com

If you have multiple, non-redundant license servers, the servers should be separated using “:” on Linux and using “;” on Windows.

If you leave the License key path empty, SVH will try to use an environment variable to find the license server.

Configure the license server in an environment variable

You can also set your license server via an environment variable instead of configuring it in SVH. Both SIGASI_LM_LICENSE_FILE and LM_LICENSE_FILE are supported. When SIGASI_LM_LICENSE_FILE is set, LM_LICENSE_FILE is ignored.

Note that if you want to use an environment variable, you can not enter a path in the License Key preference page. The value on the License Key preference page has priority over environment variables.

Linux Example:

export SIGASI_LM_LICENSE_FILE=27000@myserver.example.com

For redundant license servers, the servers should be separated using “,”. It is recommended to specify the primary server first in the list. Example:

export SIGASI_LM_LICENSE_FILE="27000@myserver1.example.com,27000@myserver2.example.com,27000@myserver3.example.com"

For more details on setting environment variables, refer to this guide.

How to block SVH from checking out a license?

If you have configured an environment variable with the location of a FlexNet license server, you can instruct SVH not to check out a license by setting the SVH License key to none.

Enabling UVM Linting Rules

When using a floating license, Sigasi Visual HDL will automatically upgrade the license to the edition that is required for the feature that is being used, e.g., when first using the Block Diagram View, SVH will bump your license from Designer to Professional. We will hold on to the acquired license for the remainder of your SVH session.

For some features, like the UVM linting rules, there is no automatic upgrading. To activate and use UVM linting rules, you need to explicitly enable them, even if you’ve already checked out the required license. The way to do so depends on the SVH version you are using.

Starting from 2024.2.1

When using SVH 2024.2.1 or newer versions, UVM linting rules can be enabled through the Enable UVM linting checkbox on the License Key preference page.

When enabled, a [Sigasi Visual HDL Professional Edition](/manual/editions/#sigasi-visual-hdl-professional-edition) license will be checked out and held on to while using SVH, unless using [Sigasi Visual HDL Community Edition](/manual/editions/#sigasi-community-edition).

Before 2024.1

When using SVH 2024.1, 2024.1.1, 2024.1.2, or 2024.1.3, the UVM linting rules can be enabled by configuring the License to check out on the License Key page to either Professional or Enterprise. When you configure a license to check out, SVH will immediately check out that license on startup. Note that we might still upgrade the license to a higher edition; for example, when a [Sigasi Visual HDL Professional Edition](/manual/editions/#sigasi-visual-hdl-professional-edition) license is configured as the license to check out, but a documentation export is performed, SVH will upgrade to an [Sigasi Visual HDL Enterprise Edition](/manual/editions/#sigasi-visual-hdl-enterprise-edition) license.