[Gluster-users] Disappointing documentation?
joe at julianfamily.org
Tue Mar 5 22:50:49 UTC 2013
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
>> Please tell me your thoughts.
> There is no online documentation for v3.3. Every google search points to
> 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
> 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
> 220.127.116.11. 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
> Using Windows Explorer, choose
> Tools > Map Network Drive...
> from the menu. The
> Network Drive
> window appears.
> Choose the drive letter using the
> drop-down list.
> , select the volume to map to the network drive, and click
> The network drive (mapped to the volume) appears in the Computer window.
> Alternatively, to manually mount a Gluster volume using CIFS.
> Start > Run
> and enter the following:
> For example:
> 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?
More information about the Gluster-users