Install prerequisites¶

Installing the prerequisites for RDMO differs on the different operating systems and is therefore covered in different sections.

Linux¶

We recommend to install the prerequisites using the packaging system of your distribution. On Debian/Ubuntu use:

sudo apt install build-essential libxml2-dev libxslt-dev zlib1g-dev \
                 python3-dev python3-pip python3-venv \
                 git pandoc

# optional, for pdf output
sudo apt install texlive texlive-xetex

on RHEL/CentOS use:

sudo yum install gcc gcc-c++ libxml2-devel libxslt-devel \
                 python34-devel python34-pip python34-virtualenv \
                 git pandoc

# optional, for pdf output
sudo yum install texlive texlive-xetex texlive-mathspec texlive-euenc \
    texlive-xetex-def texlive-xltxtra

On Ubuntu 14.04, python3-venv is not available. Please use python3.5-venv instead.

On RHEL/CentOS selinux is enabled by default. This can result in unexpected errors, depending on where you store the RDMO source code on the system. While the prefereble way is to configure it correctly (which is beyond the scope of this documentation), you can also set selinux to permissive or disabled in /etc/selinux/config (and reboot afterwards).

If you want to use Python 2.7 instead of Python 3, please use the corresponding packages:

apt install python-dev python-pip python-virtualenv    # Debian/Ubuntu
yum install python-devel python-pip python-virtualenv  # RHEL/CentOS

macOS¶

We recommend to install the prerequisites using brew:

brew install python3                                       # for python 3
brew install python                                        # for python 2
brew install git
brew install pandoc

# optional, for pdf export
brew install texlive

Windows¶

On Windows, the software prerequisites need to be downloaded and installed from their particular web sites.

For python:

download from https://www.python.org/downloads/windows/
we recommend a version >= 3.4
don’t forget to check ‘Add Python to environment variables’ during setup

For git:

download from https://git-for-windows.github.io/

For the Microsoft C++ Build Tools:

download from http://landinghub.visualstudio.com/visual-cpp-build-tools

For pdflatex (optional, for pdf export):

download from http://miktex.org/

All further steps need to be performed using the windows shell cmd.exe. You can open it from the Start-Menu.