Differences

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

--- omv6:omv6_plugins:snapraid [2023/08/03 01:23] – [Notes] crashtest
+++ omv6:omv6_plugins:snapraid [2024/04/22 04:02] (current) – crashtest
@@ Line 1: / Line 1: @@
-{{indexmenu_n>6}}
+{{indexmenu_n>9}}
 \\
 <html><center><b>SnapRAID Plugin For OMV6</b></center></html>
@@ Line 323: / Line 323: @@
   * For a better understanding of the SnapRAID works and it's features, reading the -> [[https://www.snapraid.it/manual|SnapRAID manual]] is recommended.
 \\
-\\
-===== Normal Operations =====
-As it is when using any "RAID like" package, hard drive monitoring is highly recommend.  Advanced notice of the potential for hard drive failure, and taking action to replace a failing drive, will go a long way toward preventing the loss or corruption of data.\\
-\\
-For the admin's convenience, much of the monitoring processes can be automated as follows:\\
-Configuring -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#server_notifications|Server Notifications]] and configuring -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#hard_drive_health_and_smart|SMART]], as recommend, will go a long way toward providing as much notice as possible that a hard drive is begining to fail.  If user / admins receive SMART advisory E-mails regarding a particular drive, take note of the -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#smart_attributes|SMART attributes]] that are associated with drive failure.  In addition, the SnapRAID plugin has a "drive failure probability" indicator.  It can be found under; **Services**, **SnapRAID**, **Drives**.  Under the **Info** button {{:omv6-plugins-snapraid-05-04.jpg?20|}} select **SMART** from the drop down menu.\\
 ==== Other Useful Command Line Tools ====
 ''snapraid touch'' \\
@@ Line 340: / Line 329: @@
 ''sync --force-full''\\
 If parity issues with the parity drive are persistent and the user admin is reasonably sure there are no data issues, the command ''sync --force-full'' may correct the problem.  Since this command is the rough equivalent of the a "first sync", depending on the amount of data on protected disks, it may take several hours to complete.\\
 ----
+===== Normal Operations =====
+As it is when using any "RAID like" package, hard drive monitoring is highly recommend.  Advanced notice of the potential for hard drive failure, and taking action to replace a failing drive, will go a long way toward preventing the loss or corruption of data.\\
+\\
+For the admin's convenience, much of the monitoring processes can be automated as follows:\\
+Configuring -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#server_notifications|Server Notifications]] and configuring -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#hard_drive_health_and_smart|SMART]], as recommend, will go a long way toward providing as much notice as possible that a hard drive is beginning to fail.  If user / admins receive SMART advisory E-mails regarding a particular drive, take note of the -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#smart_attributes|SMART attributes]] that are associated with drive failure.  In addition, the SnapRAID plugin has a "drive failure probability" indicator.  It can be found under; **Services**, **SnapRAID**, **Drives**.  Under the **Info** button {{:omv6-plugins-snapraid-05-04.jpg?20|}} select **SMART** from the drop down menu.\\
 \\
+If symptoms of a failing drive are noted, see Recovery Operations (below).\\
 \\
 {{ :divider2.png?nolink&800 |}}
 ===== Recovery Operations =====
