mkfs.mse [-c <in.conf>] [-f]
mkfs.mse utility creates and initializes the data files and
stores for use with Massive Storage Engine. It reads the configuration
file that describes the disks and paths to be used for
stores. This utility needs to be run once before starting
varnishd with MSE for the first time.
mkfs.mse will report an error if valid data files are found in the
locations pointed to in the configuration file, and refuse to
overwrite the existing data. Use the
-f force flag to override the
error. This will clear the cache completely, leaving an empty cache
when Varnish is started.
mkfs.mse can extend an already existing MSE configuration using the
-r option. This option will create new books and resize certain files,
such as journals.
Note that books and stores need to be placed on
ext4 volumes. Other filesystems have been found to create fragmentation and performance issues which are illusive to diagnose. In particular, XFS’s block preallocation defeats techniques MSE uses. NFS suffers from the same issue, adding network latency on top of it.
The configuration file to use. See the MSE documentation for details of the configuration file.
Use the force option. This overrides the error of previous existing configuration.
Use the reconfigure option. This enables creating new books and resizing ban-file and store journals in an existing MSE configuration. With the reconfigure option, both books and stores will be recreated if the books are missing, but not when stores are missing.