Prerequisites for deployment

Contributors juliantap

You have to install and configure the necessary protocol prerequisites on your host before you can deploy Astra Trident.

  • Verify that your deployment meets all of the requirements.

  • Verify that you have a supported version of Docker installed. If your Docker version is out of date, install or update it.

docker --version

  • Verify that the protocol prerequisites are installed and configured on your host:

Protocol Operating system Commands

NFS

RHEL/CentOS

sudo yum install -y nfs-utils

NFS

Ubuntu/Debian

sudo apt-get install -y nfs-common

iSCSI

RHEL/CentOS 7

  1. Install the following system packages:

    sudo yum install -y lsscsi iscsi-initiator-utils sg3_utils device-mapper-multipath

  2. Check that iscsi-initiator-utils version is 6.2.0.874-2.el7 or later:

    rpm -q iscsi-initiator-utils

  3. Set scanning to manual:

    sudo sed -i 's/^\(node.session.scan\).*/\1 = manual/' /etc/iscsi/iscsid.conf

  4. Enable multipathing:

    sudo mpathconf --enable --with_multipathd y --find_multipaths n

    Note Ensure etc/multipath.conf contains find_multipaths no under defaults.

  5. Ensure that iscsid and multipathd are running:

    sudo systemctl enable --now iscsid multipathd

  6. Enable and start iscsi:

    sudo systemctl enable --now iscsi

iSCSI

Ubuntu

  1. Install the following system packages:

    sudo apt-get install -y open-iscsi lsscsi sg3-utils multipath-tools scsitools

  2. Check that open-iscsi version is 2.0.874-5ubuntu2.10 or later (for bionic) or 2.0.874-7.1ubuntu6.1 or later (for focal):

    dpkg -l open-iscsi

  3. Set scanning to manual:

    sudo sed -i 's/^\(node.session.scan\).*/\1 = manual/' /etc/iscsi/iscsid.conf

  4. Enable multipathing:

    sudo tee /etc/multipath.conf <←'EOF'
    defaults {
    user_friendly_names yes
    find_multipaths no
    }
    EOF
    sudo systemctl enable --now multipath-tools.service
    sudo service multipath-tools restart

    Note Ensure etc/multipath.conf contains find_multipaths no under defaults.

  5. Ensure that open-iscsi and multipath-tools are enabled and running:

    sudo systemctl status multipath-tools
    sudo systemctl enable --now open-iscsi.service
    sudo systemctl status open-iscsi