config/configutilities/configutilities/configutilities
Angie Wang 61ac82ee82 Integrate gnocchi for OpenStack Telemetry
This commit integrates gnocchi as metric storage backend because of the
deprecation of ceilometer metering backend.
With gnocchi integrated, ceilometer api and collector processes are
removed, ceilometer agent nofitication and polling processes
are still running to collect and normalise data from other openstack
services. Ceilometer notification agent also has the responsiblity
to send samples to gnocchi backend through its gnocchi publisher and
events to panko backend.
Two gnocchi processes are introduced, gnocchi api is REST API service
and gnocchi metricd is for metric computing and gnocchi CLI is
supported to query measures/metric from gnocchi backend. Ceilometer
service and user still need to be registered in keystone, but stop
creating endpoints. Gnocchi is a seperate user/service in keystone and
run on active controller licensing on port 8041

Changes:

- puppet changes to add gnocchi user and endpoints to keystone, gnocchi
  port to haproxy and firewall,
  remote logging as well as other necessary configurations for gnocchi
- backup restore for gnocchi postgres db (except metric and resource
  tables)
- sm changes to manage gnocchi processes through created lsb scripts
- support for multi-region setup
- distributed cloud - do not enable service and create endpoints for
  gnocchi in system controller
- add gnocchi logs in syslog
- support no reboot patching for gnocchi processes
- add gnocchiclient in remote CLI
- add NotIn validation method in python-voluptuous which needed in
  gnocchi
- collect scripts updates
- cleanup ceilometer api and collector in puppet configuration, sm,
  service parameter, syslog, remotelogging, patch-restart-processes
- remote ceilometerclient from remote CLI
- remote openstack client changes for ceilometer CLI extensions
- remove ceilometer-api and ceilometer-collector packages from iso

Story: 2002825
Task: 22871
Depends-On: https://review.openstack.org/587419

Change-Id: Ia46c67eb6543c3694dff03435dc2b00fb2b760e5
Signed-off-by: Jack Ding <jack.ding@windriver.com>
2018-07-31 15:48:44 -04:00
..
common Integrate gnocchi for OpenStack Telemetry 2018-07-31 15:48:44 -04:00
LICENSE StarlingX open source release updates 2018-05-31 07:35:52 -07:00
README Upversion configutilities version to 3.0.1 2018-07-20 15:30:54 -04:00
__init__.py StarlingX open source release updates 2018-05-31 07:35:52 -07:00
config_validator.py StarlingX open source release updates 2018-05-31 07:35:52 -07:00
configfiletool.py Integrate gnocchi for OpenStack Telemetry 2018-07-31 15:48:44 -04: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 Upversion configutilities version to 3.0.1 2018-07-20 15:30:54 -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-wxgtk2.8 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.1.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.1.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.