From f5de0cebbb9817bbbe2bf55200e5c5a2520d70f5 Mon Sep 17 00:00:00 2001 From: Fernando Alfaro Campos Date: Tue, 8 Oct 2024 10:57:16 -0400 Subject: [PATCH 1/2] Add optional sdc documentation --- content/docs/csidriver/features/powerflex.md | 29 +++++++++++++++++++ .../helm/drivers/installation/powerflex.md | 1 + 2 files changed, 30 insertions(+) diff --git a/content/docs/csidriver/features/powerflex.md b/content/docs/csidriver/features/powerflex.md index bae17d0682..2f9e60f0d3 100644 --- a/content/docs/csidriver/features/powerflex.md +++ b/content/docs/csidriver/features/powerflex.md @@ -385,6 +385,16 @@ The CSI PowerFlex driver version 1.3 and later support the automatic deployment Refer to https://hub.docker.com/r/dellemc/sdc for supported OS versions. - There is no automated uninstallation of the SDC kernel module. Follow PowerFlex SDC documentation to manually uninstall the SDC driver from the node. +Starting from CSM 1.12.0, automatic deployment of the SDC can be disabled. If you have a Powerflex 4.x and NAS functionality enabled, SDC deployment is not necessary. By default, deployment of SDC will be enabled but to disable it, set the `sdc` field to `false`. + +``` +node: + ... + sdc: + # enabled: Enable/Disable SDC + enabled: true +``` + ## Multiarray Support The CSI PowerFlex driver version 1.4 added support for managing multiple PowerFlex arrays from the single driver instance. This feature is enabled by default and integrated to even single instance installations. @@ -925,6 +935,25 @@ externalAccess: "10.0.0.0/24" This means that we allow for NFS Export created by driver to be consumed by address range `10.0.0.0-10.0.0.255`. +## Configuring NFS independent of SDC + +Starting from CSM 1.12.0, the CSI PowerFlex driver supports configuring NFS independent of SDC. This separation is helpful in scenarios where an SDC is not available in the cluster or additional network interfaces do not need to be deployed. + +To enable this feature you need to disable the automatic `sdc` deployment from the values file and provide the interface names mapping for each of the nodes that are being used. + +``` +node: + ... + sdc: + # enabled: Enable/Disable SDC + enabled: false + ... + +interfaceNames: + # worker1: interface1 + # worker2: interface2 +``` + ## Storage Capacity Tracking CSI-PowerFlex driver version 2.8.0 and above supports Storage Capacity Tracking. diff --git a/content/docs/deployment/helm/drivers/installation/powerflex.md b/content/docs/deployment/helm/drivers/installation/powerflex.md index e574cdb138..c110aa822d 100644 --- a/content/docs/deployment/helm/drivers/installation/powerflex.md +++ b/content/docs/deployment/helm/drivers/installation/powerflex.md @@ -214,6 +214,7 @@ Use the below command to replace or update the secret: | enabled | A boolean that enables/disables authorization feature. | No | false | | proxyHost | Hostname of the csm-authorization server. | No | Empty | | skipCertificateValidation | A boolean that enables/disables certificate validation of the csm-authorization proxy server. | No | true | +| **interfaceNames** | A mapping of node names to interface names. Only necessary when SDC is disabled (see above). | No | "" | 10. Install the driver using `csi-install.sh` bash script by running `cd dell-csi-helm-installer && ./csi-install.sh --namespace vxflexos --values myvalues.yaml --helm-charts-version `. You may modify the release name with the `--release` arg. If arg is not provided, release will be named `vxflexos` by default. From 6024ec2a07f1a62e2362bb16881e83b0e5b99b43 Mon Sep 17 00:00:00 2001 From: Fernando Alfaro Campos Date: Tue, 8 Oct 2024 15:58:02 -0400 Subject: [PATCH 2/2] Address PR comments --- content/docs/csidriver/features/powerflex.md | 23 +++++++++++++++---- .../csmoperator/drivers/powerflex.md | 2 ++ 2 files changed, 21 insertions(+), 4 deletions(-) diff --git a/content/docs/csidriver/features/powerflex.md b/content/docs/csidriver/features/powerflex.md index 2f9e60f0d3..e428297fee 100644 --- a/content/docs/csidriver/features/powerflex.md +++ b/content/docs/csidriver/features/powerflex.md @@ -385,7 +385,9 @@ The CSI PowerFlex driver version 1.3 and later support the automatic deployment Refer to https://hub.docker.com/r/dellemc/sdc for supported OS versions. - There is no automated uninstallation of the SDC kernel module. Follow PowerFlex SDC documentation to manually uninstall the SDC driver from the node. -Starting from CSM 1.12.0, automatic deployment of the SDC can be disabled. If you have a Powerflex 4.x and NAS functionality enabled, SDC deployment is not necessary. By default, deployment of SDC will be enabled but to disable it, set the `sdc` field to `false`. +From CSM 1.12.0, you can disable automatic SDC deployment. + +By default, SDC deployment is enabled. If you do not want to deploy `sdc` with PowerFlex, it can be disabled by setting the `sdc.enabled` field to `false`. ``` node: @@ -939,8 +941,9 @@ This means that we allow for NFS Export created by driver to be consumed by addr Starting from CSM 1.12.0, the CSI PowerFlex driver supports configuring NFS independent of SDC. This separation is helpful in scenarios where an SDC is not available in the cluster or additional network interfaces do not need to be deployed. -To enable this feature you need to disable the automatic `sdc` deployment from the values file and provide the interface names mapping for each of the nodes that are being used. +To disable SDC deployment, update the values file and provide the interface names mapping for each of the nodes that are being used. +**Helm** ``` node: ... @@ -950,8 +953,20 @@ node: ... interfaceNames: - # worker1: interface1 - # worker2: interface2 + # worker-1-jxsjoueeewabc.domain: "ens192" + # worker-2-jxsjoueeewabc.domain: "ens192" +``` + +**Operator** +``` +common: +... + - name: INTERFACE_NAMES: 'worker-1-jxsjoueeewabc.domain: "ens192", worker-2-jxsjoueeewabc.domain: "ens192"' +... +node: +... + - name: X_CSI_SDC_ENABLED + value: "false" ``` ## Storage Capacity Tracking diff --git a/content/docs/deployment/csmoperator/drivers/powerflex.md b/content/docs/deployment/csmoperator/drivers/powerflex.md index d475584ec2..8f6897a41e 100644 --- a/content/docs/deployment/csmoperator/drivers/powerflex.md +++ b/content/docs/deployment/csmoperator/drivers/powerflex.md @@ -148,6 +148,7 @@ For detailed PowerFlex installation procedure, see the [Dell PowerFlex Deploymen | X_CSI_VXFLEXOS_ENABLESNAPSHOTCGDELETE | Enable this to automatically delete all snapshots in a consistency group when a snap in the group is deleted | No | false | | X_CSI_DEBUG | To enable debug mode | No | true | | X_CSI_ALLOW_RWO_MULTI_POD_ACCESS | Setting allowRWOMultiPodAccess to "true" will allow multiple pods on the same node to access the same RWO volume. This behavior conflicts with the CSI specification version 1.3. NodePublishVolume description that requires an error to be returned in this case. However, some other CSI drivers support this behavior and some customers desire this behavior. Customers use this option at their own risk. | No | false | + | INTERFACE_NAMES | A mapping of node names to interface names. Only necessary when SDC is disabled. | No | none | | ***Controller parameters*** | | X_CSI_POWERFLEX_EXTERNAL_ACCESS | allows specifying additional entries for hostAccess of NFS volumes. Both single IP address and subnet are valid entries | No | empty | | X_CSI_HEALTH_MONITOR_ENABLED | Enable/Disable health monitor of CSI volumes from Controller plugin - volume condition | No | false | @@ -155,6 +156,7 @@ For detailed PowerFlex installation procedure, see the [Dell PowerFlex Deploymen | X_CSI_RENAME_SDC_ENABLED | Enable this to rename the SDC with the given prefix. The new name will be ("prefix" + "worker_node_hostname") and it should not exceed 31 chars. | Yes | false | | X_CSI_APPROVE_SDC_ENABLED | Enable this to to approve restricted SDC by GUID during setup | Yes | false | | X_CSI_HEALTH_MONITOR_ENABLED | Enable/Disable health monitor of CSI volumes from Node plugin - volume condition | No | false | + | X_CSI_SDC_ENABLED | Enable/Disable installation of the SDC. | Yes | true | 4. Execute this command to create PowerFlex custom resource: ```bash