Validating a synchronization job

BlueCielo Meridian Enterprise Server 2017 Administrator's Guide

You are here:

Validating a synchronization job

Under typical working conditions , if the Allow automatic deletion option is enabled in the synchronization job as described in Configuring synchronization options, the job will correctly detect and delete documents and tags from the repository that no longer exist in the source vault.

However, there are some situations when this cannot be reliably detected by the synchronization job, such as when the document or tag:

Was never released
Was purged
Is not deleted in the vault but does fall outside the collection specified for synchronization

These situations can leave documents or tags in the repository that you might not want to remain. To clean up these deleted documents and tags, you should occasionally validate the synchronization job.

To validate a synchronization job:

In Meridian Enterprise Server Administration Console, in the BC Publisher group, click Jobs. The Publish Jobs page appears and lists the existing jobs.
On the ALL or EXPLORER SYNCHRONIZATION page, double-click the name of the job that you want to validate. The job's configuration option pages appear.
In the app bar, click VALIDATE SYNCHRONIZATION. The CHECK dialog box appears.
Click options or type values using the descriptions in the following table.
Click OK to start the check. A background task is started and you can continue working. When the validation has completed, the VALIDATION REPORT dialog box appears and shows the information described in the following table.
When you are finished viewing the report, click CLOSE.

Synchronization validation options
Option	Description
Check for obsolete items	Select one of the options to validate tags: Check for items that should be removed from Explorer – Counts the items but does not mark them for deletion. Ensure obsolete items will be removed from Explorer – Counts the items and marks them for deletion when the synchronization job is run the next time (if the Allow automatic deletion option is enabled for the job). Do not check – Skips this check. Note When multiple synchronization jobs exist with the same source vault and any of them has the Only publish documents from the specified collection option set, any subsequent synchronization validation job will not mark any documents to be deleted. No documents will be marked to be deleted if the synchronization job does not have the Allow automatic deletion option enabled.
Check for updated documents	Select one of the options to validate documents: Check for items that should be updated in Meridian Explorer – Counts the documents but does not update them. Check and ensure that items will be updated in Meridian Explorer – Counts the documents and does update them. Do not check – Skips this check.

Validation report items
Item	Description
Status	The completion status of the validation.
Report	The quantities of objects found by the selected checks.
Out of scope documents	The number of documents in the source vault that are not in the collection specified for the synchronization job.
Out of scope object tags	The number of tags in the source vault that are not in the collection specified for the synchronization job.
Missing items	The sum of the documents and tags in the source vault that are not in the collection specified for the synchronization job.

To schedule synchronization job validations:

In Meridian Enterprise Server Administration Console, in the Repositories group, click Repositories. The Repositories page appears and lists the existing Meridian Explorer repositories and Meridian Enterprise vaults.
Double-click the name of the repository that you want to configure. The Overview page for the repository appears.
In the menu, click MANAGEMENT TOOLS. The management tools for the selected repository appear.
In the VALIDATE SYNCHRONIZATION group, for the Run or schedule this task item, click SCHEDULE. The SCHEDULE dialog box appears. This dialog box requires the same input as the Windows Task Scheduler.
Configure the scheduled task to run when you require and then click SCHEDULE.The task is modified and will run on the configured schedule.

Note

Scheduled validations will validate the synchronization jobs for all Meridian Enterprise source vaults of the current repository.
By default, items will be updated or marked for deletion as necessary in the next synchronization job. This is the same as if both of the checking options described in the preceding task were set.
Because this task can be quite time-consuming, we recommend that you schedule it to run only once per week outside of production hours.

Related concepts

Understanding repository synchronization jobs

Related tasks

Configuring synchronization options

The ExplorerSynchronization property set