zhaoxinyu 63fe2e69a7 Make packages in virtualenv take precedance.
Duplicate installations of packages in system python environment
will take precedance by default and make unforseeable issues, so
we declare to use packages in virutalenv first and then system packages.

Change-Id: I29a56ffad33dfabec3ea73a84dbdc8e943ca8153
Closes-bug: #1354625
Cherry-pick from review.openstack.org/#/c/113052/
2014-08-20 17:09:51 -07:00
2014-08-14 22:58:27 -07:00
2014-04-03 23:53:27 -07:00
2014-07-31 19:50:49 -07:00
2014-03-21 02:22:27 +00:00
2014-05-22 21:40:35 +00:00
2014-08-19 17:13:19 -07:00
2014-08-07 17:32:05 -07:00
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/

Description
Automating Distributed System Deployment to Baremetal Resources
Readme 9.1 MiB
Languages
Python 84.1%
RAML 7.7%
Shell 5.6%
Jinja 2.3%
JavaScript 0.2%