Install Stork

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

Deployment method without Portworx Enterprise

To install Stork version 24.3.4 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 24.3.4 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 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 web console

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 web console in a namespace other than the namespace where Portworx Enterprise is deployed, perform Step 6 or else go to Step 7.

6. 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

7. Click Add Cluster.

Updating Stork deployment for Portworx Backup through web console

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:24.3.4

3. Save and exit.

Install Stork in air-gapped environments

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

2.8.1

Image	Version
openstorage/stork	24.3.4
openstorage/cmdexecutor	24.3.4
openstorage/kopiaexecutor	1.2.16
openstorage/nfsexecutor	1.2.16

2.8.0

Image	Version
openstorage/stork	24.3.3.1
openstorage/cmdexecutor	24.3.3.1
openstorage/kopiaexecutor	1.2.15
openstorage/nfsexecutor	1.2.15

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

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