Automating Distributed System Deployment to Baremetal Resources
Go to file
zhaoxinyu 5f304d4a1f Change the way to get controller IP for scp
In HA scenario, endpoint ip is HA VIP instead of real
controller's IP, causing scp openrc to fail.

Change-Id: I723c138710041cd7c3bae4fed6781bddc0e1cc9d
2014-04-08 02:56:33 +00:00
bin Change some static values to dynamic and add minimal test config 2014-04-05 03:39:03 +00:00
compass Change some static values to dynamic and add minimal test config 2014-04-05 03:39:03 +00:00
conf add code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +00:00
install Change the way to get controller IP for scp 2014-04-08 02:56:33 +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 Change the way to get controller IP for scp 2014-04-08 02:56:33 +00:00
regtest Change some static values to dynamic and add minimal test config 2014-04-05 03:39:03 +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
ez_setup.py add code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +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
requirements.txt add code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +00: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 code to match new pep8 style checking and fix bugs. 2014-03-11 01:26:42 +00: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

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/