1.\" Copyright (c) 2018 Rick Macklem 2.\" 3.\" Redistribution and use in source and binary forms, with or without 4.\" modification, are permitted provided that the following conditions 5.\" are met: 6.\" 1. Redistributions of source code must retain the above copyright 7.\" notice, this list of conditions and the following disclaimer. 8.\" 2. Redistributions in binary form must reproduce the above copyright 9.\" notice, this list of conditions and the following disclaimer in the 10.\" documentation and/or other materials provided with the distribution. 11.\" 12.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 13.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 14.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 15.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 16.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 17.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 18.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 19.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 20.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 21.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 22.\" SUCH DAMAGE. 23.\" 24.\" $FreeBSD$ 25.\" 26.Dd March 9, 2018 27.Dt PNFSDSKILL 8 28.Os 29.Sh NAME 30.Nm pnfsdskill 31.Nd 32disables a pNFS data storage server (DS) 33.Sh SYNOPSIS 34.Nm 35.Ar mounted-on-DS-dir 36.Sh DESCRIPTION 37The 38.Nm 39command disables one DS when mirroring is enabled. 40If one mirrored DS is malfunctioning, a system administrator 41may use this command on the metadata server (MDS) to disable use of this mirror. 42This command must be used on the MDS and the 43.Ar mounted-on-DS-dir 44must be the exact pathname used when mounting the DS on the MDS. 45.Pp 46If this command fails with 47.Dq Device not configured 48(ENXIO), it probably 49means that the DS has already been disabled due to an error either detected 50by the MDS or reported to the MDS by a client. 51.Pp 52The pNFS service should continue to run normally so long as the number of 53operational DSs is at least as many as the level of mirroring. 54.El 55.Sh SEE ALSO 56.Xr nfsv4 4 , 57.Xr pnfs 4 , 58.Xr nfsd 8 , 59.Xr pnfsdscopymr 8 , 60.Xr pnfsdsfile 8 61.Sh HISTORY 62The 63.Nm 64command first appeared in 65.Fx 12.0 . 66