Installing a license for an on-premises tenant

To perform this procedure, you must have access to the file system on the on-premises machine. You must also have permissions to restart IIS on the on-premises machine.

1. Download the license file. Navigate to Administration > Environment > Tenants, locate the tenant, and click the tenant name. Select the Licensing tab, click Actions () in the page header, and select Generate license file. The file is saved to your browser's download folder.

2. Place the license file into the following folder on the on-premises machine:

   %PROGRAMDATA%/Itron/Platform/License/

   Caution: Do not rename the file. Keep the file name in its original format (Licenses_<tenantId>.lic).

3. From an administrator command prompt, restart IIS:

   IISRESET

4. In the portal user interface, navigate to Tenant > Licenses. Verify that the license is listed on the Tenant Licenses page. For more information, see Tenant licenses and Adding or editing tenant licenses.

Note: If the license file is copied to an alternate location, the location path must be re-configured in two places: The appsettings file of the TenantManagement API: edit the Licensing > LicenseFilePath property of the <INSTALLFOLDER>\Platform\Identity\TenantManagement\appsettings.OnPrem.json file. The appsettings file of the Identity Server: edit the Licensing > LicenseFilePath property of the <INSTALLFOLDER>\Platform\Identity\IdentityServer\appsettings.OnPrem.json file.