8000 Todor licensing (#223) · telerik/report-server-docs@d184685 · GitHub
[go: up one dir, main page]

Skip to content

Commit d184685

Browse files
Todor licensing (#223)
* Create setting-up-your-telerik-repor-server-license-key.md * Update setting-up-your-telerik-repor-server-license-key.md * Rename knowledge-base/licensing/setting-up-your-telerik-repor-server-license-key.md to licensing/setting-up-your-telerik-repor-server-license-key.md * Update setting-up-your-telerik-repor-server-license-key.md * Create license-errors-and-warnings.md * Update license-errors-and-warnings.md * Update setting-up-your-telerik-repor-server-license-key.md * Create license-faq.md * Create test.txt * Add files via upload * Delete licensing/images/test.txt * Update setting-up-your-telerik-repor-server-license-key.md * Update setting-up-your-telerik-repor-server-license-key.md * Update license-faq.md * Rename implementer-guide/licensing-and-distribution/license-agreement.md to licensing/license-agreement.md * Update setting-up-your-telerik-repor-server-license-key.md * Update setting-up-your-telerik-repor-server-license-key.md * Update setting-up-your-telerik-repor-server-license-key.md * Update setting-up-your-telerik-repor-server-license-key.md * Update setting-up-your-telerik-repor-server-license-key.md * Update license-errors-and-warnings.md * Update license-faq.md * Update license-faq.md * Update setting-up-your-telerik-repor-server-license-key.md
1 parent 41a960e commit d184685

6 files changed

+237
-0
lines changed
24 KB
Loading
17.2 KB
Loading
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
title: Errors and Warnings
3+
page_title: "Learn about Errors and Warnings in Telerik Report Server Licensing."
4+
slug: license-errors-and-warnings
5+
tags: license, telerik, report, server, questions, errors, warnings
6+
published: True
7+
position: 7
8+
---
9+
10+
# License Activation Errors and Warnings
11+
12+
Starting with the 2025 Q1 release, using Telerik Report Server without a license or with an invalid license causes specific license warnings and errors. This article defines what an invalid license is, explains what is causing it, and describes the related license warnings and errors.
13+
14+
The implementation of the 2025 product licensing requirements will occur in two phases:
15+
16+
* Phase 1 - Starting with the 2025 Q1 release, a missing or invalid license logs a warning in the build log.
17+
* Phase 2 - Starting with the 2025 Q2 release, a missing, expired, or invalid license will result in:
18+
19+
- A watermark appears on each report document page.
20+
- A warning message appearing in the log file generating after attaching a Trace Listener to the [Report Server Manager]({%slug search%}) and [Report Server Agent]({%slug service-agent%}):
21+
22+
````
23+
Telerik and Kendo UI Licensing warning TKL002: No Telerik and Kendo UI License file found.
24+
Telerik and Kendo UI Licensing warning TKL002: The following locations were searched:
25+
Telerik and Kendo UI Licensing warning TKL002: * TELERIK_LICENSE (EnvironmentVariable)
26+
Telerik and Kendo UI Licensing warning TKL002: * KENDO_UI_LICENSE (EnvironmentVariable)
27+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Telerik.ReportServer.Web\telerik-license.txt (RecursiveFilePath)
28+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Telerik.ReportServer.Web\kendo-ui-license.txt (RecursiveFilePath)
29+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Services\telerik-license.txt (RecursiveFilePath)
30+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Services\kendo-ui-license.txt (RecursiveFilePath)
31+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\telerik-license.txt (RecursiveFilePath)
32+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\kendo-ui-license.txt (RecursiveFilePath)
33+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\telerik-license.txt (RecursiveFilePath)
34+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\kendo-ui-license.txt (RecursiveFilePath)
35+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\telerik-license.txt (RecursiveFilePath)
36+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\kendo-ui-license.txt (RecursiveFilePath)
37+
Telerik and Kendo UI Licensing warning TKL002: * C:\telerik-license.txt (RecursiveFilePath)
38+
Telerik and Kendo UI Licensing warning TKL002: * C:\kendo-ui-license.txt (RecursiveFilePath)
39+
Telerik and Kendo UI Licensing warning TKL002: * C:\Users\user1\AppData\Roaming\Telerik\telerik-license.txt (UserDirectory)
40+
Telerik and Kendo UI Licensing warning TKL002: * C:\Users\user1\AppData\Roaming\Telerik\kendo-ui-license.txt (UserDirectory)
41+
Telerik and Kendo UI Licensing warning TKL002: Activate a License Key file at https://prgress.co/3PBSVoC
42+
Telerik and Kendo UI Licensing warning TKL101: Telerik Reporting is not listed in your current license file.
43+
Telerik and Kendo UI Licensing warning TKL004: Unable to locate licenses for all products.
44+
````
45+
46+
47+
## Invalid License
48+
49+
An invalid license can be caused by any of the following:
50+
51+
* Using an expired subscription license. Subscription licenses expire at the end of the subscription term.
52+
* Using a perpetual license for Telerik Report Server versions released outside the validity period of your license.
53+
* Using an expired trial license.
54+
* A missing license for the Telerik Report Server.
55+
* Not installing a license key in your application.
56+
* Not updating the license key after renewing your Telerik Report Server license.
57+
58+
## License Warnings and Errors
59+
60+
Using the Telerik Report Server with an expired or missing license, the `Telerik.Licensing` will indicate the following errors or conditions:
61+
62+
|**Condition or Error**|**Message Code**|**Solution**|
63+
|----|----|----|
64+
|`No license key is detected`|TKL002|[Install a license key]({%slug license-key%}) to activate Telerik Report Server and remove the error message.|
65+
|`Invalid license key`|TKL003|[Download a new license key]({%slug license-key%}#downloading-the-license-key) and install it to activate Telerik Report Server and remove the error message.|
66+
|`Your subscription license has expired.`|TKL103; TKL104|Renew your subscription and [download a new license key]({%slug license-key%}#downloading-the-license-key).|
67+
|`Your perpetual license is invalid.`|TKL102||You are using a product version released outside the validity period of your perpetual license. To remove the error message, do either of the following: <ul><li>Renew your subscription and [download a new license key]({%slug license-key%}#downloading-the-license-key)</li><li>Downgrade to a Telerik Report Server version covered by your perpetual license, as specified in the message.</li></ul>|
68+
|`Your trial license has expired.`|TKL105|Purchase a commercial license to continue using the product.|
69+
|`Your license is not valid for the detected product(s).`|TKL101|Review the purchase options for the listed products.|
70+
71+
Starting with the 2025 Q2 release of Telerik Report Server, all conditions above will be treated as errors.
72+
73+
# See Also
74+
75+
* [Setting Up Your License Key]({%slug license-key%}))
76+
* [Frequently Asked Questions about Your Telerik Report Server License Key]({%slug license-frequently-asked-questions%})
77+
* [License Agreement](https://www.telerik.com/purchase/license-agreement/report-server)
78+
* [Troubleshooting Report Server]({%slug troubleshoot-report-server%})
79+
* [Troubleshooting Report Server for .NET]({%slug troubleshoot-report-server-net%})

licensing/license-faq.md

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
title: FAQs
3+
page_title: "Frequently Asked Questions about Telerik Report Server Licensing."
4+
slug: license-frequently-asked-questions
5+
tags: license, telerik, report, server, faq, questions
6+
published: True
7+
position: 9
8+
---
9+
10+
# Frequently Asked Questions
11+
12+
This article lists the answers to the most frequently asked questions (FAQs) about working with the Telerik Report Server license key.
13+
14+
## Does the license key expire?
15+
16+
Yes, the license key expires at the end of your support subscription:
17+
18+
* For trial users, this is at the end of your 30-day trial.
19+
* For commercial license holders, this is when your subscription term expires.
20+
21+
You will need to obtain and install a new license key after starting a trial, renewing a license, or upgrading a license.
22+
23+
> An expired perpetual license key is valid for all Telerik Report Server versions installed before its expiration date.
24+
25+
## Will the product function with an expired license key?
26+
27+
This depends on your license type.
28+
29+
* __Perpetual licenses__ will continue to function normally with an expired license key.
30+
31+
The following will happen only if you update or install a Report Server version that is released after the expiration date of the license:
32+
33+
- A watermark appears on each report document page
34+
- A warning message similar to the one shown below is logged in the trace log after attaching a Trace Listener to the [Report Server Manager]({%slug search%}) and [Report Server Agent]({%slug service-agent%})
35+
36+
* __Subscription licenses__. The following will happen if you try to run the application:
37+
38+
- A watermark appears on each report document page.
39+
- A warning message similar to the one shown below is logged in the trace log after attaching a Trace Listener to the Report Server Manager and Report Server Agent:
40+
41+
* __Trial licenses__. The following will happen if you try to run the application:
42+
43+
- A watermark appears on each report document page.
44+
- A warning message similar to the following is logged in the trace log after attaching a Trace Listener to the Report Server Manager and Report Server Agent:
45+
46+
````
47+
Telerik and Kendo UI Licensing warning TKL002: No Telerik and Kendo UI License file found.
48+
Telerik and Kendo UI Licensing warning TKL002: The following locations were searched:
49+
Telerik and Kendo UI Licensing warning TKL002: * TELERIK_LICENSE (EnvironmentVariable)
50+
Telerik and Kendo UI Licensing warning TKL002: * KENDO_UI_LICENSE (EnvironmentVariable)
51+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Telerik.ReportServer.Web\telerik-license.txt (RecursiveFilePath)
52+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Telerik.ReportServer.Web\kendo-ui-license.txt (RecursiveFilePath)
53+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Services\telerik-license.txt (RecursiveFilePath)
54+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\Services\kendo-ui-license.txt (RecursiveFilePath)
55+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\telerik-license.txt (RecursiveFilePath)
56+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\Telerik Report Server\kendo-ui-license.txt (RecursiveFilePath)
57+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\telerik-license.txt (RecursiveFilePath)
58+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\Progress\kendo-ui-license.txt (RecursiveFilePath)
59+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\telerik-license.txt (RecursiveFilePath)
60+
Telerik and Kendo UI Licensing warning TKL002: * C:\Program Files (x86)\kendo-ui-license.txt (RecursiveFilePath)
61+
Telerik and Kendo UI Licensing warning TKL002: * C:\telerik-license.txt (RecursiveFilePath)
62+
Telerik and Kendo UI Licensing warning TKL002: * C:\kendo-ui-license.txt (RecursiveFilePath)
63+
Telerik and Kendo UI Licensing warning TKL002: * C:\Users\user1\AppData\Roaming\Telerik\telerik-license.txt (UserDirectory)
64+
Telerik and Kendo UI Licensing warning TKL002: * C:\Users\user1\AppData\Roaming\Telerik\kendo-ui-license.txt (UserDirectory)
65+
Telerik and Kendo UI Licensing warning TKL002: Activate a License Key file at https://prgress.co/3PBSVoC
66+
Telerik and Kendo UI Licensing warning TKL101: Telerik Reporting is not listed in your current license file.
67+
Telerik and Kendo UI Licensing warning TKL004: Unable to locate licenses for all products.
68+
````
69+
70+
See the [Invalid License]({%slug license-errors-and-warnings%}#invalid-license) section for more information.
71+
72+
Note that future updates of Telerik Report Server may restrict or disable some features when no valid license is present.
73+
74+
## I updated the Telerik Report Server and the invalid license errors have appeared. What is the cause of this behavior?
75+
76+
If this happens, the possible reason is that the end date of the license activated in your application is before the release date of the newly installed product. To fix this issue:
77+
78+
1. [Download a new license key]({%slug license-key%}#downloading-the-license-key).
79+
1. [Activate the new license key]({%slug license-key%}#activating-telerik-report-server) in your project.
80+
81+
## Do I need an Internet connection to activate the license?
82+
83+
No, the license activation and validation are performed entirely offline.
84+
85+
The license is not validated with our services at any point in the project lifecycle.
86+
87+
## What happens if both the environment variable and the license key file are present?
88+
89+
If both the `TELERIK_LICENSE` environment variable and the `telerik-license.txt` file are present, then the environment variable will be used.
90+
91+
To enforce the use of the license key file, unset the environment variable.
92+
93+
## Are earlier versions of Telerik Report Server affected?
94+
95+
No, versions released before __January 2025__ do not require a license key.
96+
97+
# See Also
98+
99+
* [License Activation Errors and Warnings]({%slug license-errors-and-warnings%})
100+
* [Setting Up Your License Key]({%slug license-key%}))
101+
* [License Agreement](https://www.telerik.com/purchase/license-agreement/report-server)
102+
* [Troubleshooting Report Server]({%slug troubleshoot-report-server%})
103+
* [Troubleshooting Report Server for .NET]({%slug troubleshoot-report-server-net%})
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: Setting Up Telerik Repor Server License Key
3+
page_title: "Learn how to set up the Telerik Report Server License Key."
4+
slug: license-key
5+
tags: license, key, telerik, report, server
6+
published: True
7+
position: 1
8+
---
9+
10+
# Setting Up Your Telerik Report Server License Key
11+
12+
Starting with the Q1 2025 release, the Telerik Report Server requires activation through a license key (trial or commercial). This article describes how to download or update your personal license key and use it to activate the Telerik Report Server product.
13+
14+
An invalid license results in [errors and warnings]({%slug license-errors-and-warnings%}) during build and run-time indicators such as watermarks and banners.
15+
16+
The implementation of the 2025 licensing requirements will occur in two phases:
17+
18+
- Phase 1 - Starting with the 2025 Q1 release, a missing or invalid license for the trial distributions causes [trial message watermark in the reports]({%slug license-errors-and-warnings%}). The commercial distributions of the product do not exhibit any functional restrictions.
19+
- Phase 2 - Starting with the 2025 Q2 release, there will be only one distribution of the product with different licenses. A missing or invalid license will result in [run-time indicators]({%slug license-errors-and-warnings%}), such as watermarks.
20+
21+
Note that future updates of the product may restrict or disable some features when no valid license is present. You can send us feedback through the _Contact Us_ form or by [opening a support ticket](https://www.telerik.com/account/support-center/contact-us?utm_source=licensing&utm_medium=console&utm_campaign=no_references).
22+
23+
## Downloading the License Key
24+
25+
To download a license key for the Telerik Report Server, you must have either a developer license or a trial license. If you are new, you can sign up for a [free trial](https://www.telerik.com/account/trials) first, and then follow the steps below.
26+
27+
1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
28+
1. Click the **Download License Key** button.
29+
30+
![Download License Key](images/download-license-key.png)
31+
32+
The [Progress Control Panel](https://www.telerik.com/download-trial-file/v2/control-panel), and the automated MSI installer of Telerik Report Server will automatically download and store your license key in your home directory. You may use this file to [activate the Report Server](#activating-telerik-report-server).
33+
34+
## Activating Telerik Report Server
35+
36+
To activate the Telerik Report Server:
37+
38+
* When deploying the Report Server on a cloud environment, you may create an Environment Variable named `TELERIK_LICENSE` and add your Telerik Report Server license key as a value.
39+
* On a local environment, copy the `telerik-license.txt` license key file to the installation folder of the Telerik Report Server, by default, `C:\Program Files (x86)\Progress\Telerik Report Server\` or any parent folder. This makes the license key available to both the [Report Server Manager]({%slug search%}) and [Report Server Agent]({%slug service-agent%}).
40+
41+
You may also copy the license key file to the following subfolders, making it available for the corresponding Reporting Engine:
42+
43+
* for __Report Server Manager__, the default folder is `C:\Program Files (x86)\Progress\Telerik Report Server\Telerik.ReportServer.Web\`
44+
* for __Report Server Agent__, the default folder is `C:\Program Files (x86)\Progress\Telerik Report Server\Services\`;
45+
46+
When you run Telerik Report Server, it automatically locates the license environment variable or license file and activates itself.
47+
48+
## Updating Your License Key
49+
50+
Whenever you purchase a new license or renew an existing one, always [download](#downloading-the-license-key) and install a new license key. The new license key includes information about all previous license purchases. This process is referred to as a license key update. Once you have the new license key, use it to [activate Telerik Report Server](#activating-telerik-report-server).
51+
52+
# See Also
53+
54+
* [License Activation Errors and Warnings]({%slug license-errors-and-warnings%})
55+
* [Frequently Asked Questions about Your Telerik Report Server License Key]({%slug license-frequently-asked-questions%})

0 commit comments

Comments
 (0)
0