Skip to content

Commit 11c9962

Browse files
johnmarcojohnmarco
committed
changes after SME review
1 parent fc933bd commit 11c9962

File tree

1 file changed

+27
-27
lines changed

1 file changed

+27
-27
lines changed

‎articles/azure-arc/servers/troubleshoot-agent-onboard.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -13,33 +13,33 @@ This article provides information for troubleshooting issues that may occur conf
1313

1414
Use the following table to identify and resolve issues when configuring the Azure Arc-enabled servers agent. You will need the `AZCM0000` ("0000" can be any four digit number) error code printed to the console or script output.
1515

16-
| Error code | Description | Probable cause | Suggested remediation |
17-
|------------|-------------|----------------|-----------------------|
18-
| AZCM0000 | No Error | The action was successful | N/A |
19-
| AZCM0001 | Default Error | An unknown error occurred | Contact Microsoft Support for assistance |
20-
| AZCM0011 | Control C Pressed | The user canceled the action (CTRL+C) | Retry the previous command |
21-
| AZCM0012 | Invalid Access Token | The access token is invalid | If authenticating via access token, obtain a new token and try again. If authenticating via service principal or device logins, contact Microsoft Support for assistance. |
22-
| AZCM0016 | Missing Mandatory Paremeter | Missing a mandatory parameter | Review the error message in the output to identify which parameters are missing. For the complete syntax of the command, run `azcmagent <command> --help`. |
23-
| AZCM0018 | Admin Privileges Needed | The command was executed without administrative privileges | Retry the command in an elevated user context (administrator/root). |
24-
| AZCM0019 | Configuration File Not Found | The path to the configuration file is incorrect | Ensure the path to the configuration file is correct and try again. |
25-
| AZCM0023 | Invalid Argument | The value provided for a parameter (argument) is invalid | Review the error message for more specific information. Refer to the syntax of the command (`azcmagent <command> --help`) for valid values or expected format for the arguments. |
26-
| AZCM0026 | Network Error | There is an error in network configuration or some critical services are temporarily unavailable | Check if the required endpoints are reachable (e.g., hostnames are resolvable, endpoints are not blocked). If the network is configured for Private Link Scope, a Private Link Scope resource ID must be provided for onboarding using the `--private-link-scope` parameter. |
27-
| AZCM0041 | Failed to Get Access Token | The credentials supplied are invalid | For device logins, verify that the user account specified has access to the tenant and subscription where the server resource will be created<sup>[1](#footnote3)</sup>.<br> For service principal logins, check the client ID and secret for correctness, the expiration date of the secret<sup>[2](#footnote4)</sup>, and that the service principal is from the same tenant where the server resource will be created<sup>[1](#footnote3)</sup>.<br> <a name="footnote3"></a><sup>1</sup>See [How to find your Azure Active Directory tenant ID](/azure/active-directory/fundamentals/active-directory-how-to-find-tenant).<br> <a name="footnote4"><sup>[2]</sup>In Azure portal, open Azure Active Directory and select the App registration blade. Select the application to be used and the Certificates and secrets within it. Check whether the expiration data has passed. If it has, create new credentials with sufficient roles and try again — see [Connected Machine agent prerequisites-required permissions](prerequisites.md#required-permissions). |
28-
| AZCM0042 | Failed to Create Resource | Creation of the Azure Arc-enabled server resource failed | Review the error message in the output to identify the cause of the failure to create resource and the suggested remediation. For permission issues, see [Connected Machine agent prerequisites-required permissions](prerequisites.md#required-permissions) for more information. |
29-
| AZCM0043 | Failed to Delete Resource | Deletion of the Azure Arc-enabled server resource failed | Verify that the user/service principal specified has permissions to delete Azure Arc-enabled server/resources in the specified group — see [Connected Machine agent prerequisites-required permissions](prerequisites.md#required-permissions).<br> If the resource no longer exists in Azure, use the `--force-local-only` flag to proceed. |
30-
| AZCM0044 | Resource Already Exists | A resource with the same name already exists | Specify a different name for the `--resource-name` parameter or delete the existing Azure Arc-enabled server in Azure and try again. |
31-
| AZCM0062 | Failed to Onboard Server to Azure | An error occurred while connecting the server | Review the error message in the output for more specific information. If the error occurred after the Azure resource was created, delete this resource before retrying. |
32-
| AZCM0063 | Failed to Disconnect Server from Azure | An error occurred while disconnecting the server | Review the error message in the output for more specific information. If this error persists, delete the resource in Azure, and then run `azcmagent disconnect --force-local-only` on the server. |
33-
| AZCM0067 | Machine Already Connected | The machine is already connected to Azure | Run `azcmagent disconnect` to remove the current connection, then try again. |
34-
| AZCM0068 | Unable to Fetch Subscription ID | Subscription name was provided, and an error occurred while looking up the corresponding subscription GUID. | Retry the command with the subscription GUID instead of subscription name. |
35-
| AZCM0061<br>AZCM0064<br>AZCM0065<br>AZCM0066<br>AZCM0070<br> | Agent Communication on Error, Unable to Obtain Change Token, Unable to Obtain Agent Metadata, Unable to Obtain Agent Status, Unable to Obtain Local Configuration | The agent service is not responding or unavailable | Verify the command is run in an elevated user context (administrator/root), ensure that the HIMDS service is running (start or restart HIMDS as needed), and try the command again. |
36-
| AZCM0081 | Failed to Get MSI Certificate from HIS | An error occurred while downloading the Azure Active Directory managed identity certificate | If this message is encountered while attempting to connect the server to Azure, the agent won't be able to communicate with the Azure Arc service. Delete the resource in Azure and try connecting again. |
37-
| AZCM0101 | Command Execution Error | The command was not parsed successfully | Run `azcmagent <command> --help` to review the command syntax |
38-
| AZCM0102 | Failed to Generate Resource Name | An error occurred while retrieving the computer hostname | Retry the command and specify a resource name (with parameter --resource-name or –n), which uses only alphanumeric characters, hyphens and/or underscores; note that resource name cannot end with a hyphen or underscore. |
39-
| AZCM0103 | Failed to Generate RSA Keys | An error occurred while generating RSA keys | Contact Microsoft Support for assistance |
40-
| AZCM0105 | Failed to Get Signed Message | An error occurred while downloading the Azure Active Directory managed identify certificate | Delete the resource created in Azure and try again. |
41-
| AZCM0147-<br>AZCM0152 | — | An error occurred while installing Azcmagent on Windows | Review the error message in the output for more specific information. |
42-
| AZCM0127-<br>AZCM0146 | — | An error occurred while installing Azcmagent on Linux | Review the error message in the output for more specific information. |
16+
| Error code | Probable cause | Suggested remediation |
17+
|------------|----------------|-----------------------|
18+
| AZCM0000 | The action was successful | N/A |
19+
| AZCM0001 | An unknown error occurred | Contact Microsoft Support for assistance |
20+
| AZCM0011 | The user canceled the action (CTRL+C) | Retry the previous command |
21+
| AZCM0012 | The access token is invalid | If authenticating via access token, obtain a new token and try again. If authenticating via service principal or device logins, contact Microsoft Support for assistance. |
22+
| AZCM0016 | Missing a mandatory parameter | Review the error message in the output to identify which parameters are missing. For the complete syntax of the command, run `azcmagent <command> --help`. |
23+
| AZCM0018 | The command was executed without administrative privileges | Retry the command in an elevated user context (administrator/root). |
24+
| AZCM0019 | The path to the configuration file is incorrect | Ensure the path to the configuration file is correct and try again. |
25+
| AZCM0023 | The value provided for a parameter (argument) is invalid | Review the error message for more specific information. Refer to the syntax of the command (`azcmagent <command> --help`) for valid values or expected format for the arguments. |
26+
| AZCM0026 | There is an error in network configuration or some critical services are temporarily unavailable | Check if the required endpoints are reachable (e.g., hostnames are resolvable, endpoints are not blocked). If the network is configured for Private Link Scope, a Private Link Scope resource ID must be provided for onboarding using the `--private-link-scope` parameter. |
27+
| AZCM0041 | The credentials supplied are invalid | For device logins, verify that the user account specified has access to the tenant and subscription where the server resource will be created<sup>[1](#footnote3)</sup>.<br> For service principal logins, check the client ID and secret for correctness, the expiration date of the secret<sup>[2](#footnote4)</sup>, and that the service principal is from the same tenant where the server resource will be created<sup>[1](#footnote3)</sup>.<br> <a name="footnote3"></a><sup>1</sup>See [How to find your Azure Active Directory tenant ID](/azure/active-directory/fundamentals/active-directory-how-to-find-tenant).<br> <a name="footnote4"></a><sup>2</sup>In Azure portal, open Azure Active Directory and select the App registration blade. Select the application to be used and the Certificates and secrets within it. Check whether the expiration data has passed. If it has, create new credentials with sufficient roles and try again — see [Connected Machine agent prerequisites-required permissions](prerequisites.md#required-permissions). |
28+
| AZCM0042 | Creation of the Azure Arc-enabled server resource failed | Review the error message in the output to identify the cause of the failure to create resource and the suggested remediation. For permission issues, see [Connected Machine agent prerequisites-required permissions](prerequisites.md#required-permissions) for more information. |
29+
| AZCM0043 | Deletion of the Azure Arc-enabled server resource failed | Verify that the user/service principal specified has permissions to delete Azure Arc-enabled server/resources in the specified group — see [Connected Machine agent prerequisites-required permissions](prerequisites.md#required-permissions).<br> If the resource no longer exists in Azure, use the `--force-local-only` flag to proceed. |
30+
| AZCM0044 | A resource with the same name already exists | Specify a different name for the `--resource-name` parameter or delete the existing Azure Arc-enabled server in Azure and try again. |
31+
| AZCM0062 | An error occurred while connecting the server | Review the error message in the output for more specific information. If the error occurred after the Azure resource was created, delete this resource before retrying. |
32+
| AZCM0063 | An error occurred while disconnecting the server | Review the error message in the output for more specific information. If this error persists, delete the resource in Azure, and then run `azcmagent disconnect --force-local-only` on the server. |
33+
| AZCM0067 | The machine is already connected to Azure | Run `azcmagent disconnect` to remove the current connection, then try again. |
34+
| AZCM0068 | Subscription name was provided, and an error occurred while looking up the corresponding subscription GUID. | Retry the command with the subscription GUID instead of subscription name. |
35+
| AZCM0061<br>AZCM0064<br>AZCM0065<br>AZCM0066<br>AZCM0070<br> | The agent service is not responding or unavailable | Verify the command is run in an elevated user context (administrator/root), ensure that the HIMDS service is running (start or restart HIMDS as needed), and try the command again. |
36+
| AZCM0081 | An error occurred while downloading the Azure Active Directory managed identity certificate | If this message is encountered while attempting to connect the server to Azure, the agent won't be able to communicate with the Azure Arc service. Delete the resource in Azure and try connecting again. |
37+
| AZCM0101 | The command was not parsed successfully | Run `azcmagent <command> --help` to review the command syntax |
38+
| AZCM0102 | An error occurred while retrieving the computer hostname | Retry the command and specify a resource name (with parameter --resource-name or –n), which uses only alphanumeric characters, hyphens and/or underscores; note that resource name cannot end with a hyphen or underscore. |
39+
| AZCM0103 | An error occurred while generating RSA keys | Contact Microsoft Support for assistance |
40+
| AZCM0105 | An error occurred while downloading the Azure Active Directory managed identify certificate | Delete the resource created in Azure and try again. |
41+
| AZCM0147-<br>AZCM0152 | An error occurred while installing Azcmagent on Windows | Review the error message in the output for more specific information. |
42+
| AZCM0127-<br>AZCM0146 | An error occurred while installing Azcmagent on Linux | Review the error message in the output for more specific information. |
4343

4444
## Agent verbose log
4545

0 commit comments

Comments
 (0)