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?
_______________________________________________
Gluster-users mailing list
[email protected]
http://supercolony.gluster.org/mailman/listinfo/gluster-users

Reply via email to