Install Portworx on Kubernetes using Rancher 2.x


This guide provides instructions for installing Portworx on Kubernetes using Rancher 2.x with a Helm chart available from the public catalog.

NOTE: Currently, Portworx does not support the RancherOS distro.

Prerequisites

  • You must have a Kubernetes cluster imported into Rancher
  • Your cluster must meet the requirements for installing a Portworx cluster

Install Portworx on Kubernetes using Rancher 2.x

Perform the following steps to install Portworx:

  1. Go to your cluster, and then select the System namespace. The following screenshot uses a cluster named dev as an example:

    Screenshot showing the System namespace

  2. From the top navigation bar, select Apps:

    Screenshot showing the Apps menu location

  3. Select the Launch button to open the catalog:

    Screenshot showing the Launch button menu location

  4. Search for the Portworx catalog and select the Portworx card to start the Helm chart form:

    Screenshot showing how to Launch the Portworx Helm chart

  5. Populate the various required sections of the Configuration Options of the Helm chart form:

    • In the Key Value Store Paramters section, specify an internal or external ETCD.

      Screenshot showing the KVDB section of the Helm chart form

    • In the Storage Parameters section, specify whether your cluster is located on-prem or on a cloud provider, and choose your disk configuration.

      Screenshot showing the Storage Parameters section of the Helm chart form

  6. Select the Launch button to deploy Portworx to your cluster:

    Screenshot showing the launch button of the Helm chart form

    Depending on your network and cluster performance, it may take between 5 and 20 minutes to install Portworx. Once the installation is completed, the Portworx processes will be shown as green.

Post-Install

Once you have a running Portworx installation, below sections are useful.

Upgrade

Follow these steps to upgrade Portworx on Kubernetes using Rancher 2.x:


Last edited: Wednesday, May 20, 2020