-Recovery operation examples for single files, missing files, etc., are provided in the -> [[https://www.snapraid.it/faq|SnapRAID FAQ]] page.
+Recovery examples for single files, missing files, etc., are provided in the -> [[https://www.snapraid.it/faq|SnapRAID FAQ]] page.
 ==== Recovering a Failed Drive ====
@@ Line 358: / Line 353: @@
 \\
 Contrary to popular belief, spinning drives rarely fail "all at once" as if turning off a light switch off.  In many cases, drives will begin to reallocate sectors among other symptoms that indicate that they are beginning to fail.  If these symptoms are ignored, the drive may begin to corrupt data that is stored on it or written to it.\\
-\\
-Configuring -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#server_notifications|Server Notifications]] and configuring -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#hard_drive_health_and_smart|SMART]], as recommend, will go a long way toward providing as much notice as possible that a hard drive is begining to fail.  If user / admins receive SMART advisory E-mails regarding a particular drive, take note of the -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#smart_attributes|SMART attributes]] that are associated with drive failure.  In addition, the SnapRAID plugin has a "drive failure probability" indicator.  It can be found under; **Services**, **SnapRAID**, **Drives**.  Under the **Info** button {{:omv6-plugins-snapraid-05-04.jpg?20|}} select **SMART** from the drop down menu.\\
 \\
 When it has been determined that a drive is beginning to fail, it is crucial that user / admins **DO NOT** run the **Diff Script** OR a manual **Sync** operation.
@@ Line 370: / Line 363: @@
   * First it's crucial that the **Diff script**, if automated, is turned **OFF**.
   * Do not run a **Snyc** operation until after the replacement is completed.
-  * If user / admins have automated processes (downloaders, media centers, etc.) that save or move files on protected drives, they should be paused or turned off.
+  * If user / admins have automated processes (downloaders, media centers, etc.) that save or move files on SnapRAID protected drives, they should be paused or turned off.
   * Server users should be informed to not use the server during the drive replacement.  (This could be enforced by temporarily disabling file sharing services like SMB or NFS.)
@@ Line 382: / Line 375: @@
 When server notifications are -> [[https://wiki.omv-extras.org/doku.php?id=omv6:new_user_guide#server_notifications|configured as recommended]] , user / admins are notified by e-mail of **file system failures** and other issues.\\
 \\
-{{ ::omv6-plugins-snapraid-14.jpg?nolink&600 |}}
+{{ ::omv6-plugins-snapraid-14.jpg?nolink&700 |}}
 ----
@@ Line 389: / Line 382: @@
 \\
-{{ ::omv6-plugins-snapraid-12.jpg?nolink&800 |}}
+{{ ::omv6-plugins-snapraid-12.jpg?nolink&900 |}}
 \\
 ----
 <html><center><b>Physically remove the drive.</b></center></html>
-<html><center>If necessary, ref to <b>Storage</b>, <b>Disks</b> and compare serial numbers to the device names under <b>Storage</b>, File <b>Systems</b> to insure the right drive is removed.</center></html>
+<html><center>If necessary, refer to <b>Storage</b>, <b>Disks</b> and compare serial numbers to the device names under <b>Storage</b>, File <b>Systems</b> to insure the right drive is removed.</center></html>
 \\
-{{ :omv6-plugins-snapraid-19.jpg?nolink&800 |}}
+{{ :omv6-plugins-snapraid-19.jpg?nolink&900 |}}
 ----
@@ Line 414: / Line 407: @@
 - Click the **Save** button.
-{{ ::omv6-plugins-snapraid-21.jpg?nolink&600 |}}
+{{ ::omv6-plugins-snapraid-21.jpg?nolink&800 |}}
 <html><center>When the format is complete, click the <b>Close</b> button.</center></html>
@@ Line 422: / Line 415: @@
 \\
-{{ ::omv6-plugins-snapraid-22.jpg?nolink&600 |}}
+{{ ::omv6-plugins-snapraid-22.jpg?nolink&800 |}}
 \\
 <html><center>Click <b>Save</b> and <b>apply</b> the configuration change.</center></html>
@@ Line 431: / Line 424: @@
 <html><center><b>/dev/sde1</b> appears, empty and formatted to <b>EXT4</b></center></html>.
-{{ ::omv6-plugins-snapraid-23.jpg?nolink&600 |}}
+{{ ::omv6-plugins-snapraid-23.jpg?nolink&800 |}}
 ----
@@ Line 477: / Line 470: @@
 {{ ::omv6-plugins-snapraid-26.jpg?nolink&600 |}}
 \\
-<html><center>(The UNRECOVERABLE error may be due to a change made //after// the last **Sync** operation, that cannot be restored.)</center></html>
+<html><center>(The UNRECOVERABLE error may be due to a change made <b><i>after</i></b> the last <b>Sync</b> operation, that cannot be restored.)</center></html>
 ----
@@ Line 484: / Line 478: @@
 This concludes data restoration to a SnapRAID protected drive.\\
 **MergerFS users** skip see the section below titled; **Replacing a Failed Drive in MergerFS**. \\
 ----
 The remainder of tasks, within OMV, would be to repointing **Shared Folders** and other services to the replacement drive.  To repoint shared folders, see the guidance provided -> [[https://wiki.omv-extras.org/doku.php?id=omv6:utilities_maint_backup#repointing_a_shared_folder|here]].\\
 \\
 When all references to the failed drive have been redirected to the new drive, or removed, under **Storage**, **File Systems**, the "**Referenced**" check mark should be removed.  Highlight the **missing** drive, **unmount** it and **Apply** the change.\\
 \\
-Finally, re-enable all automated tasks and enable network shared (if previously disabled.)\\
+Finally, re-enable all automated tasks and enable SMB or NFS network shares (if previously disabled.)\\
 \\
 \\