x/compass-core
Code Issues Proposed changes
Automating Distributed System Deployment to Baremetal Resources
395 Commits 5 Branches 1 Tag 9.1 MiB
Python 84.1%
RAML 7.7%
Shell 5.6%
Jinja 2.3%
JavaScript 0.2%
b51f344a37
Go to file
Jerry Zhao b51f344a37 unpin versions of python-daemon, paramiko, etc 
python-daemon 2.0.4 has fixed issue related to setuptools, so revert
the pin but excludes broken versions.
since we have moved compass-core, tempest into virtualenv, it is also not
necessary to pin other package versions to be compatbile with tempest.
Pin MarkDown to <2.5 because py26 is not supported otherwise.
python-daemon also needs a new pip that comes with new virtualenv.

Change-Id: I7f378f344ef2e232c10e77725202acb09b3c3393
2015-01-27 05:08:42 -08:00
bin refactor delete cluster code to make it clean 2014-11-20 05:09:44 +00:00
compass Refactor db api: 2015-01-15 21:53:13 -08:00
conf Merge "Load dns_name to all interfaces instead of just mgmt" into dev/experimental 2015-01-15 18:27:40 +00:00
install unpin versions of python-daemon, paramiko, etc 2015-01-27 05:08:42 -08: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 add service status check after openstack cluster is deployed 2015-01-12 00:43:05 -08:00
monitor add monitoring script 2014-04-03 23:53:27 -07:00
regtest add service status check after openstack cluster is deployed 2015-01-12 00:43:05 -08:00
service make init db, load adapters/metadatas lazy initialization 2014-10-05 11:29:43 -07:00
.coveragerc Omit tests code in coverage report 2014-03-21 02:22:27 +00:00
.gitignore make compass install robust 2014-11-10 16:22:42 -08:00
.gitreview add default branch in .gitreview 2014-05-22 21:40:35 +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 unpin versions of python-daemon, paramiko, etc 2015-01-27 05:08:42 -08: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 Use setup.py to install config data to python library 2014-12-18 14:33:53 -08:00
test-requirements.txt update test-requirement unittest2 package version 2014-11-21 10:57:11 -08:00
tox.ini clean installers when refresh 2014-10-30 00:21:41 -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/