From ff896598fa2be2f98b28102fc1275ca90e1e3025 Mon Sep 17 00:00:00 2001 From: Mark Payne Date: Thu, 17 Jan 2019 22:52:39 -0500 Subject: [PATCH] Add Installation Instructions for Ubuntu Subsystem in Windows 10 --- .../source/users/rmg/installation/index.rst | 4 +- .../rmg/installation/ubuntuSubsystem.rst | 43 +++++++++++++++++++ 2 files changed, 46 insertions(+), 1 deletion(-) create mode 100644 documentation/source/users/rmg/installation/ubuntuSubsystem.rst diff --git a/documentation/source/users/rmg/installation/index.rst b/documentation/source/users/rmg/installation/index.rst index 8f6f694875f..a325b46f872 100644 --- a/documentation/source/users/rmg/installation/index.rst +++ b/documentation/source/users/rmg/installation/index.rst @@ -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 diff --git a/documentation/source/users/rmg/installation/ubuntuSubsystem.rst b/documentation/source/users/rmg/installation/ubuntuSubsystem.rst new file mode 100644 index 00000000000..ac1900b98af --- /dev/null +++ b/documentation/source/users/rmg/installation/ubuntuSubsystem.rst @@ -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 +`_. 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 `_. 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.