blazar/doc/source/userdoc/installation.guide.rst
Masahito Muroi 68d769bf71 Migrate climate namespace to blazar
Although the Climate project was renamed to Blazar in 2014, the code has
still been using the climate namespace.

This patch moves all code to the blazar directory and allows users and
operators to use the 'blazar' command namespace. The 'climate' namespace
remains O release to allow users of Blazar time to move their own
code to the blazar namespace, but will be removed in P release
development cycle.

Change-Id: Icbe6fab1051aae4ac819982a1fa4f323cb0bf2d0
Partial-Bug: #1662734
2017-03-02 09:36:14 +00:00

177 lines
4.3 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Installation using DevStack
===========================
This section includes instructions for Blazar installation using DevStack.
1. Download DevStack:
.. sourcecode:: console
git clone https://git.openstack.org/openstack-dev/devstack.git
..
2. Create a local.conf file in the devstack directory. You can use the
following sample local.conf:
.. sourcecode:: console
[[local|localrc]]
ADMIN_PASSWORD=password
DATABASE_PASSWORD=$ADMIN_PASSWORD
RABBIT_PASSWORD=$ADMIN_PASSWORD
SERVICE_PASSWORD=$ADMIN_PASSWORD
DEST=/opt/stack/
LOGFILE=$DEST/logs/stack.sh.log
HOST_IP=127.0.0.1
GIT_BASE=https://git.openstack.org/
RECLONE=yes
enable_plugin blazar https://git.openstack.org/openstack/blazar
..
3. Run DevStack as the stack user:
.. sourcecode:: console
./stack.sh
..
4. Source the admin credentials:
.. sourcecode:: console
. openrc admin admin
..
5. Now you can add hosts to Blazar:
.. sourcecode:: console
blazar host-create hostname
..
Installation without DevStack
=============================
This section includes instructions for Blazar installation.
Download all Blazar related repos:
.. sourcecode:: console
git clone https://github.com/stackforge/blazar.git
git clone https://github.com/stackforge/blazar-nova.git
git clone https://github.com/stackforge/python-blazarclient.git
..
Install all these projects to your working environment via:
.. sourcecode:: console
python setup.py install
..
or
.. sourcecode:: console
python setup.py develop
..
Next you need to configure Blazar and Nova. Define */etc/blazar/blazar.conf*
file using the following example:
.. sourcecode:: console
[DEFAULT]
host=<blazar_host>
os_auth_host=<auth_host>
os_auth_port=<auth_port>
os_auth_protocol=<http, for example>
os_admin_username=<username>
os_admin_password=<password>
os_admin_project_name=<project_name>
[manager]
plugins=basic.vm.plugin,physical.host.plugin
[virtual:instance]
on_start=on_start
on_end=create_image, delete
[physical:host]
on_start=on_start
on_end=on_end
blazar_username=<username>
blazar_password=<password>
blazar_project_name=<project_name>
..
Here *os_admin_** flags refer to Blazar service user. *blazar_** ones - to
admin user created specially to work with physical reservations. If you have no
these users, create them via Keystone:
.. sourcecode:: console
keystone user-create --name=blazar --pass=<service_password> --tenant_id=<service_tenant_id> --email=blazar@example.com
keystone user-role-add --tenant-id <service_tenant_id> --user-id <blazar_user> --role-id <admin_role>
..
And the same procedure for special admin user to work with physical
reservations.
Next you need to configure Nova. If you want to use physical reservations,
please add the following lines to nova.conf file:
.. sourcecode:: console
scheduler_available_filters = nova.scheduler.filters.all_filters
scheduler_available_filters = climatenova.scheduler.filters.climate_filter.ClimateFilter
scheduler_default_filters=RetryFilter,AvailabilityZoneFilter,RamFilter,ComputeFilter,ComputeCapabilitiesFilter,ImagePropertiesFilter,ClimateFilter
..
Restart nova-api and nova-scheduler to use new configuration file.
Blazar uses Keystone trusts to commit actions on behalf of user created lease.
Thats why we need to create identityv3 service with appropriate endpoints:
.. sourcecode:: console
keystone service-create --name keystonev3 --type identityv3 --description "Keystone Identity Service v3"
keystone endpoint-create --region <region> --service keystonev3 --publicurl "<auth_protocol>://<auth_host>:5000/v3" --adminurl "<auth_protocol>://<auth_host>:35357/v3" --internalurl "<auth_protocol>://<auth_host>:5000/v3"
..
And, finally, we need to create reservation service in Keystone with its
endpoints:
.. sourcecode:: console
keystone service-create --name blazar --type reservation --description “OpenStack reservation service.”
keystone endpoint-create --region <region> --service blazar --publicurl "<auth_protocol>://<blazar_host>:1234/v1" --adminurl "<auth_protocol>://<blazar_host>:1234/v1"
..
To start Blazar services use:
.. sourcecode:: console
blazar-api
blazar-manager
..
Now you can use python-blazarclient to communicate with Blazar.