#!/usr/bin/env bash # @file VMWare Configuration # @brief Installs VMWare Workstation Pro on Linux devices, applies a "publicly-retrieved" license key (see disclaimer), and automatically accepts the terms and conditions # @description # This script ensures the user included `vmware` in their software installation list. It then checks for presence of the `vmware` utility. If it is not present, then the script: # # 1. Downloads the [VMWare Workstation Pro](https://www.vmware.com/content/vmware/vmware-published-sites/us/products/workstation-pro.html.html) Linux installer # 2. Installs VMWare Workstation Pro # 3. Passes options to the installation script that automatically apply a publicly retrived license key and accept the Terms & Conditions # # This script first checks if `vagrant`, `vmware`, and `vagrant-vmware-utility` are available in the `PATH`. If they are present, then the script # configures the [`vagrant-vmware-utility`](https://developer.hashicorp.com/vagrant/docs/providers/vmware/vagrant-vmware-utility) by generating the required security certificates and enabling the service. # This system package enables the capability of controlling both VMWare Workstation and VMWare Fusion with Vagrant. # # Since this script runs only when `vagrant`, `vmware`, and `vagrant-vmware-utility` are in the `PATH`, this means that it will run # when you use an installation template that includes all three pieces of software in the software list defined in # `home/.chezmoidata.yaml`. # # **DISCLAIMER:** If you plan on using VMWare Workstation for anything but evaluation purposes, then we highly suggest purchasing a copy # of VMWare Workstation. The "publicly-retrived" license keys are scattered throughout GitHub and we are not exactly # sure why they work. You can pass in your own key by utilizing the `VMWARE_WORKSTATION_LICENSE_KEY` environment variable. More details on # using environment variables or repository-housed encrypted secrets can be found in our [Secrets documentation](https://install.doctor/docs/customization/secrets). # # ## VMWare on macOS # # This script only installs VMWare Workstation on Linux. The macOS-variant titled VMWare Fusion can be installed using a Homebrew # cask so a "work-around" script does not have to be used. # # ## VMWare vs. Parallels vs. VirtualBox vs. KVM vs. Hyper-V # # There are a handful of VM virtualization providers you can choose from. VMWare is a nice compromise between OS compatibility and performance. # Parallels, on the hand, might be better for macOS since it is designed specifically for macOS. Finally, VirtualBox is a truly free, # open-source option that does not come with the same optimizations that VMWare and Parallels provide. # # Other virtualization options include KVM (Linux / macOS) and Hyper-V (Windows). These options are better used for headless # systems. # # ## Links # # * [VMWare Workstation homepage](https://www.vmware.com/content/vmware/vmware-published-sites/us/products/workstation-pro.html.html) # * [Vagrant VMWare Utility on GitHub](https://github.com/hashicorp/vagrant-vmware-desktop) # * [`home/.chezmoidata.yaml`](https://github.com/megabyte-labs/install.doctor/blob/master/home/.chezmoidata.yaml) # * [Default license key gist](https://gist.github.com/PurpleVibe32/30a802c3c8ec902e1487024cdea26251) ### Run logic if VMware is installed if command -v vmware > /dev/null; then ### Build kernel modules if they are not present if [ ! -f "/lib/modules/$(uname -r)/misc/vmmon.ko" ] || [ ! -f "/lib/modules/$(uname -r)/misc/vmnet.ko" ]; then ### Build VMWare host modules logg info 'Building VMware host modules' if sudo vmware-modconfig --console --install-all; then logg success 'Built VMWare host modules successfully with sudo vmware-modconfig --console --install-all' else logg info 'Acquiring VMware version from CLI' VMW_VERSION="$(vmware --version | cut -f 3 -d' ')" mkdir -p /tmp/vmw_patch cd /tmp/vmw_patch logg info 'Downloading VMware host module patches' && curl -sSL "https://github.com/mkubecek/vmware-host-modules/archive/workstation-$VMW_VERSION.tar.gz" -o /tmp/vmw_patch/workstation.tar.gz tar -xzf /tmp/vmw_patch/workstation.tar.gz cd vmware* logg info 'Running sudo make and sudo make install' sudo make sudo make install logg success 'Successfully configured VMware host module patches' fi ### Sign VMware host modules if Secure Boot is enabled if [ -f /sys/firmware/efi ]; then logg info 'Signing host modules' mkdir -p /tmp/vmware cd /tmp/vmware openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=VMware/" "/usr/src/linux-headers-$(uname -r)/scripts/sign-file" sha256 ./MOK.priv ./MOK.der "$(modinfo -n vmmon)" "/usr/src/linux-headers-$(uname -r)/scripts/sign-file" sha256 ./MOK.priv ./MOK.der "$(modinfo -n vmnet)" echo '' | mokutil --import MOK.der logg success 'Successfully signed VMware host modules. Reboot the host before powering on VMs' fi ### Patch VMware with Unlocker if [ ! -f /usr/lib/vmware/isoimages/darwin.iso ]; then logg info 'Acquiring VMware Unlocker latest release version' UNLOCKER_URL="$(curl -sSL 'https://api.github.com/repos/DrDonk/unlocker/releases/latest' | jq -r '.assets[0].browser_download_url')" mkdir -p /tmp/vmware-unlocker cd /tmp/vmware-unlocker logg info 'Downloading unlocker.zip' curl -sSL "$UNLOCKER_URL" -o unlocker.zip unzip unlocker.zip cd linux logg info 'Running the unlocker' echo "y" | sudo ./unlock logg success 'Successfully unlocked VMware for macOS compatibility' else logg info '/usr/lib/vmware/isoimages/darwin.iso is already present on the system so VMware macOS unlocking will not be performed' fi if [[ ! "$(test -d /proc && grep Microsoft /proc/version > /dev/null)" ]]; then ### Start / enable VMWare service logg info 'Ensuring vmware.service is enabled and running' sudo systemctl enable vmware.service sudo systemctl restart vmware.service ### Start / enable VMWare Workstation Server service logg info 'Ensuring vmware-workstation-server.service is enabled and running' sudo systemctl enable vmware-workstation-server.service sudo systemctl restart vmware-workstation-server.service ### Start / enable VMWare USB Arbitrator service if command -v vmware-usbarbitrator.service > /dev/null; then logg info 'Ensuring vmware-usbarbitrator.service is enabled and running' sudo systemctl enable vmware-usbarbitrator.service sudo systemctl restart vmware-usbarbitrator.service else logg warn 'vmware-usbarbitrator does not exist in the PATH' fi fi else logg info 'VMware host modules are present' fi else if [ -d /Applications ] && [ -d /System ]; then ### macOS logg info 'System is macOS so there is no unlocker or modules that need to be enabled' else ### Linux and VMWare not installed logg warn 'VMware Workstation is not installed so the VMware Unlocker will not be installed' fi fi # @description Only run logic if both Vagrant and VMWare are installed if command -v vagrant > /dev/null && command -v vmware-id > /dev/null; then ### Vagrant VMWare Utility configuration if command -v vagrant-vmware-utility > /dev/null; then if [ -f /usr/local/bin/certificates/vagrant-utility.key ]; then logg info 'Assuming Vagrant VMWare Utility certificates have been properly generated since /usr/local/bin/certificates/vagrant-utility.key is present' else logg info 'Generating Vagrant VMWare Utility certificates' sudo vagrant-vmware-utility certificate generate logg success 'Generated Vagrant VMWare Utility certificates via vagrant-vmware-utility certificate generate' fi logg info 'Ensuring the Vagrant VMWare Utility service is enabled' sudo vagrant-vmware-utility service install || EXIT_CODE=$? if [ -n "$EXIT_CODE" ]; then logg info 'The Vagrant VMWare Utility command vagrant-vmware-utility service install failed. If it was already set up, there should be a notice above.' fi fi else logg info 'Vagrant is not installed so the Vagrant plugins will not be installed' logg info 'Vagrant or VMWare is not installed so the Vagrant VMWare utility will not be configured' fi