openstack/openstack-manuals
Code Issues Proposed changes
b6d557b5ab
openstack-manuals/doc/install-guide-rst/source/nova-controller-install.rst
KATO Tomoyuki 79e534c70c [install-guide-rst] add nova chapter 
just a conversion to rst files.
* ch_nova.xml
* ch_nova-controller-install.xml
* ch_nova-compute-install.xml
* ch_nova-verify.xml

Change-Id: Ic472ce467ff142dcae8305f2fdbd58034a6b5e35
Implements: blueprint installguide-liberty
2015-07-03 17:47:47 +09:00

10 KiB
Raw Blame History

Install and configure controller node

This section describes how to install and configure the Compute service, code-named nova, on the controller node.

To configure prerequisites

Before you install and configure the Compute service, you must create a database, service credentials, and API endpoint.

  1. To create the database, complete these steps:

    • Use the database access client to connect to the database server as the root user:

      $ mysql -u root -p

    • Create the nova database:

      CREATE DATABASE nova;

    • Grant proper access to the nova database:

      GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' \
  IDENTIFIED BY 'NOVA_DBPASS';
GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' \
  IDENTIFIED BY 'NOVA_DBPASS';

      Replace NOVA_DBPASS with a suitable password.

    • Exit the database access client.

  2. Source the admin credentials to gain access to admin-only CLI commands:

    $ source admin-openrc.sh

  3. To create the service credentials, complete these steps:

    • Create the nova user:

      $ openstack user create --password-prompt nova
User Password:
Repeat User Password:
+----------+----------------------------------+
| Field    | Value                            |
+----------+----------------------------------+
| email    | None                             |
| enabled  | True                             |
| id       | 8e0b71d732db4bfba04943a96230c8c0 |
| name     | nova                             |
| username | nova                             |
+----------+----------------------------------+

    • Add the admin role to the nova user:

      $ openstack role add --project service --user nova admin
+-------+----------------------------------+
| Field | Value                            |
+-------+----------------------------------+
| id    | cd2cb9a39e874ea69e5d4b896eb16128 |
| name  | admin                            |
+-------+----------------------------------+

    • Create the nova service entity:

      $ openstack service create --name nova \
  --description "OpenStack Compute" compute
+-------------+----------------------------------+
| Field       | Value                            |
+-------------+----------------------------------+
| description | OpenStack Compute                |
| enabled     | True                             |
| id          | 060d59eac51b4594815603d75a00aba2 |
| name        | nova                             |
| type        | compute                          |
+-------------+----------------------------------+

  4. Create the Compute service API endpoint:

    $ openstack endpoint create \
  --publicurl http://controller:8774/v2/%\(tenant_id\)s \
  --internalurl http://controller:8774/v2/%\(tenant_id\)s \
  --adminurl http://controller:8774/v2/%\(tenant_id\)s \
  --region RegionOne \
  compute
+--------------+-----------------------------------------+
| Field        | Value                                   |
+--------------+-----------------------------------------+
| adminurl     | http://controller:8774/v2/%(tenant_id)s |
| id           | 4e885d4ad43f4c4fbf2287734bc58d6b        |
| internalurl  | http://controller:8774/v2/%(tenant_id)s |
| publicurl    | http://controller:8774/v2/%(tenant_id)s |
| region       | RegionOne                               |
| service_id   | 060d59eac51b4594815603d75a00aba2        |
| service_name | nova                                    |
| service_type | compute                                 |
+--------------+-----------------------------------------+

To install and configure Compute controller components

Note

Default configuration files vary by distribution. You might need to add these sections and options rather than modifying existing sections and options. Also, an ellipsis (...) in the configuration snippets indicates potential default configuration options that you should retain.

obs

  1. Install the packages:

    # zypper install openstack-nova-api openstack-nova-scheduler \
  openstack-nova-cert openstack-nova-conductor \
  openstack-nova-consoleauth openstack-nova-novncproxy \
  python-novaclient iptables

rdo

  1. Install the packages:

    # yum install openstack-nova-api openstack-nova-cert \
  openstack-nova-conductor openstack-nova-console \
  openstack-nova-novncproxy openstack-nova-scheduler \
  python-novaclient

