Following are instructions for installing Congress on an Ubuntu 14.04 LXC container in the OPNFV Controller node, as installed by the JOID installer. This guide uses instructions from the [[http://congress.readthedocs.org/en/latest/readme.html#installing-congress|Congress guide on readthedocs]]. Specific values below will need to be modified if you intend to repeat this procedure in your install environment.

== Prequisite ==
OPFNV install per [[https://wiki.opnfv.org/copper/academy/joid|JOID]]

== Install Procedure ==

The install currently occurs via four bash scripts provided in the copper repo. See these files for the detailed steps:
  * [[https://git.opnfv.org/cgit/copper/tree/components/congress/joid/install_congress_1.sh|install_congress_1.sh]]: creates the linux container for the congress server on the controller node, starts the congress server, copies install_congress_2.sh to the congress server and invokes it via ssh.
  * [[https://git.opnfv.org/cgit/copper/tree/components/congress/joid/install_congress_2.sh|install_congress_2.sh]]: installs congress in the congress server.

== If you need to start over ==

Shutdown the congress server, and on the node1-control machine, delete the container.
<code>
# get the congress server address
juju ssh ubuntu@node1-control
sudo lxc-info --name juju-trusty-congress | grep IP | awk "/ / { print \$2 }"
exit
juju ssh ubuntu@<congress server address>
sudo shutdown -P 0;  exit
juju ssh ubuntu@node1-control
sudo lxc-destroy --name juju-trusty-congress
</code>

== Restarting after server power loss etc ==
Currently this install procedure is manual. Automated install and restoral after host recovery is TBD. For now, this procedure will get the Congress service running again.
<code>
# On jumphost, SSH to Congress server
juju ssh ubuntu@<congress server address>
# If that fails
  # On jumphost, SSH to controller node
  juju ssh ubuntu@node1-control
  # Start the Congress container
  sudo lxc-start -n juju-trusty-congress -d
  # Verify the Congress container status
  sudo lxc-ls -f juju-trusty-congress
  NAME                  STATE    IPV4            IPV6  GROUPS  AUTOSTART  
  ----------------------------------------------------------------------
  juju-trusty-congress  RUNNING  192.168.10.117  -     -       NO       
  # exit back to the Jumphost, wait a minute, and go back to the "SSH to Congress server" step above
# On the Congress server that you have logged into
source ~/admin-openrc.sh
cd ~/git/congress
source bin/activate
bin/congress-server &
disown -h  %1
</code>