Languages

Xsan: How to repair the filesystem

Learn how to repair Xsan filesystems using cvfsck.

How to determine if an Xsan filesystem is damaged

Note: Unmount and stop your Xsan filesystem before checking or repairing it. Running cvfsck on filesystems that are mounted may result in incorrect indications that the filesystem is corrupted.

Use these commands in Terminal:

sudo cvfsck -j VolumeName
sudo cvfsck -nv VolumeName

Replace VolumeName with the actual name of the Xsan volume.

While cvfsck is running, it will produce verbose statistics about the state of the filesystem. After the statistics, there may be an alert that the filesystem has been modified. Such an alert does not mean that the filesystem has been repaired, but rather that it will need to be repaired. In this case, you should continue with the next set of steps, in accordance with the version of Xsan you're using.

If you are concerned that the filesystem status is reported as "Clean" or "Dirty", please see this article.

How to repair a damaged Xsan filesystem

Note: See the section below if you are using Xsan 1.2 or earlier.

  1. Use Xsan Admin to unmount the volume from the Metadata Controllers and from the Xsan client units.
  2. In Xsan Admin, stop the Xsan volume.
  3. On a Metadata Controller, open Terminal.
  4. Execute the following command, and authenticate when prompted:
    sudo cvfsck -wv VolumeName

    When cvfsck exits, it will report that the filesystem was modified.

  5. Run the following command to ensure that the repair process was complete:
    sudo cvfsck -nv VolumeName

    At this point, if cvfsck reports that the filesystem was modified or would have been modified, you should contact Apple support.

Xsan 1.2 or earlier steps

  1. Use Xsan Admin to unmount the volume from the Metadata Controllers and from the Xsan client units.
  2. In Xsan Admin, stop the Xsan volume.
  3. On a Metadata Controller, open Terminal.
  4. Execute the following commands one at a time, and authenticate when prompted:
    cd /Library/Filesystems/Xsan/bin
    sudo ./cvfsck -j VolumeName
    sudo ./cvfsck VolumeName

    When cvfsck exits, it will report that the filesystem was modified.

  5. Run the following command to ensure that the repair process was complete:
    sudo cvfsck -nv VolumeName

    At this point, if cvfsck reports that the filesystem was modified or would have been modified, you should contact Apple support.

 

Last Modified: Sep 14, 2012
Helpful?
Yes
No
Not helpful Somewhat helpful Helpful Very helpful Solved my problem
Print this page
  • Last Modified: Sep 14, 2012
  • Article: HT1081
  • Views:

    88147
  • Rating:
    • 61.0

    (576 Responses)
Start a Discussion
in Apple Support Communities
See all questions on this article See all questions I have asked