Skip to main content
Version: 3.3

Prepare your Portworx cluster

important

In case of bare metal setups, you don't need to configure the portworx-api service type as LoadBalancer. However, ensure that the portworx-api and portworx-service services are present in your cluster and the Portworx cluster is in a healthy state.

You must configure an external load balancer for the Portworx API service on your source and destination clusters, as you are running Portworx in the cloud. An external load balancer is necessary because it assigns a public IP address for accessing Portworx on port 9001 from your worker nodes.

caution

It is recommended that you enable authorization on your Portworx cluster before enabling a load balancer.

Enable load balancing by running the kubectl edit stc command and adding the annotation to change the service type value from nodePort to LoadBalancer as shown below:

kubectl edit stc <stc-name> -n <namespace>
apiVersion: core.libopenstorage.org/v1
kind: StorageCluster
metadata:
  annotations:
    portworx.io/service-type: "portworx-api:LoadBalancer"
...

You can verify the changes using the kubectl get service command.

kubectl get service -n <namespace>
NAME                        TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                                        AGE
portworx-service            LoadBalancer   10.233.56.13    192.0.2.20     9001:30278/TCP,9020:30908/TCP,9021:32598/TCP   18h

Install storkctl​

Stork is Portworx's storage scheduler, offering seamless integration between Portworx and your orchestrator (Kubernetes or OpenShift). It allows you to co-locate pods with their data, provides seamless migration of pods in case of storage issues, and makes it easier to create and restore snapshots of Portworx volumes. storkctl is a command-line tool for interacting with Stork. Install storkctl on both clusters after installing Portworx.

important

Always use the latest storkctl binary tool by downloading it from the currently running Stork container.

Perform the following steps to download storkctl from the Stork pod:

  • Linux:

    STORK_POD=$(kubectl get pods -n <namespace> -l name=stork -o jsonpath='{.items[0].metadata.name}') &&
    kubectl cp -n <px-namespace> $STORK_POD:/storkctl/linux/storkctl ./storkctl
    sudo mv storkctl /usr/local/bin &&
    sudo chmod +x /usr/local/bin/storkctl

  • OS X:

    STORK_POD=$(kubectl get pods -n <namespace> -l name=stork -o jsonpath='{.items[0].metadata.name}') &&
    kubectl cp -n <px-namespace> $STORK_POD:/storkctl/darwin/storkctl ./storkctl
    sudo mv storkctl /usr/local/bin &&
    sudo chmod +x /usr/local/bin/storkctl

  • Windows:

    1. Copy storkctl.exe from the stork pod:

      STORK_POD=$(kubectl get pods -n <px-namespace> -l name=stork -o jsonpath='{.items[0].metadata.name}') &&
      kubectl cp -n <px-namespace> $STORK_POD:/storkctl/windows/storkctl.exe ./storkctl.exe

    2. Move storkctl.exe to a directory in your PATH.