Preparing your Anka Nodes

Prepare high availability macOS machines before connecting to the Anka Build Cloud Controller

Once the Anka Build Virtualization software has been installed onto a macOS machine, you'll typically want to ensure that the machine has high availability. This requires turning off sleep and several other default features that would cause the machine to become unavailable. Below are the preparatory steps we suggest:

  1. Start a UI session by logging into your node's user to ensure Apple's services are started (it doesn't have to be an administrator).

  2. Enable automatic login for the current user: Go to Preferences > Users > enable automatic login. Or, using the CLI.

    If using the CLI method, you must also XOR-encrypt the login password and add it to /etc/kcpassword. The /etc/kcpassword file must be owned by root:wheel with a mode of 0600. See the GitHub repository veertuinc/kcpassword for help generating the encrypted password string.

  3. Uncheck Log out after X minutes of inactivity under System Preferences > Security & Privacy > Advanced

  4. Uncheck Require password X after sleep or screen saver begins under System Preferences > Security

    VNC may be required to disable this. It's possible your hardware does not have VNC enabled and you also don't have physical access. The following are the commands necessary to enable VNC from an SSH:

    The following examples are only for OS X 10.5 and later.
    cd /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Resources/
    sudo ./kickstart -configure -allowAccessFor -specifiedUsers
    sudo ./kickstart -configure -allowAccessFor -allUsers -privs -all
    sudo ./kickstart -activate
    
  5. Disable all forms of sleep: Go to Preferences > Energy Saver > disable any sleep options.

    Alternatively, you can do this from the command-line:

    # Never go into computer sleep mode
    sudo systemsetup -setcomputersleep Off
    systemsetup -setcomputersleep Off || true
    # Disable standby
    sudo pmset -a standby 0
    # Disable disk sleep
    sudo pmset -a disksleep 0
    # Hibernate mode is a problem on some mac minis; best to just disable
    sudo pmset -a hibernatemode 0
    
  6. Disable spotlight:

    If you cannot perform launchctl commands, you can execute these commands from the command-line:

    # Disable indexing volumes
    sudo defaults write ~/.Spotlight-V100/VolumeConfiguration.plist Exclusions -array "/Volumes"
    sudo defaults write ~/.Spotlight-V100/VolumeConfiguration.plist Exclusions -array "/Network"
    sudo killall mds
    sleep 60
    # Make sure indexing is DISABLED for the main volume
    sudo mdutil -a -i off /
    sudo mdutil -a -i off
    

    MDS can be disable with sudo launchctl unload -w /System/Library/LaunchDaemons/com.apple.metadata.mds.plist, but only if SIP is disabled on the host (not recommended)

  7. Big Sur Only (optional): Disable Apple's mitigations with sudo anka config vmx_mitigations 0. Without it, performance will be ~10% worse inside of the VM.

  8. Set the same chunk_size across your nodes with anka config chunk_size 2147483648 (2GB). Any of the machines that create VM templates/tags need to also have this set.

    If the chunk_size is too small, you may hit Too many open files when trying to start VMs. You can try to modify the system's maxfiles (sudo launchctl limit maxfiles 4096 unlimited), but it may also be a good idea to increase the chunk_size to a larger size as well.

    It's possible to only set it for the creation and/or node that pushes to the registry, post-creation, but it's recommended to set it before creation to minimize errors.

  9. Reboot the host

You may also want to have your nodes restart on host level failure: systemsetup -setrestartpowerfailure on & systemsetup -setrestartfreeze on


Last modified June 30, 2021 : quick fix (eeda829) by Nathan Pierce