Skip to content

Commit

Permalink
fix review comments
Browse files Browse the repository at this point in the history
  • Loading branch information
anandrajak1 committed Mar 4, 2025
1 parent ca4da2a commit 9b7cd66
Show file tree
Hide file tree
Showing 3 changed files with 39 additions and 31 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,8 @@ openssl x509 -req -in tls.csr -signkey tls.key -out tls.crt -days 3650 -extensio
kubectl create secret -n <namespace> tls csirevproxy-tls-secret --cert=tls.crt --key=tls.key
```
{{< tabpane text=true lang="en" >}}
{{% tab header="Fibre Channel" lang="en" %}}
{{% tab header="Fibre Channel" lang="en" %}}

### Fibre Channel Requirements

The following requirements must be fulfilled in order to successfully use the Fiber Channel protocol with the CSI PowerMax driver:
Expand All @@ -46,15 +47,14 @@ The following requirements must be fulfilled in order to successfully use the Fi
- Ensure that the HBA WWNs (initiators) appear on the list of initiators that are logged into the array.
- If the number of volumes that will be published to nodes is high, then configure the maximum number of LUNs for your HBAs on each node. See the appropriate HBA document to configure the maximum number of LUNs.


1. Complete the zoning of each host with the PowerMax Storage Array. Please refer the <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-weight:bold; font-size:0.9rem">Host Connectivity Guide</a> for the guidelines when setting a Fibre Channel SAN infrastructure.
1. Complete the zoning of each host with the PowerMax Storage Array. Please refer to <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-size:0.9rem">Host Connectivity Guide</a> for the guidelines when setting a Fibre Channel SAN infrastructure.
<br>

2. Verify the initiators of each host are logged in to the PowerMax Storage Array. CSM will perform the Host Registration of each host with the PowerMax Array.
2. Verify the initiators of each host are logged in to the PowerMax Storage Array. CSM will perform the Host Registration of each host with the PowerMax Array.

<br>

3. Multipathing software configuration
3. Multipathing software configuration


a. Configure Device Mapper MPIO for PowerMax FC connectivity
Expand Down Expand Up @@ -95,7 +95,8 @@ The following requirements must be fulfilled in order to successfully use the Fi
<br>
<br>

```yaml
```yaml
cat <<EOF> 99-workers-multipath-conf.yaml
apiVersion: machineconfiguration.openshift.io/v1
kind: MachineConfig
Expand Down Expand Up @@ -149,9 +150,6 @@ The following requirements must be fulfilled in order to successfully use the Fi
enabled: true
EOF
```



<br>


Expand All @@ -160,12 +158,12 @@ The following requirements must be fulfilled in order to successfully use the Fi

{{% tab header="iSCSI" lang="en" %}}

