[]
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.
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.
To activate the serial key on the build server, follow these steps:
Install the MESCIUS License Manager tool (gclm) on the build server.
If Spread.NET or any MESCIUS Inc. product is installed, then the gclm tool is already installed at C:\ProgramData\GrapeCity\gclm
If Spread.NET or any MESCIUS Inc. product is not installed, then you may download the gclm deployment tool:
Windows: Download gclm_deploy.exe
Linux/MacOS: NuGet Package
Install via command line: dotnet tool install -g GrapeCity.LicenseManagerTool
Before the build, call the gclm tool to activate the license.
Windows: C:\ProgramData\GrapeCity\gclm\gclm.exe "product-id" -a "key"
Linux/MacOS: gclm "product-id" -a "key"
After the build, call the gclm tool to deactivate the license.
Windows: C:\ProgramData\GrapeCity\gclm\gclm.exe "product-id" -d
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/ .
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
To activate your pipeline serial key on the build server, follow these steps:
Install the MESCIUS License Manager tool on the build server.
If Spread.NET or any MESCIUS Inc. product is installed, the gclm tool is already installed at C:\ProgramData\GrapeCity\gclm
If Spread.NET or any MESCIUS Inc. product is not installed, you may download the gclm deployment tool:
Windows: Download gclm_deploy.exe
Linux/MacOS: NuGet Package
Install via command line: dotnet tool install -g GrapeCity.LicenseManagerTool
Copy the Local Activation Package file to the gclm install location.
Windows: C:\ProgramData\GrapeCity\gclm
Linux/MacOS: ~/.local/share/GrapeCity/gclm
Before the build, call the gclm tool to activate the license using your serial key and provided password.
Windows: gclm "Product GUID" -a "key" "password"
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.
To check whether the license is activated or not, follow these steps:
Open command prompt and navigate to location: C:\ProgramData\GrapeCity\gclm
Run the following command: C:\ProgramData\GrapeCity\gclm>gclm.exe "Product GUID" > "info.txt"
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