Automating Distributed System Deployment to Baremetal Resources
Go to file
zhaoxinyu 7bb397108d Increase disk size to avoid insufficient space for tempest
Sometimes when running volume related tempest tests, there is
change that such error occurs: "Failed to create ALL necessary
volumes to run test". It might because a race in deleting and
creating volumes. Anyway, 5G cinder volume is enough but not by
a margin. Give it a little more space.

Change-Id: Id129c21461fd027e4eddf9ea7aee24f74154dee7
2014-04-22 16:41:12 +00:00
bin Add initial code for user authentication 2014-04-14 18:13:04 -07:00
compass Add initial code for user authentication 2014-04-14 18:13:04 -07:00
conf add code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +00:00
install Don't start tempest before nova-compute is ready 2014-04-18 05:08:35 +00:00
mibs Migrate repo of 'compass' to repo of 'compass-core', leave 'compass' to host project homepage 2014-01-08 19:18:04 -08:00
misc Don't start tempest before nova-compute is ready 2014-04-18 05:08:35 +00:00
monitor add monitoring script 2014-04-03 23:53:27 -07:00
regtest Increase disk size to avoid insufficient space for tempest 2014-04-22 16:41:12 +00:00
.coveragerc Omit tests code in coverage report 2014-03-21 02:22:27 +00:00
.gitignore add code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +00:00
.gitreview Add git review backend config 2014-01-14 18:27:47 +00:00
.testr.conf Add test environment configurations to support tox 2014-02-08 02:43:41 +00:00
LICENSE Migrate repo of 'compass' to repo of 'compass-core', leave 'compass' to host project homepage 2014-01-08 19:18:04 -08:00
README.md Migrate repo of 'compass' to repo of 'compass-core', leave 'compass' to host project homepage 2014-01-08 19:18:04 -08:00
ez_setup.py add code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +00:00
requirements.txt Add initial code for user authentication 2014-04-14 18:13:04 -07:00
setup.cfg Migrate repo of 'compass' to repo of 'compass-core', leave 'compass' to host project homepage 2014-01-08 19:18:04 -08:00
setup.py Add initial code for user authentication 2014-04-14 18:13:04 -07:00
test-requirements.txt add code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +00:00
tox.ini add progress update integration test. 2014-03-18 18:12:05 -07:00

README.md

Compass

A Deoployment Automation System. See Wiki page at https://wiki.openstack.org/wiki/Compass.

How to install Compass?

  1. Run git clone https://github.com/huawei-cloud/compass
  2. Run cd compass to the Compass project directory.
  3. Run ./install/install.sh to setup compass environment. Please note that before you execute install.sh, you may setup your environment variables in install/install.conf, explanations and examples of those variables can be found in install.conf.
  4. Run source /etc/profile to setup compass profile.
  5. Run ./bin/refresh.sh to initialize database.
  6. Run service compassd start to start compass daemon services.

FAQ

  • Why doesn't celery start? What should I do if I get celery died but pid file exists message after running service compassd status?
  1. Simply remove celery pid file (/var/run/celery.pid).
  2. Try running export C_FORCE_ROOT=1
  3. Restart Compass daemon.
  • How to restart compass service?
  1. Run service compassd restart
  2. Run service httpd restart to restart web service.
  • How to check if the compass services run properly?
  1. Run service compassd status to check compass services status.
  2. Run service httpd status to check web service status.
  • How to troubleshoot if compassd can not start the services?

    1. Try to remove /var/run/celeryd.pid to release the celeryd lock
    2. Try to remove /var/run/progress_update.pid to release the progress_update lock.
  • How to use compass to install distributed systems?

Access http://<server_ip>/ods/ods.html. In the current version, we only support OpenStack deployment with a simplified configuration. Follow the simple wizard from the Web UI.

  • How to run unittest? COMPASS_SETTING=<your own compass setting> python -m discover -s compass/tests

  • Where to find the log file?

    1. /var/log/compass/compass.log is the compass web log.
    2. /var/log/compass/celery.log is the celery log
    3. The redirected celeryd stdout/stderr is at /tmp/celeryd.log.
    4. The redirected progress_update.py stdout/stderr is at /tmp/progress_update.log
    5. The web server (httpd) log files are under /var/log/httpd/.
  • Where to find the compass config file?

    1. the compass setting file is at /etc/compass/setting.
    2. the default global config file for installing distributed system is at /etc/compass/setting
    3. the default celery config file is at /etc/compass/celeryconfig
  • Where is the default database file? It is at /opt/compass/db/app.db

  • Where is the utility scripts for compass? It is at /opt/compass/bin/