barbican/install-guide/source/install-rdo.rst
Ade Lee edb2c18be6 Add install guide
Install Guides are maintained within the project and are linked
to the official docs.

This commit adds the framework and some initial content.

Change-Id: Iff18f0e866d95ff4b8b490511c2acf3209690b69
2016-08-19 10:05:09 -04:00

1.8 KiB

Install and configure for Red Hat Enterprise Linux and CentOS

This section describes how to install and configure the Key Manager service for Red Hat Enterprise Linux 7 and CentOS 7.

Install and configure components

  1. Install the packages:

    # yum install openstack-barbican-api

Finalize installation

  1. Create the /etc/httpd/conf.d/wsgi-barbican.conf file with the following content:

    <VirtualHost [::1]:9311>
        ServerName controller
    
        ## Vhost docroot
        DocumentRoot "/var/www/cgi-bin/barbican"
    
        ## Directories, there should at least be a declaration for /var/www/cgi-bin/barbican
    
        <Directory "/var/www/cgi-bin/barbican">
            Options Indexes FollowSymLinks MultiViews
            AllowOverride None
            Require all granted
        </Directory>
    
        ## Logging
        ErrorLog "/var/log/httpd/barbican_wsgi_main_error_ssl.log"
        LogLevel debug
        ServerSignature Off
        CustomLog "/var/log/httpd/barbican_wsgi_main_access_ssl.log" combined
    
        WSGIApplicationGroup %{GLOBAL}
        WSGIDaemonProcess barbican-api display-name=barbican-api group=barbican processes=2 threads=8 user=barbican
        WSGIProcessGroup barbican-api
        WSGIScriptAlias / "/var/www/cgi-bin/barbican/main"
        WSGIPassAuthorization On
    </VirtualHost>
  2. Start the Apache HTTP service and configure it to start when the system boots:

    # systemctl enable httpd.service
    # systemctl start httpd.service