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

    • In the Portworx version to be deployed. field, select the Portworx version you want to deploy. Currently recommended version is 2.5.1

      Screenshot showing the PX Version 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: Monday, Aug 3, 2020