Skip to content

Commit e95e6df

Browse files
committed
Used storageApplianceName instead of nexus...
1 parent 0c0c997 commit e95e6df

6 files changed

+23
-23
lines changed

articles/operator-nexus/cluster-parameters-jsonc-example.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: bartpinto
55
ms.author: bpinto
66
ms.service: azure-operator-nexus
77
ms.topic: how-to
8-
ms.date: 03/31/2025
8+
ms.date: 05/22/2025
99
ms.custom: template-how-to, devx-track-arm-template
1010
---
1111

@@ -61,7 +61,7 @@ ms.custom: template-how-to, devx-track-arm-template
6161
"username": "<COMPX_SVRY_BMC_USER>",
6262
"password": "<COMPX_SVRY_BMC_PASS>"
6363
},
64-
"nexusSharedStorageApplianceName": "<SA_NAME>",
64+
"storageApplianceName": "<SA_NAME>",
6565
"serialNumber": "<SA_SN>"
6666
}
6767
],

articles/operator-nexus/concepts-storage-kubernetes.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: pjw711
55
ms.author: peterwhiting
66
ms.service: azure-operator-nexus
77
ms.topic: conceptual
8-
ms.date: 01/06/2025
8+
ms.date: 05/22/2025
99
ms.custom: template-concept
1010
---
1111

