mirror of
https://github.com/hackacad/bastille.git
synced 2025-12-16 07:15:49 +01:00
47 lines
2.3 KiB
ReStructuredText
47 lines
2.3 KiB
ReStructuredText
ZFS Support
|
|
====================
|
|
.. image:: /images/bastillebsd-twitter-poll.png
|
|
:width: 400
|
|
:alt: Alternative text
|
|
|
|
Bastille 0.4 added initial support for ZFS. ``bastille bootstrap`` and ``bastille create`` will generate ZFS volumes based on settings found in the ``bastille.conf``. This section outlines how to enable and configure Bastille for ZFS. As of Bastille 0.13 you no longer need to do these steps manually. The setup program when you run:
|
|
|
|
.. code-block:: shell
|
|
bastille setup
|
|
|
|
will create the zfs settings for you IF you are running zfs. This section is left in the documents for historical purposes, and so you can understand what the setup program is doing AND so if you need to tweak your settings for some reason.
|
|
|
|
Two values are required for Bastille to use ZFS. The default values in the ``bastille.conf`` are NO and empty. Populate these two to enable ZFS.
|
|
|
|
.. code-block:: shell
|
|
|
|
## ZFS options
|
|
bastille_zfs_enable="" ## default: "NO"
|
|
bastille_zfs_zpool="" ## default: ""
|
|
bastille_zfs_prefix="bastille" ## default: "${bastille_zfs_zpool}/bastille"
|
|
bastille_zfs_options="-o compress=lz4 -o atime=off" ## default: "-o compress=lz4 -o atime=off"
|
|
|
|
Example
|
|
|
|
.. code-block:: shell
|
|
|
|
ishmael ~ # sysrc -f /usr/local/etc/bastille/bastille.conf bastille_zfs_enable=YES
|
|
ishmael ~ # sysrc -f /usr/local/etc/bastille/bastille.conf bastille_zfs_zpool=ZPOOL_NAME
|
|
|
|
Replace ``ZPOOL_NAME`` with the zpool you want Bastille to use. Tip: ``zpool list`` and ``zpool status`` will help.
|
|
If you get 'no pools available' you are likely not using ZFS and can safely ignore these settings.
|
|
|
|
By default, bastille will use ``ZPOOL_NAME/bastille`` as its working zfs dataset. If you want it to use a specific dataset
|
|
on your pool, set ``bastille_zfs_prefix`` to the dataset you want bastille to use. DO NOT include the pool name.
|
|
|
|
Example
|
|
|
|
.. code-block:: shell
|
|
|
|
ishmael ~ # sysrc -f /usr/local/etc/bastille/bastille.conf bastille_zfs_prefix=apps/bastille
|
|
|
|
The above example will set ``ZPOOL_NAME/apps/bastille`` as the working zfs dataset for bastille.
|
|
|
|
Bastille will mount the datasets it creates at ``bastille_prefix`` which defaults to ``/usr/local/bastille``
|
|
If this is not desirable, you can change it at the top of the config file.
|