Merge pull request #237 from ESMValGroup/update_installation_episode2

Update installation episode2 for v2.5.0

Author: rswamina

_episodes/02-installation.md

@@ -100,6 +100,42 @@ To install mamba on ``Linux`` or ``MacOSX``, follow the  instructions below:
 For more information about installing mamba,
 see [the mamba installation documentation](https://docs.esmvaltool.org/en/latest/quickstart/installation.html#mamba-installation).
 
+### Install the ESMValTool package
+
+The ESMValTool package contains diagnostics scripts in four languages: R,
+Python, Julia and NCL. This introduces a lot of dependencies, and therefore the
+installation can take quite long. It is, however, possible to install
+'subpackages' for each of the languages. The following (sub)packages are
+available:
+
+- `esmvaltool-python`
+- `esmvaltool-ncl`
+- `esmvaltool-r`
+- `esmvaltool` --> the complete package, i.e. the combination of the above.
+
+For the tutorial, we will install the complete package. Thus, to install the
+ESMValTool package, run
+
+```bash
+mamba create --name esmvaltool esmvaltool 'python=3.10'
+```
+
+On MacOSX ESMValTool functionalities in Julia, NCL, and R are not supported. To install
+a Mamba environment on MacOSX, please refer to specific [information](https://docs.esmvaltool.org/en/latest/quickstart/installation.html#installation-on-macosx).
+
+This will create a new [Mamba
+environment](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html)
+called `esmvaltool`, with the ESMValTool package and all of its dependencies
+installed in it.
+
+
+> ## Common issues
+>
+> You find a list of common installation problems and their solutions in the 
+> [documentation](https://docs.esmvaltool.org/en/latest/quickstart/installation.html#common-installation-problems-and-their-solutions).
+>
+{: .callout}
+
 ### Install Julia
 
 Some ESMValTool diagnostics are written in the Julia programming language.
@@ -113,46 +149,18 @@ installation page](https://julialang.org/downloads/platform/#linux_and_freebsd).
 
 > ## Julia installation instructions
 >
-> First, open a bash terminal and create a directory to install Julia in and cd
-> into it
+> First, open a bash terminal and activate the newly created `esmvaltool` environment.
 >
 > ```bash
-> mkdir ~/julia
-> cd ~/julia
+> conda activate esmvaltool
 > ```
 >
-> Next, to download and extract the file `julia-1.0.5-linux-x86_64.tar.gz`, you can use the following commands::
+> Next, to install Julia via `mamba`, you can use the following command:
 >
 > ```bash
-> wget https://julialang-s3.julialang.org/bin/linux/x64/1.0/julia-1.0.5-linux-x86_64.tar.gz
-> tar -xvzf julia-1.0.5-linux-x86\_64.tar.gz
+> mamba install julia
 > ```
->
-> This will extract the files to a directory named `~/julia/julia-1.0.5`. To run
-> Julia, you need to add the full path of Julia's `bin` folder to PATH environment
-> variable. To do this, you can edit the `~/.bashrc` (or `~/.bash_profile`) file.
-> Open the file in a text editor called ``nano``:
->
-> ```bash
-> nano ~/.bashrc
-> ```
->
-> and add a new line as follows at the
-> bottom of the file:
->
-> ```bash
-> export PATH="$PATH:$HOME/julia/julia-1.0.5/bin"
-> ```
->
-> Finally, for the settings to take effect, either reload your bash profile
->
-> ```bash
-> source ~/.bashrc
-> ```
->
-> (or `source ~/.bash_profile`), or close the bash terminal window and open a new
-> one.
->
+> 
 > To check that the Julia executable can be found, run
 >
 > ```bash
@@ -162,7 +170,7 @@ installation page](https://julialang.org/downloads/platform/#linux_and_freebsd).
 > to display the path to the Julia executable, it should be
 >
 > ```
-> ~/julia/julia-1.0.5/bin/julia
+> ~/mambaforge/envs/esmvaltool/bin/julia
 > ```
 > {: .output}
 >
@@ -175,53 +183,6 @@ installation page](https://julialang.org/downloads/platform/#linux_and_freebsd).
 > to start the interactive Julia interpreter. Press `Ctrl+D` to exit.
 {: .solution}
 
-### Install the ESMValTool package
-
-The ESMValTool package contains diagnostics scripts in four languages: R,
-Python, Julia and NCL. This introduces a lot of dependencies, and therefore the
-installation can take quite long. It is, however, possible to install
-'subpackages' for each of the languages. The following (sub)packages are
-available:
-
-- `esmvaltool-python`
-- `esmvaltool-ncl`
-- `esmvaltool-r`
-- `esmvaltool` --> the complete package, i.e. the combination of the above.
-
-For the tutorial, we will install the complete package. Thus, to install the
-ESMValTool package, run
-
-```bash
-mamba create --name esmvaltool 'python=3.9'
-```
-
-Next, we install many of the required dependencies, including the ESMValCore package
-and Python, R, and NCL interpreters, into this environment by running:
-
-```bash
-mamba env update --name esmvaltool --file environment.yml
-```
-
-On MacOSX ESMValTool functionalities in Julia, NCL, and R are not supported. To install
-a Mamba environment on MacOSX, use the dedicated environment file:
-
-```bash
-mamba env create --name esmvaltool --file environment_osx.yml
-```
-
-This will create a new [Mamba
-environment](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html)
-called `esmvaltool`, with the ESMValTool package and all of its dependencies
-installed in it.
-
-
-> ## Common issues
->
-> You find a list of common installation problems and their solutions in the 
-> [documentation](https://docs.esmvaltool.org/en/latest/quickstart/installation.html#common-installation-problems-and-their-solutions).
->
-{: .callout}
-
 ### Test that the installation was successful
 
 To test that the installation was successful, run
@@ -258,8 +219,8 @@ to display the command line help.
 > > {: .bash}
 > > The version of ESMValTool installed should be displayed on the screen as:
 > > ~~~
-> > ESMValCore: 2.4.0
-> > ESMValTool: 2.4.0
+> > ESMValCore: 2.5.0
+> > ESMValTool: 2.5.0
 > > ~~~
 > > {: .output}
 > {: .solution}