@@ -42,7 +42,7 @@ status:
4242
phase: Bound
4343
```
4444
45-
Some Azure Operator Nexus deployments may have two storage appliances installed. Persistent volume claims (PVCs) using the *nexus-volume* storage class can place the associated persistent volumes onto a specific storage appliance by using the *nexusSharedStorageApplianceName* annotation. More information is available in [this document](./concepts-storage-multiple-appliances.md).
45+
Some Azure Operator Nexus deployments may have two storage appliances installed. Persistent volume claims (PVCs) using the *nexus-volume* storage class can place the associated persistent volumes onto a specific storage appliance by using the *storageApplianceName* annotation. More information is available in [this document](./concepts-storage-multiple-appliances.md).
4646
4747
### StorageClass: nexus-shared
4848

articles/operator-nexus/concepts-storage-multiple-appliances.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: pjw711
55
ms.author: peterwhiting
66
ms.service: azure-operator-nexus
77
ms.topic: conceptual
8-
ms.date: 03/12/2025
8+
ms.date: 05/22/2025
99
ms.custom: template-concept
1010
---
1111

@@ -49,7 +49,7 @@ The default storage appliance is the appliance in rack slot 1. You can set the d
4949

5050
### Nexus-volume storage class
5151

52-
Azure Operator Nexus supports creating Persistent Volume Claims (PVCs) using the *nexus-volume* storage class. Nexus-volume PVCs are backed by a volume on the storage appliance which is created and managed by Azure Operator Nexus. You can select the storage appliance to provide the backing storage by using the `nexusSharedStorageApplianceName` annotation.
52+
Azure Operator Nexus supports creating Persistent Volume Claims (PVCs) using the *nexus-volume* storage class. Nexus-volume PVCs are backed by a volume on the storage appliance which is created and managed by Azure Operator Nexus. You can select the storage appliance to provide the backing storage by using the `storageApplianceName` annotation.
5353

5454
```yml
5555
apiVersion: v1
@@ -58,7 +58,7 @@ metadata:
5858
name: testPvc
5959
namespace: default
6060
annotations:
61-
nexusSharedStorageApplianceName: exampleStorageAppliance
61+
storageApplianceName: exampleStorageAppliance
6262
spec:
6363
accessModes:
6464
- ReadWriteOnce
@@ -76,11 +76,11 @@ status:
7676
phase: Bound
7777
```
7878
79-
`nexusSharedStorageApplianceName` must match the Azure resource name of the storage appliance resource managed by your Azure Operator Nexus cluster on which you want to create the volume backing your PVC. If there's no `nexusSharedStorageApplianceName` annotation, Azure Operator Nexus places the volume on the default storage appliance. If there is a `nexusSharedStorageApplianceName` annotation, but it does not match the Azure resource name of a storage appliance managed by your Azure Operator Nexus cluster, the PVC creation will fail.
79+
`storageApplianceName` must match the Azure resource name of the storage appliance resource managed by your Azure Operator Nexus cluster on which you want to create the volume backing your PVC. If there's no `storageApplianceName` annotation, Azure Operator Nexus places the volume on the default storage appliance. If there is a `storageApplianceName` annotation, but it does not match the Azure resource name of a storage appliance managed by your Azure Operator Nexus cluster, the PVC creation will fail.
8080

8181
#### Nexus-volume limitations
8282

83-
- Azure Operator Nexus doesn't support moving a PVC from one storage appliance to another. Attempts to change the `nexusSharedStorageApplianceName` annotation have no effect.
83+
- Azure Operator Nexus doesn't support moving a PVC from one storage appliance to another. Attempts to change the `storageApplianceName` annotation have no effect.
8484
- There's no support for placing volumes on a specific storage appliance when creating volumes through the Azure Resource Manager APIs. All volumes created directly through Azure Resource Manager will be placed on the storage appliance in rack slot 1.
8585

8686
### Nexus-shared storage class
@@ -89,11 +89,11 @@ Azure Operator Nexus provides a shared filesystem storage solution for container
8989

9090
You can create the shared storage service on either storage appliance when the CSN is created. All nexus-shared PVCs using that shared storage service consume storage from the storage appliance backing the shared service. The configuration applies to all nexus-shared PVCs using the shared storage service provided by the CSN. All nexus-shared PVCs using the same shared storage service use the same storage appliance.
9191

92-
The `nexusSharedStorageApplianceName` Azure resource tag controls which storage appliance is used to back the shared storage service. See [Prerequisites for deploying tenant workloads](./quickstarts-tenant-workload-prerequisites.md#create-a-cloud-services-network) for instructions on creating the shared storage service on a specific storage appliance.
92+
The `storageApplianceName` Azure resource tag controls which storage appliance is used to back the shared storage service. See [Prerequisites for deploying tenant workloads](./quickstarts-tenant-workload-prerequisites.md#create-a-cloud-services-network) for instructions on creating the shared storage service on a specific storage appliance.
9393

9494
If no storage appliance configuration is provided at CSN creation time, the shared storage service uses the first storage appliance. If the configuration is present but doesn't match a storage appliance then the CSN creation will fail.
9595

96-
Subsequent updates to the `nexusSharedStorageApplianceName` Azure resource tag have no effect. There is no support for moving the shared filesystem storage solution between storage appliances after initial deployment.
96+
Subsequent updates to the `storageApplianceName` Azure resource tag have no effect. There is no support for moving the shared filesystem storage solution between storage appliances after initial deployment.
9797

9898
#### Nexus-shared limitations
9999

articles/operator-nexus/howto-configure-cluster.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: bartpinto
55
ms.author: bpinto
66
ms.service: azure-operator-nexus
77
ms.topic: how-to
8-
ms.date: 03/31/2025
8+
ms.date: 05/22/2025
99
ms.custom: template-how-to, devx-track-azurecli
1010
---
1111

@@ -71,7 +71,7 @@ az networkcloud cluster create --name "<CLUSTER_NAME>" --location "<LOCATION>" \
7171
--rack-serial-number "<AGGR_RACK_SN>" \
7272
--rack-location "<AGGR_RACK_LOCATION>" \
7373
--bare-metal-machine-configuration-data "["<AGGR_RACK_BMM>"]" \
74-
--storage-appliance-configuration-data '[{"adminCredentials":{"password":"<SA1_PASS>","username":"<SA_USER>"},"rackSlot":1,"serialNumber":"<SA1_SN>","nexusSharedStorageApplianceName":"<SA1_NAME>"}]' \
74+
--storage-appliance-configuration-data '[{"adminCredentials":{"password":"<SA1_PASS>","username":"<SA_USER>"},"rackSlot":1,"serialNumber":"<SA1_SN>","storageApplianceName":"<SA1_NAME>"}]' \
7575
--compute-rack-definitions '[{"networkRackId": "<COMPX_RACK_RESOURCE_ID>", "rackSkuId": "<COMPX_RACK_SKU>", "rackSerialNumber": "<COMPX_RACK_SN>", "rackLocation": "<COMPX_RACK_LOCATION>", "storageApplianceConfigurationData": [], "bareMetalMachineConfigurationData":[{"bmcCredentials": {"password":"<COMPX_SVRY_BMC_PASS>", "username":"<COMPX_SVRY_BMC_USER>"}, "bmcMacAddress":"<COMPX_SVRY_BMC_MAC>", "bootMacAddress":"<COMPX_SVRY_BOOT_MAC>", "machineDetails":"<COMPX_SVRY_SERVER_DETAILS>", "machineName":"<COMPX_SVRY_SERVER_NAME>"}]}]'\
7676
--managed-resource-group-configuration name="<MRG_NAME>" location="<MRG_LOCATION>" \
7777
--network fabric-id "<NF_ID>" \
@@ -98,7 +98,7 @@ az networkcloud cluster create --name "<CLUSTER_NAME>" --location "<LOCATION>" \
9898
--rack-serial-number "<AGGR_RACK_SN>" \
9999
--rack-location "<AGGR_RACK_LOCATION>" \
100100
--bare-metal-machine-configuration-data "["<AGGR_RACK_BMM>"]" \
101-
--storage-appliance-configuration-data '[{"adminCredentials":{"password":"<SA1_PASS>","username":"<SA_USER>"},"rackSlot":1,"serialNumber":"<SA1_SN>","nexusSharedStorageApplianceName":"<SA1_NAME>"},{"adminCredentials":{"password":"<SA2_PASS>","username":"<SA_USER>"},"rackSlot":2,"serialNumber":"<SA2_SN>","nexusSharedStorageApplianceName":"<SA2_NAME>"}]' \
101+
--storage-appliance-configuration-data '[{"adminCredentials":{"password":"<SA1_PASS>","username":"<SA_USER>"},"rackSlot":1,"serialNumber":"<SA1_SN>","storageApplianceName":"<SA1_NAME>"},{"adminCredentials":{"password":"<SA2_PASS>","username":"<SA_USER>"},"rackSlot":2,"serialNumber":"<SA2_SN>","storageApplianceName":"<SA2_NAME>"}]' \
102102
--compute-rack-definitions '[{"networkRackId": "<COMPX_RACK_RESOURCE_ID>", "rackSkuId": "<COMPX_RACK_SKU>", "rackSerialNumber": "<COMPX_RACK_SN>", "rackLocation": "<COMPX_RACK_LOCATION>", "storageApplianceConfigurationData": [], "bareMetalMachineConfigurationData":[{"bmcCredentials": {"password":"<COMPX_SVRY_BMC_PASS>", "username":"<COMPX_SVRY_BMC_USER>"}, "bmcMacAddress":"<COMPX_SVRY_BMC_MAC>", "bootMacAddress":"<COMPX_SVRY_BOOT_MAC>", "machineDetails":"<COMPX_SVRY_SERVER_DETAILS>", "machineName":"<COMPX_SVRY_SERVER_NAME>"}]}]'\
103103
--managed-resource-group-configuration name="<MRG_NAME>" location="<MRG_LOCATION>" \
104104
--network fabric-id "<NF_ID>" \

articles/operator-nexus/quickstarts-tenant-workload-prerequisites.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: dramasamy
55
ms.author: dramasamy
66
ms.service: azure-operator-nexus
77
ms.topic: how-to
8-
ms.date: 01/25/2023
8+
ms.date: 05/22/2023
99
ms.custom: template-how-to-pattern, devx-track-azurecli, devx-track-azurepowershell
1010
---
1111

@@ -185,7 +185,7 @@ Deployments with multiple storage appliances support selecting the storage appli
185185
--extended-location name="<ClusterCustomLocationId >" type="CustomLocation" \
186186
--location "<ClusterAzureRegion>" \
187187
--additional-egress-endpoints "[{\"category\":\"<YourCategory >\",\"endpoints\":[{\"<domainName1 >\":\"< endpoint1 >\",\"port\":<portnumber1 >}]}]"
188-
--tags "nexusSharedStorageApplianceName": "<YourStorageApplianceName>""
188+
--tags "storageApplianceName": "<YourStorageApplianceName>""
189189
```
190190

