summaryrefslogtreecommitdiffstats
path: root/docs/configguide/featureconfig.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/configguide/featureconfig.rst')
-rw-r--r--docs/configguide/featureconfig.rst359
1 files changed, 19 insertions, 340 deletions
diff --git a/docs/configguide/featureconfig.rst b/docs/configguide/featureconfig.rst
index 1b3dd5a..d972999 100644
--- a/docs/configguide/featureconfig.rst
+++ b/docs/configguide/featureconfig.rst
@@ -23,356 +23,35 @@ This guide uses instructions from the `Congress intro guide on readthedocs <http
Specific values below will need to be modified if you intend to repeat this
procedure in your JOID-based install environment.
-Install base VM for congress on controller node
-...............................................
-
-.. code::
-
- sudo juju ssh ubuntu@192.168.10.21
-
-Clone the container
-...................
-
-.. code::
-
- sudo lxc-clone -o juju-trusty-lxc-template -n juju-trusty-congress
-
-Start the container
-...................
-
-.. code::
-
- sudo lxc-start -n juju-trusty-congress -d
-
-Get the container IP address
-............................
-
-.. code::
-
- sudo lxc-info -n juju-trusty-congress
-
-If you need to start over
-.........................
-
-.. code::
-
- sudo lxc-destroy --name juju-trusty-congress
-
-Exit from controller (back to jumphost) and login to congress container
-.......................................................................
-
-.. code::
-
- sudo juju ssh ubuntu@192.168.10.117
-
-Update package repos
-....................
-
-.. code::
-
- sudo apt-get update
-
-Setup environment variables
-...........................
-
-.. code::
-
- export CONGRESS_HOST=192.168.10.106
- export KEYSTONE_HOST=192.168.10.119
- export CEILOMETER_HOST=192.168.10.116
- export CINDER_HOST=192.168.10.117
- export GLANCE_HOST=192.168.10.118
- export NEUTRON_HOST=192.168.10.125
- export NOVA_HOST=192.168.10.121
-
-Install pip
-...........
-
-.. code::
-
- sudo apt-get install python-pip -y
-
-Install java
-............
-
-.. code::
-
- sudo apt-get install default-jre -y
-
-Install other dependencies
-..........................
-
-.. code::
-
- # when prompted, set and remember mysql root user password
- sudo apt-get install git gcc python-dev libxml2 libxslt1-dev libzip-dev \
- mysql-server python-mysqldb -y
- sudo pip install virtualenv
-
-Clone congress
-..............
-
-.. code::
-
- git clone https://github.com/openstack/congress.git
- cd congress
- git checkout stable/liberty
-
-Create virtualenv
+Install Procedure
.................
+The install currently occurs via four bash scripts provided in the copper repo. See these files for the detailed steps:
+ * `install_congress_1.sh <https://git.opnfv.org/cgit/copper/tree/components/congress/joid/install_congress_1.sh>`_: copies install_congress_2.sh to the controller node and invokes it via ssh.
+ * `install_congress_2.sh <https://git.opnfv.org/cgit/copper/tree/components/congress/joid/install_congress_2.sh>`_: creates the linux container for congress on the controller node.
+ * `install_congress_3.sh <https://git.opnfv.org/cgit/copper/tree/components/congress/joid/install_congress_3.sh>`_: copies install_congress_4.sh to the congress container and invokes it via ssh. Currently requires one parameter which is the congress container IP address (to be scripted when a way to do this is figured out).
+ * `install_congress_4.sh <https://git.opnfv.org/cgit/copper/tree/components/congress/joid/install_congress_4.sh>`_: installs congress in the congress container.
-.. code::
- virtualenv ~/congress
- source bin/activate
-
-Setup Congress
-..............
-
-.. code::
-
- sudo mkdir -p /etc/congress
- sudo mkdir -p /etc/congress/snapshot
- sudo mkdir /var/log/congress
- sudo chown ubuntu /var/log/congress
- sudo cp etc/api-paste.ini /etc/congress
- sudo cp etc/policy.json /etc/congress
-
-Install requirements.txt and tox dependencies
-.............................................
-
-The need for this stepo was detected by errors during "tox -egenconfig".
-
-.. code::
-
- sudo apt-get install libffi-dev -y
- sudo apt-get install openssl -y
- sudo apt-get install libssl-dev -y
-
-Install dependencies in virtualenv
-..................................
-
-.. code::
-
- pip install -r requirements.txt
- python setup.py install
-
-Install tox
-...........
-
-.. code::
-
- pip install tox
-
-Generate congress.conf.sample
-.............................
-
-.. code::
-
- tox -egenconfig
-
-Edit congress.conf.sample as needed
-...................................
-
-.. code::
-
- sed -i -- 's/#verbose = true/verbose = true/g' etc/congress.conf.sample
- sed -i -- 's/#log_file = <None>/log_file = congress.log/g' \
- etc/congress.conf.sample
- sed -i -- 's/#log_dir = <None>/log_dir = \/var\/log\/congress/g' \
- etc/congress.conf.sample
- sed -i -- 's/#bind_host = 0.0.0.0/bind_host = 192.168.10.117/g' \
- etc/congress.conf.sample
- sed -i -- 's/#policy_path = <None>/policy_path = \
- \/etc\/congress\/snapshot/g' etc/congress.conf.sample
- sed -i -- 's/#auth_strategy = keystone/auth_strategy = noauth/g' \
- etc/congress.conf.sample
- sed -i -- 's/#drivers =/drivers =\
- congress.datasources.neutronv2_driver.NeutronV2Driver,\
- congress.datasources.glancev2_driver.GlanceV2Driver,\
- congress.datasources.nova_driver.NovaDriver,\
- congress.datasources.keystone_driver.KeystoneDriver,\
- congress.datasources.ceilometer_driver.CeilometerDriver,\
- congress.datasources.cinder_driver.CinderDriver/g' etc/congress.conf.sample
- sed -i -- 's/#auth_host = 127.0.0.1/auth_host = 192.168.10.108/g' \
- etc/congress.conf.sample
- sed -i -- 's/#auth_port = 35357/auth_port = 35357/g' etc/congress.conf.sample
- sed -i -- 's/#auth_protocol = https/auth_protocol = http/g' \
- etc/congress.conf.sample
- sed -i -- 's/#admin_tenant_name = admin/admin_tenant_name = admin/g' \
- etc/congress.conf.sample
- sed -i -- 's/#admin_user = <None>/admin_user = congress/g' \
- etc/congress.conf.sample
- sed -i -- 's/#admin_password = <None>/admin_password = congress/g' \
- etc/congress.conf.sample
- sed -i -- 's/#connection = <None>/connection = mysql:\/\/ubuntu:\
- <mysql password>@localhost:3306\/congress/g' etc/congress.conf.sample
-
-Copy congress.conf.sample to /etc/congress
-..........................................
-
-.. code::
-
- sudo cp etc/congress.conf.sample /etc/congress/congress.conf
-
-Create congress database
-........................
-
-.. code::
-
- sudo mysql -u root -p
- CREATE DATABASE congress;
- GRANT ALL PRIVILEGES ON congress.* TO 'ubuntu'@'localhost' \
- IDENTIFIED BY '<mysql password>';
- GRANT ALL PRIVILEGES ON congress.* TO 'ubuntu'@'%' IDENTIFIED \
- BY '<mysql password>';
- exit
-
-Install congress-db-manage dependencies
-.......................................
-
-The need for this step was detected by errors in subsequent steps.
-
-.. code::
-
- sudo apt-get build-dep python-mysqldb -y
- pip install MySQL-python
-
-Create database schema
-......................
-
-.. code::
-
- congress-db-manage --config-file /etc/congress/congress.conf upgrade head
-
-Install dependencies of OpenStack, Congress, Keystone client operations
-.......................................................................
-
-.. code::
-
- pip install python-openstackclient
- pip install python-congressclient
- pip install python-keystoneclient
-
-Execute admin-openrc.sh as downloaded from Horizon
-..................................................
-
-.. code::
-
- source ~/admin-openrc.sh
-
-Setup Congress user
-...................
-
-TODO: needs update in `Congress intro in readthedocs < http://congress.readthedocs.org/en/latest/readme.html#installing-congress>`_.
-
-.. code::
-
- pip install cliff --upgrade
- export ADMIN_ROLE=$(openstack role list | \
- awk "/ Admin / { print \$2 }")
- export SERVICE_TENANT=$(openstack project list | \
- awk "/ admin / { print \$2 }")
- openstack user create --password congress --project admin \
- --email "congress@example.com" congress
- export CONGRESS_USER=$(openstack user list | \
- awk "/ congress / { print \$2 }")
- openstack role add $ADMIN_ROLE --user $CONGRESS_USER \
- --project $SERVICE_TENANT
-
-Create Congress service
-.......................
-
-.. code::
-
- openstack service create congress --type "policy" \
- --description "Congress Service"
- export CONGRESS_SERVICE=$(openstack service list | \
- awk "/ congress / { print \$2 }")
-
-Create Congress endpoint
-........................
-
-.. code::
-
- openstack endpoint create $CONGRESS_SERVICE \
- --region $OS_REGION_NAME \
- --publicurl http://$CONGRESS_HOST:1789/ \
- --adminurl http://$CONGRESS_HOST:1789/ \
- --internalurl http://$CONGRESS_HOST:1789/
-
-Start the Congress service in the background
-............................................
-
-.. code::
-
- bin/congress-server &
- # disown the process (so it keeps running if you get disconnected)
- disown -h %1
-
-Create data sources
-...................
-
-To remove datasources: openstack congress datasource delete <name>
-
-It's probably good to do these commands in a new terminal tab, as the
-congress server log from the last command will be flooding your original
-terminal screen.
-
-.. code::
-
- openstack congress datasource create nova "nova" \
- --config username=$OS_USERNAME \
- --config tenant_name=$OS_TENANT_NAME \
- --config password=$OS_PASSWORD \
- --config auth_url=http://$KEYSTONE_HOST:5000/v2.0
- openstack congress datasource create neutronv2 "neutronv2" \
- --config username=$OS_USERNAME \
- --config tenant_name=$OS_TENANT_NAME \
- --config password=$OS_PASSWORD \
- --config auth_url=http://$KEYSTONE_HOST:5000/v2.0
- openstack congress datasource create ceilometer "ceilometer" \
- --config username=$OS_USERNAME \
- --config tenant_name=$OS_TENANT_NAME \
- --config password=$OS_PASSWORD \
- --config auth_url=http://$KEYSTONE_HOST:5000/v2.0
- openstack congress datasource create cinder "cinder" \
- --config username=$OS_USERNAME \
- --config tenant_name=$OS_TENANT_NAME \
- --config password=$OS_PASSWORD \
- --config auth_url=http://$KEYSTONE_HOST:5000/v2.0
- openstack congress datasource create glancev2 "glancev2" \
- --config username=$OS_USERNAME \
- --config tenant_name=$OS_TENANT_NAME \
- --config password=$OS_PASSWORD \
- --config auth_url=http://$KEYSTONE_HOST:5000/v2.0
- openstack congress datasource create keystone "keystone" \
- --config username=$OS_USERNAME \
- --config tenant_name=$OS_TENANT_NAME \
- --config password=$OS_PASSWORD \
- --config auth_url=http://$KEYSTONE_HOST:5000/v2.0
-
-Run Congress Tempest Tests
-..........................
-
-.. code::
-
- tox -epy27
+Cleanup Procedure
+.................
+If there is an error during installation, use the bash script
+`clean_congress.sh <https://git.opnfv.org/cgit/copper/tree/components/congress/joid/clean_congress.sh>`_
+which stops the congress server if running, and removes the congress user and
+service from the controller database.
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.
+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
- sudo juju ssh ubuntu@192.168.10.117
+ source ~/env.sh
+ juju ssh ubuntu@$CONGRESS_HOST
# If that fails
# On jumphost, SSH to controller node
- sudo juju ssh ubuntu@192.168.10.119
+ juju ssh ubuntu@node1-control
# Start the Congress container
sudo lxc-start -n juju-trusty-congress -d
# Verify the Congress container status
@@ -380,11 +59,11 @@ service running again.
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
+ # 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 congress
+ cd ~/git/congress
source bin/activate
bin/congress-server &
disown -h %1
+