Versions Compared

Key

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

...

On This Page

Table of Contents

Overview

Control the level of tracking and reporting for content that exists on both the source and destination platform, including content that has been configured to be excluded from transfer and content that existed on the destination prior to the initial transfer. This feature categorizes items for reports on the job Validation tab or within the job transfer block with "item_inspection_policy." Items that have been ignored / skipped by policy or not shown because they already existed on the destination can now be seen on reports with the defined categories.

All job types and transfer directions support validation:

  • Basic transfer, Folder mapping, User job mapping, Network home drive mapping

  • Simulation Mode (Analyzer)

  • Transfer in one direction with copy and both directions with sync

  • Jobs using Impersonation (Run as user)

Info

Only the Content Reconciliation is available on the Validation report for roll-up reports.

Default Configuration: "item_inspection_policy": "none"

The default validation option is inspect none. This option does not need to be configured in the application user-interface or through the ReST API; it is the system default. This configuration will not track all items but will offer additional tracking with performance in mind. Inspect none will track all items on the source at all levels of the hierarchy but not including those configured to be ignored / skipped through policy. For the destination, all content in the root (files & folders) that existed prior to the initial transfer will be tracked as destination only items and reported as ignored/skipped.

This option has the following features:

...

This option does not need to be configured in the application user interface or through the REST API; it is the system default. Jobs created in previous releases will now assume this settings after upgrade. A soft reset will be required to align the validation chart calculations using the inspect none configuration.

...

The Validation report allows you to run a content inspection and to view the content reconciliation that has occurred between the source and destination.

Info

If the connection does not have access to a given folder in the hierarchy,

...

DryvIQ cannot track and report these items.

...

Destination: All content in the root (files & folders) that existed prior to the initial transfer will be tracked as destination only items and reported as ignored/skipped.

...

Content Inspection

DryvIQ allows you to control the level of tracking and reporting for content that exists on both the source and destination platform through the Item Inspection Policy. This includes content that has been configured to be excluded from transfer and content that existed on the destination prior to the initial transfer

...

If the connection does not have access to a given folder in the hierarchy, we cannot track and report these items.

...

Job type Sync: The destination will behave like the source.

...

. The inspection policy is set when creating the job as part of the job behaviors configuration.

At any time, you

...

can run a

...

job to perform validation on filtered and/or shared items. This will trigger a full inspection of

...

the selected content for the next run only.

...

Validation Default | JSON Configuration

...

Code Block
"transfer": {
"item_inspection_policy": "none",
"item_inspection_policy_next": "none"
 }

Track Everything | "item_inspection_policy": "all"

The validation option to inspect all will track all content at all levels in the hierarchy on both the source and destination; including items configured to be ignored/skipped through policy and items that existed on the destination prior to the initial transfer.

This option has the following features:

  • This option can be configured via the REST API or in the application user interface through the Advanced Scripting JSON block.

  • Source: All content in the root, folder, and subfolder directories including those configured to be skipped/ignored through policy and items that existed on the destination prior to the initial transfer will be tracked.

  • Destination: All content in the root, folder, and subfolder directories including those configured to be skipped/ignored through policy and items that existed on the destination prior to the initial transfer will be tracked.

  • If the connection does not have access to a given folder in the hierarchy, we cannot track and report these items.

...

Validation Track Everything | JSON Configuration

...

If filtered and shared items are already being inspected for the job, these options will be disabled.

...

Content Reconciliation

The content reconciliation provides a comparison of the reconciled items between the source and destination. It can help track the success of the migration. By default, it shows the counts for files and folders, but you can choose to view just folders, just folders, or data. It reports on the following information:

  • Identified: This is the totals count of items or data identified on the source and destination (including flagged/retried items).

  • Ignored destination only items: This is the count of the items ignored on the destination and the percentage of the overall content theses items make up.

  • Ignored [Filter]: If filters were added to the job to exclude content, any entry for each filter is included in this section. It will identify the count of the filtered items and the percentage of the overall content theses items make up.

  • Successfully matched or transferred (Including flagged and revised): This is the count of items or data that have been successfully matched or transferred between the course and destination.

REST API | Transfer Stats, By Inspection

Code Block
GET {{url}}v1/transfers/{{job_id}}/stats/by_inspection

...

The items reported in this section vary based on what policies and filters have been set for the job and based on what happened during the job run.

...

Ignored Categories

Reason

Description

Content extension

Ignored due to third-party extension

Date

Ignored due to date range filter

Destination only items

Ignored on the destination

Empty container policy

Ignored due to empty container policy

File extension

Ignored due to file extension filter

Hidden

Ignored due to hidden file/folder filter

Item type

Ignored due to file type filter

Large item policy

Ignored due to large item policy i.e. file too large to be transferred to destination platform

Match fail

Ignored due to error in calculating a destination path

Metadata

Ignored due to metadata filter

One way transfer

For one way transfer - destination only items which were not transferred to source

Overwrite policy

Ignored due to overwrite policy

Path

Ignored due to path filter

Pattern

Ignored due to item name pattern filter

Predefined

Ignored due to predefined content categories filter

Restricted content policy

Ignored due to restricted content policy

Shared

Ignored due to shared item filter

Size

Ignored due to file size filter

Unknown filter reason

Unknown reason, includes items ignored by previous DryvIQ versions on upgraded installations

Info

These categories are also available as filters in the Jobs grid. Select to filter by status “Ignored,” and select the subcategory to use.