Refresh azure-netapp-files-dual-protocol

MGoedtel · MGoedtel · commit f1f1a1ccf264 · 2024-02-26T11:06:32.000-05:00
diff --git a/articles/aks/azure-netapp-files-dual-protocol.md b/articles/aks/azure-netapp-files-dual-protocol.md
@@ -3,21 +3,23 @@ title: Provision Azure NetApp Files dual-protocol volumes for Azure Kubernetes S
 description: Describes how to statically provision Azure NetApp Files dual-protocol volumes for Azure Kubernetes Service.
 ms.topic: article
 ms.custom:
-ms.date: 05/08/2023
+ms.date: 02/26/2024
 ---
 
 # Provision Azure NetApp Files dual-protocol volumes for Azure Kubernetes Service
 
-After you [configure Azure NetApp Files for Azure Kubernetes Service](azure-netapp-files.md), you can provision Azure NetApp Files volumes for Azure Kubernetes Service. 
+After you [configure Azure NetApp Files for Azure Kubernetes Service][azure-netapp-files], you can provision Azure NetApp Files volumes for Azure Kubernetes Service.
 
-Azure NetApp Files supports volumes using [NFS](azure-netapp-files-nfs.md) (NFSv3 or NFSv4.1), [SMB](azure-netapp-files-smb.md), and dual-protocol (NFSv3 and SMB, or NFSv4.1 and SMB). 
-* This article describes details for statically provisioning volumes for dual-protocol access. 
-* For information about provisioning SMB volumes statically or dynamically, see [Provision Azure NetApp Files SMB volumes for Azure Kubernetes Service](azure-netapp-files-smb.md). 
-* For information about provisioning NFS volumes statically or dynamically, see [Provision Azure NetApp Files NFS volumes for Azure Kubernetes Service](azure-netapp-files-nfs.md).
+Azure NetApp Files supports volumes using [NFS][azure-netapp-nfs] (NFSv3 or NFSv4.1), [SMB][azure-netapp-smb], and dual-protocol (NFSv3 and SMB, or NFSv4.1 and SMB).
+
+This article shows how to statically provisioning volumes for dual-protocol access.
+
+* For information about provisioning SMB volumes statically or dynamically, see [Provision Azure NetApp Files SMB volumes for Azure Kubernetes Service][azure-netapp-smb].
+* For information about provisioning NFS volumes statically or dynamically, see [Provision Azure NetApp Files NFS volumes for Azure Kubernetes Service][azure-netapp-nfs].
 
 ## Before you begin
 
-* You must have already created a dual-protocol volume. See [create a dual-protocol volume for Azure NetApp Files](../azure-netapp-files/create-volumes-dual-protocol.md).
+* You must have already created a dual-protocol volume. See [create a dual-protocol volume for Azure NetApp Files][azure-netapp-files-volume-dual-protocol].
 
 ## Provision a dual-protocol volume in Azure Kubernetes Service
 
@@ -34,9 +36,9 @@ This section describes how to expose an Azure NetApp Files dual-protocol volume
     ANF_ACCOUNT_NAME="myaccountname"
     POOL_NAME="mypool1"
     VOLUME_NAME="myvolname"
-    ``` 
-    
-2. List the details of your volume using [`az netappfiles volume show`](/cli/azure/netappfiles/volume#az-netappfiles-volume-show) command.
+    ```
+
+2. List the details of your volume using the [`az netappfiles volume show`][az-netappfiles-volume-show] command.
 
     ```azurecli-interactive
     az netappfiles volume show \
@@ -46,7 +48,7 @@ This section describes how to expose an Azure NetApp Files dual-protocol volume
         --volume-name $VOLUME_NAME -o JSON
     ```
 
-    The following output is an example of the above command executed with real values. 
+    The following output is an example of the above command executed with real values.
 
     ```output
     {
@@ -83,13 +85,13 @@ This section describes how to expose an Azure NetApp Files dual-protocol volume
         path: /myfilepath2
     ```
 
-4. Create the persistent volume using the [`kubectl apply`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply) command:
+4. Create the persistent volume using the [`kubectl apply`][kubectl-apply] command:
 
     ```bash
     kubectl apply -f pv-nfs.yaml
     ```
 
