Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
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>
Wiki

User Tools

Site Tools

Page Tools
