.. _configuring-server-conf:

==============================
Appendix: creating server.conf
==============================

The file ``server.conf`` configures a mdtmFTP server’s operation
parameters. It is used for mdtmFTP server with versions < 1.1.1.

Here is a sample ``server.conf`` file:

.. code-block:: ini

   blocksize 4194304
   direct 1
   splice 0
   monitor 0

* ``blocksize`` sets the block size for disk I/O operations. The block
  size should be 4K or multiple of 4k (e.g. 4M).

* ``direct`` enables direct I/O. When direct
  I/O is enabled, file reads and writes go directly from mdtmFTP to
  the storage device(s), bypassing the OS R/W caches. For bulk data 
  transfer, enabling direct I/O would improve performance.

* ``splice`` enables zero-copy by using the
  Linux splice mechanism.

* ``monitor`` enables MDTM monitoring.

.. note:: ``splice`` is an experimental feature that may not function
          well in some systems.  You can turn this feature off by
          setting splice to ``0``.