Now that we are familiar with the environment, lets install portworx! The first step is to deploy a dedicated KVDB in this environment.

The KVDB can be built-in / portworx managed for small clusters OR we can set up our own. For this lab, lets set up a single node ETCD Cluster in this k8s environment.

Note: A sample etcd pod definition file called px-etcd.yaml is created for you in the root home directory on the master node.

Update the YAML file with the ip address of node03 and create the deployment.

Once done, run the below command to install etcd.

kubectl create -f px-etcd.yaml

Warning: Do not change anything else in the px-etcd.yaml file provided other than what has been mentioned below.

Name: px-etcd

Status: Running

Node: node03

kubectl -n kube-system get pods px-etcd -o wide

Now that we have a working KVDB, let's set up a Portworx cluster. To do this, we will make use of the px-spec.yaml.

Update the YML file located at /root/px-spec.yaml with the etcd details and drives to be added to the storage pool. Use the spec below:

1. Drives: /dev/vdb

2. KVDB: Use the ETCD endpoint from the previous step.

3. Create the Portworx cluster.

Once the YAML file is updated, run the below command to install:

kubectl create -f px-spec.yaml

Note: It can take a few minutes for the cluster to be Ready! Check that Portworx pods are running before you proceed to the next question. kubectl get pods -o wide -n kube-system -l name=portworx

Check the installation logs: PX_POD=$(kubectl get pods -l name=portworx -n kube-system -o jsonpath='{.items[0].metadata.name}'); kubectl -n kube-system logs -f $PX_POD

To exit out of the logs, press (CTRL+C)

Warning: If the Portworx cluster is set up with an incorrect px-spec.yaml file, a cleanup would be needed before you attempt to re-install!

Refer: Uninstall Portworx on K8s

Now that Portworx has been installed in the system, lets explore the cluster using pxctl utility.

Hint: You can run pxctl cli from any of the cluster nodes (node01, node02 or node03) OR you can run it from the portworx pods (label name=portworx)

Portworx on K8's Quiz

Hint: ssh -o strictHostKeyChecking=no node01 pxctl status