Xsan: How to automount StorNext volumes

Summary

This article describes the configuration of Xsan clients running Xsan 1.4.1 and earlier to automount filesystems hosted by Quantum StorNext Metadata Controllers. Perform these steps for each Xsan client that should mount a StorNext filesystem at startup.

To configure automounting of StorNext filesystems on Xsan 1.4.2 or later, please refer to instructions in the StorNext installation guide for your version of StorNext available at the Quantum web site.

Products Affected

Xsan 1.1, Xsan 1.2, Xsan 1.3, Xsan 1.4

  1. Ensure the StorNext filesystem will mount on the Xsan clients by following these steps.
  2. Run this command to create a directory to hold the Startup Item files:
    $ sudo mkdir -m 755 /Library/StartupItems/acfsMounter
  3. Using these guidelines, create a new file named "StartupParameters.plist".
  4. Paste these contents into the file:

    {
    Description = "ACFS File System Mounter";
    Provides = ("acfsMounter");
    OrderPreference = "Early";
    }
  5. Save the file, and put it here:
    /Library/StartupItems/acfsMounter
  6. Using these guidelines, create a new file named "acfsMounter".
  7. Paste these contents into the file, replacing [myVolume1 and myVolume2] (on the ninth and tenth lines of the script) with the name of your StorNext volumes. Additional volumes may be entered on the consecutive lines but must be included in the single quotes:
    #!/bin/sh 
    # 
    # CVFSMounter startup script for: 
    # 
    #       MacOS 
    . /etc/rc.common
    
    myVolumes='
    myVolume1
    myVolume2
    '
    
    StartService () 
    {
            local vol
            sleep 60
            ConsoleMessage "Mounting ACFS File System" 
            for vol in $myVolumes; do
                    if [ -d "/Volumes/${VOL.EN_US}" ]; then 
                            ConsoleMessage "Mountpoint already exists! Ensure that you are not mounting the volume on a preexisting mount!" 
                    else 
                            [ ! -e "/Volumes/${VOL.EN_US}" ] && mkdir -m 111 "/Volumes/${VOL.EN_US}" 
                            [ -d "/Volumes/${VOL.EN_US}" ] && mount -t acfs "${VOL.EN_US}" "/Volumes/${VOL.EN_US}" 
                            /usr/sbin/disktool -r > /dev/null 
                    fi 
            done
    } 
    StopService () 
    { 
            local vol
            for vol in $myVolumes; do
                    ConsoleMessage "Unmounting ACFS File System" 
                    /sbin/umount "/Volumes/${VOL.EN_US}" 
                    /usr/sbin/disktool -r > /dev/null 
            done
    } 
    RestartService () 
    { 
            StopService 
            StartService 
    } 
    RunService "$1"
    
  8. Save the file, and put it here:
    /Library/StartupItems/acfsMounter
  9. In the Terminal, execute these commands:
    $ sudo chown -R root:wheel /Library/StartupItems/acfsMounter 
    $ sudo chmod 755 /Library/StartupItems/acfsMounter/acfsMounter
    $ sudo chmod 644 /Library/StartupItems/acfsMounter/StartupParameters.plist
Important: Mention of third-party websites and products is for informational purposes only and constitutes neither an endorsement nor a recommendation. Apple assumes no responsibility with regard to the selection, performance or use of information or products found at third-party websites. Apple provides this only as a convenience to our users. Apple has not tested the information found on these sites and makes no representations regarding its accuracy or reliability. There are risks inherent in the use of any information or products found on the Internet, and Apple assumes no responsibility in this regard. Please understand that a third-party site is independent from Apple and that Apple has no control over the content on that website. Please contact the vendor for additional information.
Not helpful Somewhat helpful Helpful Very helpful Solved my problem