Differences

This shows you the differences between two versions of the page.

--- software:squirrel:orphaned_files [2025/02/17 10:30] – support@smikar.com
+++ software:squirrel:orphaned_files [2025/09/23 11:35] (current) – support@smikar.com
@@ Line 1: / Line 1: @@
-**Orphaned Files**
+===== 🔍 Squirrel Orphaned Files =====
-In the [[https://www.smikar.com/squirrel/|Squirrel]] system, Orphaned Files refer to files that are no longer linked to their original SharePoint sites or have become disconnected from their source due to various reasons, such as site migrations, deletions of the Squirrel Stub File, or reorganization. These files still exist within the Squirrel system but cannot be accessed or managed in the usual way because they are no longer associated with the original location.
+In the [[https://www.smikar.com/squirrel/|Squirrel]] system, **Orphaned Files** refer to archived files that are no longer linked to their original SharePoint site or stub file. These disconnections typically occur due to site deletions, stub removals, or major structural changes within SharePoint.
-**Why Files Become Orphaned:**
+Although orphaned files are still safely stored in Azure Blob Storage and tracked by Squirrel, they are no longer associated with their original location — which prevents standard restore workflows from functioning.
-**Site Deletion:** When a SharePoint site is deleted, all associated files may become orphaned if they are not archived or moved to another site.
+----
-**Site Reorganization:** If a site is reorganized and files are moved or restructured, some files might not get properly re-linked, resulting in them becoming orphaned.
+==== ❓ Why Files Become Orphaned ====
+- **🗑️ Site Deletion**
+  If a SharePoint site is deleted without restoring its archived files first, those files become orphaned.
-| Select Orphaned Files from the Squirrel Menu | {{:software:squirrel:orphaned_files_menu.png?200 |}}|
+- **🔁 Site Reorganization**
-| From there the main window will now show you all of your documents that have been archived from your SharePoint Sites by Squirrel, but the original file location has been deleted. | updated with pic|
+  During structural changes or site migrations, some file associations may break if not properly re-linked.
-**Restoring Orphaned Files**
+- **🧺 Stub File Deleted or Moved**
+  When a user deletes a stub file, the link between the archive record and SharePoint is lost.
-A site for orphaned files will be created for any file restorations of archives that have lost their links to the stub file. The Squirrel Administrator can rehydrate a file to the Orphaned Files SharePoint Site, and provide the user with access to their original file.
+----
-**Orphaned Files Table**
+| 📂 Select **Orphaned Files** from the Squirrel Dashboard menu. | {{:software:squirrel:squirrel_orphaned_files_sidepanel_light.png?200}} |
+| 🧾 You’ll be shown a list of all files that are no longer linked to their original SharePoint location. | {{:software:squirrel:squirrel_orphaned_light.png?400}} |
-The table in the Orphaned Files section provides several key pieces of information for each file:
+----
-  * **Filename:** The name of the orphaned file.
+==== 📋 Orphaned Files Table ====
-  * **Date Archived:** When the file was archived in the system.
-  * **Filepath:** The original location of the file within SharePoint.
+Each row in the **Orphaned Files Table** includes:
-  * **File Size:** The size of the orphaned file in MB.
-  * **Action:** Provides options for managing the orphaned file, such as restoring or deleting it.
+  * **📄 Filename** – The name of the orphaned file
+  * **📅 Date Archived** – When the file was originally archived
+  * **📅 Date Orphaned** – When the file was orphaned (i.e. Stub was deleted)
+  * **📁 Original Filepath** – The SharePoint path the file was originally archived from
+  * **📏 File Size** – Size of the file (in MB)
+  * **🛠️ Actions** – Options to **Restore** or **Delete** the orphaned file or **Delete Older than** to delete files that were orphaned after a certain date.
+----
+==== 🔄 Restoring Orphaned Files ====
+When restoring orphaned files:
+. Squirrel will automatically rehydrate the file to the Site and location it was originally archived, however, if that location no longer exists, it will restore to the designated **Orphaned Files SharePoint Site**, defined in your system settings under `Orphaned_restore_path`.
+. Admins can then share the restored file with the appropriate user or migrate it manually as needed.
+> 💡 This ensures archived data is never lost — even if its original context is no longer available.
+----
+For help managing orphaned files or configuring the orphaned restore site, contact [support@smikar.com](mailto:support@smikar.com).