From 91cf14faab874fff7d73c3acbe2f00c8fdd1e991 Mon Sep 17 00:00:00 2001 From: blsaws Date: Fri, 29 Jan 2016 15:28:56 -0800 Subject: Baseline of postinstall.rst JIRA: COPPER-7 Change-Id: Ifbaf72022c0afe1e40077dbe94d316af16e74927 Signed-off-by: blsaws --- docs/configguide/postinstall.rst | 224 +++++++++++++++++++++++++++++++++++---- 1 file changed, 204 insertions(+), 20 deletions(-) (limited to 'docs') diff --git a/docs/configguide/postinstall.rst b/docs/configguide/postinstall.rst index 1702cea..38216d3 100644 --- a/docs/configguide/postinstall.rst +++ b/docs/configguide/postinstall.rst @@ -1,26 +1,210 @@ - post installation procedures -====================================== -Add a brief introduction to the methods of validating the installation -according to this specific installer or feature. +Copper post installation procedures +=================================== +This release focused on use of the OpenStack Congress service for managing +configuration policy. The Congress install verify procedure described here +is largely manual. This procedure, as well as the longer-term goal of +automated verification support, is a work in progress. The procedure is +further specific to one OPNFV installer (JOID, i.e. MAAS/JuJu) based +environment. Automated post installation activities -------------------------------------- -Describe specific post installation activities performed by the OPNFV -deployment pipeline including testing activities and reports. Refer to -the relevant testing guides, results, and release notes. +No automated procedures are provided at this time. -note: this section should be singular and derived from the test projects -once we have one test suite to run for all deploy tools. This is not the -case yet so each deploy tool will need to provide (hopefully very simillar) -documentation of this. - - post configuration procedures --------------------------------------- -Describe any deploy tool or feature specific scripts, tests or procedures -that should be carried out on the deployment post install and configuration -in this section. +Copper post configuration procedures +------------------------------------ +No configuration procedures are required beyond the basic install procedure. Platform components validation ---------------------------------- -Describe any component specific validation procedures necessary for your -deployment tool in this section. +------------------------------ + +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 +................................. +On the jumphost: + +.. 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 + (typical output) + 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 + +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 + (typical output) + +----------------------------------+------------+----------------+ + | 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 + (typical output) + +------------+--------------------------------------------------------------------------+ + | 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 + (typical output) + +--------------------------------------+---------------------+ + | 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 + (typical output) + +--------------------------------------+----------+------------------------------------------------------+ + | 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 + (typical output) + +----+---------------------+-------+---------+ + | 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 + +Setup the Congress Test Webapp +.............................. + +.. 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 + +Using the Test Webapp +..................... +Browse to the trusty-copper server IP address. + +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. -- cgit 1.2.3-korg