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?
