~koolhead17/openstackbook/cssbook

<entry>Server 1</entry>

<entry>Server 2</entry>

<entry>Client 1</entry>

<para>Nova and Glance have been included in Universe repository . Enable Universe repository in your /etc/apt/sources.list.</para>

<programlisting>sudo apt-get install bridge-utils</programlisting>

<programlisting>sudo apt-get install ntp</programlisting>

<para>Open the file /etc/ntp.conf and add the following 2 lines to make sure that the server serves time even when its connectivity to the Internet is down. The following settings ensure that the NTP server uses its own clock as the clock source:</para>

<para>Glance is an image Server that Nova can use to pickup images from. Glance is very modular and can use several types of storage backends such as filestore, s3 etc. We are installing Glance before installing Nova, so that when we get to configuring Nova, glance is ready to be used by Nova.</para>

<programlisting>sudo apt-get install glance

<para>Glance uses sqlite as the default database backend. While sqlite offers a quick and easy way to get started, for production use, you may consider a database such as MySQL or PostgreSQL.</para>

<section xml:id="MySQL_Server-d1e657"><title>MySQL Server</title>

<section xml:id="Configuration-d1e667">

<title>Configuration</title>

<para>If you did not set the MySQL root password during installation, set it now.</para>

<programlisting>mysqladmin -u root password $MYSQL_PASS

</programlisting>

<para>Update the database to grant super user privileges for root user to login from any IP.</para>

<programlisting>sudo mysql -uroot -p$MYSQL_PASS -e "GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;"</programlisting>

<para>Set MySQL root password for login from any IP.</para>

<programlisting>sudo mysql -uroot -p$MYSQL_PASS -e "SET PASSWORD FOR 'root'@'%' = PASSWORD('$MYSQL_PASS');"</programlisting>

<section>

<title>Installing Sqlite (Instead of Mysql)</title>

<programlisting>sudo apt-get install sqlite</programlisting>

--glance_host=192.168.3.1

<para>For configuring with Sqlite change the line with --sql_connection to:</para>

<programlisting>--sql_connection=sqlite:////var/lib/nova/nova.sqlite</programlisting> 

<para>Create a group called "nova".</para>

<programlisting>sudo groupadd nova

</programlisting>

<para>Restart all the nova related services.</para>

<programlisting>sudo restart libvirt-bin; sudo restart nova-network; sudo restart nova-compute; sudo restart nova-api; sudo restart nova-objectstore; sudo restart nova-scheduler; sudo restart nova-volume; sudo restart glance-api; sudo restart glance-registry</programlisting>

AVAILABILITYZONE nova available

AVAILABILITYZONE |- server1

AVAILABILITYZONE | |- nova-compute enabled : -) 2011-04-03 07:48:50

AVAILABILITYZONE | |- nova-scheduler enabled : -) 2011-04-03 07:48:48

AVAILABILITYZONE | |- nova-network enabled : -) 2011-04-03 07:48:49

AVAILABILITYZONE | |- nova-volume enabled : -) 2011-04-03 07:48:49

</programlisting>

</section>

<section xml:id="Nova_dashboard-d1e879">

<title>Nova dashboard</title>

<para>OpenStack-dashboard is a web interface for managing users, user credentials, key pairs, images, instances etc.</para>

<para>Install bazaar version control system to fetch required software from the repository at launchpad.</para>

<programlisting>

sudo apt-get install -y bzr

sudo easy_install virtualenv

</programlisting>

<para>You have already finished setting up credentials for a user called localadmin in the Nova configuration section above. The credentials of this user will need to embedded into the dashboard's configuration file.</para>

<para>Checkout the source of OpenStack-dashboard from bzr and execute run_tests.sh, which does not only test the installation, but also installs several dependencies of the dashboard.</para>

<programlisting>

sudo bzr init-repo .

sudo bzr branch lp:openstack-dashboard -r 46 /opt/osdb

