From a9adeaaa4de0367c8b4c5e603a6099c655cc876f Mon Sep 17 00:00:00 2001 From: Anthony Scopatz Date: Fri, 2 Sep 2016 12:04:26 -0400 Subject: [PATCH] New Conda Install Instructions (#204) OK merging. thx @scopatz !! I maybe be add that in the rework we are doing. I was thinking having the unit_test workings might be a good way to ensure the proper installation of cyclus/cycamore... --- source/user/condarc | 9 +----- source/user/install.rst | 61 ++++++++++++++--------------------------- 2 files changed, 21 insertions(+), 49 deletions(-) diff --git a/source/user/condarc b/source/user/condarc index 8c51fd64c..8da8b326e 100644 --- a/source/user/condarc +++ b/source/user/condarc @@ -1,11 +1,4 @@ -# This is a sample .condarc file - -# channel locations. These override conda defaults, i.e., conda will -# search *only* the channels listed here, in the order given. Use "defaults" to -# automatically include all default channels. Non-url channels will be -# interpreted as binstar usernames (this can be changed by modifying the -# channel_alias key; see below). channels: - - https://conda.binstar.org/cyclus + - conda-forge - defaults diff --git a/source/user/install.rst b/source/user/install.rst index 487be4a82..be910d527 100644 --- a/source/user/install.rst +++ b/source/user/install.rst @@ -1,40 +1,40 @@ Installing |Cyclus| with Conda ============================== -Conda is a cross platform, user space package manager aimed at simplifying the -installation of open source software. The |cyclus| project uses conda to distribute +Conda is a cross platform, user space package manager aimed at simplifying the +installation of open source software. The |cyclus| project uses conda to distribute pre-built cyclus and cycamore binaries. Fresh Install ------------- -If you are new to conda or do not have conda already installed on your system, +If you are new to conda or do not have conda already installed on your system, please follow these steps to install |cyclus|. -Basic installation instructions for Conda can be found -`here `_. +Basic installation instructions for Conda can be found +`here `_. 1. Download and Install Miniconda * Go to the `miniconda downloads page `_ and get the version approriate to your system. - * Install this to the ``~/miniconda`` directory. For example, you would + * Install this to the ``~/miniconda`` directory. For example, you would use a command similar the following: - .. code-block:: bash + .. code-block:: bash - $ bash Miniconda-3.5.2-Linux-x86_64.sh -b -p ~/miniconda + $ bash Miniconda-Latest-Linux-x86_64.sh -b -p ~/miniconda - * Finally, add the ``~/miniconda/bin`` directory to your ``PATH`` either + * Finally, add the ``~/miniconda/bin`` directory to your ``PATH`` either in your current environment or in your ``.bashrc`` or both. - .. code-block:: bash + .. code-block:: bash $ export PATH="${HOME}/miniconda/bin:${PATH}" 2. Configure conda to look for |cyclus| - * Download this :download:`condarc` file and save it as ``~/.condarc``. If + * Download this :download:`condarc` file and save it as ``~/.condarc``. If you'd prefer to do this from the command line, type: - .. code-block:: bash + .. code-block:: bash $ curl -L http://fuelcycle.org/_downloads/condarc >> ~/.condarc @@ -42,50 +42,29 @@ Basic installation instructions for Conda can be found * Now that conda is installed and ready, installing |Cyclus| is as simple as: - .. code-block:: bash - - $ conda install cycamore --yes + .. code-block:: bash - Note that installing cycamore will also install cyclus since cyclus is one - of cycamore's dependencies. + $ conda install --yes cyclus cycamore -4. Install Cyclist (optional) - - * Now that cyclus is installed and ready, installing the graphical user interface is - simple as: - - .. code-block:: bash - - $ conda install cyclist --yes - -And that is it! +And that is it! Already Have Conda? ------------------- If you already have conda installed, installing |Cyclus| is even easier. -You simply need to make sure that the |Cyclus| binstar organization is part of +You simply need to make sure that conda-forge is part of your channels. Please edit the ``channels`` section of your :file:`~/.condarc` -to include the URL ``https://conda.binstar.org/cyclus``. For example, +to include the ``conda-forge`` channel. For example, .. code-block:: yaml channels: - - https://conda.binstar.org/cyclus + - conda-forge - defaults Once this is done, install |Cyclus| with the following comand. -.. code-block:: bash - - $ conda install cycamore --yes - -Note that installing cycamore will also install cyclus since cyclus is one -of cycamore's dependencies. Furthermore, you may also optionally install Cyclist, -the graphical user interface tool for cyclus databases. This can be done -with the following: +.. code-block:: bash -.. code-block:: bash - - $ conda install cyclist --yes + $ conda install --yes cyclus cycamore Happy simulating! \ No newline at end of file