summaryrefslogtreecommitdiffstats
path: root/components/congress/joid/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'components/congress/joid/README.txt')
-rw-r--r--components/congress/joid/README.txt191
1 files changed, 191 insertions, 0 deletions
diff --git a/components/congress/joid/README.txt b/components/congress/joid/README.txt
new file mode 100644
index 0000000..0862acb
--- /dev/null
+++ b/components/congress/joid/README.txt
@@ -0,0 +1,191 @@
+# Copyright 2015 Open Platform for NFV Project, Inc. and its contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# This file contains instructions for installing Congress on an Ubuntu 14.04 LXC container in the OPNFV Controller node
+# Prequisite: OPFNV install per https://wiki.opnfv.org/copper/academy/joid
+
+# Install base VM for congress on controller node
+sudo juju ssh ubuntu@192.168.10.21
+
+# Clone the container
+sudo lxc-clone -o juju-trusty-lxc-template -n juju-trusty-congress
+
+# Start the container
+sudo lxc-start -n juju-trusty-congress -d
+
+# Get the container IP address
+sudo lxc-info -n juju-trusty-congress
+
+# If you need to start over
+sudo lxc-destroy --name juju-trusty-congress
+
+# login to congress container
+sudo juju ssh ubuntu@192.168.10.117
+
+# Per http://congress.readthedocs.org/en/latest/readme.html#installing-congress
+
+# Setup environment variables
+export CONGRESS_HOST=192.168.10.117
+export KEYSTONE_HOST=192.168.10.108
+export CEILOMETER_HOST=192.168.10.105
+export CINDER_HOST=192.168.10.101
+export GLANCE_HOST=192.168.10.106
+export NEUTRON_HOST=192.168.10.111
+export NOVA_HOST=192.168.10.112
+
+# install pip
+sudo apt-get install python-pip -y
+
+# install java
+sudo apt-get install default-jre -y
+
+# install other dependencies; set mysql root user password = ubuntu
+sudo apt-get install git gcc python-dev libxml2 libxslt1-dev libzip-dev mysql-server python-mysqldb -y
+sudo pip install virtualenv
+
+# clone congress
+git clone https://github.com/openstack/congress.git
+
+# Create virtualenv
+virtualenv ~/congress
+cd congress
+source bin/activate
+
+# Setup Congress
+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 (detected by errors during "tox -egenconfig")
+sudo apt-get install libffi-dev -y
+sudo apt-get install openssl -y
+sudo apt-get install libssl-dev -y
+
+# install dependencies in virtualenv
+pip install -r requirements.txt
+python setup.py install
+
+# install tox
+pip install tox
+
+# generate congress.conf.sample
+tox -egenconfig
+
+# edit congress.conf.sample as needed
+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:ubuntu@localhost:3306\/congress/g' etc/congress.conf.sample
+
+# copy congress.conf.sample to /etc/congress
+sudo cp etc/congress.conf.sample /etc/congress/congress.conf
+
+# create congress database
+sudo mysql -u root -p
+CREATE DATABASE congress;
+GRANT ALL PRIVILEGES ON congress.* TO 'ubuntu'@'localhost' IDENTIFIED BY 'ubuntu';
+GRANT ALL PRIVILEGES ON congress.* TO 'ubuntu'@'%' IDENTIFIED BY 'ubuntu';
+exit
+
+# install congress-db-manage dependencies (detected by errors)
+sudo apt-get build-dep python-mysqldb
+pip install MySQL-python
+
+# create database schema
+congress-db-manage --config-file /etc/congress/congress.conf upgrade head
+
+# Dependencies no longer needed in this attempt...
+# pip install alembic
+# sudo pip install oslo.config --upgrade
+# sudo pip install oslo.db --upgrade
+# sudo pip install oslo.log --upgrade
+
+# Dependencies of OpenStack, Congress, Keystone related client operations
+pip install python-openstackclient
+pip install python-congressclient
+pip install python-keystoneclient
+
+# download admin-openrc.sh from Horizon and save in ~
+source ~/admin-openrc.sh
+
+# setup Congress user. TODO: needs update in http://congress.readthedocs.org/en/latest/readme.html#installing-congress
+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
+openstack service create congress --type "policy" --description "Congress Service"
+export CONGRESS_SERVICE=$(openstack service list | awk "/ congress / { print \$2 }")
+
+# Create Congress endpoint
+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
+bin/congress-server
+
+# Create data sources
+# to remove: openstack congress datasource delete nova
+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
+
+