Skip to content

Commit

Permalink
Merge pull request #202 from datamattsson/v242
Browse files Browse the repository at this point in the history 
v2.4.2 release
  • Loading branch information
@dileepds
dileepds authored Apr 9, 2024
2 parents 7c8ac79 + 68cde7d commit 469ee16
Show file tree
Hide file tree
Showing 6 changed files with 99 additions and 23 deletions.
36 changes: 18 additions & 18 deletions docs/csi_driver/deployment.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -42,13 +42,13 @@ Establish a working directory on a bastion Linux host that has HTTP access to th
!!! note
Only the HPE CSI Driver 1.4.0 and later is supported using this methodology.

Create a working directory and set environment variables referenced throughout the procedure. In this example, we'll use HPE CSI Driver v2.4.1 on Kubernetes 1.29. Available versions are found in the [co-deployments GitHub repo](https://github.com/hpe-storage/co-deployments/tree/master/yaml/csi-driver).
Create a working directory and set environment variables referenced throughout the procedure. In this example, we'll use HPE CSI Driver v2.4.2 on Kubernetes 1.29. Available versions are found in the [co-deployments GitHub repo](https://github.com/hpe-storage/co-deployments/tree/master/yaml/csi-driver).

```text
mkdir hpe-csi-driver
cd hpe-csi-driver
export MY_REGISTRY=registry.enterprise.example.com
export MY_CSI_DRIVER=2.4.1
export MY_CSI_DRIVER=2.4.2
export MY_K8S=1.29
```

Expand Down Expand Up @@ -434,19 +434,19 @@ kubectl create ns hpe-storage
Worker node IO settings and common `CRDs`:

```text
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-linux-config.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-volumegroup-snapshotgroup-crds.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-linux-config.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-volumegroup-snapshotgroup-crds.yaml
```

Container Storage Provider:

```text fct_label="HPE Alletra 5000/6000 and Nimble Storage"
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/nimble-csp.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/nimble-csp.yaml
```

```text fct_label="HPE Alletra Storage MP, HPE Alletra 9000, Primera and 3PAR"
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/3par-primera-csp.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/3par-primera-crd.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/3par-primera-csp.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/3par-primera-crd.yaml
```

!!! important
Expand All @@ -455,19 +455,19 @@ kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/ma
Install the CSI driver:

```text fct_label="Kubernetes 1.29"
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.29.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.29.yaml
```

```text fct_label="Kubernetes 1.28"
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.28.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.28.yaml
```

```text fct_label="Kubernetes 1.27"
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.27.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.27.yaml
```

```text fct_label="Kubernetes 1.26"
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.26.yaml
kubectl apply -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.26.yaml
```

!!! seealso
Expand All @@ -482,17 +482,17 @@ The following steps outline how to uninstall the CSI driver that has been deploy
Uninstall Worker node settings:

```text
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-linux-config.yaml
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-linux-config.yaml
```

Uninstall relevant Container Storage Provider:

```text fct_label="HPE Alletra 5000/6000 and Nimble Storage"
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/nimble-csp.yaml
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/nimble-csp.yaml
```

```text fct_label="HPE Alletra Storage MP, Alletra 9000, Primera and 3PAR"
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/3par-primera-csp.yaml
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/3par-primera-csp.yaml
```

!!! error "HPE Alletra Storage MP, Alletra 9000, Primera and 3PAR users"
Expand All @@ -501,19 +501,19 @@ kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/m
Uninstall the CSI driver:

```text fct_label="Kubernetes 1.29"
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.29.yaml
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.29.yaml
```

```text fct_label="Kubernetes 1.28"
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.28.yaml
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.28.yaml
```

```text fct_label="Kubernetes 1.27"
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.27.yaml
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.27.yaml
```

```text fct_label="Kubernetes 1.26"
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.1/hpe-csi-k8s-1.26.yaml
kubectl delete -f https://raw.githubusercontent.com/hpe-storage/co-deployments/master/yaml/csi-driver/v2.4.2/hpe-csi-k8s-1.26.yaml
```

