[]
        
(Showing Draft Content)

Pipeline Licensing

MESCIUS licensing is based upon the development machine. However, in a pipeline environment, the license needs to be activated on a virtual machine or Docker on the cloud. A pipeline license is designed for the build agent of DevOps pipelines like Azure, AWS, and Bitbucket.

Follow the instructions below for your type of license.

Activation with Standard Developer License

With a standard developer license, you may build and deploy applications from a dynamic build agent with some limitations.

  • If your pipeline has a dynamic agent (for example, Azure pipeline with Microsoft-hosted agents), you must activate the license before each build and deactivate the license after each build. Depending on the type of license, you may need to deactivate the license after each build.

  • The licensing system allows you to activate up to three separate machines for a single licensed developer to use. If this limit is exceeded, the license activation may fail.

Please contact our sales or support teams if you have any questions on the allowed activations.

Steps to Activate a Standard Serial Key

To activate the serial key on the build server, follow these steps:

  1. Install the MESCIUS License Manager tool (gclm) on the build server.

    1. If Spread.NET or any MESCIUS Inc. product is installed, then the gclm tool is already installed at C:\ProgramData\GrapeCity\gclm

    2. If Spread.NET or any MESCIUS Inc. product is not installed, then you may download the gclm deployment tool:

      1. Windows: Download gclm_deploy.exe

      2. Linux/MacOS: NuGet Package

      3. Install via command line: dotnet tool install -g GrapeCity.LicenseManagerTool

  2. Before the build, call the gclm tool to activate the license.

    1. Windows: C:\ProgramData\GrapeCity\gclm\gclm.exe "product-id" -a "key"

    2. Linux/MacOS: gclm "product-id" -a "key"

  3. After the build, call the gclm tool to deactivate the license.

    1. Windows: C:\ProgramData\GrapeCity\gclm\gclm.exe "product-id" -d

    2. Linux/MacOS: gclm "product-id" -d

Note-

  • The key should be deactivated even if the build fails, otherwise, the license cannot be activated for the next build agent.

  • If deactivation of standard developer license remains a problem, it is recommended to upgrade to a pipeline license.

  • The environment should have network access to https://sa2.grapecity.com/ .

Activation with Pipeline License

Spread.NET pipeline license allows you to build and deploy applications from a dynamic build agent efficiently, without the need to deactivate the key. A pipeline license permits unlimited activations on any number of target build agents per day. However, the serial key must be activated before each build, but it does not require network access, and it cannot be used for design-time development.

Contact our sales team at https://developer.mescius.com/contact  or call 1-800-858-2739 to obtain a pipeline license. A pipeline license includes the following:

  • Local Activation Package File

  • Serial Key

  • Password

Steps to Activate a Pipeline Serial Key

To activate your pipeline serial key on the build server, follow these steps:

  1. Install the MESCIUS License Manager tool on the build server.

    1. If Spread.NET or any MESCIUS Inc. product is installed, the gclm tool is already installed at C:\ProgramData\GrapeCity\gclm

    2. If Spread.NET or any MESCIUS Inc. product is not installed, you may download the gclm deployment tool:

      1. Windows: Download gclm_deploy.exe

      2. Linux/MacOS: NuGet Package

      3. Install via command line: dotnet tool install -g GrapeCity.LicenseManagerTool

  2. Copy the Local Activation Package file to the gclm install location.

    1. Windows: C:\ProgramData\GrapeCity\gclm

    2. Linux/MacOS: ~/.local/share/GrapeCity/gclm

  3. Before the build, call the gclm tool to activate the license using your serial key and provided password.

    1. Windows: gclm "Product GUID" -a "key" "password"

    2. Linux/MacOS: gclm "Product GUID" -a "key" "password"

Note-

  • The Product GUID for Spread.NET v18 is da57a717-0389-4e69-89bc-f5e71c20177b .

  • It is important to note that the GUID is version specific including service packs as well.

  • You may also perform the activation(step 3) using the MESCIUS License Manager GUI if you don’t want to use the command-line interface. See Activating the Product for more details.

Check the License Status

To check whether the license is activated or not, follow these steps:

  1. Open command prompt and navigate to location: C:\ProgramData\GrapeCity\gclm

  2. Run the following command: C:\ProgramData\GrapeCity\gclm>gclm.exe "Product GUID" > "info.txt"

  3. Check the license details, including license status, license type, serial key, activation date, expiration date, and edition, run the following command:  C:\ProgramData\GrapeCity\gclm>more info.txt