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. Navigate to the global cluster overview page. From the top navigation bar, select Apps:

    Screenshot showing the location of the apps tab in Rancher

  2. Select the Launch button to open the catalog:

    Screenshot showing the launch button location

  3. Search for the Portworx catalog and select the View Details button to start the Helm chart form:

    Screenshot indicating the search and select locations

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

    • In the Configuration Options section, name your project kube-system, and select System from the Target Projects dropdown:

      Screenshot showing 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

  5. 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: Tuesday, Jan 7, 2020