First published on MSDN on Dec 05, 2013
Cluster Shared Volumes (CSV) is the clustered file system for the Microsoft Private cloud, first introduced in Windows Server 2008 R2. In Windows Server 2012, we radically improved the CSV architecture. We presented a deep dive of these architecture improvements at
. Building on this new and improved architecture, in Windows Server 2012 R2, we have introduced several
new CSV features
. In this blog, I am going to discuss one of these new features – the new Get-ClusterSharedVolumeState Windows Server Failover Clustering PowerShell® cmdlet. This cmdlet enables you to view the state of your CSV. Understanding the state of your CSV is useful in troubleshooting failures as well as optimizing the performance of your CSV. In the remainder of this blog, I will explain how to use this cmdlet as well as how to interpret the information provided by the cmdlet.
The Get-ClusterSharedVolumeState cmdlet allows you to view the state of your CSV on a node in the cluster. Note that the state of your CSV can vary between the nodes of a cluster. Therefore, it might be useful to determine the state of your CSV on multiple or all nodes of your cluster.
To use the
cmdlet open a new Windows PowerShell console and run the following:
- To view the state of all CSVs on all the nodes of your cluster
- To view the state of all CSVs on a subset of the nodes in your cluster
Get-ClusterSharedVolumeState –Node clusternode1,clusternode2
- To view the state of a subset of CSVs on all the nodes of your cluster
Get-ClusterSharedVolumeState –Name “Cluster Disk 2″,”Cluster Disk 3”
Get-ClusterSharedVolume “Cluster Disk 2” | Get-ClusterSharedVolumeState
Understanding the state of your CSV
The Get-ClusterSharedVolumeState cmdlet output provides two important pieces of information for a particular CSV – the state of the CSV and the reason why the CSV is in that particular state. There are three states of a CSV – Direct, File System Redirected and Block Redirected. I will now examine the output of this cmdlet for each of these states.
In Direct Mode, I/O operations from the application on the cluster node can be sent directly to the storage. It therefore, bypasses the NTFS or ReFS volume stack.
File System Redirected Mode
In File System Redirected mode, I/O on a cluster node is redirected at the top of the CSV pseudo-file system stack over SMB to the disk. This traffic is written to the disk via the NTFS or ReFS file system stack on the coordinator node.
- When a CSV is in File System Redirected Mode, I/O for the volume will not be cached in the
CSV Block Cache
- Data deduplication occurs on a per file basis. Therefore, when a file on a CSV volume is deduped, all I/O for that file will occur in File System Redirected mode. I/O for the file will not be cached in the CSV Block Cache – it will instead be cached in the Deduplication Cache. For the remaining non-deduped files, CSV will be in direct mode. The state of the CSV will be reflected as being in
- The Failover Cluster Manager will show a volume as in
only when it is in File System Redirected Mode and the
Block Redirected Mode
In Block level redirected mode, I/O passes through the local CSVFS proxy file system stack and is written directly to Disk.sys on the coordinator node. As a result it avoids traversing the NTFS/ReFS file system stack twice.
In conclusion, the Get-ClusterSharedVolumeState cmdlet is a powerful tool that enables you to understand the state of your Cluster Shared Volume and thus troubleshoot failures and optimize the performance of your private cloud storage infrastructure.
Senior Program Manager
Clustering and High Availability