Skip to content

update.flexfs

update.flexfs is a manual update utility that installs the latest mount client binary and unmounts active mounts; add --mount to remount fstab entries after updating. It provides an alternative to the automatic update mechanism built into mount.flexfs. Requires root privileges.

Terminal window
sudo update.flexfs [flags]

All flags are public.

FlagTypeDefaultDescriptionVisibility
--forceboolfalseForce update and perform a hard resetPublic
--mount, -mboolfalseMount /etc/fstab entries after updatePublic
--reportErrorsboolfalseReport errors and panics to Paradigm4Public

The flags above apply to the default update action. They are not accepted by the version subcommand.

SubcommandDescriptionVisibility
versionPrint the build versionPublic

Invoked with no subcommand, update.flexfs runs the update described below.

Terminal window
update.flexfs version
  1. Install: Downloads and installs the latest mount.flexfs binary to /sbin/mount.flexfs.
  2. Unmount: Attempts to cleanly unmount all active flexFS mounts.
  3. Remount (with --mount): Re-mounts all fstab entries.

If clean unmounting fails for any mount point:

  • Without --force: The utility prints an error and suggests closing processes or using --force.
  • With --force: Performs a hard reset that kills all mount users and clients, resets mount points, clears caches and logs, and remounts fstab entries.

If there were no active mounts to begin with, the utility reports No active mounts found and runs the same hard reset sequence, whether or not --force was given. Nothing is mounted for it to disturb, but it still clears the cache and log directories left behind by previous mounts and recreates the fstab mount point directories — so capture any mount logs you still need before running it.

The hard reset sequence, which also runs when there are no active mounts:

  1. Kill all processes using flexFS mount points (fuser -k)
  2. Kill all mount.flexfs processes (pkill -KILL mount.flexfs)
  3. Unmount and recreate all fstab mount point directories
  4. Clear caches from /dev/shm/.flexfs* and the mount cache directory
  5. Clear log files
  6. Remount fstab entries (if --mount is set)

Step 1 requires fuser on the host. Without it the reset fails, in either of the cases that reach it.