Skip to content

Commit f6bf780

Browse files
committed
Added callout for common issues
1 parent bbfde05 commit f6bf780

File tree

1 file changed

+22
-10
lines changed

1 file changed

+22
-10
lines changed

_episodes/02-installation.md

Lines changed: 22 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,39 +29,39 @@ ESMValTool is distributed using [Conda](https://conda.io/). We will be using the
2929

3030
### Linux
3131

32-
1. Please download Miniconda3 for Linux at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html). The 64 bit version should work on any recent system. If you have problems in the next step(s) you can alternatively try a 32 bit version.
32+
1. Please download Miniconda3 for Linux at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html). The 64 bit version should work on any recent system. If you have problems in the next step(s) you can alternatively try a 32 bit version.
3333

34-
1. Next, run the installer
34+
2. Next, run the installer
3535

3636
```bash
3737
bash Miniconda3-latest-Linux-x86_64.sh
3838
```
3939

40-
1. Follow the instructions in the installer. The defaults should normally suffice.
40+
3. Follow the instructions in the installer. The defaults should normally suffice.
4141

42-
1. You will need to restart your terminal for the changes to have effect.
42+
4. You will need to restart your terminal for the changes to have effect.
4343

44-
1. Verify you have a working conda installation by listing all installed packages
44+
5. Verify you have a working conda installation by listing all installed packages
4545

4646
```bash
4747
conda list
4848
```
4949

5050
### MacOSX
5151

52-
1. Please download Miniconda3 for MacOSX at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html).
52+
1. Please download Miniconda3 for MacOSX at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html).
5353

54-
1. Next, run the installer
54+
2. Next, run the installer
5555

5656
```bash
5757
bash Miniconda3-latest-MacOSX-x86_64.sh
5858
```
5959

60-
1. Follow the instructions in the installer. The defaults should normally suffice.
60+
3. Follow the instructions in the installer. The defaults should normally suffice.
6161

62-
1. You will need to restart your terminal for the changes to have effect.
62+
4. You will need to restart your terminal for the changes to have effect.
6363

64-
1. Verify you have a working conda installation by listing all installed packages
64+
5. Verify you have a working conda installation by listing all installed packages
6565

6666
```bash
6767
conda list
@@ -139,6 +139,18 @@ This will create a new
139139
[Conda environment](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html)
140140
called `esmvaltool`, with the ESMValTool package and all of its dependencies installed in it.
141141
142+
> ## Conda common problems
143+
>
144+
> Below are some common problems that could happen while installing.
145+
>
146+
> - installation takes long time,
147+
> - downloads and compilations can take several minutes to complete, please be patient
148+
> - you might have bad luck and the dependencies can not be resolved at the moment, please try again later or [raise an issue](https://github.com/ESMValGroup/ESMValTool/issues/new/choose)
149+
> - if you have a old conda installation you could get a `UnsatisfiableError` error. Please install a new conda and try again
150+
> - downloads fail due to company proxy, see [conda docs](https://docs.anaconda.com/anaconda/user-guide/tasks/proxy/) how to resolve
151+
>
152+
{: .callout}
153+
142154
## Test that the installation was successful
143155
144156
To test that the installation was successful, run

0 commit comments

Comments
 (0)