Opened 21 months ago

Closed 8 months ago

#652 closed task (fixed)

More intuitive maproot/mapall documentation required

Reported by: gcooper Owned by: william
Priority: major Milestone:
Component: GUI Version: 8.0-RELEASE
Keywords: Cc:

Description

The maproot/mapall GUI is helpful, but incomplete for new users. The problem is that some users are not seasoned administrators, and may not be aware of some of the caveats dealing with the more strict security model in FreeBSD, in particular..

-mapall=user or -mapall=user:group1:group2:... specifies a mapping for
all client UIDs (including root) using the same semantics as -maproot.

...

In the absence of -maproot and -mapall options, remote accesses by root
will result in using a credential of -2:-2. All other users will be
mapped to their remote credential. If a -maproot option is given, remote
access by root will be mapped to that credential instead of -2:-2. If a
-mapall option is given, all users (including root) will be mapped to
that credential in place of their own.

This should be made more intuitive, either through documentation, a tool tip, a (?) icon the user can click on, etc to determine what this actually means, instead of just setting the mode without fully understanding what it does.

Copy-pasting and paraphrasing the text from exports(5) into whatever delivery mechanism deemed appropriate should suffice, along with a helpful example of what happens when they do all permutations of -maproot and -mapuser (this should be reserved for the guide though).

Change History (3)

comment:1 Changed 20 months ago by dlavigne

I think the docs are fairly clear for these options: http://doc.freenas.org/index.php/NFS_Shares#Creating_NFS_Shares, but tooltips are still needed for those who don't read/aren't aware of the docs.

comment:2 Changed 8 months ago by william

  • Owner set to william
  • Status changed from new to accepted

comment:3 Changed 8 months ago by william

  • Resolution set to fixed
  • Status changed from accepted to closed

Help text updated in r12407

Note: See TracTickets for help on using tickets.