If no longer needed, delete the "hpe-storage" `Namespace`.
Expand Down
63 changes: 63 additions & 0 deletions docs/csi_driver/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,69 @@ These are the combinations HPE has tested and can provide official support servi
For Kubernetes 1.12 and earlier please see [legacy FlexVolume drivers](../flexvolume_driver/index.md), do note that the FlexVolume drivers are being deprecated.

<a name="latest_release"></a>
#### HPE CSI Driver for Kubernetes 2.4.2

Release highlights:

* Patch release

<table>
<tr>
<th>Kubernetes</th>
<td>1.26-1.29<sup>1</sup></td>
</tr>
<tr>
<th>Helm Chart</th>
<td><a href="https://artifacthub.io/packages/helm/hpe-storage/hpe-csi-driver/2.4.2">v2.4.2</a> on ArtifactHub</td>
</tr>
<tr>
<th>Operators</th>
<td>
<a href="https://operatorhub.io/operator/hpe-csi-operator/stable/hpe-csi-operator.v2.4.2">v2.4.2</a> on OperatorHub<br />
<a href="https://catalog.redhat.com/software/container-stacks/detail/5e9874643f398525a0ceb004">v2.4.2</a> via OpenShift console
</td>
</tr>
<tr>
<th>Worker&nbsp;OS</th>
<td>
Red Hat Enterprise Linux<sup>2</sup> 7.x, 8.x, 9.x, Red Hat CoreOS 4.12-4.15<br />
Ubuntu 16.04, 18.04, 20.04, 22.04<br />
SUSE Linux Enterprise Server 15 SP3, SP4, SP5 and SLE Micro<sup>4</sup> equivalents
</tr>
<tr>
<th>Platforms<sup>3</sup></th>
<td>
Alletra Storage MP<sup>5</sup> 10.2.x - 10.3.x<br />
Alletra OS 9000 9.3.x - 9.5.x<br />
Alletra OS 5000/6000 6.0.0.x - 6.1.2.x<br />
Nimble OS 5.0.10.x, 5.2.1.x, 6.0.0.x, 6.1.2.x<br />
Primera OS 4.3.x - 4.5.x<br />
3PAR OS 3.3.x
</td>
</tr>
<tr>
<th>Data&nbsp;protocols</th>
<td>Fibre Channel, iSCSI</td>
</tr>
<tr>
<th>Filesystems</th>
<td>XFS, ext3/ext4, btrfs, NFSv4<sup>&ast;</sup></td>
</tr>
<tr>
<th>Release&nbsp;notes</th>
<td><a href="https://github.com/hpe-storage/csi-driver/blob/master/release-notes/v2.4.2.md">v2.4.2</a> on GitHub</td>
</tr>
</table>

