compass-install/README.md
Xicheng Chang fa5f106bf6 Revert "Retire stackforge/compass-install"
This reverts commit 2614e5fa95aab680fb6f9287831e50c65f76f72c.

The repository is actually maintained, the authors merely
misunderstood the stackforge namespace retirement maintenance
announcements[1] and didn't realize they needed to notify us of that
status. Reverting the repository to its former state in preparation
for a namespace move in a coming project rename maintenance.

[1] http://lists.openstack.org/pipermail/openstack-infra/2015-August/003119.html

Change-Id: I6ccdcd8f8a084711c265e42c77b3b4159af27b24
2015-11-03 17:37:20 -08:00

1.5 KiB

Compass Install

How to use examples/compass?

  1. Make sure you have docker installed.
  2. Make sure you have working cobbler and chef servers, where all adapter related code has been updated to the latest.
  3. Go to your chef server's web UI and create a client with admin privileges, name it as docker-controller.
  4. You will have ONE CHANCE to copy the private key, copy it and paste it to replace conf/chef-client.pem
  5. Go to examples/compass/conf directory
  6. Edit chef-icehouse.conf, change '10.145.89.140' to your chef server's IP.
  7. Edit cobbler.conf and change the IP to your cobbler server's IP.
  8. Edit compass.setting
  • COMPASS_SUPPORTED_PROXY: this is not supported in containerized compass, use the default value
  • COMPASS_SUPPORTED_DEFAULT_NOPROXY: default value
  • COMPASS_SUPPORTED_NTP_SERVER: I am planning to move ntpd to cobbler container, so for now just point this value to any working compass server.
  • COMPASS_DNS_SERVERS: cobbler server takes care of dns, use cobbler server IP
  • COMPASS_SUPPROTED_DOMAINS: default
  • COMPASS_SUPPORTED_DEFAULT_GATEWAY: default
  • COMPASS_SUPPORTED_LOCAL_REPO: use http://$your\_host\_for\_docker:8080
  1. Go to examples/compass and run docker build -t {image_name} .
  2. Once build finishes, run docker run -d -p 8080:80 -i -t {image_name}
  3. celery log will be displayed on terminal, once the start script finishes running, open your web browser and go to http://$your\_host\_for\_docker:8080