Installer et configurer

Installer et configurer

Cette section décrit comment installer et configurer le service de Base de Données, nom de code trove, sur le contrôleur.

Cette section suppose que vous avez déjà un environnement OpenStack fonctionnel avec au minimum les composants suivants installés : Compute, Image, Identité.

  • Si vous souhaitez effectuer des sauvegardes et des restauration, vous avez également besoin du Stockage Objet.

  • Si vous souhaitez provisionner des datastores sur des volumes de type stockage bloc, vous devez aussi installer le service Stockage Bloc.

Pré-requis

Avant d’installer et configurer le service de Base de Données, vous devez créer une base de données, des crédentiels de service et des endpoints API.

  1. Pour créer la base de données, réalisez les étapes suivantes :

    • Utilisez le client d’accès à la base de données pour vous connecter au serveur de base de données en tant qu’utilisateur root:

      $ mysql -u root -p
      
    • Créer la base de données trove :

      CREATE DATABASE trove;
      
    • Octroyer les droits nécessaires à la base de données ``trove` :

      GRANT ALL PRIVILEGES ON trove.* TO 'trove'@'localhost' \
        IDENTIFIED BY 'TROVE_DBPASS';
      GRANT ALL PRIVILEGES ON trove.* TO 'trove'@'%' \
        IDENTIFIED BY 'TROVE_DBPASS';
      

      Remplacer TROVE_DBPASS par un mot de passe approprié.

    • Quitter le client d’accès à la base de données.

  2. Sourcer les crédentiels admin pour accéder aux commandes en ligne réservées à l’administrateur :

    $ source admin-openrc.sh
    
  3. Pour créer les crédentiels du service, réalisez les étapes suivantes :

    • Créer l’utilisateur trove :

      $ openstack user create --domain default --password-prompt trove
      User Password:
      Repeat User Password:
      +-----------+-----------------------------------+
      | Field     | Value                             |
      +-----------+-----------------------------------+
      | domain_id | default                           |
      | enabled   | True                              |
      | id        | ca2e175b851943349be29a328cc5e360  |
      | name      | trove                             |
      +-----------+-----------------------------------+
      
    • Ajouter le rôle admin à l’utilisateur trove :

      $ openstack role add --project service --user trove admin
      

      Note

      Cette commande ne produit aucune sortie.

    • Créer l’entité de service trove :

      $ openstack service create --name trove \
        --description "Database" database
      +-------------+-----------------------------------+
      | Field       | Value                             |
      +-------------+-----------------------------------+
      | description | Database                          |
      | enabled     | True                              |
      | id          | 727841c6f5df4773baa4e8a5ae7d72eb  |
      | name        | trove                             |
      | type        | database                          |
      +-------------+-----------------------------------+
      
  4. Créer les endpoints API pour le service de Base de Données :

    $ openstack endpoint create --region RegionOne \
      database public http://controller:8779/v1.0/%\(tenant_id\)s
    +--------------+----------------------------------------------+
    | Field        | Value                                        |
    +--------------+----------------------------------------------+
    | enabled      | True                                         |
    | id           | 3f4dab34624e4be7b000265f25049609             |
    | interface    | public                                       |
    | region       | RegionOne                                    |
    | region_id    | RegionOne                                    |
    | service_id   | 727841c6f5df4773baa4e8a5ae7d72eb             |
    | service_name | trove                                        |
    | service_type | database                                     |
    | url          | http://controller:8779/v1.0/%\(tenant_id\)s  |
    +--------------+----------------------------------------------+
    
    $ openstack endpoint create --region RegionOne \
      database internal http://controller:8779/v1.0/%\(tenant_id\)s
    +--------------+----------------------------------------------+
    | Field        | Value                                        |
    +--------------+----------------------------------------------+
    | enabled      | True                                         |
    | id           | 9489f78e958e45cc85570fec7e836d98             |
    | interface    | internal                                     |
    | region       | RegionOne                                    |
    | region_id    | RegionOne                                    |
    | service_id   | 727841c6f5df4773baa4e8a5ae7d72eb             |
    | service_name | trove                                        |
    | service_type | database                                     |
    | url          | http://controller:8779/v1.0/%\(tenant_id\)s  |
    +--------------+----------------------------------------------+
    
    $ openstack endpoint create --region RegionOne \
      database admin http://controller:8779/v1.0/%\(tenant_id\)s
    +--------------+----------------------------------------------+
    | Field        | Value                                        |
    +--------------+----------------------------------------------+
    | enabled      | True                                         |
    | id           | 76091559514b40c6b7b38dde790efe99             |
    | interface    | admin                                        |
    | region       | RegionOne                                    |
    | region_id    | RegionOne                                    |
    | service_id   | 727841c6f5df4773baa4e8a5ae7d72eb             |
    | service_name | trove                                        |
    | service_type | database                                     |
    | url          | http://controller:8779/v1.0/%\(tenant_id\)s  |
    +--------------+----------------------------------------------+
    

Installer et configurer les composants

Note

Les fichiers de configuration par défaut diffèrent d’une distribution à l’autre. Vous pouvez être amené à ajouter ces sections et options plutôt que de modifier des sections et options existantes. De plus, une ellipse (...) dans les extraits de configuration indique d’éventuelles options de configuration par défaut que vous devez conserver.

  1. Installer les packages :

    # apt-get update
    
    # apt-get install python-trove python-troveclient \
      python-glanceclient trove-common trove-api trove-taskmanager \
      trove-conductor
    
  1. Dans le répertoire /etc/trove, éditer les fichiers trove.conf, trove-taskmanager.conf et``trove-conductor.conf`` et effectuer les actions suivantes :

    • Fournir les valeurs appropriées pour les paramètres suivants :

      [DEFAULT]
      log_dir = /var/log/trove
      trove_auth_url = http://controller:5000/v2.0
      nova_compute_url = http://controller:8774/v2
      cinder_url = http://controller:8776/v1
      swift_url = http://controller:8080/v1/AUTH_
      notifier_queue_hostname = controller
      ...
      [database]
      connection = mysql://trove:TROVE_DBPASS@controller/trove
      
    • Configurer le service de Base de Données pour utiliser le broker de messages RabbitMQ en définissant les options suivantes dans chaque fichier :

      [DEFAULT]
      ...
      rpc_backend = rabbit
      
      [oslo_messaging_rabbit]
      ...
      rabbit_host = controller
      rabbit_userid = openstack
      rabbit_password = RABBIT_PASS
      
  2. Vérifier que le fichier api-paste.ini est présent dans /etc/trove.

    Si le fichier n’est pas présent, vous pouvez le récupérer à cet emplacement.

  3. Éditer le fichier trove.conf et renseigner les paramètres ci-dessous :

    [DEFAULT]
    auth_strategy = keystone
    ...
    # Config option for showing the IP address that nova doles out
    add_addresses = True
    network_label_regex = ^NETWORK_LABEL$
    ...
    api_paste_config = /etc/trove/api-paste.ini
    ...
    [keystone_authtoken]
    ...
    auth_uri = http://controller:5000
    auth_url = http://controller:35357
    auth_type = password
    project_domain_name = default
    user_domain_name = default
    project_name = service
    username = trove
    password = TROVE_PASS
    
  4. Éditer le fichier trove-taskmanager.conf et renseigner les paramètres requis pour se connecter au service OpenStack Compute comme montré ci-dessous :

    [DEFAULT]
    ...
    # Configuration options for talking to nova via the novaclient.
    # These options are for an admin user in your keystone config.
    # It proxy's the token received from the user to send to nova
    # via this admin users creds,
    # basically acting like the client via that proxy token.
    nova_proxy_admin_user = admin
    nova_proxy_admin_pass = ADMIN_PASS
    nova_proxy_admin_tenant_name = service
    taskmanager_manager = trove.taskmanager.manager.Manager
    
  5. Éditer le fichier /etc/trove/trove-guestagent.conf pour que les futurs invités trove puissent se connecter à votre environnement OpenStack :

    rabbit_host = controller
    rabbit_password = RABBIT_PASS
    nova_proxy_admin_user = admin
    nova_proxy_admin_pass = ADMIN_PASS
    nova_proxy_admin_tenant_name = service
    trove_auth_url = http://controller:35357/v2.0
    
  6. Peupler la base de données trove précédemment créée :

    # su -s /bin/sh -c "trove-manage db_sync" trove
      ...
      2016-04-06 22:00:17.771 10706 INFO trove.db.sqlalchemy.migration [-]
      Upgrading mysql://trove:dbaasdb@controller/trove to version latest
    

    Note

    Ignorer les éventuels messages obsolètes.

Finaliser l’installation

  1. Suite à un bug dans les packages Ubuntu, éditer les fichiers de définition du service pour utiliser les bons paramètres de configuration.

    Pour ce faire, aller dans /etc/init et éditer les fichiers suivants comme décrit ci-dessous :

    trove-taskmanager.conf

    trove-conductor.conf

    (A noter que, bien qu’ils aient les mêmes noms, ces fichiers se trouvent à un emplacement différent et ont un contenu différent que ceux du même nom modifiés plus tôt dans cette procédure.)

    Dans chacun des fichiers, chercher la ligne :

    exec start-stop-daemon --start --chdir /var/lib/trove \
       --chuid trove:trove --make-pidfile \
       --pidfile /var/run/trove/trove-conductor.pid \
       --exec /usr/bin/trove-conductor -- \
       --config-file=/etc/trove/trove.conf ${DAEMON_ARGS}
    

    A noter que --config-file pointe de façon erronée vers trove.conf.

    Dans le fichier trove-taskmanager.conf, éditer config-file pour pointer vers /etc/trove/trove-taskmanager.conf.

    Dans trove-conductor.conf, éditer config-file pour pointer vers /etc/trove/trove-conductor.conf.

  2. Redémarrer les services de base de données :

    # service trove-api restart
    # service trove-taskmanager restart
    # service trove-conductor restart
    
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.