Skip to content

Commit 5223fc7

Browse files
authored
Update how-to-troubleshoot-environments.md
1 parent 0589bb2 commit 5223fc7

File tree

1 file changed

+21
-2
lines changed

1 file changed

+21
-2
lines changed

articles/machine-learning/how-to-troubleshoot-environments.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -931,8 +931,27 @@ Read the following to understand [how to authorize access to data in Azure stora
931931
Read the following if you're interested in [using SAS to access Azure storage resources](../storage/common/storage-sas-overview.md)
932932

933933
### Horovod build
934-
- Failed to create or update the conda environment because horovod failed to build
935-
- See [horovod installation](https://aka.ms/azureml/environment/install-horovod)
934+
<!--issueDescription-->
935+
This issue can happen when the conda environment fails to be created or updated because horovod failed to build.
936+
937+
**Potential causes:**
938+
* Horovod installation requires other modules that you haven't installed
939+
* Horovod installation requires certain libraries that you haven't included
940+
941+
**Affected areas (symptoms):**
942+
* Failure in building environments from UI, SDK, and CLI.
943+
* Failure in running jobs because it will implicitly build the environment in the first step.
944+
<!--/issueDescription-->
945+
946+
**Troubleshooting steps**
947+
948+
Many issues could cause a horovod failure, and there's a comprehensive list of them in horovod's documentation
949+
* Review the [horovod troubleshooting guide](https://horovod.readthedocs.io/en/stable/troubleshooting_include.html#)
950+
* Review the Build log for your failed build to see if there's an error message that surfaced when horovod failed to build
951+
* It's possible that the problem you're encountering is detailed in the troubleshooting guide, along with the solution
952+
953+
**Resources**
954+
*[horovod installation](https://aka.ms/azureml/environment/install-horovod)
936955

937956
### Conda command not found
938957
- Failed to create or update the conda environment because the conda command is missing

0 commit comments

Comments
 (0)