# Lineage Maintenance

The CopyStorm/Medic Lineage Maintenance Tool is used to view lineage data & invalidate problematic lineage records.

Over time, a Record’s lineage may be invalidated:

* One of the legacy lineage entries may no longer exist in the CopyStorm Database or Snapshot.
* Records may have multiple children, causing split lineage.

For more details on Record Lineage, [refer to this article](https://learn.capstorm.com/copystorm-restore/readme/frequently-asked-questions/how-does-record-lineage-work).

## Using the Tool

* Select “Other Tools” from the top-level menu.
* Select “Data Synchronization” and then “Lineage Maintenance”

![](/files/1vt3JJi5vu1Px5HNznQH)

* Optionally Configure Modified After & Modified Before
  * This will control what date ranges are queried for lineage.
  * Leaving these values Blank will query all time lineage.
* Optionally Enable Validators
  * Purged Record Validation
    * Identifies lineage entries that do not have a corresponding physical record in the CopyStorm Database or Snapshot.
  * Branching Lineage Validation
    * Identifies lineage entries that have multiple children.
* Optionally toggle “Only Show Invalid Lineages” checkbox
  * This should be used when investigating invalid lineages.
* Click “Start Scan”

![](/files/ATscrmPCmmzUZOQ6qCIt)

After clicking “Start Scan”, the application will render a view of:

* All Lineage within the provided Modified After / Modified Before values.
* The Status of each Lineage.
  * Valid
    * If there are no branches and all lineage entries exist in the CopyStorm Database or Snapshot
  * Invalid
    * If branch(es) are detected or any entry is missing from the CopyStorm Database or Snapshot
* The associated Salesforce Table for the Lineage.
* The Salesforce ID of the Lineage HEAD
  * HEAD is the most recent entry in the Lineage.

Use the “Invalidate Selected Lineage” to mark problematic Lineage Entries as Invalid in the database.

**Note: Invalidating Lineage will prevent CopyStorm/Restore from considering invalid entries as recovery candidates.**

![](/files/BkJzyVQGttnogtEoOI8r)

**An example of viewing a full lineage is shown below:**

![](/files/82pPshff7jILcwYf2Zsu)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.capstorm.com/reference/copystorm-medic/lineage-maintenance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.