Bug 782971

Summary: [RFE] we should provide a way to set which port the NIS server binds to
Product: Red Hat Enterprise Linux 6 Reporter: Dmitri Pal <dpal>
Component: doc-Identity_Management_GuideAssignee: Deon Ballard <dlackey>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: medium Docs Contact:
Priority: medium    
Version: 6.3CC: jgalipea, jskeoch, mkosek, rcritten
Target Milestone: rcKeywords: Documentation, FutureFeature
Target Release: 6.3   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-06-21 23:15:53 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Dmitri Pal 2012-01-19 00:19:33 UTC 
This bug is created as a clone of upstream ticket:
https://fedorahosted.org/freeipa/ticket/1957

The NIS server plugin for the directory server can either bind to an available port selected at runtime by using bindresvport(), or to a specific port.  Either way, it'll notify the portmapper of which one it's using, so clients will be able to find it.  For firewalling purposes, though, an admin is likely to want to know which port it will use ahead of time.  A port is specified by setting "nsslapd-pluginarg0" to the desired port number (the plugin's documentation uses "541" as an example, but any port below 1024 should do as well) in the entry which instructs the server to load the plugin.

Ideally, I think the tool which enables and disables the plugin should be able to set and unset this parameter.  Failing that, I guess we probably want to set one by default so that the server installation script can advise the administrator to punch a hole in the firewall for NIS, as it already does for Kerberos and LDAP services.
Comment 1 Rob Crittenden 2012-01-20 20:43:47 UTC 
Converted to a documentation bug instead.

To set a specific port you'll need to modify the plugin configuration entry in LDAP and add the nsslapd-pluginarg0 with the value of the port you want to listen on.

An example to set port 514 is:

# ldapmodify -x -D 'cn=directory manager' -W Enter LDAP Password: dn: cn=NIS Server,cn=plugins,cn=config changetype: modify add: nsslapd-pluginarg0 nsslapd-pluginarg0: 514

modifying entry "cn=NIS Server,cn=plugins,cn=config"

# /sbin/service dirsrv restart
Comment 3 Deon Ballard 2012-05-03 16:33:34 UTC 
Setting all priority and severity to medium.
Comment 4 Deon Ballard 2012-05-03 18:00:19 UTC 
Added the procedure for setting a NIS port:
http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6-Beta/html/Identity_Management_Guide/nis-port.html
Comment 5 John Skeoch 2012-05-08 01:07:09 UTC 
Verified the inclusion of comment#1 in:

http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6-Beta/html/Identity_Management_Guide/nis-port.html

Red_Hat_Enterprise_Linux-Identity_Management_Guide-6-Beta-en-US-2.2.0-0.5

---
Comment 6 Deon Ballard 2012-06-21 23:15:53 UTC 
Closing.