Modifying the Global Configuration

How to modify the Global Anka Virtualization configuration
> sudo anka config --help
Usage: anka config [OPTIONS] [PARAM]...

  Manage the CLI configuration

Options:
  -l, --list                     List parameter(s)
  -r, --reset                    Reset parameter(s) back to default
  -s, --sorted / -S, --unsorted  Sort the output in alphabetical order
  --help                         Display usage information

Viewing the configuration

View all default configuration settings for Anka installation on the host with anka config --list command:

❯ anka config -l
+-----------------------------+-----------------------------------------------------------------------------+
| registry_remotes_file_path  | /Users/nathanpierce/.anka/remote                                            |
+-----------------------------+-----------------------------------------------------------------------------+
| propagate_name              | False                                                                       |
+-----------------------------+-----------------------------------------------------------------------------+
| default_nvcpu               | 0                                                                           |
+-----------------------------+-----------------------------------------------------------------------------+
| disk_eraser_tool            | /Library/Application Support/Veertu/Anka/tools/erase_disk_image.sh          |
+-----------------------------+-----------------------------------------------------------------------------+
| mitigations                 | 0                                                                           |
+-----------------------------+-----------------------------------------------------------------------------+
| options_api_url             | https://8ewgf8mtn4.execute-api.us-west-2.amazonaws.com/prod/key/info        |
+-----------------------------+-----------------------------------------------------------------------------+
| fvutil_executable           | /Library/Application Support/Veertu/Anka/bin/fvutil                         |
+-----------------------------+-----------------------------------------------------------------------------+
| propagate_license           | False                                                                       |
+-----------------------------+-----------------------------------------------------------------------------+
| default_passwd              | admin                                                                       |
+-----------------------------+-----------------------------------------------------------------------------+
| nvram_path                  | /Library/Application Support/Veertu/Anka/uefi/anka_vars.fd                  |
+-----------------------------+-----------------------------------------------------------------------------+
| vm_lib_dir                  | /Users/nathanpierce/Library/Application Support/Veertu/Anka/vm_lib/         |
+-----------------------------+-----------------------------------------------------------------------------+
| anka_image_maker_executable | /Library/Application Support/Veertu/Anka/bin/anka_image                     |
+-----------------------------+-----------------------------------------------------------------------------+
| mac_prefix_file             | /Users/nathanpierce/.anka/mac_prefix.txt                                    |
+-----------------------------+-----------------------------------------------------------------------------+
| process_type                | Interactive                                                                 |
+-----------------------------+-----------------------------------------------------------------------------+
| addons_pkg                  | com.veertu.anka.guestaddons.pkg                                             |
+-----------------------------+-----------------------------------------------------------------------------+
| log_dir                     | /Users/nathanpierce/Library/Logs/Anka/                                      |
+-----------------------------+-----------------------------------------------------------------------------+
| operations_timeout          | 300                                                                         |
+-----------------------------+-----------------------------------------------------------------------------+
| ankacp_executable           | /Library/Application Support/Veertu/Anka/bin/ankacp                         |
+-----------------------------+-----------------------------------------------------------------------------+
| vnc_password                |                                                                             |
+-----------------------------+-----------------------------------------------------------------------------+
| nice                        | 0                                                                           |
+-----------------------------+-----------------------------------------------------------------------------+
| product_root                | /Library/Application Support/Veertu/Anka                                    |
+-----------------------------+-----------------------------------------------------------------------------+
| addons_disk_tool            | /Library/Application Support/Veertu/Anka/tools/addons_create_update_disk.sh |
+-----------------------------+-----------------------------------------------------------------------------+
| time_sync                   | 1                                                                           |
+-----------------------------+-----------------------------------------------------------------------------+
| ca_bundle                   | /Users/nathanpierce/.anka/ca-bundle.crt                                     |
+-----------------------------+-----------------------------------------------------------------------------+
| max_vms_allowed             | 255                                                                         |
+-----------------------------+-----------------------------------------------------------------------------+
| portfwd_base                | 10000                                                                       |
+-----------------------------+-----------------------------------------------------------------------------+
| addons_postupdate           | /Library/Application Support/Veertu/Anka/tools/addons_postupdate.sh         |
+-----------------------------+-----------------------------------------------------------------------------+
| bridge_name                 |                                                                             |
+-----------------------------+-----------------------------------------------------------------------------+
| mac_random_bytes            | 2                                                                           |
+-----------------------------+-----------------------------------------------------------------------------+
| anka_executable             | /Library/Application Support/Veertu/Anka/bin/ankahv                         |
+-----------------------------+-----------------------------------------------------------------------------+
| table_fmt                   | grid                                                                        |
+-----------------------------+-----------------------------------------------------------------------------+
| block_nocache               | True                                                                        |
+-----------------------------+-----------------------------------------------------------------------------+
| default_user                | anka                                                                        |
+-----------------------------+-----------------------------------------------------------------------------+
| vm_lock_dir                 | /Users/nathanpierce/Library/Application Support/Veertu/Anka/vm_lib/.locks   |
+-----------------------------+-----------------------------------------------------------------------------+
| default_ram                 | 0                                                                           |
+-----------------------------+-----------------------------------------------------------------------------+
| state_lib_dir               | /Users/nathanpierce/Library/Application Support/Veertu/Anka/state_lib/      |
+-----------------------------+-----------------------------------------------------------------------------+
| mac_counter                 | /Users/nathanpierce/.anka/mac_counter.txt                                   |
+-----------------------------+-----------------------------------------------------------------------------+
| uhost_executable            | /Library/Application Support/Veertu/Anka/bin/uhost                          |
+-----------------------------+-----------------------------------------------------------------------------+
| addons_identifier           | com.veertu.anka.addons.core.pkg                                             |
+-----------------------------+-----------------------------------------------------------------------------+
| addons_image                | /Library/Application Support/Veertu/Anka/guestaddons/anka-addons-mac.iso    |
+-----------------------------+-----------------------------------------------------------------------------+
| default_disk                | 137438953472                                                                |
+-----------------------------+-----------------------------------------------------------------------------+
| allow_nonunique_names       | False                                                                       |
+-----------------------------+-----------------------------------------------------------------------------+
| permanent_mac_prefix        | 86,69,69                                                                    |
+-----------------------------+-----------------------------------------------------------------------------+
| anka_viewer                 | /Applications/Anka.app                                                      |
+-----------------------------+-----------------------------------------------------------------------------+
| img_lib_dir                 | /Users/nathanpierce/Library/Application Support/Veertu/Anka/img_lib/        |
+-----------------------------+-----------------------------------------------------------------------------+
| puller_threads              | 2                                                                           |
+-----------------------------+-----------------------------------------------------------------------------+
| bios_path                   | /Library/Application Support/Veertu/Anka/uefi/anka_code.fd                  |
+-----------------------------+-----------------------------------------------------------------------------+
| log_file                    | anka.log                                                                    |
+-----------------------------+-----------------------------------------------------------------------------+
| adresses_per_byte           | 250                                                                         |
+-----------------------------+-----------------------------------------------------------------------------+
| trim_disk                   | True                                                                        |
+-----------------------------+-----------------------------------------------------------------------------+

You can see a value for a specific configuration parameter with anka config $PARAM_NAME.

  • The default VM username is anka
  • The default VM password is admin
  • The default storage locations for Anka VM Templates & Tags are:
    • vm_lib_dir - /Users/XXX/Library/Application Support/Veertu/Anka/vm_lib/
    • state_lib_dir - /Users/XXX/Library/Application Support/Veertu/Anka/state_lib/
    • img_lib_dir - /Users/XXX/Library/Application Support/Veertu/Anka/img_lib/
  • The log directory is /Users/XXX/Library/Logs/Anka/ and log file is anka.log.

Changing the default Anka VM storage location

Depending on how many Anka VMs you have, the disk usage might be too much for the default storage location. There are three configuration parameters to control location for storing Anka VMs.

It's recommended to keep the vm_lib_dir on the local disk as it contains file locks.

Assuming you want to store your Templates on /Volumes/ExternalDrive/, perform these steps:

  1. anka config img_lib_dir /Volumes/ExternalDrive/image_lib
  2. anka config state_lib_dir /Volumes/ExternalDrive/state_lib
  3. anka config vm_lib_dir /Volumes/ExternalDrive/vm_lib

Last modified November 12, 2020 : 2.3.0 BETA (cc782fc) by Nathan Pierce