.png){kind=logo}
Settings: License Management
Manage the license for the Software Appliance in the in the License Management section in Webconf.
To use the EJBCA application within the appliance the corresponding license provided by Keyfactor must be uploaded.
A valid license can be found in the download folder.
To obtain or renew an expired license contact support@keyfactor.com.
Important!
EJBCA can only be started if a valid license has been uploaded.
If an update has been performed without a valid license:
no data or key material will be lost
only the service will be discontinued
you will receive the error message No valid license found
The table below summarizes the resulting system behavior in a deployed system based on the status of the EJBCA license file.
Important!
EJBCA and EJBCA LRA will not start if no license is available.
EJBCA and EJBCA LRA will also not start if the uploaded license has expired.
60 days before a license expires, a warning will be displayed in Webconf that EJBCA or EJBCA LRA will be shut down shortly.
EJBCA and EJBCA LRA remain functional for up to 90 days after the license expires (grace period). A warning (in red) is displayed to remind the user that shutdown is imminent.
EJBCA License File Status | System Behavior |
|---|---|
Valid License File | Normal operation |
Invalid or Missing License File
| EJBCA shuts down |
Expiring License
| Message in logs and Admin UI |
Expired License
| Message in logs and Admin UI |
Expired License
| EJBCA shuts down |
Log in to your Software Appliance and open the Settings page.
In the section License Management click Upload License to open the file browser.
Select the license and upload it.
After uploading the license, it takes about 7 seconds for the success message to appear in the Webconf.
The Uploaded New License with all important information is displayed on an overlay window
Click Use New License to continue.
The uploaded license now appears in the License Management section.
Under Installed License all information about the license is displayed.
The installed license is displayed with the most important information:
Installed License |
|---|
Product Name |
Product Version |
License ID |
Customer Name |
Issued Date |
Expiration Date |
Below the list with information about the license another table displays:
the Feature and its Status / In Use,or if applicable, the Issue.
To determine the time of the last automatic license check, move the mouse pointer over the Status / In Use area and a tool tip will show how long ago the last check took place.To add more licenses, click Upload New License.
In the Feature section, the number of active EJBCA Active Certificates is compared with the maximum number of certificates permitted for your purchased license.
The Status/Issue column first displays the number of active certificates and then the number of valid certificates.
In the Feature section, the number of active EJBCA Active Certificates is compared with the maximum number of certificates permitted for your purchased license.
The Status/Issue column first displays the number of active certificates and then the number of valid certificates.
A warning will be displayed if the license is invalid or if more certificates have been uploaded than the license allows.
A 12-hour control interval checks the validity of the uploaded licenses.
If a license loses its validity due to reaching the maximum number of permitted certificates or due to expiry, a warning appears in the License Management section.
To upload of an expired license or the same license twice is prevented by the system in advance.
Furthermore, a banner with the warning: LICENSE NO LONGER VALID appears at the top and bottom of all pages in Webconf.
The current status of the license is also displayed on the Overview page below the application info box.
The number of permissible certificates is too high here.
To determine the time of the last automatic license check, move the mouse pointer over the Status / In Use area.
A tool tip will display the date/time on which the last check was performed.
Contact support@keyfactor.com to renew the invalid license.
Only one license can be active at a time.
If another license is uploaded, the Uploaded New License is compared to the Currently Installed License.The decision is confirmed with Use New License or Cancel and the process is completed.
