{{TableOfContents}}

Here are some notes on using Fuego with Squad:

Commit d6634b2 is an early implementation of ftc support
for putting run data to squad.

More debugging is needed and there are several FIXTHIS included,
but it works.

Here are squad installation instructions for Ubuntu Xenial (16.04)

= Squad installation =
== Install squad server software ==    
 * Install squad server application (this is a Django application)

{{{#!YellowBox
  host$ sudo apt-get install rabbitmq-server
    [Note] this is required for squad to communicate with celery worker tasks
  host$ git clone https://github.com/Linaro/squad
  host$ cd squad/
  host$ mkvirtualenv --python=/usr/bin/python3.5  mysquad
  (mysquad) host$ pip3 install -r requirements-dev.txt
  (mysquad) host$ ./manage.py test
  (mysquad) host$ ./manage.py migrate
  (mysquad) host$ ./manage.py createsuperuser
  (mysquad) host$ ./manage.py runserver
}}}

If that doesn't work, try the following:
{{{#!YellowBox
  host$ mkvirtualenv --python=/usr/bin/python3.5  pipsquad
  (pipsquad) host$ ./manage.py migrate
  (pipsquad) host$ ./manage.py createsuperuser
  (pipsquad) host$ ./manage.py runserver
}}}

And if that doesn't work, you can install it on your host by following
the instructions at: https://squad.readthedocs.io/en/latest/quickstart.html

To stop the server, type ctrl-C in the terminal where squad is running:
 * (pipsquad) host$ ctrl-C

To exit the virtual environment:
{{{#!YellowBox
 * (pipsquad) host$ deactivate
 * host$
}}}

== Starting squad after initial installation ==
[Note] The next time you use Squad, do this:

{{{#!YellowBox
  host$ cd squad
  host$ workon squad
  host$ ./manage.py runserver
}}}
    
== Configuring Squad ==
 * Configure a team and project in Squad
   * host$ firefox http://localhost:8000/
     - click upper-right popup menu > settings
       - profile: write your name
       - API token: copy the token
    	  - -> assign it to "server_squad_token" in fuego-ro/fuego.conf
     - click upper-right popup menu > Administration
       - Under: "Authentication and authorization"
    	  - Add group (this is a user group!)
             - name: myusergroup
             - permissons: Under the Available permissions box, select "choose all"
             - click "Save"
       - Under: "Core"
          - Add group (this is a team)
              - slug=fuego
              - name=fuego
    		 - -> assign this name ('fuego') to "server_squad_team" in fuego-ro/fuego.conf
              - description: whatever
              - usergroups: myusergroup
          - Add project
              - group: fuego
              - slug=jessie
              - name=jessie
                 - -> assign this name ('jessie') to "server_squad_project" in fuego-ro/fuego.conf
   

= Fuego squad configuration =
 * Edit fuego-ro/conf/fuego.conf to add squad attributes:
   * server_type=squad
   * server_domain=localhost:8000
   * server_squad_token=<token generated above>
   * server_squad_team=fuego
   * server_squad_project=jessie


= Putting runs from Fuego into Squad =
 * To upload a run from Fuego

{{{#!YellowBox
  fuego-docker# ftc list-runs -q
    Benchmark.IOzone-default-1-bbb
  fuego-docker# ftc put-run Benchmark.IOzone-default-1-bbb
    Packaging run 'Benchmark.IOzone-default-1-bbb'
    run/
    run/devlog.after.txt
    run/syslog.before.txt
    run/build.xml
    run/devlog.txt
    run/testlog.txt
    run/consolelog.txt
    run/run.json
    Run packaged successfully, and is at: /tmp/run-Benchmark.IOzone-default-1-on-fuegohost:bbb.frp
    WARNING: not adding attachment syslog.after
    WARNING: not adding attachment test_spec
    POSTING to http://localhost:8000/api/submit/fuego/jessie/a80be74d1629bdb2455b08db453beba0-4.9.133/bbb-4.9
    Run package run-Benchmark.IOzone-default-1-on-fuegohost:bbb.frp was accepted by the server.
}}}

= Issues =
 * see FIXTHIS issues in ftc:
   * $ grep FIXTHIS fuego-core/engine/scripts/ftc | grep squad