From owner-svn-src-projects@freebsd.org Sun Jun 3 17:49:46 2018 Return-Path: Delivered-To: svn-src-projects@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 419F9FE549C for ; Sun, 3 Jun 2018 17:49:46 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id EC65F71772; Sun, 3 Jun 2018 17:49:45 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id CAA6521D1E; Sun, 3 Jun 2018 17:49:45 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w53Hnjoj021749; Sun, 3 Jun 2018 17:49:45 GMT (envelope-from rmacklem@FreeBSD.org) Received: (from rmacklem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w53HnjR8021748; Sun, 3 Jun 2018 17:49:45 GMT (envelope-from rmacklem@FreeBSD.org) Message-Id: <201806031749.w53HnjR8021748@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rmacklem set sender to rmacklem@FreeBSD.org using -f From: Rick Macklem Date: Sun, 3 Jun 2018 17:49:45 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r334573 - projects/pnfs-planb-server/usr.bin/pnfsdskill X-SVN-Group: projects X-SVN-Commit-Author: rmacklem X-SVN-Commit-Paths: projects/pnfs-planb-server/usr.bin/pnfsdskill X-SVN-Commit-Revision: 334573 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-projects@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: "SVN commit messages for the src " projects" tree" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 03 Jun 2018 17:49:46 -0000 Author: rmacklem Date: Sun Jun 3 17:49:45 2018 New Revision: 334573 URL: https://svnweb.freebsd.org/changeset/base/334573 Log: Update the pnfsdskill.1 man page to reflect the change to a distributed mirroring model and make use of the .Dq macro. Modified: projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1 Modified: projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1 ============================================================================== --- projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1 Sun Jun 3 17:17:45 2018 (r334572) +++ projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1 Sun Jun 3 17:49:45 2018 (r334573) @@ -33,21 +33,25 @@ disables a pNFS data storage server (DS) .Sh SYNOPSIS .Nm -.Ar mounted_on_path_of_DS +.Ar mounted-on-DS-dir .Sh DESCRIPTION The .Nm -command disables one mirror of a mirrored set of DSs. -Two or more DSs may be configured as a mirrored set. -If one of these mirrored DSs is malfunctioning, a system administrator +command disables one DS when mirroring is enabled. +If one mirrored DS is malfunctioning, a system administrator may use this command on the metadata server (MDS) to disable use of this mirror. This command must be used on the MDS and the -.Ar mounted_on_path_of_DS +.Ar mounted-on-DS-dir must be the exact pathname used when mounting the DS on the MDS. .Pp -If this command fails with ``Device not configured'' (ENXIO), it probably +If this command fails with +.Dq Device not configured +(ENXIO), it probably means that the DS has already been disabled due to an error either detected by the MDS or reported to the MDS by a client. +.Pp +The pNFS service should continue to run normally so long as the number of +operational DSs is at least as many as the level of mirroring. .El .Sh SEE ALSO .Xr pnfsdscopymr 1 ,