^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) ==================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) pNFS SCSI layout server user guide
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) ==================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) This document describes support for pNFS SCSI layouts in the Linux NFS server.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) With pNFS SCSI layouts, the NFS server acts as Metadata Server (MDS) for pNFS,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) which in addition to handling all the metadata access to the NFS export,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) also hands out layouts to the clients so that they can directly access the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) underlying SCSI LUNs that are shared with the client.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) To use pNFS SCSI layouts with the Linux NFS server, the exported file
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) system needs to support the pNFS SCSI layouts (currently just XFS), and the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) file system must sit on a SCSI LUN that is accessible to the clients in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) addition to the MDS. As of now the file system needs to sit directly on the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) exported LUN, striping or concatenation of LUNs on the MDS and clients
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) is not supported yet.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) On a server built with CONFIG_NFSD_SCSI, the pNFS SCSI volume support is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) automatically enabled if the file system is exported using the "pnfs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) option and the underlying SCSI device support persistent reservations.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) On the client make sure the kernel has the CONFIG_PNFS_BLOCK option
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) enabled, and the file system is mounted using the NFSv4.1 protocol
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) version (mount -o vers=4.1).