Preparing the nodes

Prepare your IBM® Cloud Private nodes for GlusterFS configuration.

1. On each GlusterFS storage node, complete these steps:

   a. Configure the dm_thin_pool kernel module.

    sudo modprobe dm_thin_pool
   

   b. To ensure that loading of the kernel module is persisted across reboots, add the dm_thin_pool module name to the modules file.

   • On Ubuntu, run this command:

      echo dm_thin_pool | sudo tee -a /etc/modules
     

   • On Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SLES), run this command:

     echo dm_thin_pool | sudo tee -a /etc/modules-load.d/dm_thin_pool.conf
     

     If the changes are saved correctly, the commands return the following output:

     dm_thin_pool
     

2. On each IBM Cloud Private cluster node that uses the GlusterFS volume, install the GlusterFS client.

   • On Ubuntu, run the following commands:

     sudo apt-get update
     

     sudo apt-get install glusterfs-client
     

   • On RHEL, run the following command:

     sudo yum install glusterfs-client
     

   • On SLES, run the following commands:

     zypper addrepo https://download.opensuse.org/repositories/filesystems/SLE_12_SP3/filesystems.repo
     

     zypper refresh
     

     zypper install glusterfs
     

   • On RHEL Linux® on Power® (ppc64le), first create a repository, then install GlusterFS client:

     1. Create a repository:

        [centos-gluster41]
        name=CentOS-$releasever - Gluster 4.1
        baseurl=https://buildlogs.centos.org/centos/7/storage/$basearch/gluster-4.1/
        gpgcheck=0
        enabled=1
        

     2. Install GlusterFS client:

        sudo yum install glusterfs-client
        

   • On SLES Linux® on Power® (ppc64le), first add a repository, then install GlusterFS package:

     1. Import the key:

        rpm --import https://oplab9.parqtec.unicamp.br/pub/ppc64el/glusterfs/sles/openpower-gpgkey-public.asc
        

        Check whether the key was correctly imported:

        rpm -q gpg-pubkey --qf '%{NAME}-%{VERSION}-%{RELEASE}\t%{SUMMARY}\n'
        

     2. Add the repository.

        zypper ar -t YUM https://oplab9.parqtec.unicamp.br/pub/ppc64el/glusterfs/sles/ OpenPower\ Unicamp\ Lab
        

     3. Install GlusterFS package:

        zypper install glusterfs
        

   • On SLES on IBM Z, first add a repository, then install GlusterFS package:

     1. Import the key:

        rpm --import https://oplab9.parqtec.unicamp.br/pub/key/openpower-gpgkey-public.asc
        

        Check whether the key was correctly imported:

        rpm -q gpg-pubkey --qf '%{NAME}-%{VERSION}-%{RELEASE}\t%{SUMMARY}\n'
        

     2. Add the repository.

        zypper ar -t YUM https://oplab9.parqtec.unicamp.br/pub/s390x/glusterfs/sles/12sp4/ OpenPower\ Unicamp\ Lab
        

     3. Install GlusterFS package:

        zypper install glusterfs
        

   • On RHEL on IBM Z, first add a repository, then install GlusterFS package:

     1. Import the key:

        rpm --import https://oplab9.parqtec.unicamp.br/pub/key/openpower-gpgkey-public.asc
        

        Check whether the key was correctly imported:

        rpm -q gpg-pubkey --qf '%{NAME}-%{VERSION}-%{RELEASE}\t%{SUMMARY}\n'
        

     2. Add the repository.

        yum install yum-utils && yum-config-manager --add-repo https://oplab9.parqtec.unicamp.br/pub/s390x/glusterfs/rhel/7.6/
        

     3. Install GlusterFS package:

        yum update && yum install glusterfs-client gluster-cli
        

   • On Ubuntu 18.04 on IBM Z, first add the repository, then install GlusterFS package:

     1. Add the repository.

        add-apt-repository "deb https://oplab9.parqtec.unicamp.br/pub/s390x/glusterfs/ubuntu/ bionic main"
        

     2. Install the GlusterFS package:

        apt-get update
        apt-get install glusterfs-client=4.1.5-ubuntu1~bionic1
        

        Check whether the GlusterFS package is correctly installed:

        /usr/sbin/glusterfs --version
        

   • On Ubuntu 16.04 on IBM Z, first add the repository, then install GlusterFS package:

     1. Add the repository.

        add-apt-repository "deb https://oplab9.parqtec.unicamp.br/pub/s390x/glusterfs/ubuntu/ xenial main"
        

     2. Install the GlusterFS package:

        apt-get update  
        apt-get install glusterfs-client=4.1.5-ubuntu1~xenial2
        

        Check whether the GlusterFS package is correctly installed:

        /usr/sbin/glusterfs --version