Skip to content

Latest commit

 

History

History
67 lines (45 loc) · 2.5 KB

deploy_clients_2_x.md

File metadata and controls

67 lines (45 loc) · 2.5 KB
Raw

Deploy Quobyte clients

Quobyte CSI driver requires a running Quobyte client with the mount point <values.clientMountPoint>/mounts on every host node. This example deployment of clients assumes values.clientMountPoint: /mnt/quobyte

Deploy quobyte-client package (systemd service) -- Recommended

  1. Download the install_quobyte script

    wget https://support.quobyte.com/repo/3/<QUOBYTE_REPO_ID>/install_quobyte \
 && sudo chmod +x install_quobyte

  2. Install client on (remote) node

    registry-endpoints or qns-id can be found on registry nodes in /etc/quobyte/registry.cfg as registry=<registry-endpoints> and qns.id=<qns-id> respectively.

    sudo ./install_quobyte add-client --registry-endpoints <registry-endpoints> \
 --mount-point /mnt/quobyte/mounts --repo-id <QUOBYTE_REPO_ID> \
 [remote_user@remote_ip]

    If your Quobyte deployment uses QNS, you should install client with --qns-id

    sudo ./install_quobyte add-client --qns-id <qns-id> \
 --mount-point /mnt/quobyte/mounts --repo-id <QUOBYTE_REPO_ID> \
  [remote_user@remote_ip]

    To use access keys, quobyte-client.service must be started with --enable-access-contexts.

Note:

  1. remote_user must have sudo capabilities on the remote_ip node to install Quobyte client.

  2. install_quobyte uses ssh to install the Quobyte client on the remote node. So, to install client on a remote node, your base node must be able to connect the remote node using ssh.

Deploy Containerized Quobyte client

To use Quobyte volumes in Kubernetes, nodes must have a running Quobyte client with the mount point as /mnt/quobyte/mounts. Please see the example client configuration.

  1. Label Kubernetes nodes

    kubectl label nodes <node-1> <node-n> quobyte_client="true"

  2. Edit example/client.yaml and configure

    • namespace of your choice
    • QUOBYTE_REGISTRY environment variable set with Quobyte registry
    • QUOBYTE_MOUNT_POINT environment variable set to /mnt/quobyte/mounts
    • host path volume /mnt/quobyte

  3. Deploy Quobyte clients.

    kubectl create -f example/client.yaml

Note: Not deploying Quobyte clients with /mnt/quobyte/mounts results in pod start failures with mount fail errors.