software:squirrel:restore_process []

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== 🔄 File Restore and Rehydration (Stub-Based Restore) =====

In the [[https://www.smikar.com/squirrel/|Squirrel]] system, **file restore (rehydration)** is the process of seamlessly returning an archived file from Azure Blob Storage back into SharePoint when a user interacts with a stub file.

This page explains how the restore process works when an end user clicks the **Restore** option from a Squirrel stub file, and what happens behind the scenes.

----

==== 👤 End User Restore Experience ====

From the end user’s perspective, restoring a file is simple and intuitive:

  * The user locates the stub file in SharePoint, OneDrive, or Microsoft Teams.
  * The user opens the stub file and clicks the **Restore** button.
  * A Squirrel restore page opens, showing a **real-time progress indicator**.
  * Once complete, the user is presented with options to:
    * Open the file directly, or
    * Open the file location in SharePoint.

The restored file then behaves exactly like any normal SharePoint file.

> ✅ No administrator involvement is required.  
> ✅ No special client software is required.  
> ✅ The experience is browser-based and fully integrated into SharePoint.

----

==== ⚙️ What Happens During Restore ====

When a user triggers a restore from a stub file, Squirrel performs the following operations:

  - The restore request is securely sent to the Squirrel rehydration service.
  - Squirrel validates the file, tenant, and restore request.
  - The archived file is located in the customer’s Azure Blob Storage.
  - The file is **decrypted and decompressed**.
  - The file is **streamed back into SharePoint**.
  - The stub file is replaced with the original file.
  - The restore is finalized and the user is notified.

Throughout this process, the user can monitor progress in real time from the restore page.

----

==== 🗂️ Versions and Metadata Preservation ====

Squirrel restore is designed to perform a **full-fidelity rehydration**, returning archived content back into SharePoint as close as possible to its original state.

During restore, Squirrel attempts to:

  * Restore all available file versions.
  * Preserve original timestamps.
  * Preserve SharePoint metadata.
  * Return the file to its original SharePoint location.

The objective of the restore process is to return the file so that, once completed, it behaves in SharePoint like a standard non-archived file, with version history and properties intact where supported by the platform and source data.

Because restore operations depend on the state of the source environment and Microsoft 365 platform behaviours, exact reconstruction of all attributes may vary in exceptional cases.
----

==== 🔁 End-to-End Restore Lifecycle ====

  - User clicks **Restore** from the stub file.
  - Squirrel validates and initiates the restore job.
  - Archived content is securely retrieved from Azure Blob Storage.
  - Data is decrypted and decompressed.
  - File content and available versions are restored to SharePoint.
  - The stub is removed and replaced with the original file.
  - The user is offered options to open the file or its location.

----

==== 🎯 What Administrators Should Know ====

For customer administrators, the stub-based restore process means:

  * No service desk involvement for routine file recovery.
  * No manual handling of blobs, containers, or exports.
  * Files are restored back into their **original SharePoint location**.
  * File history, structure, and metadata remain intact.
  * End users remain in control of day-to-day retrieval.

This enables large-scale archiving without introducing operational overhead or disrupting business users.

----

==== 🌐 Visual Walkthrough ====

A full visual walkthrough of the end-user restore experience is available here:

👉 [[https://www.smikar.com/squirrel-data-rehydration/|Squirrel File Rehydration Walkthrough]]

----

If you need assistance with stub configuration, restore branding, or validating restore behaviour in your environment, contact support@smikar.com.