Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Licensing page allows you to review your license details, refresh your existing license, or add a new license through the DryvIQ Platform.

Info

DryvIQ uses standard base-2 conversion for transfer values. Any content that has been evaluated by DryvIQ counts towards the licensed byte Limit (data under management), even if it was not transferred to the destination. Simulation Jobs do not count towards the licensed byte limit until they are converted to jobs.

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

Job runs affect the “Volume used” This page provides information to help you understand how your license usage is calculated and how job runs affect the usage.

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.

If the link is disabled (known issue), click Add new key and enter the renewed license. Click Activate, and the application will be updated with the renewed license and ready for use.

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.

...

Info

DryvIQ Migrate and Govern share a license page. The Govern/Discover Data Under Management section only populates for Govern installations and can be ignored for Migrate installations.

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.

Code Block
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.

Code Block
GET v1/transfers/audits.csv
Code Block
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.

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

Info

 The audit log is purged every 90 days by default.