4e184911bd92094097843ad767b18bd6b1823ad8
[domino.git] / docs / release / installation / installation.instructions.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3
4 ===================
5 Domino Installation
6 ===================
7
8 Note: The steps below are tested for Ubuntu (16.04, 14.04) and OS X El Capitan.
9
10 Prerequisites
11 -------------
12 * git
13 * python-pip
14 * python (version =2.7)
15 * tosca-parser (version >=0.4.0)
16 * heat-translator (version >=0.5.0)
17
18 Installation Steps (Single Node)
19 --------------------------------
20
21 * Step-0: Prepare Environment
22
23 .. code-block:: bash
24
25   > $sudo pip install tosca-parser
26   > $sudo pip install heat-translator
27   > $sudo pip install requests
28
29 * Step-1: Get the Domino code
30
31 .. code-block:: bash
32
33   git clone https://gerrit.opnfv.org/gerrit/domino -b stable/danube
34
35 * Step-2: Go to the main domino directory
36
37 .. code-block:: bash
38
39   cd domino
40
41 You should see DominoClient.py, DominoServer.py, and domino-cli.py as executables.
42
43 Installation Steps (Multiple Node)
44 ----------------------------------
45
46 Repeat the installation steps for single node on each node. The script
47 run_multinode.sh under ./domino/tests directory deploys the Domino Code on three
48 hosts from a deployment node and tests RPC calls. The private key location and
49 remote host IP addresses must be manually entered and IS_IPandKEY_CONFIGURED=false
50 must be changed to IS_IPandKEY_CONFIGURED=true.