compass-core/vagrant/README.md
Carl Li 371b5c978e move stackforge to openstack
Change-Id: I78d9c15f5565ba9bd9495bb2df910ff26da00544
2015-10-18 09:57:23 -07:00

2.4 KiB

compass-vbox

vbox setup for compass

how to use it

requirements

  • Ubuntu-14.04(12.04 not tested but should work)
  • Virtualbox >= 4.3.18
  • Oracle VM VirtualBox extension pack for 4.3.18r96516 to support pxeboot
  • x86_64 CPU architechture
  • Git installed

run:

./launch.sh

or

./launch.sh --recreate

the "recreate" flag will destroy all configured vms and hostonly networks in VirtualBox.

After launch finishes, to access compass server:

vagrant ssh

To use compass-web UI, go to a browser and enter http://192.168.33.10 in the address bar.

Please refer to http://www.syscompass.org/user.html for instructions of Compass UI.

Note:

  • When "discover machines", use 127.0.0.1 as Switch IP. Use any values for Version and Community, leave Filters blank.

  • Please use 192.168.33.0/24 as your eth0 subnet during network configurations as VirtualBox has already been set as so.

  • Please use 192.168.33.10 as the Gateway IP. Compass UI has the default value "10.145.88.1", please relace it.

When to check status:

  • After hitting Deploy, and the cluster state turns to "Installing". Turn on four vms in VirtualBox.

  • When all host states have turned to 50%. ssh to compass server and

tail -f /var/ansible/run/{{ cluster_name }}/ansible.log

Currently customized service credentials are not supported(will be soon). Default credentials for horizon is "admin/admin_secret"

Ansible code

  • All ansible-related code on github: https://github.com/openstack/compass-adatpers.

  • On the Compass virtualbox, to access ansible playbooks, go to /var/ansible/openstack_juno. To check/modify the ansible code on any existing environment, go to /var/ansible/run/{{ cluster_name }}

Debugging and refreshing compass

If there's an unknown error, the best log files to follow: /var/log/compass/celery.log and /var/log/compass/compass.log

To clean up an existing compass cluster, do sudo /opt/compass/bin/refresh.sh

To make sure refresh has cleaned up the ansible running directory, check if /var/ansible/run is empty

NOTE:

  • To make sure the box file is at its minimum size, it only contains OpenStack Juno release related packages and ISOs. Selecting adapters other than "OpenStack Juno" will result in a failure deployment.