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              |
+-----------------------------+---------------------------------------------------------------------------------+
| allow_nonunique_names       | 0                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| anka_executable             | /Library/Application Support/Veertu/Anka/bin/ankahv.app/Contents/MacOS/ankahv   |
+-----------------------------+---------------------------------------------------------------------------------+
| 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                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| ankasc_tool                 |                                                                                 |
+-----------------------------+---------------------------------------------------------------------------------+
| bios_path                   |                                                                                 |
+-----------------------------+---------------------------------------------------------------------------------+
| block_nocache               | 0                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| bridge_name                 |                                                                                 |
+-----------------------------+---------------------------------------------------------------------------------+
| ca_bundle                   | /Users/m1mini/.anka/ca-bundle.crt                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| chunk_size                  | 0                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| default_disk                | 137438953472                                                                    |
+-----------------------------+---------------------------------------------------------------------------------+
| default_format              | 1                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| default_nvcpu               | 4                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| default_passwd              | admin                                                                           |
+-----------------------------+---------------------------------------------------------------------------------+
| default_ram                 | 4294967296                                                                      |
+-----------------------------+---------------------------------------------------------------------------------+
| default_user                | anka                                                                            |
+-----------------------------+---------------------------------------------------------------------------------+
| delete_logs                 | 1                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| exit_delay                  | 10                                                                              |
+-----------------------------+---------------------------------------------------------------------------------+
| fvutil_executable           | /Library/Application Support/Veertu/Anka/bin/fvutil                             |
+-----------------------------+---------------------------------------------------------------------------------+
| img_lib_dir                 | /Users/m1mini/Library/Application Support/Veertu/Anka/img_lib                   |
+-----------------------------+---------------------------------------------------------------------------------+
| img_path                    |                                                                                 |
+-----------------------------+---------------------------------------------------------------------------------+
| implicit_mount              | 0                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| install_tool                | /Library/Application Support/Veertu/Anka/bin/ankahv.app/Contents/MacOS/ankahv   |
+-----------------------------+---------------------------------------------------------------------------------+
| io_threads                  | 0                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| log_dir                     | /Users/m1mini/Library/Logs/Anka/                                                |
+-----------------------------+---------------------------------------------------------------------------------+
| log_file                    | anka.log                                                                        |
+-----------------------------+---------------------------------------------------------------------------------+
| max_vms_allowed             | 255                                                                             |
+-----------------------------+---------------------------------------------------------------------------------+
| mitigations                 | 0                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| nice                        | 0                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| operations_timeout          | 300                                                                             |
+-----------------------------+---------------------------------------------------------------------------------+
| options_api_url             | https://licensing.veertu.com/prod/key/info                                      |
+-----------------------------+---------------------------------------------------------------------------------+
| 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                                                                            |
+-----------------------------+---------------------------------------------------------------------------------+
| tag_lib_dir                 |                                                                                 |
+-----------------------------+---------------------------------------------------------------------------------+
| time_sync                   | 1                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| trim_disk                   | 1                                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| uhost_executable            | /Library/Application Support/Veertu/Anka/bin/uhost                              |
+-----------------------------+---------------------------------------------------------------------------------+
| update_catalog              | https://mesu.apple.com/assets/macos/com_apple_macOSIPSW/com_apple_macOSIPSW.xml |
+-----------------------------+---------------------------------------------------------------------------------+
| vlaunch_sock                | /var/run/vlaunchd                                                               |
+-----------------------------+---------------------------------------------------------------------------------+
| vlaunch_sock_gui            | /Users/m1mini/.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