cd /opt/osdb

sudo sh run_tests.sh

cd openstack-dashboard

</programlisting>

<para>Note: It has been tested with revison 46 of OpenStack Dashboard</para>

<para>Since you are trying to checkout from bzr anonymously, a message saying "You have not informed bzr of your Launchpad ID..." is displayed. You can safely ignore that.</para>

 

<para>Edit /opt/osdb/openstack-dashboard/local/local_settings.py to include certain details required for connecting to nova-api.</para>

<programlisting>

NOVA_DEFAULT_ENDPOINT = 'http://localhost:8773/services/Cloud'

NOVA_DEFAULT_REGION = 'nova'

NOVA_ACCESS_KEY = 'b6a7e3ca-f894-473b-abca-84329d9829fa:proj'

NOVA_SECRET_KEY = '2d61a361-965a-4ed6-966a-d9f543b42531'

NOVA_ADMIN_USER = 'novaadmin'

NOVA_PROJECT = 'proj'

</programlisting>

<para>A simple way of doing this will be to copy the relevant lines from novarc file that we discussed above.</para>

<section xml:id="Setting_Up_E-mail_service_for_the_web_interface-d1e919">

<title>Setting Up E-mail service for the web interface</title>

<para>In order to have mails generated by OpenStack dashboard delivered, we need to configure dashboard with the details of an smtp server by editing local_settings.py file.</para>

<programlisting>

EMAIL_HOST = 'server1.example.com'

EMAIL_PORT = 25

</programlisting>

<para>If the mail server provides only authenticated SMTP, add the following lines:</para>

<programlisting>

EMAIL_USER =

EMAIL_PASSWORD =

</programlisting>

<para>If the mail server requires a TLS connection, add the following lines:</para>

<programlisting>EMAIL_USE_TLS = 'True'

</programlisting>

<para>Create a openstack-dashboard database and its schema with the syncdb command. Provide the name/email address/desired password of the administrative user when prompted.</para>

<programlisting>sudo tools/with_venv.sh dashboard/manage.py syncdb</programlisting>

<para>While creating the schema, the above command asks you to create an admin account for the dashboard. Choose the user name as the project admin's user name you chose above while creating the project ( novadmin in our case). You can choose any password you like.</para>

<para>Launch the default python-django server. If you want the dashboard application to be available on port 8000 :</para>

<programlisting>sudo tools/with_venv.sh dashboard/manage.py runserver 10.10.10.2:8000

</programlisting>

<para>To check the installation open a browser and enter the following URL</para>

<programlisting>http://10.10.10.2:8000

</programlisting>

<para>You should be able to login as "novaadmin" using the password chosen above. Any other user trying to access the interface for the first time, will need to sign up and will be able to use the interface after the account is approved by the administrator.</para>

<para>A successful login and display of the project named "proj" on the dashboard will indicate that the dashboard has been setup successfully</para>

</section>

<section xml:id="OpenStack_Dashboard_with_Mysql_Database-d1e972">

<title>OpenStack Dashboard with Mysql Database</title>

<para>Dashboard uses SQLite database by default. For a production use, MySQL or PostgreSQL may be more preferable. The procedure for MySQL is given below. Procedure for PostgreSQL will be very similar.

</para>

<para>Install python-dev and libmysqlclient-dev</para>

<programlisting>

sudo apt-get install libmysqlclient-dev

sudo apt-get install python-dev

</programlisting>

<para>Activate virtualenv and install mysql-python package inside the virtual environment of Dashboard.</para>

<programlisting>

cd /opt/osdb/openstack-dashboard

sudo bash

source .dashboard-venv/bin/activate

easy_install mysql-python

</programlisting>

<para>Create a MySQL database user with all privileges on OpenStack Dashboard database</para>

<programlisting>

mysql -uroot -pmygreatsecret

 

&gt;create database dashboarddb;

