[Gluster-users] Disappointing documentation?

[Joe Julian]

On 03/05/2013 02:46 PM, Papp Tamas wrote:
> On 03/05/2013 05:33 PM, Joe Julian wrote:
>>
>> It comes up on this list from time to time that there's not 
>> sufficient documentation on
>> troubleshooting. I assume that's what some people mean when they 
>> refer to disappointing
>> documentation as the current documentation is far more detailed and 
>> useful than it was 3 years ago
>> when I got started. I'm not really sure what's being asked for here, 
>> nor am I sure how one would
>> document how to troubleshoot. In my mind, if there's a trouble that 
>> can be documented with a clear
>> path to resolution, then a bug report should be filed and that should 
>> be fixed. Any other cases that
>> cannot be coded for require human intervention and are already 
>> documented.
>>
>> Please tell me your thoughts.
>
> There is no online documentation for v3.3. Every google search points to
> http://gluster.org/community/documentation/index.php/Gluster_3.2_Filesystem_Administration_Guide 
>
>
>
> There is an Admin guide, but it's in pdf and html gzipped? Is it fun?:)
> Also I'm afraid this guide is RH specific.
>
> For example there is this section:
>
> "If you are using Samba to access GlusterFS FUSE mount, then POSIX 
> ACLs are enabled by default.
> Samba has been compiled with the
> --with-acl-support
> option, so no special flags are required
> when accessing or mounting a Samba share."
>
> How do you know about that?
>
>
> Also there is no good cifs documentation.
> I suggest adding a full smb.conf.
> I asked here in the list for tuning help, with no answer, then later I 
> found the solution by google.
> For me max/min protocol = SMB2 was the trick. But there can be locking 
> issues (for example Adobe Premiere and Photoshop).
> I don't blame the list, but the online, searchable documentation 
> should be more helpful.
>
> However of course this is a samba general issue at the same time.
>
>
> And I think this guide should be used more or less by experts, not 
> absolutely beginners.
> If someone is looking for the right information, it's hard to find, 
> because too verbose:
>
> "Chapter 6. Accessing Data - Setting Up GlusterFS Client
> 28
> 6.3.1.2. Manually Mounting Volumes Using CIFS
> You can manually mount Gluster volumes using CIFS on Microsoft 
> Windows-based client machines.
> To manually mount a Gluster volume using CIFS
> 1.
> Using Windows Explorer, choose
> Tools > Map Network Drive...
> from the menu. The
> Map
> Network Drive
> window appears.
> 2.
> Choose the drive letter using the
> Drive
> drop-down list.
> 3.
> Click
> Browse
> , select the volume to map to the network drive, and click
> OK
> .
> 4.
> Click
> Finish.
> The network drive (mapped to the volume) appears in the Computer window.
> Alternatively, to manually mount a Gluster volume using CIFS.
> •
> Click
> Start > Run
> and enter the following:
> \\SERVERNAME\VOLNAME
> For example:
> \\server1\test-volume"
>
>
>
> This whol cifs section is obviously only an example:)

I know I'm probably starting to sound like a broken record, repeating 
the same mantra over and over again, but I'll ask anyway: can you add 
the better information you found to the wiki please?