Portworx Documentation has moved to https://docs.portworx.com
Portworx Enterprise version 2.13 has reached end of life and end of extended maintenance. Refer to the release support policy doc here.
Upgrade to the latest version of Portworx Enterprise for continued support. Documentation for the latest version of Portworx Enterprise can be found here.

Install Portworx on Kubernetes using Rancher


This guide provides instructions for installing Portworx on Kubernetes using Rancher with a Helm chart.

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

Perform the following steps to install Portworx from your Rancher UI:

  1. From your Cluster Dashboard, click App in the left pane to open the Charts page:

    Rancher Dashboard

  2. Search for the Portworx catalog and select the Portworx card on the Charts page:

    Search Portworx

  3. Choose the latest version from the Chart Versions list and then click the Install button in the upper-right corner to start the Helm chart form:

    Install Portworx

  4. Choose the kube-system namespace from the drop-down list and click Next:

    Portworx Namespace

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

    • In the Key value store parameters section, choose Built-in option for the Select ETCD filed.

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

      Portworx-parameters

    • Do not change the Portworx version in the Portworx version to be deployed field of Advanced parameters. Advance parameters

  6. Click the Install button in the bottom-right corner to deploy Portworx.

    Once the installation is completed, the Portworx status will be shown as Deployed.

Post-Install

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


Last edited: Tuesday, May 16, 2023