Bug 29215

Summary: NIS Section in Handbook should be more detailed
Product: Documentation Reporter: Thorsten Steentjes <tst>
Component: Books & ArticlesAssignee: ue
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Thorsten Steentjes 2001-07-25 11:00:01 UTC
Section 18.7.4.2 "NIS Servers" of the FreeBSD Handbook needs to be more
detailed.The installation of a NIS master server is written like a
"step-by-step" tutorial, but there are some missing items.

Fix: 

The following steps should be added to the NIS section:
- necessary lines in /etc/rc.conf to start ypbind on the  NIS server and
  bind it to the NIS master with the -S option.
- delete NIS users from /etc/master.passwd after copying it to
  /var/yp/master.passwd
- it's useful to keep a "normal" useraccount in /etc/master.passwd which
  is a member of the wheel group for the situation when the ypserv or
  rpc.yppasswdd dies and you want to logon from a remote machine to
  become root and restart the server processes.
How-To-Repeat: Install a NIS master server like described in the NIS Servers section
and try to update a NIS useraccount, e.g. setting a new password with
yppasswd.
Comment 1 dima 2001-07-25 13:24:27 UTC
Thorsten Steentjes <tst@guug.de> writes:
> >Fix:
> The following steps should be added to the NIS section:
> - necessary lines in /etc/rc.conf to start ypbind on the  NIS server and
>   bind it to the NIS master with the -S option.

This is not true.  An NIS server doesn't have to be a client.  If this
is added, it should make it clear that this is *optional*.

Other than that, it seems useful.  Care to work up a patch to the
DocBook source? :-)
Comment 2 Thorsten Steentjes 2001-07-25 17:30:46 UTC
Am Wed, Jul 25, 2001 at 05:24:27AM -0700, schrieb Dima Dorfman :
> 
> This is not true.  An NIS server doesn't have to be a client.  If this
> is added, it should make it clear that this is *optional*.
> 
This is very true, it's a optional but very useful feature.

> Other than that, it seems useful.  Care to work up a patch to the
> DocBook source? :-)
> 
Sure, just give me a little time to write a patch cause I'm very
busy these days.
Comment 3 alex freebsd_committer freebsd_triage 2001-08-06 14:36:27 UTC
Responsible Changed
From-To: freebsd-doc->ue

ue did a big overhaul of the NIS parts some time ago
Comment 4 ue freebsd_committer freebsd_triage 2001-10-28 11:25:33 UTC
State Changed
From-To: open->closed

The existing chapter has been improved in revision 1.98 of 
advanced-networking/chapter.sgml.