config/configutilities/configutilities/configutilities
Alex Kozyrev ebc7ac888d Barbican configuration thru Puppet and SysInv.
1. Add the new barbican DB and barbican user.
2. Support DB backup/restore and upgrades for barbican.
3. Configure barbican user and password in region config.
4. Provide Barbican configuration with appropriate data via SysInv.
5. Setup Barbican thru puppet manifests.
There are three main services that need to be configured:
- Barbican API: a RESTful API for managing secrets.
- Barbican Worker: a RPC interface for Barbican API.
- Barbican Keystone Listener: a service for Keystone changes.
Also, HA Proxy and Firewall need to be updated with Barbican port (9311)
as well as Remote Logging manifest to allow Barbican log collection.

Change-Id: I6b0b0c90456627bebde2b834b339bc968100b6f9
Story: 2003108
Task: 27700
Depends-On: I2667d56a71b7d3881c03b6a5c1e5ed61d4f0b902
Signed-off-by: Alex Kozyrev <alex.kozyrev@windriver.com>
2018-12-03 15:49:37 -05:00
..
common Barbican configuration thru Puppet and SysInv. 2018-12-03 15:49:37 -05:00
LICENSE StarlingX open source release updates 2018-05-31 07:35:52 -07:00
README Update SDK configutilities to version 3.0.2 2018-08-16 15:32:57 -04:00
__init__.py StarlingX open source release updates 2018-05-31 07:35:52 -07:00
config_validator.py Python 3 compatibility: convert ConfigParser to configparser. 2018-09-07 11:32:48 +08:00
configfiletool.py Barbican configuration thru Puppet and SysInv. 2018-12-03 15:49:37 -05:00
configgui.py StarlingX open source release updates 2018-05-31 07:35:52 -07:00
hostfiletool.py StarlingX open source release updates 2018-05-31 07:35:52 -07:00
setup.py Update SDK configutilities to version 3.0.2 2018-08-16 15:32:57 -04:00

README

Copyright © 2017 Wind River Systems, Inc.

SPDX-License-Identifier: Apache-2.0
-----------------------------------------------------------------------


Titanium Cloud Configuration Utilities
---------------------------------------

To facilitate various aspects of Titanium Cloud installation and
configuration, utilities have been created to generate and validate
configuration and setup files which are utilized by the system.


Installing the Configuration Utilities
--------------------------------------

This tarball includes several utilities which can be used to aid in the
configuration of Titanium Cloud.  Note that these are optional tools which are run prior
to installation, and not run on the target system.

To install the utilities on a Linux machine follow these steps:

1.  Ensure you have the tools necessary to install new python packages (pip and setuptools)
    If you do not, you must install them using the appropriate commands for
    your version of linux, such as:
        sudo apt-get install python-pip  # e.g. for Ubuntu or Debian

2.  The config_gui tool makes use of external tools which must be
    installed as follows:

        if using Ubuntu/Debian:
            sudo apt-get install python-wxtools

        if using Fedora:
            sudo yum install wxPython python-setuptools

        if using CentOS/RedHat, the appropriate rpm can be obtained from EPEL
            sudo yum install epel-release
            sudo yum install wxPython

            Note, if epel-release is not available, it can be obtained as such (specific to
            your version)
                wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
                sudo rpm -Uvh epel-release-6*.rpm
                sudo yum install wxPython python-pip

3.  Copy wrs-configutilities-3.0.2.tgz to the python install directory
    (i.e. /usr/lib/python2.7/dist-packages or /usr/lib/python2.7/site-packages)

4.  Cd to this python install directory

5.  Untar the file: 
        sudo tar xfv wrs-configutilities-3.0.2.tgz

6.  Cd configutilities

7.  Run setup:  
        sudo python setup.py install


Using the Configuration Utilities
---------------------------------

There are two tools installed: config_validator and config_gui.

config_validator is a commandline tool which takes a 'controller configuration
input' file of the INI type and does preliminary analysis to ensure its validity.
It can be called as follows: 
    config_validator --system-config <filename>

config_gui is a GUI-based tool which provides tools for creating a 'controller 
configuration input' INI file and/or a 'bulk host' XML file.  It can be launched 
by calling 'config_gui' from the command line and will walk you through the process
of generating the desired configuration files.