[Gluster-users] Disappointing documentation?

[Papp Tamas]

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:)

Cheers,
tamas