README.md 3.07 KB
Newer Older
Maxime Perrotin committed
1 2 3
TASTE
=====

Maxime Perrotin committed
4 5 6
This is the meta package that is used to install all git modules required
to make a TASTE installation.

7 8 9 10 11 12
Installation
============

TASTE Virtual Machine
---------------------
If possible, please use the TASTE VM - it is available at [http://taste.tools](http://taste.tools)
13
(follow the 'Downloads' link and download the .ova file - that's a VirtualBox
14 15 16 17 18 19 20 21 22 23 24 25
machine that you can import via VirtualBox's *"File/Import Appliance"*).

Docker container
----------------
The repository includes a Dockerfile, that creates a fully functional "taste" Docker image,
built from the sources necessary in all the submodules.

Simply Process this Dockerfile with:

    docker build -t taste .

And we then recommend to launch a fresh TASTE container with proper X11 redirection setup, with...
Maxime Perrotin committed
26

27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
    ./Docker-run.sh

This script does all the necessary setup to map your local X11 socket inside the container,
allowing you to use X11 applications. In addition, your `$HOME` folder is mapped inside the
container under the `/root/work` folder, so any work you do in there will survive the
container's eventual closing. As with all Docker containers, you can also commit the 
changes you perform in your container (via `docker commit...`) and create your own
customized images.

For users where the TASTE VM is a concern for reasons of security *(e.g. uncertainty of what
exactly is included inside it)* the Docker container is a complete and clear answer: 
it is built from source, so there is full visibility on what is inside it.

In Debian-based distributions
-----------------------------
In theory,  under a modern Debian-based distribution a native install is also possible:
you would start by creating a new 'taste' user, and...
44

45
    $ git clone https://gitrepos.estec.esa.int/taste/taste-setup.git tool-src
46 47 48
    $ cd tool-src
    $ ./Update-TASTE.sh

49
You'd then have to follow the prompts to fix whatever issues are detected in your configuration.
50

51 52 53
In any native distribution offering `debootstrap`
-------------------------------------------------
Since the installation scripts depend on Debian tools, the setup process only works as-is inside environments that are Debian-based. Note however that almost all distributions offer `debootstrap` - a tool that allows the setup of a complete Debian chroot:
54

55 56 57 58 59 60 61
    # mkdir /opt/jessie-chroot
    # debootstrap jessie /opt/jessie-chroot
    # mount -t proc none /opt/jessie-chroot/proc/
    # mount -t sysfs none /opt/jessie-chroot/sys/
    # mount -o bind /dev /opt/jessie-chroot/dev/
    # mount -o bind /dev/pts /opt/jessie-chroot/dev/pts/
    # chroot /opt/jessie-chroot
62 63 64 65

At this point, you can continue with the normal process described above for Debian-based distributions - for (almost) all intents and purposes, this chroot will behave just like a native Debian install; and thus allows you to have a "sandboxed" TASTE install that will not interfere with your main distribution.

In fact, this is reason enough to employ this process even if you do have a Debian-based distribution; the chroot will contain all TASTE-related work, and will therefore leave your main distribution undisturbed.