diff options
Diffstat (limited to 'components/congress/test-webapp')
| -rw-r--r-- | components/congress/test-webapp/README.txt | 189 |
1 files changed, 175 insertions, 14 deletions
diff --git a/components/congress/test-webapp/README.txt b/components/congress/test-webapp/README.txt index dc3484f..aa0f91c 100644 --- a/components/congress/test-webapp/README.txt +++ b/components/congress/test-webapp/README.txt @@ -14,24 +14,185 @@ # # This file contains instructions for installation and use of the Copper -# project adhoc test driver for OpenStack Congress. +# project adhoc test driver for OpenStack Congress, formatted as a +# Docuwiki page. -# -# For Ubuntu -# -# install dependencies +Following are notes on creating a container as test driver for Congress. This is based upon an Ubuntu host as installed by JOID. + +=== Create and Activate the Container === + +<code> +sudo lxc-create -n trusty-copper -t /usr/share/lxc/templates/lxc-ubuntu -- -b ubuntu ~/opnfv + +sudo lxc-start -n trusty-copper -d + +sudo lxc-info --name trusty-copper +Name: trusty-copper +State: RUNNING +PID: 4563 +IP: 10.0.3.44 +CPU use: 28.77 seconds +BlkIO use: 522.79 MiB +Memory use: 559.75 MiB +KMem use: 0 bytes +Link: vethDMFOAN + TX bytes: 2.62 MiB + RX bytes: 88.48 MiB + Total bytes: 91.10 MiB +</code> + +=== Login and configure the test server === +<code> +ssh ubuntu@10.0.3.44 +sudo apt-get update +sudo apt-get upgrade -y + +# Install pip +sudo apt-get install python-pip -y + +# Install java +sudo apt-get install default-jre -y + +# Install other dependencies +sudo apt-get install git gcc python-dev libxml2 libxslt1-dev libzip-dev php5-curl -y + +# Setup OpenStack environment variables per your OPNFV install +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 HEAT_HOST=192.168.10.107 +export NEUTRON_HOST=192.168.10.111 +export NOVA_HOST=192.168.10.112 +source ~/admin-openrc.sh + +# Install and test OpenStack client +mkdir ~/git +cd git +git clone https://github.com/openstack/python-openstackclient.git +cd python-openstackclient +git checkout stable/liberty +sudo pip install -r requirements.txt +sudo python setup.py install +openstack service list ++----------------------------------+------------+----------------+ +| ID | Name | Type | ++----------------------------------+------------+----------------+ +| 2f8799ae50f24c928c021fabf8a50f5f | keystone | identity | +| 351b13f56d9a4e25849406ec1d5a2726 | cinder | volume | +| 5129510c3143454f9ba8ec7e6735e267 | cinderv2 | volumev2 | +| 5ee1e220460f41dea9be06921400ce9b | congress | policy | +| 78e73a7789a14f56a5d248a0cd141201 | quantum | network | +| 9d5a00fb475a45b2ae6767528299ed6b | ceilometer | metering | +| 9e4b1624ef0b434abc0b82f607c5045c | heat | orchestration | +| b6c01ceb5023442d9f394b83f2a18e01 | heat-cfn | cloudformation | +| ba6199e3505045ad87e2a7175bd0c57f | glance | image | +| d753f304a0d541dbb989780ae70328a8 | nova | compute | ++----------------------------------+------------+----------------+ + +# Install and test Congress client +cd ~/git +git clone https://github.com/openstack/python-congressclient.git +cd python-congressclient +git checkout stable/liberty +sudo pip install -r requirements.txt +sudo python setup.py install +openstack congress driver list ++------------+--------------------------------------------------------------------------+ +| id | description | ++------------+--------------------------------------------------------------------------+ +| ceilometer | Datasource driver that interfaces with ceilometer. | +| neutronv2 | Datasource driver that interfaces with OpenStack Networking aka Neutron. | +| nova | Datasource driver that interfaces with OpenStack Compute aka nova. | +| keystone | Datasource driver that interfaces with keystone. | +| cinder | Datasource driver that interfaces with OpenStack cinder. | +| glancev2 | Datasource driver that interfaces with OpenStack Images aka Glance. | ++------------+--------------------------------------------------------------------------+ + +# Install and test Glance client +cd ~/git +git clone https://github.com/openstack/python-glanceclient.git +cd python-glanceclient +git checkout stable/liberty +sudo pip install -r requirements.txt +sudo python setup.py install +glance image-list ++--------------------------------------+---------------------+ +| ID | Name | ++--------------------------------------+---------------------+ +| 6ce4433e-65c0-4cd8-958d-b06e30c76241 | cirros-0.3.3-x86_64 | ++--------------------------------------+---------------------+ + +# Install and test Neutron client +cd ~/git +git clone https://github.com/openstack/python-neutronclient.git +cd python-neutronclient +git checkout stable/liberty +sudo pip install -r requirements.txt +sudo python setup.py install +neutron net-list ++--------------------------------------+------# install dependencies sudo apt-get install lamp-server^ -y # when prompted, set mysql root user password to "ubuntu" -sudo apt-get install php5-curl +----+------------------------------------------------------+ +| id | name | subnets | ++--------------------------------------+----------+------------------------------------------------------+ +| dc6227df-af41-439f-bd2c-c2c2f0fe7fc5 | public | 5745846c-dd79-4900-a7da-bf506348ceac 192.168.10.0/24 | +| a3f9f13a-5de9-4d3b-98c8-d2e40a2ef8e9 | internal | 5e0be862-90da-44ab-af43-56d5c65aa049 10.0.0.0/24 | ++--------------------------------------+----------+------------------------------------------------------+ + +# Install and test Nova client +cd ~/git +git clone https://github.com/openstack/python-novaclient.git +cd python-novaclient +git checkout stable/liberty +sudo pip install -r requirements.txt +sudo python setup.py install +nova hypervisor-list ++----+---------------------+-------+---------+ +| ID | Hypervisor hostname | State | Status | ++----+---------------------+-------+---------+ +| 1 | compute1.maas | up | enabled | ++----+---------------------+-------+---------+ + +# Install and test Keystone client +cd ~/git +git clone https://github.com/openstack/python-keystoneclient.git +cd python-keystoneclient +git checkout stable/liberty +sudo pip install -r requirements.txt +sudo python setup.py install + +</code> + +=== Setup the Congress Test Webapp === -# get Copper test driver app -cd ~ -git clone https://gerrit.opnfv.org/gerrit/copper -sudo cp ~copper/components/congress/test-webapp/www/ubuntu-apache2.conf /etc/apache2/apache2.conf -sudo cp -R ~copper/components/congress/test-webapp/www/html /var/www +<code> +# Clone Copper (if not already cloned in user home) +cd ~/git +if [ ! -d ~/git/copper ]; then git clone https://gerrit.opnfv.org/gerrit/copper; fi + +# Copy the Apache config +sudo cp ~/git/copper/components/congress/test-webapp/www/ubuntu-apache2.conf /etc/apache2/apache2.conf + +# Point proxy.php to the Congress server per your install +sed -i -- "s/192.168.10.117/$CONGRESS_HOST/g" \ + ~/git/copper/components/congress/test-webapp/www/html/proxy/index.php + +# Copy the webapp to the Apache root directory and fix permissions +sudo cp -R ~/git/copper/components/congress/test-webapp/www/html /var/www sudo chmod 755 /var/www/html -R + +# Make webapp log directory and set permissions +mkdir ~/logs +chmod 777 ~/logs + +# Restart Apache sudo service apache2 restart +</code> + +=== Using the Test Webapp === +Browse to the trusty-copper server IP address. -# Using the app: Browse to http://localhost -# Interactive options are meant to be self-explanatory given a basic -# familiarity with the Congress service and data model. +Interactive options are meant to be self-explanatory given a basic familiarity with the Congress service and data model. But the app will be developed with additional features and UI elements. |