Install Stork

You can install Stork with or without Portworx Enterprise using the following methods:

Deployment method without Portworx Enterprise

To install Stork version 23.9.1 on your Kubernetes cluster without installing Portworx Enterprise, run the below commands:

1. Download the Stork deployment spec:

curl -fsL -o stork-spec.yaml "https://install.portworx.com/pxbackup?comp=stork&storkNonPx=true"

2. In the stork-spec.yaml, change the Stork version to 23.9.1 if the version differs.

3. Apply the stork-spec.yaml to install the latest Stork version:

kubectl apply -f stork-spec.yaml

Deployment Method with Portworx Enterprise

If you have to install Stork 23.9.1 along with Portworx Enterprise, you can opt-in for Daemonset installation or Portworx Operator installation:

Portworx DaemonSet installation

To install Stork using Daemonset installation method:

1. Fetch the Kubernetes version and then download stork-spec.yaml:

KBVER=$(kubectl version --short | awk -Fv '/Server Version: /{print $3}')
curl -fsL -o stork-spec.yaml "https://install.portworx.com/pxbackup?kbver=${KBVER}&comp=stork"

2. Apply the stork-spec.yaml with the below command:

kubectl apply -f stork-spec.yaml

Portworx Operator installation

Stork fresh installation for Portworx Backup through user interface

If Stork is not installed as part of Portworx deployment, perform the following steps:

1. From the home page, click Add cluster.

2. Choose your Kubernetes platform.

3. Provide cluster name and Kubeconfig details.

4. Click Px-cluster to copy the stork installation command.

5. Run the Stork installation command.

note

If Stork is installed through PX Cluster option from the user interface in a namespace other than the namespace where Portworx Enterprise is deployed, perform Step 6 or else go to Step 7.

7. Update the following key-value pairs in stork deployment's (stork-spec.yaml) environment variable section, using kubectl edit command.

kubectl edit deployment stork -n <stork-namespace>

env:
      - name: PX_NAMESPACE
        value: <portworx-deployed-namespace>
      - name: PX_SERVICE_NAME
        value: portworx-api
      - name: STORK-NAMESPACE
        value: portworx

8. Click Add Cluster.

Updating Stork deployment for Portworx Backup through user interface

Perform the below steps to update Stork installation using Portworx operator option:

1. Edit the stc (Kubernetes resource):

kubectl edit stc -n <portworx-deployed-namespace>

2. Append the Stork image and version details in Stork section:

   stork:
      args:
        webhook-controller: "true"
      enabled: true
      image: openstorage/stork:23.9.1
3. Save and exit.

Stork install for air-gapped environments

If your application cluster is air-gapped, then you must pull the following images before installing Stork:

• openstorage/cmdexecutor:23.9.1
• openstorage/stork:23.9.1
• openstorage/kopiaexecutor:1.2.10
• openstorage/nfsexecutor:1.2.10

1. Push the above images to your internal registry server, accessible by the air-gapped nodes.

2. After pushing the images, follow the instructions in How to install Stork based on your deployment methods to install your stork version.