mkfs.mse [-c <in.conf>] [-f]
The 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 books
and
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.
-c <in.conf>
The configuration file to use. See the MSE documentation for details of the configuration file.
-f
Use the force option. This overrides the error of previous existing configuration.
-r
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.