Licensing | ComponentOne
Additional Activation Scenarios / Activation by Command Line
In This Topic
    Activation by Command Line
    In This Topic

    GrapeCity licensing requires each developer’s machine and build machine to be licensed. It’s recommended to fully install the ComponentOne product on each machine and activate licenses through the GrapeCity License Manager tool (gclm.exe).

    The GrapeCity License Manager tool is also designed to work by command line. You may activate a license through command line even if you have no ComponentOne products installed.

    Command Line Activation

    If you require command line activation, follow these steps:

    1. Install the GrapeCity License Manager tool (gclm).
      1. If the ComponentOne product (for example, WinForms Edition) is installed, then the gclm tool is already installed at (C:\ProgramData\GrapeCity\gclm)
      2. If no ComponentOne product is installed, you may download the gclm deployment tool:
        1. Windows: https://cdn.grapecity.com/license/gclm_deploy.exe
        2. Linux/MacOS: https://www.nuget.org/packages/GrapeCity.LicenseManagerTool/ or you may install the gclm tool from command line:
          "dotnet tool install -g GrapeCity.LicenseManagerTool"
    2. 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"

    Deactivation by Command Line

    Deactivation can be applied only after a key is activated for a specific product. Use the following command to deactivate a license:

    1. 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

    Product IDs

    Refer to the following product IDs when activating and deactivating by command line.

    Product Name

    Product ID

    ComponentOne Studio Enterprise

    331cf6cd-b73c-429f-ba79-fa2f85eebd68

    ComponentOne WinForms Edition

    da3d5d14-691f-4908-aa3c-fd3239734232

    ComponentOne WPF Edition

    c02c28b7-1c24-4109-8eb3-f99c3905f3f1

    ComponentOne ASP.NET MVC Edition

    839e1737-f256-46ea-b391-50da451c13a4

    ComponentOne Blazor Edition

    6631ee67-fec7-45b0-a771-4ec75cd748e3

    ComponentOne UWP Edition

    9afa522c-ea0b-47fe-ae14-7d9225612767

    ComponentOne Studio for Xamarin

    de2b5824-e24d-4e7f-86d1-a87c1729993c

    ComponentOne Xamarin.iOS Edition

    c2e333e5-6dae-4aaf-8903-fa1dc779d32a

    ComponentOne Xamarin.Android Edition

    18dbecd7-edc0-49d0-95d9-bdb9e5e4827f

    Licensing Old Products by Command Line

    The GrapeCity License Manager tool (gclm) was introduced in the 2020 v2 release (July 29th, 2020). If you are working with older versions of ComponentOne controls, you will need to activate keys using the legacy C1LicenseActivation.exe tool.

    If activating a 2020 v2 or later key, run the activate the license using gclm following the steps above, and then run the following command for C1LicenseActivation.

    C:\Program Files (x86)\ComponentOne\C1StartMenu\C1LicenseActivation.exe /gcdetect

    This will generate "old" licenses from the newly installed gclm licenses and do so silently. This is the same as running the C1LicenceActivation UI tool as described in the Licensing old versions of controls using new serial keys topic.

    This will give you access to both new and old products. If a product honors a new key, it will use it. If not, the old key will be honored.

    If activating a 2020 v1 or earlier key, you must activate it using C1LicenseActivation.exe. The following command will silently activate a key.

    C:\Program Files (x86)\ComponentOne\C1StartMenu\C1LicenseActivation.exe /as:sn /u:username /c:company