Automating Distributed System Deployment to Baremetal Resources
Go to file
zhaoxinyu c4674360ef add regtest script and conf
Change-Id: Ieb82235bd6b436b6716992c1b45698b083d03d86

remove pre-existing chef files before uploading new chef files.

having legacy stale chef roles/cookbooks/databags in the knife
source directory will result in possible failure of dependency check,
so gurantee we have the latest code in that directory.

clean installation logs when refresh database.

Change-Id: I6609e90e51d8ca3560f1848f2de62e148f0c5b49
2014-09-17 11:46:07 -07:00
bin add regtest script and conf 2014-09-17 11:46:07 -07:00
compass add regtest script and conf 2014-09-17 11:46:07 -07:00
conf fix instance cannot get IP from dhcp 2014-09-16 14:26:09 -07:00
install add regtest script and conf 2014-09-17 11:46:07 -07: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 compass deamon name in httpd service 2014-09-06 20:12:05 -07:00
monitor add monitoring script 2014-04-03 23:53:27 -07:00
regtest add regtest script and conf 2014-09-17 11:46:07 -07:00
service make our utility script switch to virtual env before running. 2014-09-05 13:16:47 -07:00
.coveragerc Omit tests code in coverage report 2014-03-21 02:22:27 +00:00
.gitignore set poll switch lock timeout to 120 seconds 2014-09-07 11:19:48 -07: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 fix instance cannot get IP from dhcp 2014-09-16 14:26:09 -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 update state to deploy action 2014-08-07 17:32:05 -07:00
test-requirements.txt Bump up mgmt ip start to avoid conflict with compass server 2014-05-20 01:56:37 +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/