[]
API DEMOS BLOG SUPPORT PRICING DOWNLOAD
(Showing Draft Content)

Licensing Build Agents/Pipelines using Command Line

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. 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 and, depending on the type of license, you may need to deactivate the license after each build. See the instructions below for your type of license.

Activation with Pipeline License

This method of activation is the recommended one.

With a pipeline license you may build and deploy applications from a dynamic build agent with fewer limitations than a standard developer license. A pipeline license allows unlimited activations per day with no need to deactivate the key. The serial key must still be activated before each build, but it does not require network access and it cannot be used for design-time development.

You should contact our sales team at activereports.sales@mescius.com or call 1.800.858.2739 for issuing the pipeline license. A pipeline license includes three things:

  1. Serial Key
  2. Local Activation Package File
  3. Password

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

  1. Install the MESCIUS License Manager tool in the pipeline.

    1. If ActiveReports or any MESCIUS inc. product is installed, then the gclm tool is already installed at C:\ProgramData\GrapeCity\gclm
    2. If ActiveReports or any MESCIUS inc. product is not installed, you may download the gclm deployment tool:

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

    • Windows: C:\ProgramData\GrapeCity\gclm
    • 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.

    • Windows:

      C:\ProgramData\GrapeCity\gclm\gclm.exe "437d0240-ba2c-4f9e-9a92-c2816f83d391" -a "key" “password”

    • Linux/MacOS:

      gclm "437d0240-ba2c-4f9e-9a92-c2816f83d391" -a "key" “password”

type=note

Note: You may also perform the activation (step 3) using the MESCIUS License Manager GUI if command line interface is not required. See Licensing a Developer Machine and follow the steps for activating your pipeline key. It will prompt you to enter the password separately.

Activation with Standard Developer License

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

  1. Your serial key must be activated and deactivated for each build.
  2. You may only activate and deactivate a single key up to 3 times per day, 10 times per 10 days, and 25 times per 360 days. Reaching any of these limits will cause additional activation requests to fail.

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

  1. Install the MESCIUS License Manager tool (gclm) in the pipeline.
    1. If ActiveReports or any MESCIUS inc. product is installed, then the gclm tool is already installed at C:\ProgramData\GrapeCity\gclm
    2. If ActiveReports or any MESCIUS inc. product is not installed, you may download the gclm deployment tool:
  2. Before the build, call the gclm tool to activate the license

    • Windows:

      C:\ProgramData\GrapeCity\gclm\gclm.exe "437d0240-ba2c-4f9e-9a92-c2816f83d391" -a "key"

    • Linux/MacOS:

      gclm "437d0240-ba2c-4f9e-9a92-c2816f83d391" -a "key"

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

    • Windows:

      C:\ProgramData\GrapeCity\gclm\gclm.exe "437d0240-ba2c-4f9e-9a92-c2816f83d391" -d

    • Linux/MacOS:

      gclm "437d0240-ba2c-4f9e-9a92-c2816f83d391" -d

Notes:

  • The key should be deactivated even if the build is failed, otherwise the license cannot be activated for next build agent. You may contact our support team to resolve the issue if a key cannot be deactivated. If deactivation may be a problem, we recommend upgrading to a pipeline license.
  • The environment should have the network to access https://sa2.grapecity.com/ website.

Check the License Status

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

  1. Create a file, say 'info.txt' with the product name and GUID specified

    C:\ProgramData\GrapeCity\gclm>gclm "437d0240-ba2c-4f9e-9a92-c2816f83d391" > "info.txt"

  2. Check the license details: license status, license type, serial key, activation date, expiration date, and edition

    C:\ProgramData\GrapeCity\gclm>more info.txt