...

The Licensing page allows you to review your license details, refresh your existing license, or add a new license through the DryvIQ Platform. This page provides information to help you understand how your license usage is calculated and how job runs affect the usage.

Image Removed

Understanding License Usage

The Licensing page displays the data under management, byte limit remaining and used, and the percent of the byte limit used. The “Volume used” is the analyzed bytes being counted towards the data under management and not the amount of content transferred. Again, DryvIQ does not calculate the limit based on the amount of content transferred; it calculates the limit based on the amount of content analyzed.

...

Volume Used Calculations

...

Usage Overview

This section displays what’s currently available for your license. In addition to identifying the number of activations, this section helps you track how much of your license byte limit has been used. Jobs will run provided the byte limit has not been reached. If a job is running and the byte limit is reached during that job run, the job will finish the current run. If a job attempts to start once the byte limit has been reached, the job will fail with a license warning.

...

License Details

This section identifies information about the version of DryvIQ you are running as well as the expiration date for your license.

License Key Termination Date

Once a license expires, the application functions will no longer be available. If attempting to use a license that has reached its activation limit, the license will not activate, and a warning message will display that the license cannot be used. If the expired license is renewed, you must refresh the key on the DryvIQ Licensing page in Settings:

1. Click Settings and select Licensing.

2. Click on the Refresh link.

Data Migrated

This section relates to the licensing for your migrations. It identifies the total byte limit for the license, how much of the limit has been used, and how much remains.

...

The Volume used value is calculated based on the amount of data that has been migrated. Job runs affect the calculations as follows:

• First Run (New Jobs), Duplicated Jobs, Recreated Jobs: For the initial job run, the “Volume used” increments by the size of the all items tracked in the following three statuses: Succeeded, Revised in Transfer, and Ignored.

  • If a folder is set to be ignored, none of the folder contents will be tracked or included in the “Volume used.”

  migrated.

• Delta Job Runs and Job Resets: For subsequent job runs, the “Volume used” increments by the size of the new items tracked in the same three statuses as above or any changes to items from the succeeded or Revised in Transfer status.

  “Volume used” increments by

  migrated as part of the job run. For edited items, the increment will be the full size of the changed item(s) and NOT the difference in size due to the

  change

  changes.

• Deleted Jobs: If a job is deleted, the “Volume used” remains unchanged and does not decrement.

• Simulation Jobs: Simulation jobs do not count towards the “Volume used” until simulation is disabled and the job is run as a standard job (in normal mode).

• Versions: When a job runs with versioning enabled, the “Volume used” increases for each version of a file managed by that job. This is important to understand since the job overview page only displays the item as a single item and doesn’t reflect its versions. If the job is set to only preserve the latest version, only the current version counts towards the “Volume used” since DryvIQ only evaluates moves the current version of the file. If changes are made to the file, the latest version will be analyzed and tracked migrated due to the change and count towards the “Volume used.”

• Permissions: If permissions change on a file but the file itself is not updated, DryvIQ doesn’t transfer the file; therefore, the file isn’t included in the “Volume used.”

Exceeded Byte Limits

Jobs will run provided the byte limit has not been reached.

• If a job is running and the byte limit is reached during that job run, the job will finish the current run.

• If a job attempts to start once the byte limit has been reached, the job will fail with a license warning.

License Expiration

Once a license expires, the application functions will no longer be available.

If attempting to use a license that has reached its activation limit, the license will not activate, and a warning message will display that the license cannot be used.

If the expired license is renewed, you must refresh the key on the DryvIQ Licensing page in Settings:

1. Click Settings and select Licensing.

2. Click on the Refresh link.

...

Enabled Options

This sections allows you to view the options that have been enabled for your license. This section is for reference only.

Enabled Platforms

This section allows you to view which platforms are enabled for your license. This determines which connections you can create.

...

Licensing through the REST API

GET License Usage

Use the following GET to get your license details.

GET {{url}}v1/licensing?usage=true

GET Job Details/Audit Log

An audit log can be downloaded using one of the following calls. This provides insights into activity that affects your license usage.

GET v1/transfers/audits.csv

GET {{url}}v1/transfers/{job}/audits.csv

Audit Log for a Specific Job

Use the "job", "jobs", "job_id", or "job_ids" parameter to filter the output by job or specific jobs, or use the v1/transfers/{job}/audits.csv endpoint.

Use the "transferred" or "transferred_on" parameter to filter output by a date range.

GET {{url}}v1/transfers/audits.csv?job=12345678&transferred=1/1/2023-1/4/2023