Skip to main content
Version: 3.1

ROSA prerequisites

Installation Prerequisites

The minimum supported size for a Portworx cluster is three nodes. Each node must meet the following hardware, software, and network requirements:

Hardware
CPU4 cores minimum, 8 cores recommended
RAM4GB minimum, 8GB recommended
Disk
  • /var
  • /opt
  • 2GB free
  • 3GB free
Backing drive8GB (minimum required)
128 GB (minimum recommended)
Operating system root partition64 GB is the minimum required size for the root filesystem which contains the operating system
128 GB minimum recommended
Storage drivesStorage drives must be unmounted block storage: raw disks, drive partitions, LVM, or cloud block storage.
Network connectivityBandwidth:
  • 10 Gbps recommended
  • 1 Gbps minimum

Latency requirements for synchronous replication: less than 10ms between nodes in the cluster
Node typeBare metal and virtual machine (VM)
Software
Linux kernel and distroKernel version 3.10 or greater.
To check if your Linux distro and kernel are supported, see Supported Kernels.
DockerVersion 1.13.1 or greater.
Key-value storePortworx needs a key-value store to perform its operations. As such, install a clustered key-value database (kvdb) with a three node cluster.

You can also use Internal KVDB during installation. In this mode, Portworx will create and manage an internal key-value store (KVDB) cluster.

If you plan of using your own KVDB, refer to KVDB for Portworx for details on recommendations for installing and configuring a KVDB cluster.
Disable swapDisable swap on all nodes that will run the Portworx software. Ensure that the swap device is not automatically mounted on server reboot.
Network Time Protocol (NTP)All nodes in the cluster should be in sync with NTP time. Any time drift between nodes can cause unexpected behaviour, impacting services.

Portworx network requirements

note

Portworx also requires the following ports:

  • An open KVDB port. For example, if you're using etcd externally, open port 2379.
  • An open UDP port at 17002.

Portworx ports for east to west traffic

Supported disk types

Cloud providerDisk types
AWS
  • GP2
  • GP3
  • IO1

Supported Kubernetes versions

Before you install Portworx on Kubernetes, ensure that you're using a supported Kubernetes version:

Supported Kubernetes Version
  • ROSA 4.12: (Verified up to 4.12.51)
  • ROSA 4.13: (Verified up to 4.13.44)
  • ROSA 4.14: (Verified up to 4.14.31)
  • ROSA 4.15: (Verified up to 4.15.20)
  • ROSA 4.16: (Verified up to 4.16.0)
  • NOTE:
    • For ROSA 4.16, Portworx Enterprise 3.1.3 or newer and Operator 24.1.1 or newer are required
    .

Best practices

Prevent Accidental Deletion: If your virtualization software has a feature to prevent accidental deletion, you should enable it for the instances hosting PX nodes. While PX is designed to handle the loss of some nodes without issue, losing a significant number of storage nodes due to instance deletion can result in a loss of quorum and an outage. For more information on how to prevent accidental deletion of instance, refer to Enable termination protection on Amazon EC2 instance.

Was this page helpful?