From b10a1c890f8881a74b14549351bf8315ce2c3fe5 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Mon, 16 Dec 2013 18:56:51 +0100 Subject: [PATCH] Clarifies the share issue about pool in Windows. --- TODO | 15 ++++++++++++++- snapraid.1 | 18 ++++++++++++++---- snapraid.d | 15 +++++++++++---- snapraid.txt | 15 +++++++++++---- 4 files changed, 50 insertions(+), 13 deletions(-) diff --git a/TODO b/TODO index e3d620fb..8a4548d1 100644 --- a/TODO +++ b/TODO @@ -98,7 +98,12 @@ only if changes are committed after an aborted sync. - Pooling -* Allow to specify the shared path to use to access remote symlink. +* Allow to specify the shared path in Windows to access remote symlinks. +Something like: +share \\SERVER\JBOD\ +And then converting all the symbolic links to prepend this path in the link +definition. +Links will appears as \\SERVER\JBOD\DISK_NAME\sub_path_inside_the_disk. * Add a new "commit" command to move changes from the pool to the array. It should: @@ -157,6 +162,14 @@ Rejected TODO This is a list of rejected TODO items. +* In "pool" for Windows, and for unique directories a junction to the +directory could be used, avoiding to use symlinks to files. +This allows to overcome the problem of sharing symlinks. +- It would work, in fact it would work to well. The problem is that +Windows will treat the junction as the real directory, like *really* +deleting its content from Explorer pressing "del" and also from the +command line with "rd". Too dangerous. + * When fixing, before overwriting the present file, make a copy of it just in case that the original file cannot be completely recovered. We can always open files in read-only mode, if a write is required, we close it, diff --git a/snapraid.1 b/snapraid.1 index ba5faafb..9d1ae1ef 100644 --- a/snapraid.1 +++ b/snapraid.1 @@ -360,6 +360,7 @@ snapraid \-p 0 scrub To have all the files in your array shown in the same directory tree, you can enable \(a"pooling\(a", that consists in creating a virtual view of all the files in your array using symbolic links. +.PP You can configure the \(a"pooling\(a" directory in the configuration file with: .PP .RS 4 @@ -378,7 +379,7 @@ pool C:\(rspool .PD .RE .PP -and then run the \(a"pool\(a" command. +and then run the \(a"pool\(a" command to create or update the virtual view. .PP .RS 4 snapraid pool @@ -387,9 +388,9 @@ snapraid pool .PD .RE .PP -If you are using a Unix platform and you want to configure SAMBA to -share such directory, you should add to your /etc/samba/smb.conf the -following options: +If you are using a Unix platform and you want to share such directory +in the network to either Windows or Unix machines, you should add +to your /etc/samba/smb.conf the following options: .PP .RS 4 # In the global section of smb.conf @@ -431,7 +432,16 @@ wide links = yes .PD 0 .PP .PD +follow symlinks = yes +.PD 0 +.PP +.PD .RE +.PP +In Windows the same sharing operation is not so straightforward, +because Windows shares in the network the symbolic links as they are, +and that requires to have modern network clients able to understand +them, that usually doesn\(cqt happen for embedded clients like TVs. .SH COMMANDS SnapRAID provides a few simple commands that allow to: .PD 0 diff --git a/snapraid.d b/snapraid.d index 6c85fd99..0c08183c 100644 --- a/snapraid.d +++ b/snapraid.d @@ -204,6 +204,7 @@ Getting Started To have all the files in your array shown in the same directory tree, you can enable "pooling", that consists in creating a virtual view of all the files in your array using symbolic links. + You can configure the "pooling" directory in the configuration file with: :pool /pool @@ -212,13 +213,13 @@ Getting Started :pool C:\pool - and then run the "pool" command. + and then run the "pool" command to create or update the virtual view. :snapraid pool - If you are using a Unix platform and you want to configure SAMBA to - share such directory, you should add to your /etc/samba/smb.conf the - following options: + If you are using a Unix platform and you want to share such directory + in the network to either Windows or Unix machines, you should add + to your /etc/samba/smb.conf the following options: :# In the global section of smb.conf :unix extensions = no @@ -230,6 +231,12 @@ Getting Started :read only = yes :guest ok = yes :wide links = yes + :follow symlinks = yes + + In Windows the same sharing operation is not so straightforward, + because Windows shares in the network the symbolic links as they are, + and that requires to have modern network clients able to understand + them, that usually doesn't happen for embedded clients like TVs. Commands SnapRAID provides a few simple commands that allow to: diff --git a/snapraid.txt b/snapraid.txt index 0735ab07..014f7562 100644 --- a/snapraid.txt +++ b/snapraid.txt @@ -223,6 +223,7 @@ if really fixed. You can use -p 0 to scrub only blocks marked as bad. To have all the files in your array shown in the same directory tree, you can enable "pooling", that consists in creating a virtual view of all the files in your array using symbolic links. + You can configure the "pooling" directory in the configuration file with: pool /pool @@ -231,13 +232,13 @@ or, if you are in Windows, with: pool C:\pool -and then run the "pool" command. +and then run the "pool" command to create or update the virtual view. snapraid pool -If you are using a Unix platform and you want to configure SAMBA to -share such directory, you should add to your /etc/samba/smb.conf the -following options: +If you are using a Unix platform and you want to share such directory +in the network to either Windows or Unix machines, you should add +to your /etc/samba/smb.conf the following options: # In the global section of smb.conf unix extensions = no @@ -249,6 +250,12 @@ following options: read only = yes guest ok = yes wide links = yes + follow symlinks = yes + +In Windows the same sharing operation is not so straightforward, +because Windows shares in the network the symbolic links as they are, +and that requires to have modern network clients able to understand +them, that usually doesn't happen for embedded clients like TVs. 5 COMMANDS