.. _desktop:

MAGI Desktop
============

1. Install the following dependencies.
   The source code for all of these is available on
   Deter Ops (users.deterlab.net) under /share/magi/tarfiles/
  - python-yaml
  - python-pydot
  - python-networkx
  - py-matplotlib
  - Mongo DB
  - python-pymongo
  - Yaml C Library (required for c-based agents, otherwise too helps improve performance)
  - Mongo C Library (required only for c-based agents)

  All python packages can all be installed using pip.

  Install pip, if not already available.

  .. code-block:: bash

      curl -O https://bootstrap.pypa.io/get-pip.py
      python get-pip.py

  .. code-block:: bash

      pip install pyyaml
      pip install pydot
      pip install networkx
      pip install matplotlib
      pip install pymongo

2. Download and install MAGI

  .. code-block:: bash

      $ git clone https://github.com/deter-project/magi.git
      $ cd magi
      $ sudo python setup.py install

3. Run a simple two node MAGI setup.

  .. code-block:: bash

      $ tools/magi_desktop_bootstrap.py -n node1,node2
      # This should start two MAGI daemon processes with names node1 and node2
      # The script creates sample config files and uses them to run MAGI daemons
      # by default the config and logs files should be available under /tmp/<node_name>

4. Check if both MAGI daemons are running

  .. code-block:: bash

      $ magi_status.py -b node1 -n node1,node2
      # This should at the end say "Received reply back from all the required nodes"