Skip to content

Commit 284b1ad

Browse files
authored
Update disconnected-operations-known-issues.md
Added the H2 heading back so that the other headings aren't out of alignment.
1 parent 9680a03 commit 284b1ad

File tree

1 file changed

+31
-29
lines changed

1 file changed

+31
-29
lines changed

azure-local/manage/disconnected-operations-known-issues.md

Lines changed: 31 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,9 @@ This article lists critical known issues and their workarounds in disconnected o
1818

1919
These release notes update continuously, and we add critical issues that require a workaround as we find them. Before you deploy disconnected operations with Azure Local, review the information here.
2020

21-
## Azure Local deployment with Azure Keyvault
21+
## Known issues for the preview release
22+
23+
### Azure Local deployment with Azure Keyvault
2224

2325
Role-Based Access Control (RBAC) permissions on a newly created Azure Key Vault take up to 20 minutes to propagate. If you create the Azure Key Vault in the local portal and try to finish the cloud deployment, you might encounter permission issues when validating the cluster before deployment.
2426

@@ -72,29 +74,29 @@ $managedIds|foreach-object {
7274
Write-Verbose "Wait 30 min before running cloud deployment from portal"
7375
```
7476

75-
## Azure Local VMs (Arc VMs)
77+
### Azure Local VMs (Arc VMs)
7678

77-
### Azure Resource Graph add or edit tags error
79+
#### Azure Resource Graph add or edit tags error
7880

7981
When adding or editing a tag on an Arc VM, you might see an Azure Resource Graph error.
8082

8183
**Mitigation**: Use Azure Command-Line Interface (CLI) to add or edit tags for the resource.
8284

83-
### Start, restart, or delete buttons disabled after stopping VM
85+
#### Start, restart, or delete buttons disabled after stopping VM
8486

8587
After you stop an Arc VM, the start, restart, and delete buttons in the Azure portal are disabled.
8688

8789
**Mitigation**: Refresh your browser and the page.
8890

89-
### Unable to view the network interface or read properties on an Arc VM
91+
#### Unable to view the network interface or read properties on an Arc VM
9092

9193
Viewing the network interface or properties on an Arc VM in the portal is unsupported in this preview release.
9294

93-
### Portal showing unsaved change notification after updating VM size
95+
#### Portal showing unsaved change notification after updating VM size
9496

9597
If the notification in the top right shows that the save operation is complete, you can ignore the unsaved message and continue navigating away. The VM size is updated.
9698

97-
### Delete a VM resource
99+
#### Delete a VM resource
98100

99101
When you delete a VM from the portal, you might see the message ***Delete associated resource failed*** and ***Failed to delete the associated resource 'name' of type 'Network interface'***.
100102

@@ -104,9 +106,9 @@ When you delete a VM from the portal, you might see the message ***Delete associ
104106
az stack-hci-vm network nic delete
105107
```
106108

107-
## Azure Kubernetes Service (AKS) on Azure Local
109+
### Azure Kubernetes Service (AKS) on Azure Local
108110

109-
### Use an existing public key when creating AKS cluster
111+
#### Use an existing public key when creating AKS cluster
110112

111113
In this release, you can only use an existing public key when creating an AKS cluster.
112114

@@ -117,7 +119,7 @@ ssh-keygen -t rsa
117119
(cat ~\.ssh\id_rsa.pub)|set-clipboard
118120
```
119121

120-
### Update or scale a node pool from the portal is disabled
122+
#### Update or scale a node pool from the portal is disabled
121123

122124
Updating or scaling a node pool from the portal is unsupported in this preview release.
123125

@@ -128,35 +130,35 @@ az aksarc nodepool update
128130
az aksarc nodepool scale
129131
```
130132

131-
### Kubernetes cluster list empty under Azure Local (Kubernetes clusters)
133+
#### Kubernetes cluster list empty under Azure Local (Kubernetes clusters)
132134

133135
When you navigate to Azure Local and click **Kubernetes clusters**, you might see an empty list of clusters.
134136

135137
**Mitigation**: Navigate to **Kubernetes** > **Azure Arc** in the left menu or using the search bar. Your clusters should appear in the list.
136138

137-
### Save Kubernetes service notification stuck
139+
#### Save Kubernetes service notification stuck
138140

139141
After updating to a newer version of Kubernetes, you might encounter a stuck notification, `Save Kubernetes service`.
140142

141143
**Mitigation**: Navigate to the cluster view page and refresh it. Verify that the state is still upgrading or has completed. If it's completed, you can ignore the notification.
142144

143-
### Activity log shows authentication issue
145+
#### Activity log shows authentication issue
144146

145147
Ignore the portal warning for this release.
146148

147-
### Microsoft Entra authentication with Kubernetes RBAC fails
149+
#### Microsoft Entra authentication with Kubernetes RBAC fails
148150

149151
When attempting to create a Kubernetes cluster with Entra authentication, you encounter an error.
150152

151153
**Mitigation**: Only local accounts with Kubernetes RBAC are supported in this preview release.
152154

153-
### Arc extensions
155+
#### Arc extensions
154156

155157
When navigating to extensions on an AKS cluster the add button is disabled and there aren't any extensions listed.
156158

157159
Arc extensions are unsupported in this preview release.
158160

159-
### AKS resource shows on portal after deletion
161+
#### AKS resource shows on portal after deletion
160162

161163
After successfully deleting an AKS cluster from portal the resource continues to show.
162164

@@ -166,47 +168,47 @@ After successfully deleting an AKS cluster from portal the resource continues to
166168
az aksarc delete
167169
```
168170

169-
### Export Host Guardian Service certificates
171+
#### Export Host Guardian Service certificates
170172

171173
This feature is unsupported in this preview release.
172174

173-
### Restart a node or the control plane VM
175+
#### Restart a node or the control plane VM
174176

175177
After you restart a node or the control plane VM, the system might take up to an hour to become fully ready. If you notice issues with the local portal, missing resources, or failed deployments, check the appliance health using the **OperationsModule** to confirm that all services are fully converged.
176178

177-
## Subscriptions
179+
### Subscriptions
178180

179-
### Operator create subscription
181+
#### Operator create subscription
180182

181183
After you create a new subscription as an operator, the subscription appears in the list as non-clickable and displays ***no access*** for the owner.
182184

183185
**Mitigation**: Refresh your browser window.
184186

185-
### Operator subscriptions view (timeout)
187+
#### Operator subscriptions view (timeout)
186188

187189
If you're signed in as an operator, you might see a timeout screen and be unable to view, list, or create subscriptions.
188190

189191
**Cause**: This issue happens when a subscription owner is deleted or isn't synced from the source identity system to the local control plane. When you try to view subscriptions, the process fails because the owner's identity isn't available.
190192

191193
**Mitigation**: If the portal doesn't work, use Azure CLI or REST API to create and list subscriptions. To assign a different owner, use the REST API and enter the `subscriptionOwnerId` parameter when you create the subscription.
192194

193-
## Azure CLI
195+
### Azure CLI
194196

195-
### Manage clouds
197+
#### Manage clouds
196198

197199
When you use the `az cloud` commands, such as `az cloud register`, `az cloud show`, or `az cloud set`, you might encounter issues if you use uppercase letters in the cloud name.
198200

199201
**Mitigation**: Only use lowercase letters for cloud names in `az cloud` subcommands, such as `register`, `show`, or `set`.
200202

201-
### Create subscriptions
203+
#### Create subscriptions
202204

203205
Azure CLI doesn't support providing `subscriptionOwnerId` for new subscriptions. This makes the operator the default owner of newly created subscriptions without a way of changing the owner currently.
204206

205207
**Mitigation**: Use `az rest` to create subscriptions with a different owner if required to automate directly with different owner
206208

207-
## Azure portal
209+
### Azure portal
208210

209-
### Signout fails
211+
#### Signout fails
210212

211213
When you select Sign-out, the request doesn't work.
212214

@@ -218,13 +220,13 @@ When you select Sign-out, the request doesn't work.
218220
219221
### AKS on Azure Local-->
220222

221-
## Azure Resource Manager
223+
### Azure Resource Manager
222224

223-
### Template specs
225+
#### Template specs
224226

225227
Template specs are unsupported in the preview release. Deployments that use ARM templates with template specs fail.
226228

227-
## Unsupported scenarios
229+
### Unsupported scenarios
228230

229231
The following scenarios are unsupported in the preview release.
230232

0 commit comments

Comments
 (0)