General Information

In order to run the DeepHub, a subscription is required with associated license keys (for trial, development, and production). 


The DeepHub licensing mechanism is configured through a property of your DeepHub instance:


license_key: <key given to you by partner manager>


Aside from adding this key to your DeepHub configuration, nothing else needs to be done. This key only needs to be added once.


License Server, Lease, and Grace Period

When starting a DeepHub instance, an internet connection is required so that the DeepHub can access the Flowcate License Server via SSL/HTTPS on port 443. Generally, nothing needs to be done to allow this because:

  • The DeepHub initiates the connection (not the License Server), so it is a connection from the inside to the outside of your network.

  • Port 443 is the standard port for HTTPS and is usually configured to be open within firewall settings.


After accessing the License Server, a license lease is provided that includes the grace period. This grace period ensures that the DeepHub can continue to operate uninterrupted, even if the DeepHub instance loses internet connection or restarts unexpectedly and is unable to reach the License Server. If this occurs, the log would look like the following:

I20220307 15:34:25.859074 195937792 HubController.cpp:676] - Starting server
I20220307 15:34:35.861795 38715392 ConsumptionReportScheduler.cpp:160] - Requesting a lease from the license server
W20220307 15:34:35.962210 38715392 ConsumptionReportScheduler.cpp:256] - Failed to contact the license server
W20220307 15:34:35.962282 40861696 LicenseManager.cpp:152] - This instance was unable to reach the Flowcate license server. Please ensure that you have a proper internet connection. Remaining days until shutdown: 7.

However, if the DeepHub is unable to reach the License Server within the grace period, it will automatically deactivate. If this occurs, the log would look like the following:


I20220307 15:30:44.351586 195937792 HubController.cpp:676] - Starting server
I20220307 15:30:54.363415 264830976 ConsumptionReportScheduler.cpp:160] - Requesting a lease from the license server
I20220307 15:30:54.471340 264830976 ConsumptionReportScheduler.cpp:275] - Successfully contacted the license server
W20220307 15:30:54.572182 264830976 ConsumptionReportScheduler.cpp:256] - Failed to contact the license server
W20220307 15:30:54.572245 266977280 LicenseManager.cpp:152] - This instance was unable to reach the Flowcate license server. Please ensure that you have a proper internet connection. Remaining days until shutdown: 0.
W20220307 15:30:54.572412 266977280 LicenseManager.cpp:322] - The grace period has expired.
E20220307 15:30:54.572422 266977280 LicenseManager.cpp:410] - Disabling the DeepHub because no valid lease is available

In the event that the DeepHub has never successfully contacted the License Server, the log would look like the following:


I20220307 15:42:41.346244     8 HubController.cpp:676] - Starting server
I20220307 15:42:51.345257    14 ConsumptionReportScheduler.cpp:160] - Requesting a lease from the license server
W20220307 15:42:51.352674    14 ConsumptionReportScheduler.cpp:256] - Failed to contact the license server
E20220307 15:42:51.352777    18 LicenseManager.cpp:88] - Could not retrieve a valid lease from the license server.
E20220307 15:42:51.352787    18 LicenseManager.cpp:410] - Disabling the DeepHub because no valid lease is available

Reach out to DeepHub® Support or your Partner Manager for more information.