Modifying the Global Configuration

How to modify the Global Anka Virtualization configuration
> anka config --help
usage: config [options] [param...]

   Manage the CLI configuration

arguments:
  param                    Parameter name

options:
  -l,--list                List parameter(s)
  -r,--reset               Reset parameter(s) back to default

Viewing the configuration

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

❯ anka config                                                   
+-----------------------------+-----------------------------------------------------------------------------------+
| addons_disk_tool            | /Library/Application Support/Veertu/Anka/guestaddons/create_update_disk.sh        |
+-----------------------------+-----------------------------------------------------------------------------------+
| addons_identifier           | ANKA_ADDONS_IDENTIFIER                                                            |
+-----------------------------+-----------------------------------------------------------------------------------+
| addons_image                | /Library/Application Support/Veertu/Anka/guestaddons/anka-addons-mac              |
+-----------------------------+-----------------------------------------------------------------------------------+
| addons_pkg                  | com.veertu.anka.guestaddons.pkg                                                   |
+-----------------------------+-----------------------------------------------------------------------------------+
| addons_postupdate           | /Library/Application Support/Veertu/Anka/guestaddons/postupdate.sh                |
+-----------------------------+-----------------------------------------------------------------------------------+
| adresses_per_byte           | 250                                                                               |
+-----------------------------+-----------------------------------------------------------------------------------+
| allow_nonunique_names       | False                                                                             |
+-----------------------------+-----------------------------------------------------------------------------------+
| anka_executable             | /Library/Application Support/Veertu/Anka/bin/headless.app/Contents/MacOS/headless |
+-----------------------------+-----------------------------------------------------------------------------------+
| anka_image_maker_executable | /Library/Application Support/Veertu/Anka/bin/anka_image                           |
+-----------------------------+-----------------------------------------------------------------------------------+
| anka_viewer                 | /Applications/Anka.app                                                            |
+-----------------------------+-----------------------------------------------------------------------------------+
| ankacp_executable           | /Library/Application Support/Veertu/Anka/bin/ankacp                               |
+-----------------------------+-----------------------------------------------------------------------------------+
| ankactl_executable          | /Library/Application Support/Veertu/Anka/bin/ankactl                              |
+-----------------------------+-----------------------------------------------------------------------------------+
| ankanet_sock                | /var/run/ankanetd                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| block_nocache               | 1                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| bridge_name                 |                                                                                   |
+-----------------------------+-----------------------------------------------------------------------------------+
| ca_bundle                   | /Users/m1mini/.anka/ca-bundle.crt                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| chunk_size                  | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| config_path                 | /Library/Application Support/Veertu/Anka:~/.anka/settings.ini                     |
+-----------------------------+-----------------------------------------------------------------------------------+
| default_disk                | 137438953472                                                                      |
+-----------------------------+-----------------------------------------------------------------------------------+
| default_format              | 1                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| default_nvcpu               | 4                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| default_passwd              | admin                                                                             |
+-----------------------------+-----------------------------------------------------------------------------------+
| default_ram                 | 4294967296                                                                        |
+-----------------------------+-----------------------------------------------------------------------------------+
| default_user                | anka                                                                              |
+-----------------------------+-----------------------------------------------------------------------------------+
| delete_logs                 | 1                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| exit_delay                  | 5                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| fvutil_executable           | /Library/Application Support/Veertu/Anka/bin/fvutil                               |
+-----------------------------+-----------------------------------------------------------------------------------+
| img_lib_dir                 | /Users/m1mini/Library/Application Support/Veertu/Anka/img_lib                     |
+-----------------------------+-----------------------------------------------------------------------------------+
| io_threads                  | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| log_dir                     | /Users/m1mini/Library/Logs/Anka/                                                  |
+-----------------------------+-----------------------------------------------------------------------------------+
| log_file                    | anka.log                                                                          |
+-----------------------------+-----------------------------------------------------------------------------------+
| mac_random_bytes            | 2                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| max_vms_allowed             | 255                                                                               |
+-----------------------------+-----------------------------------------------------------------------------------+
| mitigations                 | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| nice                        | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| operations_timeout          | 300                                                                               |
+-----------------------------+-----------------------------------------------------------------------------------+
| options_api_url             | https://8ewgf8mtn4.execute-api.us-west-2.amazonaws.com/prod/key/info              |
+-----------------------------+-----------------------------------------------------------------------------------+
| permanent_mac_prefix        | 86,69,69                                                                          |
+-----------------------------+-----------------------------------------------------------------------------------+
| portfwd_base                | 10000                                                                             |
+-----------------------------+-----------------------------------------------------------------------------------+
| process_type                | Interactive                                                                       |
+-----------------------------+-----------------------------------------------------------------------------------+
| product_root                | /Library/Application Support/Veertu/Anka                                          |
+-----------------------------+-----------------------------------------------------------------------------------+
| propagate_license           | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| propagate_name              | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| pull_checkout               | 1                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| puller_threads              | 4                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| qncpu                       | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| quantum                     | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| qvcpu                       | 0                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| registry_remotes_file_path  | /Users/m1mini/.anka/remote                                                        |
+-----------------------------+-----------------------------------------------------------------------------------+
| state_lib_dir               | /Users/m1mini/Library/Application Support/Veertu/Anka/img_lib                     |
+-----------------------------+-----------------------------------------------------------------------------------+
| table_fmt                   | grid                                                                              |
+-----------------------------+-----------------------------------------------------------------------------------+
| time_sync                   | 1                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| trim_disk                   | 1                                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| uhost_executable            | /Library/Application Support/Veertu/Anka/bin/uhost                                |
+-----------------------------+-----------------------------------------------------------------------------------+
| vlaunch_sock                | /var/run/vlaunchd                                                                 |
+-----------------------------+-----------------------------------------------------------------------------------+
| vlaunch_sock_gui            | ~/.anka/vlaunchd                                                                  |
+-----------------------------+-----------------------------------------------------------------------------------+
| vm_lib_dir                  | /Users/m1mini/Library/Application Support/Veertu/Anka/vm_lib                      |
+-----------------------------+-----------------------------------------------------------------------------------+
| vm_lock_dir                 | /Users/m1mini/Library/Application Support/Veertu/Anka/vm_lib/.locks               |
+-----------------------------+-----------------------------------------------------------------------------------+
| vnc_password                | admin                                                                             |
+-----------------------------+-----------------------------------------------------------------------------------+
❯ anka config puller_threads
4

❯ anka config puller_threads 10

❯ anka config puller_threads
10

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