Index for Section 8

Alphabetical listing for C

Bottom of page

clu_delete_member(8)
NAME
  clu_delete_member - Remove a member from a cluster

SYNOPSIS
  /usr/sbin/clu_delete_member [-f] [-m memberid]

FLAGS
  -f	    Force the deletion of the member. Normally clu_delete_member
	    attempts to mount the boot partition of the member being deleted;
	    if it cannot mount the boot partition, it exits.  When you
	    specify -f, clu_delete_member deletes the member even if it
	    cannot mount that member's boot partition.

  -m memberid
	    Specifies the memberid of the cluster member that
	    clu_delete_member should remove.  (If you do not supply a member
	    ID, the command prompts for the member ID of the member to
	    delete.)

DESCRIPTION
  The clu_delete_member command removes a member from a cluster.  You must be
  root to run this command.

  The command is interactive. It prompts for the information required to
  perform each task, displays the entered information so you can check its
  accuracy, and, only after you confirm that the information is correct,
  modifies the system.	The command also provides online help. To display a
  help message, type the word help or a question mark, ?, at any prompt.

  The clu_delete_member command does the following:

    ·  Mounts the member's boot partition and deletes all files in the boot
       partition. The system can no longer boot from this disk.

				      Caution

	    The clu_delete_member -f command will delete a member even
	    when the member's boot disk is inaccessible. This lets you
	    delete a member whose boot disk has failed or is for any
	    reason inaccessible.  However, if clu_delete_member cannot
	    access the disk, you must make sure that no cluster member
	    can inadvertently boot from that disk. Remove the disk from
	    the cluster, reformat it, or use the disklabel command to
	    make it a nonbootable disk.

    ·  If the member has votes, and if the member's boot disk is accessible,
       it adjusts the value of cluster_expected_votes throughout the cluster.

				      Caution

	    If clu_delete_member cannot mount the boot partition, it
	    cannot determine the number of votes held by the member, and
	    therefore cannot reset cluster_expected_votes throughout the
	    cluster. After clu_delete_member completes, use the
	    clu_quorum command to check the value of
	    cluster_expected_votes. Adjust the value if necessary. For
	    example, if the deleted member had 0 votes, no adjustment is
	    needed, but if the member had 1 or more votes,
	    cluster_expected_votes should be adjusted.

    ·  Deletes all member-specific directories and files in the clusterwide
       file systems.

					Note

	    The clu_delete_member command deletes member-specific files
	    from the /cluster, /usr/cluster, and /var/cluster
	    directories. However, an application or an administrator can
	    create member-specific files in other directories, such as
	    /usr/local. You must manually remove those files after
	    running clu_delete_member. Otherwise, if you add a new
	    member and re-use the same member ID, the new member will
	    have access to these (outdated and perhaps erroneous) files.

    ·  Removes the deleted member's host name for its cluster interconnect
       interface from the /.rhosts and /etc/hosts.equiv files.

    ·  Writes a log file of the deletion to
       /cluster/admin/clu_delete_member.log.

  The TruCluster Server Cluster Administration manual describes how to delete
  a cluster member. Refer to that manual before running the clu_delete_member
  command.

  The following list outlines the steps needed to delete a member from the
  cluster:

   1.  Determine whether the member is a critical voting member of the
       cluster. If the member supplies a critical vote to the cluster,
       halting it will cause the cluster to lose quorum and suspend
       operations. Before halting the member, use the clu_quorum command to
       determine whether it is safe to do so. (See clu_quorum(8) and the
       TruCluster Server Cluster Administration manual for information on
       adjusting votes.)

   2.  Halt the member to be deleted.

   3.  Make sure that all voting cluster members are up.

   4.  On another cluster member, run the clu_delete_member command to remove
       the halted member from the cluster. For example, to delete a halted
       member whose member ID is 3, enter the following command:
	    # /usr/sbin/clu_delete_member -m 3

FILES
  /usr/sbin/clu_delete_member
	    Specifies the command path.

  /cluster/admin/clu_delete_member.log
	    Log file for clu_delete_member.

RELATED INFORMATION
  Commands: clu_add_member(8), clu_check_config(8), clu_create(8),
  clu_quorum(8), clu_upgrade(8)

  TruCluster Server Cluster Administration

Index for Section 8

Alphabetical listing for C

Top of page