11. Managing DynFi Manager licenses

DynFi® Manager (on premise) will run with all features without any paid license if it manages up to three devices.

11.1. Buying a DynFi Manager license

To manage more than three devices, a paid license is needed. It can be bought at shop.dynfi.com. Visit the page for the current offers, prices and subscriptions.

Proceed with checkout and Stripe payment. This creates an account for you on shop.dynfi.com.

After a successful payment, go to My Account > Subscriptions and click on the corresponding subscription (e.g. S01234).

_images/DynFi_Shop_Account_licenses.png

DynFi Manager license on shop.dynfi.com

You now need to enter the Instance ID of your DynFi Manager instance by clicking on the Instance UUID, as shown in the image below.

_images/DynFi_Shop_License_UUID_input.png

Instance ID registration on shop.dynfi.com

Your Instance ID can be easily found on your DynFi Manager instance: log in to your DynFi Manager and at the bottom of every page, you will find a little (i) (circled in red in the image below). Click it. A pop-up window will open and you should be able to copy your Instance ID, which looks similar to this: 9d151c55-2ceb-445b-9b29-fd8ee8fe574d

_images/DynFi_Manager_UUID.jpg

Accessing your DynFi Manager Instance ID

Once the Instance ID has been pasted into the field, click Register Instance. This will link your current DynFi Manager instance to the license you just bought and generate the license. The license is displayed inline and looks like this:

_images/DynFi_Shop_license_display.png

An example of a DynFi Manager license displayed inline on shop.dynfi.com

11.2. Importing a license

After a license has been purchased on shop.dynfi.com, it has to be imported into DynFi Manager (on premise or SaaS) to increase the device limit. It can be done in System settings, in the License information tab, by clicking the Import license button.

_images/licenses.png

License information list in DynFi Manager’s System settings

A small license import window pops up. It shows the Instance ID, which is different for each DynFi Manager installation.

_images/license_import.png

License import pop-up window

Using this window, a new license key or a renewal can be imported.

For online licenses, DynFi Manager will send its Instance ID to shop.dynfi.com automatically, so all you need to do is paste the License ID obtained at shop.dynfi.com and click the Submit button.

For offline licenses, you have to paste the Instance ID at shop.dynfi.com before generating the license key for further offline usage. Then the whole license key (not only the License ID) has to be pasted into the import window before clicking the Submit button.

Note

Make sure that you copy the license info including everything from -----BEGIN PGP MESSAGE----- to -----END PGP MESSAGE-----.

In the License information tab, the license key currently used by DynFi Manager is listed first and marked with the In use label. If several valid license keys are imported, DynFi Manager uses the one allowing the highest number of devices. The other license keys are listed below it, newest first.

The Check online for license updates button immediately checks shop.dynfi.com for renewals of the imported licenses. The list and the number of available devices are refreshed after every import and after a check triggered by this button.

11.3. License renewals

How the renewed license key gets into DynFi Manager depends on its configuration:

  • If automatic download of license renewals has not been disabled, DynFi Manager will try to download the renewal.

  • If automatic download of license renewals has been disabled, the renewed license key has to be imported manually.

Automatic download of license renewals can be configured in System settings, tab General, using the Automatically download license renewals option, as shown below.

_images/general.png

General System settings in DynFi Manager

If the license subscription is not cancelled, a license will automatically be renewed at shop.dynfi.com. The renewed license key keeps the same License ID and is generated when the renewal invoice is issued. This usually happens shortly after the expiration date of the previous license key:

  • for payments by saved card or by bank transfer, the renewed license key is available about 15 to 30 minutes after the expiration,

  • for payments that take time to confirm (e.g. SEPA), the renewed license key is available once the payment is confirmed, which can take a few days,

  • for payments made in the customer portal without a saved card, the renewed license key is available once the invoice is paid. If it is paid in advance, the renewed license key can be available before the expiration.

Note

Changing the plan or ordering the renewal manually at shop.dynfi.com creates a license with a new License ID. Such a license has to be imported manually (see Importing a license), as automatic download only fetches renewals of license keys already imported into DynFi Manager.

DynFi Manager starts checking for the renewed license key some time before the expiration: 4 days for monthly plans, 2 weeks for quarterly plans and 3 weeks for yearly plans.

Because the renewed license key is usually not available before the expiration date, DynFi Manager keeps working for 3 days after the expiration (see License expiration).

In order to fetch renewed license keys, the DynFi Manager instance needs to be able to connect to https://license.dynfi.com (IP: 212.52.24.70). Please make sure that this connection is allowed in your firewall. The rule might look like this:

Allow FROM IP_of_your_DynFi_Manager_server any port TO license.dynfi.com ON TCP port 443

Note

If automatic download of license renewals is disabled or cannot be performed (e.g. due to network traffic to license.dynfi.com being blocked), make sure that the renewed license key is imported manually before the grace period (see License expiration) ends.

11.4. Expiration warnings

If the renewed license key has not been imported yet, DynFi Manager warns about the upcoming expiration in the event log (see DFM Logs) 7 days, 3 days and 1 day before the license expires. Each warning is logged only once. For monthly plans, only the warnings 3 days and 1 day before expiration are logged. If e-mail notifications are enabled, these warnings are also sent by e-mail.

The System status widget on the dashboard shows the expiration date of the license in use. From the time DynFi Manager starts checking for the renewal (4 days, 2 weeks or 3 weeks before expiration, as described above), the date is highlighted in yellow and a notice appears above the license list in the License information tab. Once a renewed license key is imported, the highlight and the notice disappear.

11.5. License expiration

If your DynFi Manager instance manages more than three devices, at any time (apart from the 3-day grace period described below) it must have at least one license key imported that covers the number of devices being managed (the license can be issued for more devices). License keys can overlap in time.

If the license key expires and there are more than three devices managed by the DynFi Manager instance, DynFi Manager will shut down after a grace period of 3 days.

During the grace period DynFi Manager keeps working as if the license key were still valid, with all features and the same number of devices, and keeps checking for the renewed license key. The renewed license key can also be imported manually. The System status widget on the dashboard and the License information tab show, highlighted in red, when the license expired and when DynFi Manager will shut down.

During the last 6 hours before the shutdown, DynFi Manager logs an error in the event log on every license check (every 30 to 90 minutes). The error says when DynFi Manager will shut down and how to get the renewed license key: either by enabling the Automatically download license renewals option or by importing it manually. If e-mail notifications are enabled, these errors are also sent by e-mail.

11.6. Importing a license via the CLI

If DynFi Manager has already shut down and the renewed license key cannot be downloaded automatically (download disabled or license.dynfi.com unreachable), import the key using the CLI (command line interface or “terminal”). First, the license key (the whole key, not only the License ID) has to be downloaded and saved to a file, e.g. license.key.

Next, the license key can be imported from the file like this:

java -jar /path/to/dynfi.jar --import-license /path/to/license.key

In case you are running DynFi Manager on Debian/Ubuntu using dynfi.com’s DEB archive or repository (as described in Installing DFM on Ubuntu), you can use the following command. Please note that the path to the JAR file has to be specified precisely, and the version tag will be different in your setup:

sudo -u dynfi java -jar /usr/share/dynfi/lib/dynfi-version.goes.here.jar --import-license /path/to/license.key

Note

If the manual import procedure in the CLI does not work and the log file says License not matching this DynFi Manager, the license key was most likely generated for another DynFi Manager instance, or with an incorrect Instance ID.