20.4. Enabling Management Encryption


Red Hat recommends enabling both management and I/O encryption, but if you only want to use I/O encryption, you can skip this section and continue with Section 20.3.1, “Enabling I/O Encryption”.

Prerequisites

  • Enabling management encryption requires that storage servers are offline. Schedule an outage window for volumes, applications, clients, and other end users before beginning this process. Be aware that features such as snapshots and geo-replication may also be affected by this outage.

Procedure 20.7. Enabling management encryption

  1. Prepare to enable encryption

    1. Unmount all volumes from all clients

      Run the following command on each client, for each volume mounted on that client.
      # umount mount-point
    2. Stop NFS Ganesha or SMB services, if used

      Run the following command on any gluster server to disable NFS-Ganesha.
      # systemctl stop nfs-ganesha
      Run the following command on any gluster server to stop SMB.
      # systemctl stop ctdb
    3. Unmount shared storage, if used

      Run the following command on all servers to unmount shared storage.
      # umount /var/run/gluster/shared_storage

      Note

      With the release of 3.5 Batch Update 3, the mount point of shared storage is changed from /var/run/gluster/ to /run/gluster/ .

      Important

      Features that require shared storage, such as snapshots and geo-replication, may not work until after this process is complete.
    4. Stop all volumes

      Run the following command on any server to stop all volumes, including the shared storage volume.
      # for vol in `gluster volume list`; do gluster --mode=script volume stop $vol; sleep 2s; done
    5. Stop gluster services on all servers

      For Red Hat Enterprise Linux 7 based installations:
      # systemctl stop glusterd
      # pkill glusterfs
      For Red Hat Enterprise Linux 6 based installations:
      # service glusterd stop
      # pkill glusterfs

      Important

      Red Hat Gluster Storage is not supported on Red Hat Enterprise Linux 6 (RHEL 6) from 3.5 Batch Update 1 onwards. See Version Details table in section Red Hat Gluster Storage Software Components and Versions of the Installation Guide
  2. Create and edit the secure-access file on all servers and clients

    Create a new /var/lib/glusterd/secure-access file. This file can be empty if you are using the default settings.
    # touch /var/lib/glusterd/secure-access
    Your Certificate Authority may require changes to the SSL certificate depth setting, transport.socket.ssl-cert-depth, in order to work correctly. To edit this setting, add the following line to the secure-access file, replacing n with the certificate depth required by your Certificate Authority.
    echo "option transport.socket.ssl-cert-depth n" > /var/lib/glusterd/secure-access
  3. Clean up after configuring management encryption

    1. Start the glusterd service on all servers

      For Red Hat Enterprise Linux 7 based installations:
      # systemctl start glusterd
      For Red Hat Enterprise Linux 6 based installations:
      # service glusterd start

      Important

      Red Hat Gluster Storage is not supported on Red Hat Enterprise Linux 6 (RHEL 6) from 3.5 Batch Update 1 onwards. See Version Details table in section Red Hat Gluster Storage Software Components and Versions of the Installation Guide
    2. Start all volumes

      Run the following command on any host to start all volumes including shared storage.
      # for vol in `gluster volume list`; do gluster --mode=script volume start $vol; sleep 2s; done
    3. Mount shared storage, if used

      Run the following command on all servers to mount shared storage.
      # mount -t glusterfs hostname:/gluster_shared_storage /run/gluster/shared_storage
    4. Restart NFS Ganesha or SMB services, if used

      Run the following command on any gluster server to start NFS-Ganesha.
      # systemctl start nfs-ganesha
      Run the following command on any gluster server to start SMB.
      # systemctl start ctdb
    5. Mount volumes on clients

      The process for mounting a volume depends on the protocol your client is using. The following command mounts a volume using the native FUSE protocol.
      # mount -t glusterfs server1:/testvolume /mnt/glusterfs
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.