1. Complete the iSCSI network configuration to connect the hosts with the PowerMax Storage array. Please refer the [host connectivity guide](https://elabnavigator.dell.com/vault/pdf/Linux.pdf) for the best practices for attaching the hosts to a PowerMax storage array.
1. Complete the iSCSI network configuration to connect the hosts with the PowerMax Storage array. Please refer to <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-size:0.9rem">Host Connectivity Guide</a> for the best practices for attaching the hosts to a PowerMax storage array.
<br>
2. Verify the initiators of each host are logged in to the PowerMax Storage Array. CSM will perform the Host Registration of each host with the PowerMax Array.
<br>
3. Enable iSCSI service
<br>
3. Enable iSCSI service
<br>

Use this command to create the machine configuration to enable the iscsid service.
```bash
Expand All @@ -191,15 +189,16 @@ The following requirements must be fulfilled in order to successfully use the Fi
units:
- name: "iscsid.service"
enabled: true
EOF
```
<br>

4. Multipathing software configuration
4. Multipathing software configuration


a. Configure Device Mapper MPIO for PowerMax FC connectivity
a. Configure Device Mapper MPIO for PowerMax FC connectivity

Use this command to create the machine configuration to configure the DM-MPIO service on all the worker hosts for FC connectivity.
Use this command to create the machine configuration to configure the DM-MPIO service on all the worker hosts for FC connectivity.

```bash
oc apply -f 99-workers-multipath-conf.yaml
Expand Down Expand Up @@ -301,20 +300,21 @@ The following requirements must be fulfilled in order to successfully use the Fi
{{% tab header="NVMeFC" lang="en" %}}


1. Complete the zoning of each host with the PowerMax Storage Array. Please refer the <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-weight:bold; font-size:0.9rem">Host Connectivity Guide</a> for the guidelines when setting a Fibre Channel SAN infrastructure.
1. Complete the zoning of each host with the PowerMax Storage Array. Please refer to <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-size:0.9rem">Host Connectivity Guide</a> for the guidelines when setting a Fibre Channel SAN infrastructure.

<br>

2. Verify the initiators of each host are logged in to the PowerMax Storage Array. CSM will perform the Host Registration of each host with the PowerMax Array.

<br>

3. Multipathing software configuration
3. Multipathing software configuration


```yaml
cat <<EOF> 71-nvmf-iopolicy-dell.rules
ACTION=="add", SUBSYSTEM=="nvme-subsystem", ATTR{model}=="dellemc-powermax",ATTR{iopolicy}="round-robin"
EOF
```
<br>
<br>
Expand All @@ -339,16 +339,16 @@ The following requirements must be fulfilled in order to successfully use the Fi
filesystem: root
mode: 420
path: /etc/udev/rules.d/71-nvme-io-policy.rules
EOF
```
<br>

4. Configure NVMe reconnecting forever


```yaml
cat <<EOF> 72-nvmf-ctrl_loss_tmo.rules
ACTION=="add|change", SUBSYSTEM=="nvme", KERNEL=="nvme*", ATTR{ctrl_loss_tmo}="-1"
EOF
```

<br>
Expand All @@ -373,12 +373,13 @@ The following requirements must be fulfilled in order to successfully use the Fi
filesystem: root
mode: 420
path: /etc/udev/rules.d/72-nvmf-ctrl_loss_tmo.rules
EOF
```

{{% /tab %}}
{{% /tab %}}

{{% tab header="NVMeTCP" lang="en" %}}
{{% /tab %}}
{{% /tab %}}

{{% tab header="NFS" lang="en" %}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,22 +15,21 @@ Before you install CSI Driver for Unity XT, verify the requirements that are men
* To use iSCSI protocol, iSCSI initiator utils packages needs to be installed and Multipath needs to be configured
* To use NFS protocol, there is no prerequisite on Openshift

{{< tabpane text=true lang="en" >}}
{{< tabpane text=true lang="en" >}}
{{% tab header="FC" lang="en" %}}

1. Complete the zoning of each host with the Unity Storage Array. Please refer the <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-weight:bold; font-size:0.9rem">Host Connectivity Guide</a> for the guidelines when setting a Fibre Channel SAN infrastructure.
1. Complete the zoning of each host with the Unity Storage Array. Please refer to <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-size:0.9rem">Host Connectivity Guide</a> for the guidelines when setting a Fibre Channel SAN infrastructure.
<br>

2. Verify the initiators of each host are logged in to the Unity Storage Array. CSM will perform the Host Registration of each host with the Unity Array.

<br>

3. Multipathing software configuration


3. Multipathing software configuration

a. Configure Device Mapper MPIO for Unity FC connectivity

Use this command to create the machine configuration to configure the DM-MPIO service on all the worker hosts for FC connectivity.
Use this command to create the machine configuration to configure the DM-MPIO service on all the worker hosts for FC connectivity.
```bash
oc apply -f 99-workers-multipath-conf.yaml
```
Expand Down Expand Up @@ -122,18 +121,17 @@ Before you install CSI Driver for Unity XT, verify the requirements that are men
```



<br>

{{% /tab %}}
{{% tab header="iSCSI" lang="en" %}}


1. Complete the iSCSI network configuration to connect the hosts with the Unity Storage array. Please refer the [host connectivity guide](https://www.delltechnologies.com/asset/en-us/products/storage/technical-support/docu5128.pdf). for the best practices for attaching the hosts to a Unity storage array.
1. Complete the iSCSI network configuration to connect the hosts with the Unity Storage array. Please refer to <a href="https://elabnavigator.dell.com/vault/pdf/Linux.pdf" target="_blank" style="font-size:0.9rem">Host Connectivity Guide</a>. for the best practices for attaching the hosts to a Unity storage array.
<br>
2. Verify the initiators of each host are logged in to the Unity Storage Array. CSM will perform the Host Registration of each host with the Unity Array.
<br>
3. Enable iSCSI service
3. Enable iSCSI service
<br>

Use this command to create the machine configuration to enable the iscsid service.
Expand All @@ -143,7 +141,7 @@ Before you install CSI Driver for Unity XT, verify the requirements that are men

<br>

Example:
Example:
```yaml
cat <<EOF> 99-workers-enable-iscsid.yaml
apiVersion: machineconfiguration.openshift.io/v1
Expand All @@ -160,6 +158,7 @@ Before you install CSI Driver for Unity XT, verify the requirements that are men
units:
- name: "iscsid.service"
enabled: true
EOF
```
<br>

Expand Down
8 changes: 8 additions & 0 deletions go.sum
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo=
github.com/FortAwesome/Font-Awesome v0.0.0-20240716171331-37eff7fa00de/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo=
github.com/google/docsy v0.11.0 h1:QnV40cc28QwS++kP9qINtrIv4hlASruhC/K3FqkHAmM=
github.com/google/docsy v0.11.0/go.mod h1:hGGW0OjNuG5ZbH5JRtALY3yvN8ybbEP/v2iaK4bwOUI=
github.com/google/docsy/dependencies v0.7.2 h1:+t5ufoADQAj4XneFphz4A+UU0ICAxmNaRHVWtMYXPSI=
github.com/google/docsy/dependencies v0.7.2/go.mod h1:gihhs5gmgeO+wuoay4FwOzob+jYJVyQbNaQOh788lD4=
github.com/twbs/bootstrap v5.2.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=
github.com/twbs/bootstrap v5.3.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=

0 comments on commit 9b7cd66

Please sign in to comment.