ActiveReports 18 .NET Edition
Developers / License ActiveReports / Licensing Build Agents/Pipelines
In This Topic
    Licensing Build Agents/Pipelines
    In This Topic

    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\MESCIUS\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\MESCIUS\gclm
      • Linux/MacOS: ~/.local/share/MESCIUS/gclm

    3. Before the build, call the gclm tool to activate the license using your serial key and provided password.
      • Windows:
        C:\ProgramData\MESCIUS\gclm\gclm.exe "463c4179-288c-48fe-a4df-3b609586667d" -a "key" “password”
        
      • Linux/MacOS:
        gclm "463c4179-288c-48fe-a4df-3b609586667d" -a "key" “password”
        
    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 9 times per day.

    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 "463c4179-288c-48fe-a4df-3b609586667d" -a "key"
        
      • Linux/MacOS:
        gclm "463c4179-288c-48fe-a4df-3b609586667d" -a "key"
        

    3. After the build, call the gclm tool to deactivate the license
      • Windows:
        C:\ProgramData\GrapeCity\gclm\gclm.exe "463c4179-288c-48fe-a4df-3b609586667d" -d
        
      • Linux/MacOS:
        gclm "463c4179-288c-48fe-a4df-3b609586667d" -d
        

    Notes:

    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 "463c4179-288c-48fe-a4df-3b609586667d" > "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