Licensing Build Agents/Pipelines using Command Line

Activating CI/CD Build Agents with a Pipeline License

The ActiveReports Pipeline License allows you to license applications built using CI/CD agents (such as BitBucket Pipelines, GitHub Actions, Azure DevOps, etc.) without consuming a developer license seat.

Prerequisites

To activate a license on a build server, you must first obtain a Pipeline License. Please contact the sales team to request one:

Email: activereports.sales@mescius.com
Phone: 1.800.858.2739

Once issued, you will receive the following required items:

Serial Key
Local Activation Package File (e.g., activation_package.zip)
Password

Activation Steps

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

1. Install the MESCIUS License Manager

You need the sa3client command-line tool available on your agent. You can access this in two ways:

Option A: Existing Installation
If ActiveReports (or any MESCIUS Inc. product) is already installed on the agent, the License Manager client is typically located at:
%ProgramData%\SA3\sa3client.exe
(Note: Verify this path based on your specific product version and installation directory).
Option B: NuGet Package (Recommended for CI/CD)
Install the license manager as a global tool using the sa3client NuGet package:
```
dotnet tool install -g sa3client
```

2. Run the Activation Command

Execute the following command in your build script pipeline. Ensure the Local Activation Package File is accessible in your working directory.

sa3client local <Serial Key> <Password> -p <Path/To/Local Activation Package File>