# 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](http://192.168.33.10) in the address bar.

Please refer to [http://www.syscompass.org/user.html](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](https://github.com/openstack/compass-adapters).

* 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.