Installing FlexRAID on OpenMediaVault (OMV)

NOTICE: This tutorial is old and obsolete. It will soon be removed. Please follow this newer tutorial on installing FlexRAID RAID-F on OMV:

============================================= OLD =========================================

Courtesy of:;u=2530

This tutorial covers the integration of FlexRAID into OpenMediaVault (OMV).
Specifically, we are integrating FlexRAID 2.0u6 with OMV 0.2.7 (with 0.3 currently in beta as of April, 30th 2012).
Do check both projects for their latest releases.

For brevity, the test bed used as example in this document will have 2 DRUs and 1 PPU.
Although OMV mandates a plugin system for its integrations, there is no plugin to configure when it comes to FlexRAID as all configurations can be done through FlexRAID WebUI.

As a prerequisite, download and install OMV as documented on the product’s setup pages.

Configuring OMV and preparing it for FlexRAID

Part I. Enabling remote access and formatting your drives (configurations done through OMV’s GUI):

  1. Update your OMV system OS using the update manager
  2. Enable SSH in the “Service/SSH” configuration section
  3. In the “Storage/Filesystems” section, format and label your drives (BUT DO NOT MOUNT THEM! – OMV mounting options may cause issues with FlexRAID). For this example we are using ext4 for filesystem format and labels DATA1, DATA2, PARITY1 for the DRUs and PPU respectively.

Part II. Preliminary system wide configurations (SSH to your OMV server as root):

  1. In a shell prompt, execute: apt-get update
  2. Then, execute (ia32-libs is required only for the x64 version of OMV): apt-get install default-jre fuse-utils ia32-libs
  3. Change to /media (cd /media) and “mkdir DATA1 DATA2 PARITY1” (1 directory for each HDD to be managed).
  4. Edit /etc/fstab and add the entries as shown below:
  5. Edit /etc/fuse.conf and uncomment “user_allow_other”
  6. Execute “chmod g+w” on /etc/fuse.conf
  7. Edit /etc/sudoers and add the lines as shown below if missing:

  8. Reboot your system

Part III. Creating a “flexraid” user account:

  1. Open OMV’s GUI and ensure that the drives you formatted and labelled in Part I are visible in the “Storage/Filesystems” section.
  2. In “Access Right management / User”, create a new user (“flexraid” in this example). Although this can be done through the shell using the “adduser” or “useradd” commands, you won’t be able to see your user in the OMV Access right management interface. So, it is best to do this configuration through the UI.

Part IV. System configuration for the “flexraid” account:

  1. Execute “sudo usemod -G fuse flexraid” to add the “flexraid” user to Fuse group (Fuse group doesn’t appear in OMV UI)
  2. Execute “sudo usemod -G fuse root” to add the “root” user to Fuse group
  3. Change to /media (cd /media)
  4. Execute “sudo chown -R flexraid:fuse DATA1 DATA2 PARITY1” to make the user “flexraid” owner of mounted volumes
  5. Execute “sudo chmod -R g+w DATA1 DATA2 PARITY1” to give writing rights to Fuse group on mounted volumes
  6. Change to the “flexraid” user’s home directory
  7. Execute “mkdir flx” to create an installation directory named “flx” in /home/flexraid (better for right management issues)
  8. “wget <release download url>” (consult for the latest release links)
  9. After downloading, you can optionally check the hash of the downloaded file (you will need to install md5sum under OMV)
  10. Make the downloaded file executable by typing “chmod a+x FlexRAID-*”
  11. Execute the downloaded file (./FlexRAID-*)
  12. When prompted, specify your desired installation directory (for this example, we are using /home/flexraid/flx)
  13. Note: FlexRAID comes with FUSE libraries compiled for its runtime. Do not symbolically link those libraries to your system FUSE libraries.
  14. Reboot your system

Configuring FlexRAID

  1. Remote into your OMV system under the “flexraid” account
  2. Start FlexRAID (cd /home/flexraid/flx && ./FlexRAID)
    * It’s possible with scripts used for Ubuntu or Zyental to force FlexRAID running at boot.
    * It’s also possible to login with the “flexraid” user at boot (Google: “autologin linux console mode”).
    * YOU CAN’T RUN FlexRAID with the OMV UI user (“admin”). You need to start a local session on physical OMV server with the “flexraid” user.
  3. Connect to the FlexRAID WebUI (http://<host>:8080)
  4. Activate your installation or import your registration key
  5. Ensure that the sudo password has been set and is reflected in the System Control Panel (if not, set it)
  6. Create your RAID configuration (See
    For our example, will create a simple CruiseControl Snapshot RAID:

  7. Initialize your RAID and enjoy!
Be Sociable, Share!

9 Responses to “Installing FlexRAID on OpenMediaVault (OMV)”

  1. Jake October 21, 2013 at 10:47 PM #

    I have a question for Par 1 step 4. Is there a typo “defaults/relatime”? Should it be “defaults/realtime”?

  2. Jake October 21, 2013 at 10:50 PM #

    I need to re-edit. Should be Part II and “defaults,relatime” vs “defaults,realtime”.

  3. Jake October 21, 2013 at 11:04 PM #

    Possible typo:
    Part IV, step 1 and 2.
    “sudo usemod -G fuse flexraid”
    “sudo usermod -G fuse flexraid”

  4. Jake October 21, 2013 at 11:12 PM #

    Part III, step 2:
    When adding user, I dont have “Home directory”.
    This also prevents me from moving pass Part IV step 6. I’m stuck.

  5. Jake October 21, 2013 at 11:33 PM #

    It appears that in order to have a /home director, I might need to mount a file system. The only file systems I created are from Part I (which are large drives, and not the system drive).

  6. Jake October 21, 2013 at 11:51 PM #

    Part IV step 8 is out of date.

  7. Jake October 22, 2013 at 12:12 AM #

    I tried working through the above issues. When starting FlexRaid I receive “FlexRAID initialized with errors”, and nothing else happens. There’s no details of the errors on the screen.

    The log file says “FileNotFoundException: /home/flexraid/”
    I also get a permission denied error after “Scheduler flexraid_$_1 started”.

  8. fubz November 21, 2015 at 2:56 PM #

    Part IV step 1 and 2 typos are still there…….

Leave a Reply