191191
### [Azure PowerShell](#tab/azure-powershell)
@@ -201,7 +201,7 @@ $additionalEgressEndpoint = New-AzNetworkCloudEgressEndpointObject `
201201
-Category "YourCategory" `
202202
-Endpoint $endpointList
203203
$endpointEgressList+= $additionalEgressEndpoint
204-
$tags @{"nexusSharedStorageApplianceName"="<YourStorageApplianceName>"}
204+
$tags @{"storageApplianceName"="<YourStorageApplianceName>"}
205205
206206
New-AzNetworkCloudServicesNetwork -CloudServicesNetworkName "<YourCloudServicesNetworkName>" `
207207
-ResourceGroupName "<YourResourceGroupName>" `

articles/operator-nexus/troubleshoot-multiple-storage-appliances.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Troubleshooting common issues with multiple Storage Appliances
44
ms.service: azure-operator-nexus
55
ms.custom: troubleshooting
66
ms.topic: troubleshooting
7-
ms.date: 08/12/2024
7+
ms.date: 05/22/2024
88
ms.author: peterwhiting
99
author: pjw711
1010
---
@@ -35,26 +35,26 @@ If any of the configurations was incorrect:
3535

3636
## Nexus-volume Persistent Volume Claim (PVC) on the wrong storage appliance
3737

