chslave Command

Commands Reference, Volume 1

chslave Command

Purpose

Re-executes the ypinit command to retrieve maps from a master server and re-starts the ypserv daemon to change the slave server.

Syntax

/usr/etc/yp/chslave [-C |-c] [ -O | -o ] [ -I | -B | -N ] Master

Description

The chslave command re-invokes the ypinit command to retrieve maps from the master server you specify on the command line. The ypserv daemon is re-started after the ypinit command has completed successfully. The Master parameter specifies the host name of the master server. The master server specified can be the master server currently in use or a new master server that is configured and running.

You can use the Web-based System Manager Network application (wsm network fast path) to run this command. You could also use the System Management Interface Tool (SMIT) smit chslave fast path to run this command.

Flags

-B	Invokes the ypinit command and starts the ypserv daemon. If the ypserv daemon is already running, this flag will cause the ypinit command to kill the daemon and then restart it. This flag is the default.
-C	Invokes the ypinit command with the -n flag. The chslave command continues on errors. This flag is the default.
-c	Stops execution when errors occur.
-I	Executes the ypinit command immediately but does not start or restart the ypserv daemon.
-O	Overwrites any maps that exist in the domain.
-o	Prevents the overwrite of maps that exist in the domain. This flag is the default.
-N	Invokes the ypinit command and restarts the ypserv daemon.

Examples

To retrieve maps from the master server named host91, enter:

chslave -O -B host91

This will overwrite any existing maps for the current domain.

Files

/etc/rc.nfs	Contains the startup script for NFS and NIS daemons.
/var/yp/domainname	Contains the NIS maps for the NIS domain.

Related Information

The chmaster command, mkclient command, mkslave command, rmyp command, smit command, ypinit command.

The ypbind daemon, yppasswdd daemon, ypserv daemon, ypupdated daemon.

Setting up and running Web-based System Manager in AIX Version 4.3 System Management Guide: Operating System and Devices.

System Management Interface Tool (SMIT): Overview in AIX Version 4.3 System Management Concepts: Operating System and Devices.

Network Information Service (NIS) in AIX Version 4.3 Network Information Services (NIS and NIS+) Guide.

NIS Reference.