NAME

remove_client −  remove a diskless NFS client

SYNOPSIS

/usr/etc/setup/remove_client [ −v ] [ −x ] [ −p pid ] client [ client ...  ]

DESCRIPTION

remove_client removes a diskless NFS client from a Solbourne server.  It can only be run by the super-user. 

The client argument is the hostname of the diskless client to be removed. 

When run with no arguments, remove_client displays a usage message. 

A log of all invocations of remove_client is maintained in /var/log/diskless_log, along with all other diskless client configuration and installation activity. 

OPTIONS

-v Enable verbose output message display during execution. 

-x Execute the "set -x" command to enable shell execution tracing.  This feature is useful for determining the actions of remove_client, but will cause the script to detect an error after normal processing has completed, and the client may not be completely removed. 

-p pid Process id of system administration installation tool handling display output.  This option should only be used when remove_client is invoked by the system administration tool. 

USAGE

You can not remove diskless clients that have not been installed using the install_client (8) command.  You must make sure that the Internet and Ethernet addresses for client are listed in the YP hosts database (if the server is running the YP), or in the server’s /etc/hosts and /etc/ethers databases, respectively (otherwise).  The server must have also been configured for this machine_arch architecture, using the config_server (8) command.  Then, run remove_client with appropriate arguments. 

remove_client updates the /etc/bootparams file.  If the server is a YP master, it updates the local YP database.  It does not propagate the local update to other YP servers.  To propagate the updates, use the following commands:

 example# cd /var/yp
example# make
 

If the server is running YP but is not a YP master, remove_client updates only the local database.  The master database must be updated as well. 

remove_client updates the /etc/exports file to remove root access to each client’s root file system.  It also removes the client’s swap and dump file systems as well.  NOTE: the system administrator should verify that the /etc/exports file contains correct information, and that file systems are exported to the correct users and groups.  Refer to exportfs(8) for details on exporting file systems. 

EXAMPLES

This example shows how to remove a Solbourne system NFS client from a server. 

example# remove_client frodo

FILES

/etc/hosts hosts database

/etc/ethers database of hostnames and Ethernet addresses

/etc/bootparams database for diskless clients to determine their root and swap files

/etc/exports database of exported file systems

/exports directory or symbolic link to directory which did contain client root and swap directories. 

/var/log/diskless_log log of all diskless client configuration and installation activity

SEE ALSO

exportfs(8), config_server(8), install_client(8)

Solbourne Installation Guide
Solbourne System and Network Administration Manual

DIAGNOSTICS

Must be run by the super user
You must be root to use remove_client. 

Can not determine domainname
Could not determine the yellow pages domainname of the server.  See domainname (1). 

Client internet address not found.  Check /etc/hosts or yp
You must add the client’s Internet address to the hosts database before using remove_client. 

Can not convert internet address
An error occurred trying to convert the client internet address to it’s hexadecimal form.  Verify the internet address specified in the hosts database.

Can not remove client root directory
An error occurred while removing the client root directory. You should remove it by hand.

Can not remove client swap file
An error occurred while removing the client swap file. You should remove it by hand.

Can not update bootparams
An error occurred while adding the client information to /etc/bootparams.  Check permissions and verify the bootparams database.

Can not create temporary exports file
An error occurred creating a copy of the /etc/exports file in /tmp.  Verify permissions and free space in /tmp.

Check /etc/exports
An error was detected by exportfs (8).  Check and correct the /etc/exports file and run /usr/etc/exportfs. 

Solbourne Computer, Inc.  —  18 May 1989