Skip to content

Commit

Permalink
Add Installation Instructions for Ubuntu Subsystem in Windows 10
Browse files Browse the repository at this point in the history
  • Loading branch information
amarkpayne committed Jan 21, 2019
1 parent 669ef4c commit da2d2f1
Show file tree
Hide file tree
Showing 2 changed files with 46 additions and 1 deletion.
4 changes: 3 additions & 1 deletion documentation/source/users/rmg/installation/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,12 +21,14 @@ Installation on a Windows Platform

Due to difficulties with dependencies, installation on Windows directly is no longer supported. Instead, it is
recommended to run a Linux virtual machine from Windows and follow either the instructions for basic users
(binary installation using Anaconda) or the instructions for developers.
(binary installation using Anaconda) or the instructions for developers. Alternatively, it is also possible to install
RMG in the Ubuntu subsystem now available on Windows 10.

.. toctree::
:maxdepth: 1

virtualMachineSetup
ubuntuSubsystem


For Basic Users: Binary Installation Using Anaconda
Expand Down
43 changes: 43 additions & 0 deletions documentation/source/users/rmg/installation/ubuntuSubsystem.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
.. _ubuntuSubsystem:

*****************************************************
Installing RMG in the Ubuntu Subsystem on Windows 10
*****************************************************

Installing the Ubuntu Subsystem
===================================

1. Follow the instructions provided by Microsoft to install the Ubuntu subsystem, available `here
<https://docs.microsoft.com/en-us/windows/wsl/install-win10>`_. The basic steps include enabling the Windows Linux
subsystem from a powershell **run as an administrator**, and downloading the latest LTS version of Ubuntu
*from the Windows store*. We highly recommend Ubuntu over the other Linux distros, as Ubuntu is used by many of the
RMG developers.

2. Once the Ubuntu subsystem is installed, open an Ubuntu terminal. Open a web browser in Windows and go to the
`Anaconda Python Platform Downloads Page <https://www.anaconda.com/download/#linux>`_. Go to the tab for the
**Linux Installer**, and **right click** on the download icon for Python 2.7 to copy the link location. Paste this link
into the Ubuntu terminal immediately after the ``wget`` command, so that your terminal looks like the following: ::

wget https://repo.continuum.io/archive/Anaconda2-2018.12-Linux-x86_64.sh

Your exact link will look similar to the one above, but may be a more recent version of the installer. Execute this
command in the terminal to begin downloading the installer.

3. Once the Anaconda installer has downloaded, execute the following commands in the Ubuntu terminal, changing the name
of ``Anaconda2-2018.12-Linux-x86_64.sh`` to match the name of the script you downloaded. ::

chmod 744 Anaconda2-2018.12-Linux-x86_64.sh
./Anaconda2-2018.12-Linux-x86_64.sh

Install the anaconda2 folder inside your home directory (it should be the default location when it asks for a location
to install). **When prompted to append Anaconda to your PATH, select or type Yes**. You do NOT need to install Microsoft
VSCode.

4. Execute the following commands to make sure that all of the required packages in Ubuntu are also installed: ::

sudo apt install gcc
sudo apt install g++
sudo apt install make
sudo apt-get install libxrender1

5. Follow the instructions for either the binary or source installation for the Linux Operating system.

0 comments on commit da2d2f1

Please sign in to comment.