perClass Mira installations include a command line activation utility called perClass_activate, which can be used to activate, deactivate, and show existing license information. The utility is available for both Windows and Linux, the examples shown are for Windows, but they should all work in similar way for Linux as well.

Showing license information

Calling perClass_activate without any action, or with the info action, will make it show information about the currently installed licenses in the license directory:


C:\Program Files\perClass Mira\bin>perClass_activate.exe info

perClass_activate - perClass activation utility 2.0 for perClass Mira 5.4 (31-jan-2026)


Searching for licenses in "C:/ProgramData/perClassBV"...

  Trying "mira.lic"...

  Trying "mira_box.lic"...

  Trying "mira_runtime.lic"...


Filename         | Product      | Status  | Details for version 2026.0131

---------------- | ------------ | ------- | -------------------------------------------------------------------------------------------------------

mira.lic         | mira         | Success | Permanent rehostable license, updates until version 2026.1231, activation key: xx4i-1234-1234-1234-1234

mira_box.lic     | mira.box     | Success | Permanent rehostable license, updates until version 2026.1231, activation key: xx4i-4567-4567-4567-4567

mira_runtime.lic | mira.runtime | Error   | Requested version not supported (-6)


The default license directory depends on whether a license has been (re)activated since perClass Mira 5.4. In case no license has been (re)activated, then the default license directory for info will be in the user's application data directory: %APPDATA%\perClassBV on Windows or ~/.local/share/perClassBV on Linux. If a license has been (re)activated, then the default license directory will be in a shared location instead: %PROGRAMDATA%\perClassBV on Windows or /var/tmp/perClassBV on Linux. It also possible to manually provide a different directory from where to get the license information from by using the --directory <directory> option.


The default validation version will be the current date, which will show if the license would be valid for a version that would have been released today. If instead the license should be checked for a previous version, then the --version <date> option can be provided, where the date is the release date formatted as yyyy.MMdd. To, for instance, check if the licenses would be valid for perClass Mira 5.3, which was released on May 28th 2025, then --version 2025.0528 can be provided.


The info action will return 0 if at least one license has a success status and a non-zero value if all of them have an error status. To make sure that a specific product has at least a success status, it is possible to provide the --product <product> option, this will both filter the output to only show licenses for that product and return 0 only if at least one license for that product has a success status.


NOTE: When providing any extra options to show license information, then it is required to include the info action in the command.

Activating a license

Licenses can be activated using the activate action followed by an activation key:


C:\Program Files\perClass Mira\bin>perClass_activate.exe activate xx4i-1234-1234-1234-1234

perClass_activate - perClass activation utility 2.0 for perClass Mira 5.4 (31-jan-2026)


Activating license for product "mira"...

Sucessfully activated license for product "mira", validating...


Filename | Product | Status  | Details for version 2026.0131

-------- | ------- | ------- | -------------------------------------------------------------------------------------------------------

mira.lic | mira    | Success | Permanent rehostable license, updates until version 2026.1231, activation key: xx4i-1234-1234-1234-1234


Unlike the info action, the default license directory for new activations will always be in the shared location: %PROGRAMDATA%\perClassBV on Windows or /var/tmp/perClassBV on Linux. This can be changed by using the --directory <directory> option, which is required when activating the license for an older version of perClass Mira.


If activating an older version of perClass Mira, then it is also useful to add the --version <date> option, which does work the same as for the info action. This makes it possible to activate licenses for perClass Mira versions as old as perClass Mira 2.0, which was released on October 10th 2019:


C:\Program Files\perClass Mira\bin>perClass_activate.exe activate xx3i-1234-1234-1234-1234 --directory %APPDATA%\perClassBV --version 2019.1010

perClass_activate - perClass activation utility 2.0 for perClass Mira 5.4 (31-jan-2026)


Activating license for product "mira"...

Sucessfully activated license for product "mira", validating...


Filename | Product | Status  | Details for version 2019.1010

-------- | ------- | ------- | -------------------------------------------------------------------------------------------------------

mira.lic | mira    | Success | Permanent rehostable license, updates until version 2019.1231, activation key: xx3i-1234-1234-1234-1234


The activate action will return 0 if the final validation of the license results in a success status, if the validation returns an error status, or if any other errors occurred during activation, then a non-zero value will be returned.

Reactivating licenses

If a license that has been previously activated using at least perClass Mira 5.4 or perClass_activate since perClass Mira 5.4 has been deactivated, then it can easily be reactivated using the same key by calling the activate action without a key. This way perClass_activate will use the previously used key, which is also shown in the output, to try and activate again:


C:\Program Files\perClass Mira\bin>perClass_activate.exe activate

perClass_activate - perClass activation utility 2.0 for perClass Mira 5.4 (31-jan-2026)


Using previously used activation key "xx4i-1234-1234-1234-1234" to activate license for product "mira"


Activating license for product "mira"...

Sucessfully activated license for product "mira", validating...


Filename | Product | Status  | Details for version 2026.0131

-------- | ------- | ------- | -------------------------------------------------------------------------------------------------------

mira.lic | mira    | Success | Permanent rehostable license, updates until version 2026.1231, activation key: xx4i-1234-1234-1234-1234


Different products can also be reactivated in the same way by providing the --product <product> option. This way licenses can easily be swapped between different systems without having to look up the license key again.

Deactivating a license

Previously activated licenses can be deactivated by using the deactivate action which may or may not be followed by an activation key or --product <product> option. In case neither an activation key or product is provided, then, by default, the mira product will be deactivated:


C:\Program Files\perClass Mira\bin>perClass_activate.exe deactivate

perClass_activate - perClass activation utility 2.0 for perClass Mira 5.4 (31-jan-2026)


Deactivating license for product "mira"...

Sucessfully deactivated license for product "mira"


The deactivate action will return 0 if deactivation was successful, otherwise a non-zero value is returned.

Installing a dongle license

It is also possible to install a dongle license using perClass_activate using the install action. The install action works similar to the activate action, but instead of providing an activation key, the path to a dongle license file needs to be provided. Both the --directory <directory> and --version <date> options work the same as they do for the activate action. However, the --product <product> option is not supported, because dongle licenses can support multiple product, which will all be validated after installing:


C:\Program Files\perClass Mira\bin>perClass_activate.exe install %USERPROFILE%\Downloads\mira_box_D123.lic

perClass_activate - perClass activation utility 2.0 for perClass Mira 5.4 (31-jan-2026)


Sucessfully installed license file "C:/Users/Sander/Downloads/mira_box_D123.lic", validating...


Filename          | Product  | Status  | Details for version 2026.0131

----------------- | -------- | ------- | ---------------------------------------------------------

mira_box_D123.lic | mira     | Success | Permanent dongle license, updates until version 2026.1231

mira_box_D123.lic | mira.box | Success | Permanent dongle license, updates until version 2026.1231


The return codes are also similar to the activate action, 0 will be returned if the final validation has at least one success status, and if the validation results in only errors, or if any other error occurred, then a non-zero value is returned.