Search
Varnish Enterprise

mkfs.mse

Synopsis

mkfs.mse [-c <in.conf>] [-f]

Description

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.

Options

-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.