Commit 47b250193d8fa7ff50b5defa1774b3bbc4a45ef2

Authored by Erwan Motte
1 parent b2a7d6fe
Exists in master

Updated install documentation

Showing 1 changed file with 54 additions and 4 deletions   Show diff stats
source/PRO/PRO_install.rst
... ... @@ -12,14 +12,63 @@ processing chain.
12 12 Requirements
13 13 ============
14 14  
  15 +Hardware
  16 +--------
  17 +
  18 +The GLORI processing chain have been tested successfully on standard PC
  19 +equipped with intel core i7 processors and at least 8GB of RAM. Campaign
  20 +data can be stored on an external hard drive (min 3TB).
  21 +
  22 +Software
  23 +--------
  24 +
15 25 Currently, the GLORI processing chain has been used and tested only on Linux
16   -Fedora 23. The major requirements comes form the availability of python
  26 +Fedora 23 and 24. The major requirements comes from the availability of python
17 27 packages on the target platform.
18 28  
19 29  
20 30 Installation instructions
21 31 =========================
22 32  
  33 +Fedora Virtual machine installation
  34 +-----------------------------------
  35 +
  36 +- Install the latest version of virtualbox_
  37 +
  38 +- Download the latest version of `Fedora workstation`_
  39 +
  40 +- Create a new virtual machine in virtualbox (32 GB recommended) and install
  41 + Fedora on it (instructions `here <http://www.wikihow
  42 + .com/Install-Fedora-17-in-Virtualbox>`_)
  43 +
  44 +- Make data available on the virtual machine
  45 +
  46 + - create a shared folder in virtualbox, call it F_DRIVE, pointing to the
  47 + GLORI data folder
  48 +
  49 + - on the Fedora machine add linux user to the virtualbox group
  50 +
  51 + .. code-block:: none
  52 +
  53 + sudo usermod -aG vboxsf <user>
  54 +
  55 +
  56 +.. _virtualbox : https://www.virtualbox.org/
  57 +.. _`Fedora workstation` : https://getfedora.org/en/workstation/
  58 +
  59 +Fedora configuration and software installation
  60 +----------------------------------------------
  61 +
  62 +All the following steps have to be done from Fedora or the Linux
  63 +distribution that will host the GLORI processing chain.
  64 +
  65 +- Download and install `Anaconda python 2`_
  66 +
  67 +- Download and install `PyCharm Community Edition`_
  68 +
  69 +
  70 +.. _`Anaconda python 2` : https://www.continuum.io/downloads#_unix
  71 +.. _`PyCharm Community Edition` : https://www.jetbrains.com/pycharm/download
23 72  
24 73 Benchmark
25 74 =========
... ... @@ -28,10 +77,11 @@ Benchmark
28 77 - HP : Intel Core i7-5500U_ @ 2.39GHz (2 cores, 4 threads), 8GB RAM
29 78  
30 79 .. _i7-4790 : http://ark.intel.com/fr/products/80806/Intel-Core-i7-4790-Processor-8M-Cache-up-to-4_00-GHz
31   -.. _i7-5500U : http://ark.intel.com/fr/products/85214/Intel-Core-i7-5500U-Processor-4M-Cache-up-to-3_00-GHz
  80 +.. _i7-5500U : http://ark.intel.com/fr/products/85214/Intel-Core-i7-5500U-Processor-4M-Cache-up-to-3_00-GHz
32 81  
33 82 When the processing chain is used inside a virtual machine, the number of
34   -useful cores/threads and usable memory is divided by 2.
  83 +useful cores/threads and usable memory can be selected by the user. By
  84 +default we use all the cores and half of the available memory.
35 85  
36 86 .. list-table:: Phoronix Benchmarks
37 87 :widths: 20 15 15 15 15 15
... ... @@ -51,7 +101,7 @@ useful cores/threads and usable memory is divided by 2.
51 101 - 27
52 102 - 11 170
53 103  
54   - * - HP Fedora 24 VB
  104 + * - HP Fedora 24 VB 1 core
55 105 - 3 756
56 106 - 5 347
57 107 - 5 920
... ...