-5. Verify the status of the persistent volume is *Available* by using the [`kubectl describe`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#describe) command:
+5. Verify the status of the persistent volume is *Available* by using the [`kubectl describe`][kubectl-describe] command:
 
     ```bash
     kubectl describe pv pv-nfs
@@ -113,13 +115,13 @@ This section describes how to expose an Azure NetApp Files dual-protocol volume
           storage: 100Gi
     ```
 
-2. Create the persistent volume claim using the [`kubectl apply`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply) command:
+2. Create the persistent volume claim using the [`kubectl apply`][kubectl-apply] command:
 
     ```bash
     kubectl apply -f pvc-nfs.yaml
     ```
 
-3. Verify the *Status* of the persistent volume claim is *Bound* by using the [`kubectl describe`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#describe) command:
+3. Verify the *Status* of the persistent volume claim is *Bound* by using the [`kubectl describe`][kubectl-describe] command:
 
     ```bash
     kubectl describe pvc pvc-nfs
@@ -151,19 +153,19 @@ This section describes how to expose an Azure NetApp Files dual-protocol volume
           claimName: pvc-nfs
     ```
 
-2. Create the pod using the [`kubectl apply`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply) command:
+2. Create the pod using the [`kubectl apply`][kubectl-apply][kubectl-apply] command:
 
     ```bash
     kubectl apply -f nginx-nfs.yaml
     ```
 
-3. Verify the pod is *Running* by using the [`kubectl apply`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply) command:
+3. Verify the pod is *Running* by using the [`kubectl apply`][kubectl-apply] command:
 
     ```bash
     kubectl describe pod nginx-nfs
     ```
 
-4. Verify your volume has been mounted on the pod by using [`kubectl exec`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#exec) to connect to the pod, and then use `df -h` to check if the volume is mounted.
+4. Verify your volume has been mounted on the pod by using [`kubectl exec`][kubectl-exec] to connect to the pod, and then use `df -h` to check if the volume is mounted.
 
     ```bash
     kubectl exec -it nginx-nfs -- sh
@@ -181,38 +183,43 @@ This section describes how to expose an Azure NetApp Files dual-protocol volume
 
 ### Create a secret with the domain credentials
 
-1. Create a secret on your AKS cluster to access the AD server using the [`kubectl create secret`](https://kubernetes.io/docs/tasks/configmap-secret/managing-secret-using-kubectl/) command. This secret will be used by the Kubernetes persistent volume to access the Azure NetApp Files SMB volume. Use the following command to create the secret, replacing `USERNAME` with your username, `PASSWORD` with your password, and `DOMAIN_NAME` with your domain name for your Active Directory.
+1. Create a secret on your AKS cluster to access the AD server using the [`kubectl create secret`][kubectl-create-secret] command. This secret will be used by the Kubernetes persistent volume to access the Azure NetApp Files SMB volume. Use the following command to create the secret, replacing `USERNAME` with your username, `PASSWORD` with your password, and `DOMAIN_NAME` with your Active Directory domain name.
 
     ```bash
         kubectl create secret generic smbcreds --from-literal=username=USERNAME --from-literal=password="PASSWORD" --from-literal=domain='DOMAIN_NAME'
     ```
 
-2. Check the secret has been created.
+2. To verify the secret has been created, run the [`kubectl get`][kubectl-get] command.
 
     ```bash
        kubectl get secret
+    ```
+
+   ```output
        NAME       TYPE     DATA   AGE
        smbcreds   Opaque   2      20h
     ```
 
 ### Install an SMB CSI driver
 
-You must install a Container Storage Interface (CSI) driver to create a Kubernetes SMB `PersistentVolume`. 
+You must install a Container Storage Interface (CSI) driver to create a Kubernetes SMB `PersistentVolume`.
 
-1.	Install the SMB CSI driver on your cluster using helm. Be sure to set the `windows.enabled` option to `true`:
+1. Install the SMB CSI driver on your cluster using helm. Be sure to set the `windows.enabled` option to `true`:
 
     ```bash
     helm repo add csi-driver-smb https://raw.githubusercontent.com/kubernetes-csi/csi-driver-smb/master/charts   
     helm install csi-driver-smb csi-driver-smb/csi-driver-smb --namespace kube-system --version v1.10.0 –-set windows.enabled=true
     ```
 
-    For other methods of installing the SMB CSI Driver, see [Install SMB CSI driver master version on a Kubernetes cluster](https://github.com/kubernetes-csi/csi-driver-smb/blob/master/docs/install-csi-driver-master.md). 
+    For other methods of installing the SMB CSI Driver, see [Install SMB CSI driver master version on a Kubernetes cluster][install-smb-csi-driver].
 
-2.	Verify that the `csi-smb` controller pod is running and each worker node has a pod running using the [`kubectl get pods`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#get) command:   
+2. Verify the `csi-smb` controller pod is running and each worker node has a pod running using the [`kubectl get pods`][kubectl-get-pods] command:
 
     ```bash
     kubectl get pods -n kube-system | grep csi-smb
-    
+    ```
+  
+    ```output
     csi-smb-controller-68df7b4758-xf2m9   3/3     Running   0          3m46s
     csi-smb-node-s6clj                    3/3     Running   0          3m47s
     csi-smb-node-win-tfxvk                3/3     Running   0          3m47s
@@ -227,9 +234,9 @@ You must install a Container Storage Interface (CSI) driver to create a Kubernet
     ANF_ACCOUNT_NAME="myaccountname"
     POOL_NAME="mypool1"
     VOLUME_NAME="myvolname"
-    ``` 
-    
-2. List the details of your volume using [`az netappfiles volume show`](/cli/azure/netappfiles/volume#az-netappfiles-volume-show).
+    ```
+
+2. List the details of your volume using [`az netappfiles volume show`][az-netappfiles-volume-show] command.
 
     ```azurecli-interactive
     az netappfiles volume show \
@@ -239,7 +246,7 @@ You must install a Container Storage Interface (CSI) driver to create a Kubernet
         --volume-name "$VOLUME_NAME -o JSON
     ```
 
-    The following output is an example of the above command executed with real values. 
+    The following output is an example of the above command executed with real values.
 
     ```output
     {
@@ -287,21 +294,21 @@ You must install a Container Storage Interface (CSI) driver to create a Kubernet
           namespace: default
     ```
 
-4. Create the persistent volume using the [`kubectl apply`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply) command:  
+4. Create the persistent volume using the [`kubectl apply`][kubectl-apply] command:  
 
     ```bash
     kubectl apply -f pv-smb.yaml
     ```
 
-5. Verify the status of the persistent volume is *Available* using the [`kubectl describe`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#describe) command:
+5. Verify the status of the persistent volume is *Available* using the [`kubectl describe`][kubectl-describe] command:
 
     ```bash
     kubectl describe pv anf-pv-smb
     ```
 
 ### Create a persistent volume claim for SMB
 
-1. Create a file name `pvc-smb.yaml` and copy in the following YAML. 
+1. Create a file name `pvc-smb.yaml` and copy in the following YAML.
 
     ```yaml
     apiVersion: v1
@@ -318,19 +325,19 @@ You must install a Container Storage Interface (CSI) driver to create a Kubernet
           storage: 100Gi
     ```
 
-2.	Create the persistent volume claim using the [`kubectl apply`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply) command: 
+2. Create the persistent volume claim using the [`kubectl apply`][kubectl-apply] command:
 
     ```bash
     kubectl apply -f pvc-smb.yaml
     ```
 
-    Verify the status of the persistent volume claim is *Bound* by using the [`kubectl describe`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#describe) command:   
+    Verify the status of the persistent volume claim is *Bound* by using the [`kubectl describe`][kubectl-describe] command:
 
     ```bash
     kubectl describe pvc anf-pvc-smb
     ```
 
-### Mount within a pod using SMB 
+### Mount within a pod using SMB
 
 1. Create a file named `iis-smb.yaml` and copy in the following YAML. This file will be used to create an Internet Information Services pod to mount the volume to path `/inetpub/wwwroot`.
 
@@ -363,19 +370,19 @@ You must install a Container Storage Interface (CSI) driver to create a Kubernet
           readOnly: false
     ```
 
-2. Create the pod using the [kubectl apply](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply) command:
+2. Create the pod using the [kubectl apply][kubectl-apply] command:
 
     ```bash
     kubectl apply -f iis-smb.yaml
     ```
 
-3. Verify the pod is *Running* and `/inetpub/wwwroot` is mounted from SMB by using the [`kubectl describe`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#describe) command:
+3. Verify the pod is *Running* and `/inetpub/wwwroot` is mounted from SMB by using the [`kubectl describe`][kubectl-describe] command:
 
     ```bash
     kubectl describe pod iis-pod
     ```
 
-    The output of the command resembles the following example:   
+    The output of the command resembles the following example:
 
     ```output
     Name:         iis-pod
@@ -413,12 +420,13 @@ You must install a Container Storage Interface (CSI) driver to create a Kubernet
     ...
     ```
 
-4. Verify your volume has been mounted on the pod by using the [kubectl exec](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#exec) command to connect to the pod, and then use `dir` command in the correct directory to check if the volume is mounted and the size matches the size of the volume you provisioned. 
+4. Verify your volume has been mounted on the pod by using the [kubectl exec][kubectl-exec] command to connect to the pod. Then use the `dir` command in the correct directory to check if the volume is mounted and the size matches the size of the volume you provisioned.
 
     ```bash
     kubectl exec -it iis-pod –- cmd.exe
     ```
-    The output of the command resembles the following example:   
+
+    The output of the command resembles the following example:
 
     ```output
     Microsoft Windows [Version 10.0.20348.1668]
@@ -449,37 +457,20 @@ Astra Trident supports many features with Azure NetApp Files. For more informati
 * [Importing volumes][importing-trident-volumes]
 
 <!-- EXTERNAL LINKS -->
-[astra-trident]: https://docs.netapp.com/us-en/trident/index.html
-[kubectl-create]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#create
 [kubectl-apply]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply
 [kubectl-describe]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#describe
 [kubectl-exec]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#exec
-[astra-control-service]: https://cloud.netapp.com/astra-control
-[kubernetes-csi-driver]: https://kubernetes-csi.github.io/docs/
-[trident-install-guide]: https://docs.netapp.com/us-en/trident/trident-get-started/kubernetes-deploy.html
-[trident-helm-chart]: https://docs.netapp.com/us-en/trident/trident-get-started/kubernetes-deploy-operator.html
-[tridentctl]: https://docs.netapp.com/us-en/trident/trident-get-started/kubernetes-deploy-tridentctl.html
-[trident-backend-install-guide]: https://docs.netapp.com/us-en/trident/trident-use/backends.html
+[kubectl-create-secret]: https://kubernetes.io/docs/tasks/configmap-secret/managing-secret-using-kubectl/
+[kubectl-get-pods]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#get
 [kubectl-get]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#get
 [expand-trident-volumes]: https://docs.netapp.com/us-en/trident/trident-use/vol-expansion.html
+[install-smb-csi-driver]: https://github.com/kubernetes-csi/csi-driver-smb/blob/master/docs/install-csi-driver-master.md
 [on-demand-trident-volume-snapshots]: https://docs.netapp.com/us-en/trident/trident-use/vol-snapshots.html
 [importing-trident-volumes]: https://docs.netapp.com/us-en/trident/trident-use/vol-import.html
-[backend-anf.yaml]: https://raw.githubusercontent.com/NetApp/trident/v23.01.1/trident-installer/sample-input/backends-samples/azure-netapp-files/backend-anf.yaml
 
 <!-- INTERNAL LINKS -->
-[aks-quickstart-cli]: ./learn/quick-kubernetes-deploy-cli.md
-[aks-quickstart-portal]: ./learn/quick-kubernetes-deploy-portal.md
-[aks-quickstart-powershell]: ./learn/quick-kubernetes-deploy-powershell.md
-[anf]: ../azure-netapp-files/azure-netapp-files-introduction.md
-[anf-delegate-subnet]: ../azure-netapp-files/azure-netapp-files-delegate-subnet.md
-[anf-regions]: https://azure.microsoft.com/global-infrastructure/services/?products=netapp&regions=all
-[az-aks-show]: /cli/azure/aks#az_aks_show
-[az-netappfiles-account-create]: /cli/azure/netappfiles/account#az_netappfiles_account_create
-[az-netapp-files-dynamic]: azure-netapp-files-dynamic.md
-[az-netappfiles-pool-create]: /cli/azure/netappfiles/pool#az_netappfiles_pool_create
-[az-netappfiles-volume-create]: /cli/azure/netappfiles/volume#az_netappfiles_volume_create
 [az-netappfiles-volume-show]: /cli/azure/netappfiles/volume#az_netappfiles_volume_show
-[az-network-vnet-subnet-create]: /cli/azure/network/vnet/subnet#az_network_vnet_subnet_create
-[install-azure-cli]: /cli/azure/install-azure-cli
-[use-tags]: use-tags.md
-[azure-ad-app-registration]: ../active-directory/develop/howto-create-service-principal-portal.md
+[azure-netapp-nfs]: azure-netapp-files-nfs.md
+[azure-netapp-smb]: azure-netapp-files-smb.md
+[azure-netapp-files]: azure-netapp-files.md
+[azure-netapp-files-volume-dual-protocol]: ../azure-netapp-files/create-volumes-dual-protocol.md