ubuntu

  1. Install the packages:

    # apt-get install nova-api nova-cert nova-conductor \
  nova-consoleauth nova-novncproxy nova-scheduler \
  python-novaclient

  1. Edit the /etc/nova/nova.conf file and complete the following actions:

    • Add a [database] section, and configure database access:

      [database]
...
connection = mysql://nova:NOVA_DBPASS@controller/nova

      Replace NOVA_DBPASS with the password you chose for the Compute database.

    • In the [DEFAULT] and [oslo_messaging_rabbit] sections, configure RabbitMQ message queue access:

      [DEFAULT]
...
rpc_backend = rabbit

[oslo_messaging_rabbit]
...
rabbit_host = controller
rabbit_userid = openstack
rabbit_password = RABBIT_PASS

      Replace RABBIT_PASS with the password you chose for the openstack account in RabbitMQ.

    • In the [DEFAULT] and [keystone_authtoken] sections, configure Identity service access:

      [DEFAULT]
...
auth_strategy = keystone

[keystone_authtoken]
...
auth_uri = http://controller:5000
auth_url = http://controller:35357
auth_plugin = password
project_domain_id = default
user_domain_id = default
project_name = service
username = nova
password = NOVA_PASS

      Replace NOVA_PASS with the password you chose for the nova user in the Identity service.

      Note

      Comment out or remove any other options in the [keystone_authtoken] section.

    • In the [DEFAULT] section, configure the my_ip option to use the management interface IP address of the controller node:

      [DEFAULT]
...
my_ip = 10.0.0.11

    • In the [DEFAULT] section, configure the VNC proxy to use the management interface IP address of the controller node:

      [DEFAULT]
...
vncserver_listen = 10.0.0.11
vncserver_proxyclient_address = 10.0.0.11

    • In the [glance] section, configure the location of the Image service:

      [glance]
...
host = controller

    obs

    • In the [oslo_concurrency] section, configure the lock path:

      [oslo_concurrency]
...
lock_path = /var/run/nova

    rdo

    • In the [oslo_concurrency] section, configure the lock path:

      [oslo_concurrency]
...
lock_path = /var/lib/nova/tmp

    ubuntu

    • In the [oslo_concurrency] section, configure the lock path:

      [oslo_concurrency]
...
lock_path = /var/lib/nova/tmp

    • (Optional) To assist with troubleshooting, enable verbose logging in the [DEFAULT] section:

      [DEFAULT]
...
verbose = True

rdo

  1. Populate the Compute database:

    # su -s /bin/sh -c "nova-manage db sync" nova

ubuntu

  1. Populate the Compute database:

    # su -s /bin/sh -c "nova-manage db sync" nova

To finalize installation

obs

  • Start the Compute services and configure them to start when the system boots:

    # systemctl enable openstack-nova-api.service \
  openstack-nova-cert.service openstack-nova-consoleauth.service \
  openstack-nova-scheduler.service openstack-nova-conductor.service \
  openstack-nova-novncproxy.service
# systemctl start openstack-nova-api.service \
  openstack-nova-cert.service openstack-nova-consoleauth.service \
  openstack-nova-scheduler.service openstack-nova-conductor.service \
  openstack-nova-novncproxy.service

rdo

  • Start the Compute services and configure them to start when the system boots:

    # systemctl enable openstack-nova-api.service \
  openstack-nova-cert.service openstack-nova-consoleauth.service \
  openstack-nova-scheduler.service openstack-nova-conductor.service \
  openstack-nova-novncproxy.service
# systemctl start openstack-nova-api.service \
  openstack-nova-cert.service openstack-nova-consoleauth.service \
  openstack-nova-scheduler.service openstack-nova-conductor.service \
  openstack-nova-novncproxy.service

ubuntu

  • Restart the Compute services:

    # service nova-api restart
# service nova-cert restart
# service nova-consoleauth restart
# service nova-scheduler restart
# service nova-conductor restart
# service nova-novncproxy restart

  • By default, the Ubuntu packages create an SQLite database.

    Because this configuration uses a SQL database server, you can remove the SQLite database file:

    # rm -f /var/lib/nova/nova.sqlite