&gt;grant ALL on dashboarddb.* to nova@localhost identified by 'mygreatsecret';

</programlisting>

<para>Update the DATABASES section of the Django's local_settings.py file (/opt/osdb/openstack-dashboard/local/local_settings.py) with the MySQL database settings. Here is the relevant extract from the updated file:</para>

<programlisting>

DATABASES = {

    'default': {

        'ENGINE': 'django.db.backends.mysql',

        'NAME': 'dashboarddb',

        'USER': 'nova',

        'PASSWORD': 'mygreatsecret',

        'HOST': 'localhost',

        'default-character-set': 'utf8',

    }

}

</programlisting>

<para>Create the schema in the database</para>

<programlisting>sudo tools/with_venv.sh dashboard/manage.py syncdb

</programlisting>

</section>

<section xml:id="Running_Dashboard_on_apache2_with_mod_wsgi-d1e1013">

<title>Running Dashboard on apache2 with mod_wsgi</title>

<para>While the web server that is included in Django is good for testing, for production use, it is recommended to use a web server like Apache with mod_wsgi.</para>

<para>Install apache2 and wsgi module.</para>

<programlisting>sudo apt-get install apache2 libapache2-mod-wsgi

</programlisting>

<para>Dashboard includes a file django.wsgi(/opt/osdb/openstack-dashboard/dashboard/wsgi/django.wsgi) to help in running dashboard under Apache with WSGI. You can replace the default file with the file below.</para>

<programlisting>

# Ref: http://jmoiron.net/blog/deploying-django-mod-wsgi-virtualenv/

 

import sys

import site

import os

 

#we are adding virtual environment path.

vepath = '/opt/osdb/openstack-dashboard/.dashboard-venv/lib/python2.7/site-packages'

os.environ['PYTHON_EGG_CACHE'] = '/opt/osdb/openstack-dashboard/.dashboard-venv/lib/python2.7/site-packages'

 

prev_sys_path = list(sys.path)

 

# add the site-packages of our virtualenv as a site dir

site.addsitedir(vepath)

 

# reorder sys.path so new directories from the addsitedir show up first

 

new_sys_path = [p for p in sys.path if p not in prev_sys_path]

 

for item in new_sys_path:

    sys.path.remove(item)

sys.path[:0] = new_sys_path

 

# import from down here to pull in possible virtualenv django install

 

from django.core.handlers.wsgi import WSGIHandler

os.environ['DJANGO_SETTINGS_MODULE'] = 'dashboard.settings'

application = WSGIHandler()

</programlisting>

</section>

<section xml:id="Setting_up_the_virtual_host_and_WSGI_alias_in_Apache-d1e1035">

<title>Setting up the virtual host and WSGI alias in Apache</title>

<para>Create /etc/apache2/sites-available/openstack with the following contents:</para>

<programlisting>

Listen 8000

&lt;VirtualHost 10.10.10.2:8000&gt;

    ServerName 10.10.10.2

    WSGIScriptAlias / /opt/osdb/openstack-dashboard/dashboard/wsgi/django.wsgi

    Alias /media/admin/  /opt/osdb/openstack-dashboard/.dashboard-venv/lib/python2.7/site-packages/django/contrib/admin/media/

&lt;/VirtualHost&gt;

</programlisting>

<para>Enable virtual host.</para>

<programlisting>

sudo a2ensite openstack

sudo /etc/init.d/apache2 reload

</programlisting>

<para>Dashboard should now be available at http://10.10.10.2:8000</para>

</section>

<title>Server 2</title>

 <para>This server runs nova-compute and all the virtual machines and hypervisor. You can also bundle images on Server 2.</para>

<programlisting>sudo apt-get install bridge-utils</programlisting>

<programlisting>sudo apt-get install ntp</programlisting>

--glance_host=192.168.3.1

<programlisting>sudo apt-get install ntp

<programlisting>sudo apt-get install qemu-kvm</programlisting>

</chapter>