<small>
<sup>&ast;</sup> = The HPE CSI Driver for Kubernetes is a block storage driver primarily. It includes an [NFS Server Provisioner](using.md#using_the_nfs_server_provisioner) that allows "ReadWriteMany" `PersistentVolumeClaims`.<br/>
<sup>1</sup> = For HPE Ezmeral Runtime Enterprise, SUSE Rancher, Mirantis Kubernetes Engine and others; Kubernetes clusters must be deployed within the currently supported range of "Worker OS" platforms listed in the above table. See [partner ecosystems](../partners) for other variations. Lowest tested and known working version is Kubernetes 1.21.<br />
<sup>2</sup> = The HPE CSI Driver will recognize CentOS, AlmaLinux and Rocky Linux as RHEL derives and they are supported by HPE.<br/>
<sup>3</sup> = Learn about each data platform's team [support commitment](../legal/support/index.md#container_storage_providers).<br/>
<sup>4</sup> = SLE Micro nodes may need to be conformed manually, run `transactional-update -n pkg install multipath-tools open-iscsi nfs-client sg3_utils` and reboot if the CSI node driver doesn't start.<br/>
<sup>5</sup> = The HPE CSI Driver for Kubernetes only support HPE Alletra Storage MP when used with HPE GreenLake for Block Storage. Please see the [VAST CSI Driver](https://support.vastdata.com/s/topic/0TOV40000000TtFOAU/vast-csi-driver) for HPE GreenLake for File Storage.<br/>
</small>

#### HPE CSI Driver for Kubernetes 2.4.1

Release highlights:
Expand Down
4 changes: 4 additions & 0 deletions docs/csi_driver/operations.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -284,6 +284,10 @@ Enabling and setting up the CSI snapshotter and related `CRDs` is not necessary

In the event the CSI driver contains updates to the NFS Server Provisioner, any running NFS server needs to be updated manually.

### Upgrade to v2.4.2

No changes to NFS Server Provisioner image between v2.4.1 and v2.4.2.

### Upgrade to v2.4.1

Any prior deployed NFS servers may be upgraded to v2.4.1.
Expand Down
9 changes: 9 additions & 0 deletions docs/csi_driver/using.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,15 @@ kubectl get sts,deploy -A

If no prior CRDs or controllers exist, install the snapshot CRDs and common snapshot controller (once per Kubernetes cluster, independent of any CSI drivers).

```text fct_label="HPE CSI Driver v2.4.2"
# Kubernetes 1.26-1.29
git clone https://github.com/kubernetes-csi/external-snapshotter
cd external-snapshotter
git checkout tags/v6.3.3 -b hpe-csi-driver-v2.4.2
kubectl kustomize client/config/crd | kubectl create -f-
kubectl -n kube-system kustomize deploy/kubernetes/snapshot-controller | kubectl create -f-
```

```text fct_label="HPE CSI Driver v2.4.1"
# Kubernetes 1.26-1.29
git clone https://github.com/kubernetes-csi/external-snapshotter
Expand Down
Binary file modified docs/img/csi-driver-overview.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 5 additions & 5 deletions docs/partners/redhat_openshift/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,10 @@ Software delivered through the HPE and Red Hat partnership follows a [rigorous c

| Status | Red Hat OpenShift | HPE CSI Operator | Container Storage Providers |
| ----------------------- | --------------------------------- | -------------------------- | ------------------------------------------------ |
| Certified | 4.15 | 2.4.1 | [All](../../container_storage_provider/index.md) |
| Certified | 4.14 EUS<sup>2</sup> | 2.4.0, 2.4.1 | [All](../../container_storage_provider/index.md) |
| Certified | 4.13 | 2.4.0, 2.4.1 | [All](../../container_storage_provider/index.md) |
| Certified | 4.12 EUS<sup>2</sup> | 2.3.0, 2.4.0, 2.4.1 | [All](../../container_storage_provider/index.md) |
| Certified | 4.15 | 2.4.1, 2.4.2 | [All](../../container_storage_provider/index.md) |
| Certified | 4.14 EUS<sup>2</sup> | 2.4.0, 2.4.1, 2.4.2 | [All](../../container_storage_provider/index.md) |
| Certified | 4.13 | 2.4.0, 2.4.1, 2.4.2 | [All](../../container_storage_provider/index.md) |
| Certified | 4.12 EUS<sup>2</sup> | 2.3.0, 2.4.0, 2.4.1, 2.4.2 | [All](../../container_storage_provider/index.md) |
| EOL<sup>1</sup> | 4.11 | 2.3.0 | [All](../../container_storage_provider/index.md) |
| EOL<sup>1</sup> | 4.10 EUS<sup>2</sup> | 2.2.1, 2.3.0 | [All](../../container_storage_provider/index.md) |

Expand Down Expand Up @@ -112,7 +112,7 @@ Once the SCC has been applied to the project, login to the OpenShift web console
![Click Install](img/webcon-2.png)
*Click 'Install'.*
!!! note
Latest supported HPE CSI Operator on OpenShift 4.14 is 2.4.1
Latest supported HPE CSI Operator on OpenShift 4.14 is 2.4.2

![Click Install](img/webcon-3.png)
*Select the Namespace where the SCC was applied, select 'Manual' Update Approval, click 'Install'.*
Expand Down

0 comments on commit 469ee16

Please sign in to comment.