Mac OS

Setting up your Anka Build Cloud Controller & Registry on Mac OS

Installing

Instructions can be found under our Getting Started with Mac OS guide

Expectations

  1. The service runs as root
  2. Anka Controller listens on port 80
  3. Anka Registry is listening on port 8089
  4. Registry data is stored at /Library/Application Support/Veertu/Anka/registry

Start / Stop

The registry is included in the anka-controller service. They are restarted together.

Use sudo anka-controller command to start/stop/check status of the controller.

sudo anka-controller --help
usage: /usr/local/bin/anka-controller [start|stop|restart|status|logs]

Changing location of VM storage in the Registry

  1. Stop the controller service sudo anka-controller stop
  2. Change the default settings, including the location of registry storage by editing the /usr/local/bin/anka-controllerd.
  3. Start the controller service sudo anka-controller start

Go to the localhost:port in the browser on the mac where you installed the controller/registry package and you will see the controller dashboard.

Uninstalling

From the command line, execute the following command:

sudo /Library/Application Support/Veertu/Anka/tools/controller/uninstall.sh

Debugging Issues

Anka controller is a server that usually runs as a daemon and errors are usually written to a log. The easiest way to debug the controller is to run ‘/usr/local/bin/anka-controllerd’ directly. This will output the controller log to the screen and you will be able to see if there are any errors.

  1. First stop the controller with sudo anka-controller stop
  2. Then execute /usr/local/bin/anka-controllerd

You can also tail the log, the default location is /Library/Logs/Veertu/AnkaController. Check /usr/local/bin/anka-controllerd in order to see the log dir location.



Last modified July 2, 2020 : various improvements to setup guides (9bc9081) by Nathan Pierce