Installation notes

(Notes from Mike Hucka.) These are the steps I took to install Moccasin on different platforms. These are more or less minimal installations. In all cases, to create virtual machines (VMs), I used Parallels Desktop version 13 running on a macOS 10.13 system.

Ubuntu Linux (16.04, 18.04)

Ubuntu does not preinstall the libraries needed by wxPython, which leads to failures when running pip3 install for Moccasin. The following is a reproducible way to create an Ubuntu environment that can be used to build Moccasin.

1. Install a basic Ubuntu 16.04 or 18.04 distribution in a fresh virtual machine
2. Configure your VM to have sufficient RAM and other resources. (I used 4 GB RAM, 2 cores.)
3. Reboot
4. Log in
5. Do post-installation updates using Ubuntu's software updater
6. Reboot & log in again
7. Start a terminal shell
8. Install git, Python 3 and pip: sudo apt-get install git python3-pip
9. Install certain system packages needed by wxPython 4 that are not installed automatically:

   sudo apt-get install -y build-essential libwebkit2gtk-4.0-dev freeglut3-dev
   sudo apt-get install -y libgstreamer-plugins-base1.0-dev libsdl2-dev libtiff5-dev

10. Reboot & log in again
11. Do the Moccasin installation:

    git clone https://github.com/sbmlteam/moccasin.git
    cd moccasin
    sudo pip install .

CentOS 7

CentOS 7.4 and 7.5 do not preinstall the libraries needed by wxPython, which leads to failures when running pip3 install for Moccasin.

1. Install a basic CentOS distribution in a fresh virtual machine
2. Configure your VM to have sufficient RAM and other resources. (I used 4 GB RAM, 2 cores.)
3. Reboot
4. Log in
5. Do post-installation updates: sudo yum update -y
6. Reboot & log in again
7. Start a terminal shell
8. Install git, Python 3 and pip: sudo apt-get install git python35-pip
9. Install a C++ compiler and libraries needed to build wxPython:

   sudo yum groupinstall 'Development Tools'
   sudo yum install python35-devel mesa-libGLU-devel gtk3-devel freeglut-dev
   sudo yum install gstreamer1-devel gstreamer1-plugins-base-devel
   sudo yum install webkitgtk3-devel
   

macOS

The python provided with macOS up to 10.13 (High Sierra) is Python 2, therefore you will need to install Python 3 and pip. There are many possible approaches. For example, if you already use MacPorts as your package manager, you could use the following sequence of commands:

sudo port install python34 py34-pip
sudo port select --set python3 python34

On macOS, it is also necessary to install the Xcode command-line tools:

sudo xcode-select --install