"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "devstack/README.md" between
monasca-api-3.1.0.tar.gz and monasca-api-4.0.0.tar.gz

About: OpenStack Monasca API is a RESTful API server that is designed with a layered architecture and supports Monitoring as a Service (MONaaS).
The "Ussuri" series (latest release).

README.md  (monasca-api-3.1.0):README.md  (monasca-api-4.0.0)
skipping to change at line 31 skipping to change at line 31
need to create the local.conf if it does not already exist. need to create the local.conf if it does not already exist.
``` ```
# BEGIN DEVSTACK LOCAL.CONF CONTENTS # BEGIN DEVSTACK LOCAL.CONF CONTENTS
[[local|localrc]] [[local|localrc]]
DATABASE_PASSWORD=secretdatabase DATABASE_PASSWORD=secretdatabase
RABBIT_PASSWORD=secretrabbit RABBIT_PASSWORD=secretrabbit
ADMIN_PASSWORD=secretadmin ADMIN_PASSWORD=secretadmin
SERVICE_PASSWORD=secretservice SERVICE_PASSWORD=secretservice
SERVICE_TOKEN=111222333444
LOGFILE=$DEST/logs/stack.sh.log LOGFILE=$DEST/logs/stack.sh.log
LOGDIR=$DEST/logs LOGDIR=$DEST/logs
LOG_COLOR=False LOG_COLOR=False
# The following two variables allow switching between Java and Python for the im # The following variable allow switching between Java and Python for
plementations # the implementations of the Monasca Persister. If this variable is not set,
# of the Monasca API and the Monasca Persister. If these variables are not set, # then the default is to install the Python implementation of
then the # the Monasca Persister.
# default is to install the Python implementations of both the Monasca API and t
he Monasca Persister. # Uncomment of the following two lines to choose Java or Python for
# the Monasca Pesister.
# Uncomment one of the following two lines to choose Java or Python for the Mona # MONASCA_PERSISTER_IMPLEMENTATION_LANG=${MONASCA_PERSISTER_IMPLEMENTATION_LANG:
sca API. -java}
MONASCA_API_IMPLEMENTATION_LANG=${MONASCA_API_IMPLEMENTATION_LANG:-java} MONASCA_PERSISTER_IMPLEMENTATION_LANG=${MONASCA_PERSISTER_IMPLEMENTATION_LANG:-p
# MONASCA_API_IMPLEMENTATION_LANG=${MONASCA_API_IMPLEMENTATION_LANG:-python} ython}
# Uncomment of the following two lines to choose Java or Python for the Monasca # Uncomment one of the following two lines to choose either InfluxDB or
Pesister. # Apache Cassandra.
MONASCA_PERSISTER_IMPLEMENTATION_LANG=${MONASCA_PERSISTER_IMPLEMENTATION_LANG:-j # default "influxdb" is selected as metric DB.
ava}
# MONASCA_PERSISTER_IMPLEMENTATION_LANG=${MONASCA_PERSISTER_IMPLEMENTATION_LANG:
-python}
# Uncomment one of the following two lines to choose either InfluxDB or Vertica.
# default "influxdb" is selected as metric DB
MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-influxdb} MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-influxdb}
# MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-vertica} # MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-cassandra}
# This line will enable all of Monasca. # This line will enable all of Monasca.
enable_plugin monasca-api https://opendev.org/openstack/monasca-api enable_plugin monasca-api https://opendev.org/openstack/monasca-api
# END DEVSTACK LOCAL.CONF CONTENTS # END DEVSTACK LOCAL.CONF CONTENTS
``` ```
3. Run './stack.sh' from the root of the devstack directory. 3. Run './stack.sh' from the root of the devstack directory.
If you want to run Monasca with the bare mininum of OpenStack components If you want to run Monasca with the bare mininum of OpenStack components
you can add the following two lines to the local.conf file. you can add the following two lines to the local.conf file.
``` ```
disable_all_services disable_all_services
enable_service rabbit mysql key enable_service rabbit mysql key
``` ```
If you also want the Tempest tests to be installed then add `tempest` If you also want the Tempest tests to be installed then add `tempest` and
`monasca-tempest-plugin`.
``` ```
enable_service rabbit mysql key tempest enable_service rabbit mysql key tempest
enable_plugin monasca-tempest-plugin https://opendev.org/openstack/monasca-tempe st-plugin
``` ```
To enable Horizon and the Monasca UI add `horizon` To enable Horizon and the Monasca UI add `horizon`
``` ```
enable_service rabbit mysql key horizon tempest enable_service rabbit mysql key horizon tempest
``` ```
# Using Vagrant # Using Vagrant
Vagrant can be used to deploy a VM with Devstack and Monasca running in it using the Vagrantfile. After installing Vagrant, just run the command `vagrant up` as usual in the `../monasca-api/devstack` directory. Vagrant can be used to deploy a VM with Devstack and Monasca running in it using the Vagrantfile. After installing Vagrant, just run the command `vagrant up` as usual in the `../monasca-api/devstack` directory.
To use local repositories in the devstack install, commit your changes to the ma ster branch of the local repo, then modify the `_REPO` variable in the settings file that corresponds to the local repo to use ```file://my/local/repo/location` ``. To use local repositories in the devstack install, commit your changes to the ma ster branch of the local repo, then modify the `_REPO` variable in the settings file that corresponds to the local repo to use ```file://my/local/repo/location` ``.
To use a local instance of the monasca-api repo, change the ```enable_plugin mon asca-api https://opendev.org/openstack/monasca-api``` to ```enable_plugin monasc a-api file://my/repo/is/here```. Both of these settings will only take effect on a rebuild of the devstack VM. To use a local instance of the monasca-api repo, change the ```enable_plugin mon asca-api https://opendev.org/openstack/monasca-api``` to ```enable_plugin monasc a-api file://my/repo/is/here```. Both of these settings will only take effect on a rebuild of the devstack VM.
## Enable Vertica as the Metrics DB using Vagrant
Monasca supports using both InfluxDB and Vertica for storing metrics and alarm s
tate history.
InfluxDB is enabled by default in the DevStack environment.
Vertica is a commercial database from Hewlett Packard Enterprise.
A free Community Edition (CE) installer is available for download.
To enable Vertica, do the following:
1. Register and download the Vertica Debian installer from `https://my.vertica.c
om/download/vertica/community-edition/` and put it in your home directory.
Unfortunately, there isn't a URL that the DevStack installer can automatically u
se, so it must be downloaded separately, and put in a location where the install
er can find it when it runs.
The installer assumes this location is your home directory.
When using Vagrant, your home directory will normally be mounted inside the VM a
s "/vagrant_home".
2. Modify the environment variable `MONASCA_METRICS_DB` in the `local.conf`, `se
ttings` or `Vagrantfile` file from influxdb to vertica as follows:
```
MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-vertica}
```
## Using PostgreSQL or MySQL
Monasca supports using both PostgreSQL and MySQL and so does this devstack plugi
n.
Enable either ```postgresql``` or ```mysql``` to use either of them.
To setup environment with MySQL use:
```sh
enable_service mysql
```
Alternatively, for PostgreSQL, use:
```
enable_service postgresql
```
## Using ORM support
ORM support can be controlled with ```MONASCA_DATABASE_USE_ORM``` variable.
However ORM support is enforced if PostgreSQL is enabled, as the database backen
d,
a.k.a.
```sh
enable_service postgresql
```
## Enforcing Apache mirror ## Enforcing Apache mirror
If, for any reason, ```APACHE_MIRROR``` that is picked is not working, you can If, for any reason, ```APACHE_MIRROR``` that is picked is not working, you can
enforce it in following way: enforce it in following way:
```sh ```sh
APACHE_MIRROR=http://www-us.apache.org/dist/ APACHE_MIRROR=http://www-us.apache.org/dist/
``` ```
## Using WSGI ## Using WSGI
 End of changes. 6 change blocks. 
80 lines changed or deleted 19 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)