Skip to content

Commit 0c0c997

Browse files
committed
Update storageApplianceName to new tag, nexusSharedStorageApplianceName
1 parent e6a7d41 commit 0c0c997

5 files changed

+11
-11
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -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-
"storageApplianceName": "<SA_NAME>",
64+
"nexusSharedStorageApplianceName": "<SA_NAME>",
6565
"serialNumber": "<SA_SN>"
6666
}
6767
],

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -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 *storageApplianceName* 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 *nexusSharedStorageApplianceName* 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: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -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 `storageApplianceName` 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 `nexusSharedStorageApplianceName` annotation.
5353

5454
```yml
5555
apiVersion: v1
@@ -58,7 +58,7 @@ metadata:
5858
name: testPvc
5959
namespace: default
6060
annotations:
61-
storageApplianceName: exampleStorageAppliance
61+
nexusSharedStorageApplianceName: exampleStorageAppliance
6262
spec:
6363
accessModes:
6464
- ReadWriteOnce
@@ -76,11 +76,11 @@ status:
7676
phase: Bound
7777
```
7878
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.
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.
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 `storageApplianceName` annotation have no effect.
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.
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

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -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>","storageApplianceName":"<SA1_NAME>"}]' \
74+
--storage-appliance-configuration-data '[{"adminCredentials":{"password":"<SA1_PASS>","username":"<SA_USER>"},"rackSlot":1,"serialNumber":"<SA1_SN>","nexusSharedStorageApplianceName":"<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>","storageApplianceName":"<SA1_NAME>"},{"adminCredentials":{"password":"<SA2_PASS>","username":"<SA_USER>"},"rackSlot":2,"serialNumber":"<SA2_SN>","storageApplianceName":"<SA2_NAME>"}]' \
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>"}]' \
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/troubleshoot-multiple-storage-appliances.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,19 +35,19 @@ 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 `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.
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.
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 `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:
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:
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 `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.
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.
5151

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

0 commit comments

Comments
 (0)