.. role:: ref(emphasis)

.. _mkfs.mse(1):

========
mkfs.mse
========

-------------------------------
Massive Storage Engine mkfs.mse
-------------------------------

:Manual section: 1

SYNOPSIS
========

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

DESCRIPTION
===========

The `mkfs.mse` utility creates and initializes the data files and
stores for use with Massive Storage Engine. It reads a provided
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 existing (and 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.

OPTIONS
=======

-c <in.conf>

  Specify the configuration file to use. See the :ref:`varnish-mse(7)`
  manpage for details of the configuration file.

-f

  Use the force option. This overrides the error that prevents accidentally
  re-creating the MSE data files of an existing configuration.

-r

  Use the reconfigure option. This enables creating new books and resizing
  ban-file and store journals in an existing MSE configuration.

SEE ALSO
========

* :ref:`varnish-mse(7)`


COPYRIGHT
=========

* Copyright (c) 2020 Varnish Software

* Author: Martin Blix Grydeland <martin@varnish-software.com>