38-
PVCs using the nexus-volume storage class can select the storage appliance to use for backing storage using the `nexusSharedStorageApplianceName` annotation. If this annotation isn't present, the PVC uses the first storage appliance. You can check this by using `kubectl get pvc <pvcName> -o yaml` and checking the `nexusSharedStorageApplianceName` annotation. The value tells you which storage appliance the PVC is using.
38+
PVCs using the nexus-volume storage class can select the storage appliance to use for backing storage using the `storageApplianceName` annotation. If this annotation isn't present, the PVC uses the first storage appliance. You can check this by using `kubectl get pvc <pvcName> -o yaml` and checking the `storageApplianceName` annotation. The value tells you which storage appliance the PVC is using.
3939

4040
If you wanted to create the PVC on the other storage appliance then you must delete and recreate the PVC, and then provide the correct annotation. There's no support for moving the volumes consumed by a PVC between storage appliances.
4141

4242
## Failure to create nexus-volume PVC
4343

44-
A PVC fails to create if the `nexusSharedStorageApplianceName` annotation is present but doesn't match the Azure Resource name of a storage appliance managed by the Nexus Cluster. You can check that the `nexusSharedStorageApplianceName` annotation is correct by:
44+
A PVC fails to create if the `storageApplianceName` annotation is present but doesn't match the Azure Resource name of a storage appliance managed by the Nexus Cluster. You can check that the `storageApplianceName` annotation is correct by:
4545

4646
1. Opening the Cluster (Operator Nexus) resource in the Azure portal
4747
1. Clicking on Rack definitions in the resource menu.
4848
1. Navigating to the aggregator rack and selecting Storage Appliance definitions.
4949

50-
The `nexusSharedStorageApplianceName` annotation must match one of the storage appliances in the Storage Appliance definitions list. You must delete the PVC and recreate it with the correct annotation to resolve this issue.
50+
The `storageApplianceName` annotation must match one of the storage appliances in the Storage Appliance definitions list. You must delete the PVC and recreate it with the correct annotation to resolve this issue.
5151

5252
## Cloud Service Network (CSN) fails to create
5353

54-
A CSN fails to create if the `nexusSharedStorageApplianceName` Azure resource tag is present but doesn't match the Azure Resource name of a storage appliance managed by the Nexus Cluster. You can check that the `nexusSharedStorageApplianceName` Azure resource tag is correct by:
54+
A CSN fails to create if the `storageApplianceName` Azure resource tag is present but doesn't match the Azure Resource name of a storage appliance managed by the Nexus Cluster. You can check that the `storageApplianceName` Azure resource tag is correct by:
5555

5656
1. Opening the Cluster (Operator Nexus) resource in the Azure portal
5757
1. Clicking on Rack definitions in the resource menu.
5858
1. Navigating to the aggregator rack and selecting Storage Appliance definitions.
5959

60-
The `nexusSharedStorageApplianceName` Azure resource tag must match one of the storage appliances in the Storage Appliance definitions list. You must delete the CSN and recreate it with the correct Azure Resource tag to resolve this issue.
60+
The `storageApplianceName` Azure resource tag must match one of the storage appliances in the Storage Appliance definitions list. You must delete the CSN and recreate it with the correct Azure Resource tag to resolve this issue.

0 commit comments

Comments
 (0)