monasca-ui/README.md
Witold Bedyk c2c73f5254 Move Grafana to Apache's DocumentRoot
Static files are normally deployed with django's 'manage.py collectstatic'.
When run with --clear option, which seems to be default in some distributions
(e.g. RDO), all static resources are deleted first. Current Horizon integration
creates link to Grafana in static directory. Runing collectstatic --clear
leaves Grafana corrupted.

Proposed solution: Move Grafana to Apache's DocumentRoot.

also see: https://github.com/hpcloud-mon/ansible-monasca-ui/pull/6

Change-Id: Icbb2eecd45dfb1da48f63464ac83acb9e06cd71f
2015-12-17 13:23:31 +01:00

2.7 KiB

monasca-ui

Monasca UI is implemented as a horizon plugin that adds panels to horizon. It is installed into devstack by monasca-vagrant.

#Deployment Set Up

#Development Environment Set Up

##Get the Code

git clone https://github.com/openstack/monasca-ui.git  # clone monasca-ui
git clone https://github.com/openstack/horizon.git  # clone horizon
git clone https://github.com/hpcloud-mon/grafana.git  # clone grafana

##Set up Horizon

Since Monasca UI is a horizon plugin the first step is to get their development environment set up.

cd horizon
./run_tests.sh
cp openstack_dashboard/local/local_settings.py.example openstack_dashboard/local/local_settings.py

Pro Tip: Make sure you have horizon running correctly before proceeding. For more details go to http://docs.openstack.org/developer/horizon/quickstart.html#setup

##Set up Monasca-UI

  • Edit openstack_dashboard/local/local_settings.py to modify the OPENSTACK_HOST IP address to point to devstack.
  • Add monasca-client to requirements.txt. Get the latest version from https://pypi.python.org/pypi/python-monascaclient
  • Link monasca into Horizon:
cp ../monasca-ui/monitoring/enabled/_50_admin_add_monitoring_panel.py openstack_dashboard/enabled/.
ln -s ../monasca-ui/monitoring monitoring
./run_tests #load monasca-client into virtualenv

##Set up Grafana

cd ..
ln -r -s grafana/src <apache_document_root>/grafana
cd grafana
cp config.monasca.js config.js

##Start Server

./run_tests.sh --runserver

##Removing notification panel If you want to disable the notification panel copy over _70_remove_monasca_notification_panel to the openstack_dashboard/enabled directory

#License

Copyright (c) 2014 Hewlett-Packard Development Company, L.P.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.