YPXFR(8) | NIS Reference Manual | YPXFR(8) |
NAME¶
ypxfr - transfer NIS database from remote server to local host
SYNOPSIS¶
/usr/lib/yp/ypxfr [-f] [-c] [-d target domain] [-h source host] [-s source domain] [-C taskid program-number host port] [-p yp_path] mapname...
DESCRIPTION¶
ypxfr copies an NIS database from one NIS server to the local host by using the NIS service. ypxfr is generally invoked by ypinit or by ypserv, when ypserv receives a map transfer request from yppush. It creates a temporary map in the directory /var/yp/domain (this directory must already exist; domain is the default domainname for the local host), fills it by getting the map's entries and fetches the map parameters (master and order number). If the transfer was successful, the old version of the map will be deleted and the temporary copy will be moved into its place. Then, ypxfr will attempt to send a "clear current map" request to the local ypserv.
If run interactively, ypxfr writes its output to stderr. However, if it is invoked without a controlling terminal, it will log the output to syslog.
ypxfr is used primarily in environments where several NIS servers are in use. For all maps, you have a NIS master server, which maintains a canonical copy of the NIS map, and all the other servers, the NIS slaves, copy the new version of the map from the master whenever a update was made. Normally, you have one NIS master for all maps.
In order to maintain consistency across all NIS servers, ypxfr can be run periodically in a cron job. Maps which change infrequently need only be updated once a day (preferably late at night when system usage is lowest), where those with frequent changes (such as passwd.byname and passwd.byuid ) should be updated perhaps once every hour. Examples are in /usr/lib/yp: ypxfr_1perday, ypxfr_2perday, and ypxfr_1perhour. They can serve as reasonable first cuts.
Normally all updates should be propagated by yppush when /var/yp/Makefile is run on the NIS master server, however it is a good practice on large networks where possible outages could cause NIS slaves to fall out of sync with the master.
OPTIONS¶
The following options are supported:
-f
-c
-d domain
-h source host
-s source domain
-C taskid progam-number host port
-p yp_path
mapname
FILES¶
/var/yp/[domainname]/[maps]
SEE ALSO¶
AUTHOR¶
Thorsten Kukuk <kukuk@linux-nis.org>
12/31/2020 | NIS Reference Manual |