Installation

You can use the pip utility to install this package. One way of doing that is by pointing pip directly to the directory containing the setup.py file such as:

pip install .

Alternatively, one can use the public repository of this project for installation by pip such as:

pip install git@github.com:crim-ca/mss.git

This will install the Multimedia storage system along with program entry points for various utilities.

A good practise might be to make use of a virtual environment in which all the dependencies will be installed through pip.

Requirements

This package was developed on/for Linux CentOS version 6.6 though it should work with most recent Linux distributions.

The main interface uses Python version 2.7 .

Docker Builds

This interface has been containerized and you can also create your own images by using the following Dockerfile contents:

Note

The following Dockerfile implies that you have a copy of the source code and that you are executing the docker build command from the top level of the package structure.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
FROM python:2.7-alpine
MAINTAINER frederic.osterrath@crim.ca

RUN apk update &&\
    apk add build-base\
            linux-headers\
            bash &&\
    pip install pbr==1.8.0\
                python-keystoneclient==1.7.1\
                python-swiftclient==2.6.0\
                gunicorn==19.3.0 &&\
    pip install mercurial==3.4 &&\
    apk del build-base\
            linux-headers

# Thanks to a bug in pbr, this is the only way to expose its version to swift.
ENV PBR_VERSION 1.8.0

# App
COPY . /usr/local/src/mss
RUN pip install /usr/local/src/mss gunicorn

RUN mkdir -p /data
RUN mkdir -p /opt/mss

COPY deployment/conf.py /opt/mss/config.py
COPY logging.conf /opt/mss/logging.conf

ENV VRP_CONFIGURATION /opt/mss/config.py

COPY deployment/mss_startup.sh /opt/mss/mss_startup.sh
RUN chmod +x /opt/mss/mss_startup.sh

EXPOSE 5000

WORKDIR /opt/mss
CMD ["./mss_startup.sh"]