Difference between revisions of "VMware/Installing Arch as a guest"

From ArchWiki
Jump to: navigation, search
(COPY AND PASTE: link to main article)
m (Drag and drop, copy/paste needs gtkmm3, not gtkmm since V10.2.0)
 
(190 intermediate revisions by 62 users not shown)
Line 1: Line 1:
 
[[Category:Getting and installing Arch]]
 
[[Category:Getting and installing Arch]]
[[Category:Virtualization]]
+
[[Category:Hypervisors]]
[[es:Installing Arch Linux in VMware]]
+
[[es:VMware/Installing Arch as a guest]]
[[nl:Installing Arch Linux in VMware]]
+
[[ja:VMware に Arch Linux をインストール]]
[[zh-CN:Installing Arch Linux in VMware]]
+
[[nl:VMware/Installing Arch as a guest]]
{{Article summary start}}
+
[[ru:VMware/Installing Arch as a guest]]
{{Article summary text|Installing Archlinux in VMware: open-vm-tools and configuring Xorg}}
+
[[zh-hans:VMware/Installing Arch as a guest]]
{{Article summary heading|Related}}
+
{{Related articles start}}
{{Article summary wiki|VMware}}
+
{{Related|VMware}}
{{Article summary wiki|Installing VMWare vCLI}}
+
{{Related|Installing VMWare vCLI}}
{{Article summary wiki|Installing Arch Linux in VMware (systemd)}}
+
{{Related articles end}}
{{Article summary end}}
+
This article is about installing Arch Linux in a [[VMware]] product, such as [http://www.vmware.com/products/player/ Player (Plus)], [http://www.vmware.com/products/fusion/ Fusion] or [http://www.vmware.com/products/workstation/ Workstation].
  
This article handles installing Archlinux in a VMware-based virtual environment such as VMware ESX, VMware Workstation/Fusion and VMware Player.
+
== In-kernel drivers ==
  
==VMware Tools versus Open-VM-Tools==
+
*{{ic|vmw_balloon}} - The physical memory management driver. It acts like a "balloon" that can be inflated to reclaim physical pages by reserving them in the guest and invalidating them in the monitor, freeing up the underlying machine pages so they can be allocated to other guests. It can also be deflated to allow the guest to use more physical memory. Deallocated Virtual Machine memory can be reused in the host without terminating the guest.
 +
*{{ic|vmw_pvscsi}} - For VMware's Paravirtual SCSI (PVSCSI) HBA.
 +
*{{ic|vmw_vmci}} - The Virtual Machine Communication Interface. It enables high-speed communication between host and guest in a virtual environment via the VMCI virtual device.
 +
*{{ic|vmwgfx}} - For 3D acceleration. This is a KMS enabled DRM driver for the VMware SVGA2 virtual hardware.
 +
*{{ic|vmxnet3}} - For VMware's vmxnet3 virtual ethernet NIC.
 +
* a fuse-based hgfs implementation has been added to {{ic|open-vm-tools}} 10.0+ and is supported from kernel version 4.0+.
 +
These drivers are only needed if you are running Arch Linux on a hypervisor like [http://www.vmware.com/products/vsphere-hypervisor VMware vSphere Hypervisor]. Client-server applications can write to the VMCI Sock (vsock) interface to make use of the VMCI virtual device, when communicating between virtual machines.
 +
*{{ic|vsock}} - The Virtual Socket Protocol. It is similar to the TCP/IP socket protocol, allowing communication between Virtual Machines and hypervisor or host.
 +
*{{ic|vmw_vsock_vmci_transport}} - Implements a VMCI transport for Virtual Sockets.
  
VMware Tools for linux exists in 2 forms: the [http://packages.vmware.com/tools official VMware Tools] and Open-VM-Tools. VMware Tools is based on a stable snapshot of Open-VM-Tools. Open-VM-Tools contains more experimental code and features.
+
{{Note|Arch's [[Udev]] auto-detects and enables a few of these modules.  Additional modules, such as {{ic|vmw_balloon}}, may need to be added to your [[Mkinitcpio]]'s {{ic|MODULES}} list.  For example:
The official VMware Tools are not available for Archlinux.
+
{{hc| # cat /etc/mkinitcpio.conf|output=
 +
...
 +
MODULES="... vmw_balloon vmw_pvscsi vsock vmw_vsock_vmci_transport ..."}}
  
Originally, VMware Tools provided the best drivers for network and storage, combined with the functionality for other features such as time synchronization. However, for quite a while now the drivers for the network adapter en scsi adapter are part of the linux kernel, and VMware Tools is only needed for extra features and support for the "old" vmxnet adapter.
+
Make sure to rebuild with:
 +
  # mkinitcpio -p linux
  
==Open-VM-Tools modules==
+
Some modules, such as the legacy {{ic|vmhgfs}} shared folder module, will require additional work to manually {{ic|compile}} and systemd {{ic|enable}} in order to function properly.
  
The open-vm-tools package contains the following modules:
+
}}
  
* vmblock: kernel filesystem module, enables drag&drop functionality between the host system and the virtual machine in VMware Workstation/Fusion.
+
== VMware Tools versus Open-VM-Tools ==
* vmhgfs: kernel filesystem module, enables file/directory sharing between the host system and the virtual machine in VMware Workstation/Fusion.
 
* vmsync: experimental filesystem sync driver, enables filesystem quiescing when creating backups and snapshots.
 
* vmci: virtual machine communication interface, high performance interface between virtual machines on the same host and between virtual machines and the host itself.
 
* vsocket: part of vmci.
 
* vmxnet: driver for the old vmxnet netwerk-adapter.
 
  
==Open-VM-Tools utilities==
+
In 2007, VMware released large partitions of the [http://kb.vmware.com/kb/340 VMware Tools] under the LGPL as [http://sourceforge.net/projects/open-vm-tools/ Open-VM-Tools]. The official Tools are not available [http://packages.vmware.com/tools/esx/latest/repos/index.html separately] for Arch Linux.
  
The open-vm-tools package comes with the following utilities:
+
Originally, VMware Tools provided the best drivers for network and storage, combined with the functionality for other features such as time synchronization. However, for quite a while now the drivers for the network/SCSI adapter are part of the Linux kernel.
  
* vmtoolsd: service responsible for the virtual machine status report.
+
The official VMware Tools used to have the advantage of being able to use the Unity mode feature, but as of VMWare Workstation 12, Unity mode for Linux guests has been removed due to lack of use and developer difficulties in maintaining the feature. See the answer in this [https://communities.vmware.com/thread/518735|this thread].
* vmware-check-vm: tool to check whether a utility has been started on a physical or virtual machine.
 
* vmware-xferlogs: Dumps logging/debugging information to the virtual machine logfile.
 
* vmware-toolbox-cmd: tool to obtain virtual machine information of the host such as statistics,...
 
* vmware-user-suid-wrapper: tool to enable clipboard sharing (copy/paste) between host and virtual machine.
 
  
==Installating Open-VM-Tools==
+
== Open-VM-Tools ==
  
Install the {{Pkg|open-vm-tools}} package in the <nowiki>[</nowiki>[[community]]<nowiki>]</nowiki> repository.
+
=== Utilities ===
  
Start the service and enable it at boot:
+
The {{Pkg|open-vm-tools}} package comes namely with the following utilities:
  
# systemctl start vmtoolsd
+
* {{ic|vmtoolsd}} - Service responsible for the Virtual Machine status report.
# systemctl enable vmtoolsd
+
* {{ic|vmware-checkvm}} - Tool to check whether a program is running in the guest.
 +
* {{ic|vmware-toolbox-cmd}} - Tool to obtain Virtual Machine information of the host.
 +
* {{ic|vmware-user}} - Tool to enable clipboard sharing (copy/paste) between host and guest.
 +
* {{ic|vmware-vmblock-fuse}} - Filesystem utility. Enables drag & drop functionality between host and guest through [[Wikipedia:Filesystem in Userspace|FUSE]] (Filesystem in Userspace).
 +
* {{ic|vmware-xferlogs}} - Dumps logging/debugging information to the Virtual Machine logfile.
 +
* {{ic|vmhgfs-fuse}} - Utility for mounting vmhgfs shared folders.
  
The open-vm-tools reads the file /etc/arch-release which is empty:
+
=== Modules ===
  
cat /proc/version > /etc/arch-release
 
  
==Time synchronization==
+
*{{ic|vmhgfs}} - Legacy filesystem driver. Enables legacy sharing implementation between host and guest.
 +
*{{ic|vmxnet}} - for the old VMXNET network adapter.
  
Configuring time synchronization in a virtual machine is important: fluctuations are bound to occur more easily in a virtual machine compared to a physical host. This is mostly due to the fact that the CPU is shared by more than one virtual machine.
+
=== Installation ===
  
There are 2 options to set up time synchronization: the host machine as source or an external server as source.
+
[[Install]] the {{Pkg|open-vm-tools}}. If you want to use shared folders you also need to install the {{AUR|open-vm-tools-dkms}} package.
  
===Host machine as time source===
+
Open-VM-Tools reads version information from {{ic|/etc/arch-release}}, which is empty:
To use the host as a time source (for example in an ESX server), run the following command (one time is enough):
 
  
  vmware-toolbox-cmd timesync enable
+
  # cat /proc/version > /etc/arch-release
  
To synchronize your guest clock with the host after your host machine wakes up from sleeping (like a laptop computer):
+
==== Multi-User Target ====
 +
If you're booting into the {{ic|multi-user.target}} then follow the steps mentioned here. If you're booting into the graphical.target then please skip this section and read the instructions for the {{ic|graphical.target}}.
  
sudo hwclock --hctosys --localtime
+
[[Start]] {{ic|vmtoolsd.service}} and enable it on boot, if desired.
  
I run the above command every time I wake up my sleeping laptop and resume using Arch Linux inside the VMWare Player.
+
==== Graphical Target ====
 +
If you are booting into a graphical environment then follow these steps to enable the VMware tools.
  
===External server as time source===
+
Enable the {{ic|vmware-vmblock-fuse.service}} Systemd service. NOTE: as of 2018/01/01 it appears that vmtoolsd (as described in above multi-user section) must also be enabled in order for this to work properly.
 +
 
 +
If you have installed {{AUR|open-vm-tools-dkms}} then you should enable the {{ic|dkms.service}} Systemd service which automatically recompiles the kernel modules after a kernel update.
 +
 
 +
Try to install {{Pkg|gtkmm3}} manually if it does not work properly. To enable copy&paste between host and guest {{Pkg|gtkmm3}} is required.
 +
 
 +
=== Host/Guest interaction ===
 +
For automatic resolution update on window resize and in order to enable copy&paste between host and guest [https://bbs.archlinux.org/viewtopic.php?pid=1081629#p1081629 start] {{ic|/usr/bin/vmware-user}} from within X. This may throw warnings like "vmware-user: could not open /proc/fs/vmblock/dev" and warnings about GTK which can be ignored.
 +
 
 +
== Official VMware Tools ==
 +
 
 +
=== Modules ===
 +
 
 +
*{{ic|vmblock}} - Filesystem driver. Enables drag & drop functionality between host and guest ([https://www.mail-archive.com/open-vm-tools-devel@lists.sourceforge.net/msg00213.html superseded] by the {{ic|vmware-vmblock-fuse}} utility).
 +
*{{ic|vmci}} - High performance communication interface between host and guest.
 +
*{{ic|vmmon}} - Virtual Machine Monitor.
 +
*{{ic|vmnet}} - Networking driver.
 +
*{{ic|vsock}} - VMCI sockets.
 +
 
 +
{{Note|There is no module for {{ic|vmware-vmblock-fuse}}, and {{ic|vmblock}} has been removed from the kernel unless you disable {{ic|fuse}}.  Instead, systemd services need to be {{ic|enabled}} to allow these functions.  See instructions below.
 +
}}
 +
 
 +
=== Installation (from guest) ===
 +
 
 +
Install the dependencies: {{Grp|base-devel}} (for building), {{Pkg|net-tools}} (for {{ic|ifconfig}}, used by the installer) and {{Pkg|linux-headers}} (for kernel headers).
 +
 
 +
Then, create bogus init directories for the installer:
 +
# for x in {0..6}; do mkdir -p /etc/init.d/rc${x}.d; done
 +
 
 +
The installer can then be mounted:
 +
# mount /dev/cdrom /mnt
 +
 
 +
Extracted (e.g. to {{ic|/root}}):
 +
# tar xf /mnt/VMwareTools*.tar.gz -C /root
 +
 
 +
And started:
 +
# perl /root/vmware-tools-distrib/vmware-install.pl
 +
 
 +
You can safely ignore the following build failures:
 +
 
 +
* VMNEXT 3 virtual network card
 +
* "Warning: This script could not find mkinitrd or update-initramfs and cannot remake the initrd file!"
 +
* Fuse components not found on the system.
 +
 
 +
 
 +
Enable {{ic|vmware-vmblock-fuse}} systemd services) (make sure you install the dependencies manually or use the ''-s'' flag:
 +
 
 +
  # asp checkout open-vm-tools
 +
  # cd open-vmtools/repos/community-x86_64/
 +
  # makepkg -s --asdeps
 +
  # cp vm* /usr/lib/systemd/system
 +
  # systemctl enable vmware-vmblock-fuse
 +
  # systemctl enable vmtoolsd
 +
 
 +
Reboot the Virtual Machine:
 +
 
 +
# systemctl reboot
 +
 
 +
Log in and start the VMware Tools:
 +
 
 +
# /etc/init.d/rc6.d/K99vmware-tools start
 +
 
 +
{{Tip|There is also a [https://github.com/rasa/vmware-tools-patches project] in GitHub trying to automate all this.}}
 +
 
 +
== Xorg configuration ==
 +
 
 +
{{Note|To use Xorg in a Virtual Machine, a minimum of 32MB VGA memory is needed.}}
 +
 
 +
Install the dependencies: {{Pkg|xf86-input-vmmouse}}, {{Pkg|xf86-video-vmware}}, and {{Pkg|mesa}}.
 +
 
 +
If booting into a {{ic|graphical target}} you are almost done. {{ic|/etc/xdg/autostart/vmware-user.desktop}} will get started which will setup most of the things needed to work with the Virtual Machine.
 +
 
 +
However, if booting into {{ic|multi-user.target}} or using an uncommon setup (e.g. multiple monitors), then {{ic|vmtoolsd.service}} needs to be [[enable]]d. In addition to this, edit:
 +
 
 +
{{hc|head=/etc/X11/Xwrapper.config|output=
 +
needs_root_rights=yes
 +
}}
 +
 
 +
to give permission for loading drivers.
 +
 
 +
== Tips and tricks ==
 +
 
 +
 
 +
=== Shared Folders with {{ic|vmhgfs-fuse}} utility ===
 +
 
 +
{{Note|This functionality is only available with {{ic|open-vm-tools}} v.10.x and kernel 4.x onwards and with VMware Workstation and Fusion.}}
 +
 
 +
Share a folder by selecting ''Edit virtual machine settings > Options > Shared Folders > Always enabled'', and creating a new share.
 +
 
 +
You should be able to see the shared folders with:
 +
 
 +
$ vmware-hgfsclient
 +
 
 +
Now you can mount the folder:
 +
 
 +
# mkdir <shared folders root directory>
 +
# vmhgfs-fuse -o allow_other -o auto_unmount .host:/''<shared_folder>'' ''<shared folders root directory>''
 +
 
 +
Other {{ic|vmhgfs-fuse}} mount options can be viewed by using the {{ic|-h}} input flag:
 +
 
 +
# vmhgfs-fuse -h
 +
 
 +
===== fstab =====
 +
 
 +
Add a rule for each share:
 +
 
 +
{{hc|/etc/fstab|
 +
.host:/''<shared_folder>'' ''/home/user1/shares'' fuse.vmhgfs-fuse defaults 0 0
 +
}}
 +
 
 +
Create and mount the Shared Folders:
 +
 
 +
# mkdir /home/user1/shares
 +
# mount /home/user1/shares
 +
 
 +
===== Systemd =====
 +
 
 +
Create the following {{ic|.service}}:
 +
 
 +
{{hc|head=/etc/systemd/system/''<shared folders root directory>''-''<shared_folder>''.service|output=
 +
[Unit]
 +
Description=Load VMware shared folders
 +
Requires=vmware-vmblock-fuse.service
 +
After=vmware-vmblock-fuse.service
 +
ConditionPathExists=.host:/''<shared_folder>''
 +
ConditionVirtualization=vmware
 +
 
 +
[Service]
 +
Type=oneshot
 +
RemainAfterExit=yes
 +
ExecStart=
 +
ExecStart=/usr/bin/vmhgfs-fuse -o allow_other -o auto_unmount .host:/''<shared_folder>'' ''<shared folders root directory>''
 +
 
 +
 
 +
[Install]
 +
WantedBy=multi-user.target
 +
}}
 +
 
 +
Make sure the {{ic|''<shared folders root directory>''}} folder exists on your system. If this folder does not exist then you have to create it as the systemd service depends on it:
 +
 
 +
# mkdir -p ''<shared folders root directory>''
 +
 
 +
[[Enable]] the {{ic|<shared folders root directory>-<shared_folder>.service}} mount target.
 +
 
 +
If you want to mount all shared folders automatically then omit ''<shared_folder>''.
 +
 
 +
=== Legacy Shared Folders with vmhgfs module  ===
 +
 
 +
{{Note|This functionality is only available in VMware Workstation and Fusion}}
 +
 
 +
Share a folder by selecting ''Edit virtual machine settings > Options > Shared Folders > Always enabled'', and creating a new share.
 +
 
 +
Make sure the {{ic|vmhgfs}} driver is loaded:
 +
 
 +
# modprobe vmhgfs
 +
 
 +
You should be able to see the shared folders with:
 +
 
 +
$ vmware-hgfsclient
 +
 
 +
Now you can mount the folder:
 +
 
 +
# mkdir /home/user1/shares
 +
# mount -n -t vmhgfs .host:/''<shared_folder>'' /home/user1/shares
 +
 
 +
==== Enable at boot ====
 +
 
 +
Edit your {{ic|mkinitcpio.conf}} like this:
 +
{{hc| # cat /etc/mkinitcpio.conf|output=
 +
...
 +
MODULES="... vmhgfs"
 +
...
 +
}}
 +
and then update your ramdisk:
 +
# mkinitcpio -p linux
 +
 
 +
===== fstab =====
 +
 
 +
Add a rule for each share:
 +
 
 +
{{hc|/etc/fstab|
 +
.host:/''<shared_folder>'' ''/home/user1/shares'' vmhgfs defaults 0 0
 +
}}
 +
 
 +
Create and mount the Shared Folders:
 +
 
 +
# mkdir /home/user1/shares
 +
# mount /home/user1/shares
 +
 
 +
===== Systemd =====
 +
 
 +
For shared folders to be working you need to have loaded the {{ic|vmhgfs}} driver. Simply create the following {{ic|.service}}s:
 +
 
 +
{{hc|head=/etc/systemd/system/''<shared folders root directory>''-''<shared_folder>''.mount|output=
 +
[Unit]
 +
Description=Load VMware shared folders
 +
ConditionPathExists=.host:/''<shared_folder>''
 +
ConditionVirtualization=vmware
 +
 
 +
[Mount]
 +
What=.host:/''<shared_folder>''
 +
Where=''<shared folders root directory>''/''<shared_folder>''
 +
Type=vmhgfs
 +
Options=defaults,noatime
 +
 
 +
[Install]
 +
WantedBy=multi-user.target
 +
}}
 +
 
 +
{{hc|head=/etc/systemd/system/''<shared folders root directory>''-''<shared_folder>''.automount|output=
 +
[Unit]
 +
Description=Load VMware shared folders
 +
ConditionPathExists=.host:/''<shared_folder>''
 +
ConditionVirtualization=vmware
 +
 
 +
[Automount]
 +
Where=''<shared folders root directory>''/''<shared_folder>''
 +
 
 +
[Install]
 +
WantedBy=multi-user.target
 +
}}
 +
 
 +
Make sure the {{ic|''<shared folders root directory>''}} folder exists on your system. If this folder does not exist then you have to create it as the systemd scripts depend on it:
 +
 
 +
# mkdir -p ''<shared folders root directory>''
 +
 
 +
[[Enable]] the {{ic|mnt-hgfs.automount}} mount target.
 +
 
 +
If you want to mount all shared folders automatically then omit ''<shared_folder>''.
 +
 
 +
==== Prune mlocate DB ====
 +
 
 +
When using [[mlocate]], it is useless to index the shared directories in the {{ic|locate DB}}. Therefore, add the directories to {{ic|PRUNEPATHS}} in {{ic|/etc/updatedb}}.
 +
 
 +
=== 3D Acceleration ===
 +
 
 +
If not selected at guest creation time, 3D Acceleration can be enabled in: ''Edit virtual machine settings > Hardware > Display > Accelerate 3D graphics''.
 +
 
 +
{{Note|Xorg can be very slow with 3D Acceleration enabled. It some cases, llvmpipe software rendering is much faster.}}
 +
 
 +
==== OpenGL and GLSL support ====
 +
 
 +
It is possible to update OpenGL and GLSL with new kernel modules, overriding Arch-controlled versions. 
 +
 
 +
At the time of this writing, OpenGL 3.3 and GLSL 3.30 can be supported.  See https://bbs.archlinux.org/viewtopic.php?id=202713 for more details.
 +
 
 +
=== Time synchronization ===
 +
 
 +
Configuring time synchronization in a Virtual Machine is important; fluctuations are bound to occur more easily in a guest, compared to a physical host. This is mostly due to the CPU being shared by more than one guest.
 +
 
 +
There are 2 options to set up time synchronization: the host or an external source.
 +
 
 +
==== Host machine as time source ====
 +
 
 +
To use the host as a time source, ensure {{ic|vmtoolsd.service}} is [[start]]ed. Then enable the time synchronization:
 +
 
 +
# vmware-toolbox-cmd timesync enable
 +
 
 +
To synchronize the guest after suspending the host:
 +
 
 +
# hwclock --hctosys --localtime
 +
 
 +
==== External server as time source ====
  
 
See [[NTP]].
 
See [[NTP]].
  
==Xorg configuration==
+
=== Performance Tips ===
 +
 
 +
{{Merge|VMware|Applies to all sort of VMs, particularly the last section}}
 +
 
 +
You can try the followings tips to improve the performance of your virtual machine.
 +
 
 +
==== Paravirtual SCSI adapter ====
 +
 
 +
[http://kb.vmware.com/kb/1010398 VMware Paravirtual SCSI (PVSCSI) adapters] are high-performance storage adapters for VMware ESXi that can result in greater throughput and lower CPU utilization. PVSCSI adapters are best suited for environments, where hardware or applications drive a very high amount of I/O throughput.
 +
 
 +
The SCSI adapter type {{ic|VMware Paravirtual}} is available in the Virtual Machine settings.
 +
 
 +
If you do not have these settings in your virtual machine configuration you can still use the paravirtual SCSI adapter like this:
 +
Make sure that the paravirtual SCSI adapter is included in your kernel image. For this you have to modify your {{ic|mkinitcpio.conf}}
 +
{{hc| cat /etc/mkinitcpio.conf|output=
 +
...
 +
MODULES="... vmw_pvscsi"
 +
...
 +
}}
 +
Rebuild your ramdisk:
 +
# mkinitcpio -p linux
 +
Shutdown your virtual machine and change the SCSI adapter your {{ic|.vmx}} to the following:
 +
scsi0.virtualDev = "pvscsi"
 +
 
 +
==== Paravirtual Network Adapater ====
 +
 
 +
VMware offers [http://kb.vmware.com/kb/1001805 multiple network adapters] for the guest OS.  The default adapter used is usually the {{ic|e1000}} adapter, which emulates an Intel 82545EM Gigabit Ethernet NIC.  This Intel adapter is generally compatible with the built-in drivers across most operating systems, include Arch.
 +
 
 +
For [http://rickardnobel.se/vmxnet3-vs-e1000e-and-e1000-part-1/ much more performance and additional features] (such as multiqueue support), the VMware native {{ic|vmxnet3}} network adapter can be used.
 +
 
 +
Arch has the {{ic|vmxnet3}} kernel module available with a default install.  Once enabled in [[mkinitcpio]] (or if it is auto-detected, check by running {{ic|<nowiki>lsmod | grep vmxnet3</nowiki>}} to see if it is loaded), shutdown and change the network adapter type in your ''.vmx'' file to the following:
 +
 
 +
ethernet0.virtualDev = "vmxnet3"
 +
 
 +
After changing network adapters, you will need to update your network and [[dhcpcd]] settings to use the new adapter name and mac address.
 +
 
 +
# dhcpcd ''new_interface_name''
 +
# systemctl enable dhcpcd@''new_interface_name''.service
  
{{Note|To use Xorg in a virtual machine, a minimum of 32MB VGA memory is needed, and the VMware hardware version has to be > 8, version 7 is no longer functioning correctly.}}
+
You can get the new interface name by running {{ic|ip link}}
  
Install the following dependencies:
+
==== Virtual Machine Settings ====
 +
These settings could help improve the responsiveness of your virtual machine by reducing disk I/O at the expense of using more host memory.  [http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1008885 Vmware's KB1008885] provides the following optimizations:
  
  pacman -S xf86-input-vmmouse xf86-video-vmware svga-dri
+
  mainMem.useNamedFile = "FALSE"
 +
MemTrimRate = "0"
 +
prefvmx.useRecommendedLockedMemSize = "TRUE"
 +
MemAllowAutoScaleDown = "FALSE"
 +
sched.mem.pshare.enable = "FALSE"
  
Configure the {{ic|vmwgfx}} module to [[Kernel Modules#Loading|load at boot]].
+
* '''mainMem.useNamedFile''': This will only work for Windows hosts and you can use this parameter if you experience high disk activity on shutting down the virtual machine. This will prevent VMware from creating a ''.vmem'' file. Use ''mainmem.backing = "swap"'' on Linux hosts instead.
 +
* '''MemTrimRate''': This setting prevents that memory which was released by the guest is released on the host also.
 +
* '''prefvmx.useRecommendedLockedMemSize''': Unfortunately there does not seem to exist a proper explanation for this setting. This setting seems to prevent the host system from swapping parts of the guest memory.
 +
* '''MemAllowAutoScaleDown''': Prevents that VMware adjusts the memory size of the virtual machine in case it cannot allocate enough memory.
 +
* '''sched.mem.pshare.enable''': If several virtual machines are running simultaneously VMware will try to locate identical pages and share these between the virtual machines. This can be very I/O intensive.
  
Create the following file:
+
The following settings could also be set in the configuration dialog of VMware Workstation(''Edit -> Preferences... -> Memory/Priority'').
{{hc|/etc/X11/xorg.conf.d/20-gpudriver.conf|
+
  prefvmx.minVmMemPct = "100"
  Section "Device"
+
mainMem.partialLazySave = "FALSE"
        Identifier "Card0"
+
mainMem.partialLazyRestore = "FALSE"
        Driver    "vmware"
+
* '''prefvmx.minVmMemPct''': Sets amount of RAM in percent which should be reserved by the virtual machine on the host system. If you set this to a lower value it is possible to assign the virtual machine more memory than available in the host system. Be careful though in this case as this will most likely lead to excessive hard drive usage. If you have enough RAM then leave this value at 100.
EndSection}}
+
* '''mainMem.partialLazySave''' and '''mainMem.partialLazyRestore''': These two parameters will prevent the virtual machine from creating partial snapshots for suspends. When you use these parameters and you suspend your virtual machine it will take a little bit longer, but there should be less hard disk activity from VMware trying to store this information.
  
Afterwards, a reboot is required.
+
== Troubleshooting ==
 +
=== Network slow on guest ===
 +
Arch Linux, as well as other Linux guests, may have slow network speeds while using NAT. To resolve this, switch the network type to '''Bridged mode''' in the guest settings on the host, changing the configuration file for the network on the guest where necessary. For more information on configuration, see [[Network configuration]]. If on a Windows host and it is not connecting properly despite correct guest configuration, open the '''Virtual Network Editor''' on the host as '''Administrator''' and press the '''Restore defaults''' button at the bottom left.
  
For guest screen autofit to work correctly, vmware-user-suid-wrapper must be started after X starts. To do so, create the following file:
+
=== File share problems with newer kernels ===
 +
As the {{AUR|open-vm-tools-dkms}} package is no longer being updated, newer kernels are not patched correctly using it to be compatible with a host-guest file share. The [https://github.com/davispuh/open-vm-tools-dkms  Github repository] has some patch files that can be manually applied to restore functionality.
  
{{Note|The open-vm-tools 1:9.2.0-2 package creates this file. Maybe this step can be removed from this wiki?}}
+
It is also recommended you check the AUR comment section for this package.
{{hc|/etc/xdg/autostart/vmware-user.desktop|
+
=== Sound problems ===
[Desktop Entry]
+
If unacceptably loud and annoying sounds occur, then it may be related to the [[PC speaker]]. The issue may be resolved by globally disabling the PC speaker within the guest image:
Type&#61;Application
 
Name&#61;VMWare User Agent
 
Exec&#61;/usr/bin/vmware-user-suid-wrapper
 
Icon&#61;system-run}}
 
  
Restart X and the guest will resize automatically to the host window after login.
+
  # echo "blacklist pcspkr" > /etc/modprobe.d/nobeep.conf
  
==Paravirtual SCSI-Adapter==
+
=== Mouse problems ===
  
Due to less overhead the paravirtual scsi-adapter can give a substantial performance boost in ESX.
+
The following problems may occur with mouse:
  
This can be used as follows: open the {{ic|/etc/[[mkinitcpio.conf]]}} file and add the following to the MODULES array:
+
*The automatic grab/ungrab feature will not automatically grab input when cursor enters the window
 +
*Missing buttons
 +
*Input lag
 +
*Clicks are not registered in some applications
 +
*Mouse cursor jumps when entering/leaving virtual machine
 +
*Mouse position jumps to where it left the guest VM
  
MODULES=(...vmw_pvscsi...)
+
You can try to [[Remove]] the {{Pkg|xf86-input-vmmouse}} package. {{Pkg|xf86-input-vmmouse}} and {{Pkg|xf86-input-libinput}} should be sufficient for handling mouse and keyboard inputs.
  
Afterwards, run the command:
+
You can try to add these settings to your {{ic|.vmx}} configuration file ([https://forums.mageia.org/en/viewtopic.php?f=7&t=7977 Mouse position jumps to where it left the guest VM]):
 +
{{hc|~/vmware/''<Virtual Machine name>''/''<Virtual Machine name>''.vmx|2=
 +
mouse.vusb.enable = "TRUE"
 +
mouse.vusb.useBasicMouse = "FALSE"
 +
}}
  
mkinitcpio -p linux
+
VMware also attempts to automatically optimize mouse for gaming. If experiencing problems, disabling it is recommended: ''Edit > Preferences > Input > Optimize mouse for games: Never''
  
Shutdown the virtual machine and change the scsi-adapter type to: {{ic|VMware Paravirtual}}. It's safe to ignore the warning that'll pop up.
+
Alternatively, attempting to [http://www.spinics.net/lists/xorg/msg53932.html disable] the {{ic|catchall}} event in {{ic|60-libinput.conf}} may be needed:
  
==VMCI==
+
{{hc|/usr/share/X11/xorg.conf.d/60-libinput.conf|
 +
#Section "InputClass"
 +
#        Identifier "libinput pointer catchall"
 +
#        MatchIsPointer "on"
 +
#        MatchDevicePath "/dev/input/event*"
 +
#        Driver "libinput"
 +
#EndSection
 +
}}
  
The [http://www.vmware.com/support/developer/vmci-sdk VMCI interface] is enabled by default in VMware Workstation and Fusion. In VMware ESX the interface is restricted, which means that communication is only possible between ESX and the virtual machine, not between virtual machines themselves. This can be changed in the Virtual Machine settings, traffic between ESX and the Virtual Machine can not be disabled.
+
=== Boot problems ===
  
==DRAG AND DROP==
+
==== Slow boot time ====
  
Drag and Drop from files, from VMware Workstation/Fusion into the Virtual Machines, can be disabled by editing {{ic|/etc/conf.d/open-vm-tools}}:
+
You may see the following errors if VMWare's memory hot-add feature is enabled.
  
VM_DRAG_AND_DROP="no"
+
*add_memory failed
 +
*acpi_memory_enable_device() error
  
==COPY AND PASTE==
+
Disable the memory hot-add feature by setting {{ic|1=mem.hotadd = "FALSE"}} to the {{ic|.vmx}}.
  
Install the following package (it is required for copy/paste but not listed as a dependency as reported [https://bbs.archlinux.org/viewtopic.php?id=141607 here])
+
{{hc|~/vmware/''<Virtual Machine name>''/''<Virtual Machine name>''.vmx|2=
 +
mem.hotadd = "FALSE"
 +
}}
  
pacman -S gtkmm
+
==== Shutdown/Reboot hangs ====
  
Run the following command after starting X (or add it to your {{ic|~/.xinitrc}} file) to automatically synchronize your X clipboard with the host's.  This allows you to copy text from your virtual machine and paste it in the host, and vice versa.
+
Adjust the timeout for the vmtoolsd service (defaults to 90 seconds).
  
vmware-user-suid-wrapper
+
{{hc|/etc/systemd/system/vmtoolsd.service.d/timeout.conf|2=
 +
[Service]
 +
TimeoutStopSec=1
 +
}}
  
If you get the following error (which, in rare cases, you might have to run `strace vmware-user-suid-wrapper` to see it!)
+
=== Window resolution autofit problems ===
  
vmware-user: could not open /proc/fs/vmblock/dev
+
Autofit means that when you resize the VMWare window in the host, ArchLinux should automatically follow and readjust its resolution to fit the new size of the host window.
  
you need to first insert the vmblock module into your kernel.
+
==== Potential solution 1 ====
  
sudo modprobe vmblock
+
Make sure you have enabled autofit.
  
To have the module loaded at boot, see [[Kernel Modules#Loading]].
+
For VMware Worksation you can find the setting in: ''View -> Autosize -> Autofit Guest''
  
===Rebuilding the vmblock module===
+
==== Potential solution 2 ====
  
If your kernel already has the vmblock module loaded,
+
For some reason autofit requires packages '''gtkmm''' and '''gtk2''', so you should check that you have them installed. If you don't have X windows installed or you are using a non GTK-based desktop environment such as KDE, you might have to install them manually.
  
lsmod | grep vmblock
+
==== Potential solution 3 ====
  
and vmware-user-suid-wrapper still doesn't work, then you'll have to build the open-vm-tools-modules package yourself from the [[Arch Build System]]:
+
You may need to add the modules to mkinitcpio.conf.
  
sudo abs community/open-vm-tools-modules
+
{{hc|1=/etc/mkinitcpio.conf|2=
cp -R /var/abs/community/open-vm-tools-modules/ .
+
MODULES="vsock vmw_vsock_vmci_transport vmw_balloon vmw_vmci vmwgfx"
cd ./open-vm-tools-modules/
+
}}
makepkg -s
 
pacman -U open-vm-tools-modules-*.xz
 
  
Afterwards, restart your machine for the newly rebuilt & re-installed modules to take effect!
+
Do not forget to run:
  
== Shared Folders with the Host ==
+
{{bc|# mkinitcpio -p linux}}
  
{{Note| This functionality is only available in VMware Workstation and Fusion}}
+
==== Potential solution 4 ====
  
Create a new Shared Folder by selecting {{ic|VM}} -> {{ic|Settings...}} in the VMware Workstation menu. Select the {{ic|Options}} tab and then {{ic|Shared Folder}}. Enable the {{ic|Always enabled}} option and create a new share. For Windows XP, you can create a share named {{ic|C}} with the Host Path {{ic|C:\}}.
+
[[Enable]] {{ic|vmtoolsd.service}}.
  
Add the following rule to {{ic|/etc/fstab}} (adjust the uid/gid where needed) for each shared folder:
+
=== Drag and drop, copy/paste ===
 +
{{Tip|There is an unspecified relationship between it and ''gtkmm3'' that causes it to silently fail. This is documented in {{Bug|43159}}.}}
  
.host:/shared_folder /mnt/shared vmhgfs defaults,user,ttl=5,uid=root,gid=root,fmask=0133,dmask=0022 0 0
+
The drag-and-drop (copy/paste) feature requires both {{Pkg|open-vm-tools}} and {{Pkg|gtkmm}} packages to be installed in order to work.
  
Create the mount directories and Shared Folders:
+
Make the command {{ic|vmware-user}} run after [[X11]] by either:
  
mkdir /mnt/shared
+
* Ensuring {{ic|etc/xdg/autostart/vmware-user.desktop}} exists, and if not, run:
  mount /mnt/shared
+
  # cp /etc/vmware-tools/vmware-user.desktop /etc/xdg/autostart/vmware-user.desktop
 +
OR
 +
* Add {{ic|vmware-user}} to [[Xinitrc]]
  
Temporary mounts are also possible:
+
=== Problems when running as a shared VM on Workstation 11 ===
  
  mount -t -v -o rw .host:/shared_folder /mnt/shared
+
Workstation 11 has a bug where vmware-hostd crashes if an Arch guest is running as a shared VM and vmtoolsd is running in the guest. A patch to open-vm-tools to work around the bug is [https://github.com/vmware/open-vm-tools/issues/31 here].
  
{{Note| an alternative way, tested on VMware player}}
+
=== Shared folder not mounted after system upgrade ===
  
.host:/ /mnt/shared vmhgfs defaults 0 0
+
Most likely, this should only happen to {{Pkg|open-vm-tools}}. Since the {{ic|vmhgfs}} module belongs to {{AUR|open-vm-tools-dkms}}, the legacy filesystem driver would not be upgraded by using the command {{ic|pacman -Syu}}. Therefor, {{AUR|open-vm-tools-dkms}} should be manually upgraded before the official repositories.  
mount -t vmhgfs .host:/ /mnt/shared
 
=== Prune mlocate DB ===
 
  
When using mlocate, it's useless to index the shared directories in the {{ic|locate DB}}. Therefore, add the directories to {{ic|PRUNEPATHS}} in {{ic|/etc/updatedb}}.
+
If a shared folder is not mounted after a system upgrade, then remove the shared filesystem automount, upgrade {{AUR|open-vm-tools-dkms}}, run {{ic|pacman -Syu}}, and finally execute {{ic|mkinitcpio -p linux}}. Don't forget to restore the filesystem automount.

Latest revision as of 21:21, 21 February 2018

This article is about installing Arch Linux in a VMware product, such as Player (Plus), Fusion or Workstation.

In-kernel drivers

  • vmw_balloon - The physical memory management driver. It acts like a "balloon" that can be inflated to reclaim physical pages by reserving them in the guest and invalidating them in the monitor, freeing up the underlying machine pages so they can be allocated to other guests. It can also be deflated to allow the guest to use more physical memory. Deallocated Virtual Machine memory can be reused in the host without terminating the guest.
  • vmw_pvscsi - For VMware's Paravirtual SCSI (PVSCSI) HBA.
  • vmw_vmci - The Virtual Machine Communication Interface. It enables high-speed communication between host and guest in a virtual environment via the VMCI virtual device.
  • vmwgfx - For 3D acceleration. This is a KMS enabled DRM driver for the VMware SVGA2 virtual hardware.
  • vmxnet3 - For VMware's vmxnet3 virtual ethernet NIC.
  • a fuse-based hgfs implementation has been added to open-vm-tools 10.0+ and is supported from kernel version 4.0+.

These drivers are only needed if you are running Arch Linux on a hypervisor like VMware vSphere Hypervisor. Client-server applications can write to the VMCI Sock (vsock) interface to make use of the VMCI virtual device, when communicating between virtual machines.

  • vsock - The Virtual Socket Protocol. It is similar to the TCP/IP socket protocol, allowing communication between Virtual Machines and hypervisor or host.
  • vmw_vsock_vmci_transport - Implements a VMCI transport for Virtual Sockets.
Note: Arch's Udev auto-detects and enables a few of these modules. Additional modules, such as vmw_balloon, may need to be added to your Mkinitcpio's MODULES list. For example:
 # cat /etc/mkinitcpio.conf
...
MODULES="... vmw_balloon vmw_pvscsi vsock vmw_vsock_vmci_transport ..."

Make sure to rebuild with:

 # mkinitcpio -p linux

Some modules, such as the legacy vmhgfs shared folder module, will require additional work to manually compile and systemd enable in order to function properly.

VMware Tools versus Open-VM-Tools

In 2007, VMware released large partitions of the VMware Tools under the LGPL as Open-VM-Tools. The official Tools are not available separately for Arch Linux.

Originally, VMware Tools provided the best drivers for network and storage, combined with the functionality for other features such as time synchronization. However, for quite a while now the drivers for the network/SCSI adapter are part of the Linux kernel.

The official VMware Tools used to have the advantage of being able to use the Unity mode feature, but as of VMWare Workstation 12, Unity mode for Linux guests has been removed due to lack of use and developer difficulties in maintaining the feature. See the answer in this thread.

Open-VM-Tools

Utilities

The open-vm-tools package comes namely with the following utilities:

  • vmtoolsd - Service responsible for the Virtual Machine status report.
  • vmware-checkvm - Tool to check whether a program is running in the guest.
  • vmware-toolbox-cmd - Tool to obtain Virtual Machine information of the host.
  • vmware-user - Tool to enable clipboard sharing (copy/paste) between host and guest.
  • vmware-vmblock-fuse - Filesystem utility. Enables drag & drop functionality between host and guest through FUSE (Filesystem in Userspace).
  • vmware-xferlogs - Dumps logging/debugging information to the Virtual Machine logfile.
  • vmhgfs-fuse - Utility for mounting vmhgfs shared folders.

Modules

  • vmhgfs - Legacy filesystem driver. Enables legacy sharing implementation between host and guest.
  • vmxnet - for the old VMXNET network adapter.

Installation

Install the open-vm-tools. If you want to use shared folders you also need to install the open-vm-tools-dkmsAUR package.

Open-VM-Tools reads version information from /etc/arch-release, which is empty:

# cat /proc/version > /etc/arch-release

Multi-User Target

If you're booting into the multi-user.target then follow the steps mentioned here. If you're booting into the graphical.target then please skip this section and read the instructions for the graphical.target.

Start vmtoolsd.service and enable it on boot, if desired.

Graphical Target

If you are booting into a graphical environment then follow these steps to enable the VMware tools.

Enable the vmware-vmblock-fuse.service Systemd service. NOTE: as of 2018/01/01 it appears that vmtoolsd (as described in above multi-user section) must also be enabled in order for this to work properly.

If you have installed open-vm-tools-dkmsAUR then you should enable the dkms.service Systemd service which automatically recompiles the kernel modules after a kernel update.

Try to install gtkmm3 manually if it does not work properly. To enable copy&paste between host and guest gtkmm3 is required.

Host/Guest interaction

For automatic resolution update on window resize and in order to enable copy&paste between host and guest start /usr/bin/vmware-user from within X. This may throw warnings like "vmware-user: could not open /proc/fs/vmblock/dev" and warnings about GTK which can be ignored.

Official VMware Tools

Modules

  • vmblock - Filesystem driver. Enables drag & drop functionality between host and guest (superseded by the vmware-vmblock-fuse utility).
  • vmci - High performance communication interface between host and guest.
  • vmmon - Virtual Machine Monitor.
  • vmnet - Networking driver.
  • vsock - VMCI sockets.
Note: There is no module for vmware-vmblock-fuse, and vmblock has been removed from the kernel unless you disable fuse. Instead, systemd services need to be enabled to allow these functions. See instructions below.

Installation (from guest)

Install the dependencies: base-devel (for building), net-tools (for ifconfig, used by the installer) and linux-headers (for kernel headers).

Then, create bogus init directories for the installer:

# for x in {0..6}; do mkdir -p /etc/init.d/rc${x}.d; done

The installer can then be mounted:

# mount /dev/cdrom /mnt

Extracted (e.g. to /root):

# tar xf /mnt/VMwareTools*.tar.gz -C /root

And started:

# perl /root/vmware-tools-distrib/vmware-install.pl

You can safely ignore the following build failures:

  • VMNEXT 3 virtual network card
  • "Warning: This script could not find mkinitrd or update-initramfs and cannot remake the initrd file!"
  • Fuse components not found on the system.


Enable vmware-vmblock-fuse systemd services) (make sure you install the dependencies manually or use the -s flag:

 # asp checkout open-vm-tools
 # cd open-vmtools/repos/community-x86_64/
 # makepkg -s --asdeps
 # cp vm* /usr/lib/systemd/system
 # systemctl enable vmware-vmblock-fuse
 # systemctl enable vmtoolsd

Reboot the Virtual Machine:

# systemctl reboot

Log in and start the VMware Tools:

# /etc/init.d/rc6.d/K99vmware-tools start
Tip: There is also a project in GitHub trying to automate all this.

Xorg configuration

Note: To use Xorg in a Virtual Machine, a minimum of 32MB VGA memory is needed.

Install the dependencies: xf86-input-vmmouse, xf86-video-vmware, and mesa.

If booting into a graphical target you are almost done. /etc/xdg/autostart/vmware-user.desktop will get started which will setup most of the things needed to work with the Virtual Machine.

However, if booting into multi-user.target or using an uncommon setup (e.g. multiple monitors), then vmtoolsd.service needs to be enabled. In addition to this, edit:

/etc/X11/Xwrapper.config
needs_root_rights=yes

to give permission for loading drivers.

Tips and tricks

Shared Folders with vmhgfs-fuse utility

Note: This functionality is only available with open-vm-tools v.10.x and kernel 4.x onwards and with VMware Workstation and Fusion.

Share a folder by selecting Edit virtual machine settings > Options > Shared Folders > Always enabled, and creating a new share.

You should be able to see the shared folders with:

$ vmware-hgfsclient

Now you can mount the folder:

# mkdir <shared folders root directory>
# vmhgfs-fuse -o allow_other -o auto_unmount .host:/<shared_folder> <shared folders root directory>

Other vmhgfs-fuse mount options can be viewed by using the -h input flag:

# vmhgfs-fuse -h
fstab

Add a rule for each share:

/etc/fstab
.host:/<shared_folder> /home/user1/shares fuse.vmhgfs-fuse defaults 0 0

Create and mount the Shared Folders:

# mkdir /home/user1/shares
# mount /home/user1/shares
Systemd

Create the following .service:

/etc/systemd/system/<shared folders root directory>-<shared_folder>.service
[Unit]
Description=Load VMware shared folders
Requires=vmware-vmblock-fuse.service
After=vmware-vmblock-fuse.service
ConditionPathExists=.host:/<shared_folder>
ConditionVirtualization=vmware

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=
ExecStart=/usr/bin/vmhgfs-fuse -o allow_other -o auto_unmount .host:/<shared_folder> <shared folders root directory>


[Install]
WantedBy=multi-user.target

Make sure the <shared folders root directory> folder exists on your system. If this folder does not exist then you have to create it as the systemd service depends on it:

# mkdir -p <shared folders root directory>

Enable the <shared folders root directory>-<shared_folder>.service mount target.

If you want to mount all shared folders automatically then omit <shared_folder>.

Legacy Shared Folders with vmhgfs module

Note: This functionality is only available in VMware Workstation and Fusion

Share a folder by selecting Edit virtual machine settings > Options > Shared Folders > Always enabled, and creating a new share.

Make sure the vmhgfs driver is loaded:

# modprobe vmhgfs

You should be able to see the shared folders with:

$ vmware-hgfsclient

Now you can mount the folder:

# mkdir /home/user1/shares
# mount -n -t vmhgfs .host:/<shared_folder> /home/user1/shares

Enable at boot

Edit your mkinitcpio.conf like this:

 # cat /etc/mkinitcpio.conf
...
MODULES="... vmhgfs"
...

and then update your ramdisk:

# mkinitcpio -p linux
fstab

Add a rule for each share:

/etc/fstab
.host:/<shared_folder> /home/user1/shares vmhgfs defaults 0 0

Create and mount the Shared Folders:

# mkdir /home/user1/shares
# mount /home/user1/shares
Systemd

For shared folders to be working you need to have loaded the vmhgfs driver. Simply create the following .services:

/etc/systemd/system/<shared folders root directory>-<shared_folder>.mount
[Unit]
Description=Load VMware shared folders
ConditionPathExists=.host:/<shared_folder>
ConditionVirtualization=vmware

[Mount]
What=.host:/<shared_folder>
Where=<shared folders root directory>/<shared_folder>
Type=vmhgfs
Options=defaults,noatime

[Install]
WantedBy=multi-user.target
/etc/systemd/system/<shared folders root directory>-<shared_folder>.automount
[Unit]
Description=Load VMware shared folders
ConditionPathExists=.host:/<shared_folder>
ConditionVirtualization=vmware

[Automount]
Where=<shared folders root directory>/<shared_folder>

[Install]
WantedBy=multi-user.target

Make sure the <shared folders root directory> folder exists on your system. If this folder does not exist then you have to create it as the systemd scripts depend on it:

# mkdir -p <shared folders root directory>

Enable the mnt-hgfs.automount mount target.

If you want to mount all shared folders automatically then omit <shared_folder>.

Prune mlocate DB

When using mlocate, it is useless to index the shared directories in the locate DB. Therefore, add the directories to PRUNEPATHS in /etc/updatedb.

3D Acceleration

If not selected at guest creation time, 3D Acceleration can be enabled in: Edit virtual machine settings > Hardware > Display > Accelerate 3D graphics.

Note: Xorg can be very slow with 3D Acceleration enabled. It some cases, llvmpipe software rendering is much faster.

OpenGL and GLSL support

It is possible to update OpenGL and GLSL with new kernel modules, overriding Arch-controlled versions.

At the time of this writing, OpenGL 3.3 and GLSL 3.30 can be supported. See https://bbs.archlinux.org/viewtopic.php?id=202713 for more details.

Time synchronization

Configuring time synchronization in a Virtual Machine is important; fluctuations are bound to occur more easily in a guest, compared to a physical host. This is mostly due to the CPU being shared by more than one guest.

There are 2 options to set up time synchronization: the host or an external source.

Host machine as time source

To use the host as a time source, ensure vmtoolsd.service is started. Then enable the time synchronization:

# vmware-toolbox-cmd timesync enable

To synchronize the guest after suspending the host:

# hwclock --hctosys --localtime

External server as time source

See NTP.

Performance Tips

Merge-arrows-2.pngThis article or section is a candidate for merging with VMware.Merge-arrows-2.png

Notes: Applies to all sort of VMs, particularly the last section (Discuss in Talk:VMware/Installing Arch as a guest#)

You can try the followings tips to improve the performance of your virtual machine.

Paravirtual SCSI adapter

VMware Paravirtual SCSI (PVSCSI) adapters are high-performance storage adapters for VMware ESXi that can result in greater throughput and lower CPU utilization. PVSCSI adapters are best suited for environments, where hardware or applications drive a very high amount of I/O throughput.

The SCSI adapter type VMware Paravirtual is available in the Virtual Machine settings.

If you do not have these settings in your virtual machine configuration you can still use the paravirtual SCSI adapter like this: Make sure that the paravirtual SCSI adapter is included in your kernel image. For this you have to modify your mkinitcpio.conf

 cat /etc/mkinitcpio.conf
...
MODULES="... vmw_pvscsi"
...

Rebuild your ramdisk:

# mkinitcpio -p linux

Shutdown your virtual machine and change the SCSI adapter your .vmx to the following:

scsi0.virtualDev = "pvscsi"

Paravirtual Network Adapater

VMware offers multiple network adapters for the guest OS. The default adapter used is usually the e1000 adapter, which emulates an Intel 82545EM Gigabit Ethernet NIC. This Intel adapter is generally compatible with the built-in drivers across most operating systems, include Arch.

For much more performance and additional features (such as multiqueue support), the VMware native vmxnet3 network adapter can be used.

Arch has the vmxnet3 kernel module available with a default install. Once enabled in mkinitcpio (or if it is auto-detected, check by running lsmod | grep vmxnet3 to see if it is loaded), shutdown and change the network adapter type in your .vmx file to the following:

ethernet0.virtualDev = "vmxnet3"

After changing network adapters, you will need to update your network and dhcpcd settings to use the new adapter name and mac address.

# dhcpcd new_interface_name
# systemctl enable dhcpcd@new_interface_name.service

You can get the new interface name by running ip link

Virtual Machine Settings

These settings could help improve the responsiveness of your virtual machine by reducing disk I/O at the expense of using more host memory. Vmware's KB1008885 provides the following optimizations:

mainMem.useNamedFile = "FALSE"
MemTrimRate = "0"
prefvmx.useRecommendedLockedMemSize = "TRUE"
MemAllowAutoScaleDown = "FALSE"
sched.mem.pshare.enable = "FALSE"
  • mainMem.useNamedFile: This will only work for Windows hosts and you can use this parameter if you experience high disk activity on shutting down the virtual machine. This will prevent VMware from creating a .vmem file. Use mainmem.backing = "swap" on Linux hosts instead.
  • MemTrimRate: This setting prevents that memory which was released by the guest is released on the host also.
  • prefvmx.useRecommendedLockedMemSize: Unfortunately there does not seem to exist a proper explanation for this setting. This setting seems to prevent the host system from swapping parts of the guest memory.
  • MemAllowAutoScaleDown: Prevents that VMware adjusts the memory size of the virtual machine in case it cannot allocate enough memory.
  • sched.mem.pshare.enable: If several virtual machines are running simultaneously VMware will try to locate identical pages and share these between the virtual machines. This can be very I/O intensive.

The following settings could also be set in the configuration dialog of VMware Workstation(Edit -> Preferences... -> Memory/Priority).

prefvmx.minVmMemPct = "100"
mainMem.partialLazySave = "FALSE"
mainMem.partialLazyRestore = "FALSE"
  • prefvmx.minVmMemPct: Sets amount of RAM in percent which should be reserved by the virtual machine on the host system. If you set this to a lower value it is possible to assign the virtual machine more memory than available in the host system. Be careful though in this case as this will most likely lead to excessive hard drive usage. If you have enough RAM then leave this value at 100.
  • mainMem.partialLazySave and mainMem.partialLazyRestore: These two parameters will prevent the virtual machine from creating partial snapshots for suspends. When you use these parameters and you suspend your virtual machine it will take a little bit longer, but there should be less hard disk activity from VMware trying to store this information.

Troubleshooting

Network slow on guest

Arch Linux, as well as other Linux guests, may have slow network speeds while using NAT. To resolve this, switch the network type to Bridged mode in the guest settings on the host, changing the configuration file for the network on the guest where necessary. For more information on configuration, see Network configuration. If on a Windows host and it is not connecting properly despite correct guest configuration, open the Virtual Network Editor on the host as Administrator and press the Restore defaults button at the bottom left.

File share problems with newer kernels

As the open-vm-tools-dkmsAUR package is no longer being updated, newer kernels are not patched correctly using it to be compatible with a host-guest file share. The Github repository has some patch files that can be manually applied to restore functionality.

It is also recommended you check the AUR comment section for this package.

Sound problems

If unacceptably loud and annoying sounds occur, then it may be related to the PC speaker. The issue may be resolved by globally disabling the PC speaker within the guest image:

 # echo "blacklist pcspkr" > /etc/modprobe.d/nobeep.conf

Mouse problems

The following problems may occur with mouse:

  • The automatic grab/ungrab feature will not automatically grab input when cursor enters the window
  • Missing buttons
  • Input lag
  • Clicks are not registered in some applications
  • Mouse cursor jumps when entering/leaving virtual machine
  • Mouse position jumps to where it left the guest VM

You can try to Remove the xf86-input-vmmouse package. xf86-input-vmmouse and xf86-input-libinput should be sufficient for handling mouse and keyboard inputs.

You can try to add these settings to your .vmx configuration file (Mouse position jumps to where it left the guest VM):

~/vmware/<Virtual Machine name>/<Virtual Machine name>.vmx
mouse.vusb.enable = "TRUE"
mouse.vusb.useBasicMouse = "FALSE"

VMware also attempts to automatically optimize mouse for gaming. If experiencing problems, disabling it is recommended: Edit > Preferences > Input > Optimize mouse for games: Never

Alternatively, attempting to disable the catchall event in 60-libinput.conf may be needed:

/usr/share/X11/xorg.conf.d/60-libinput.conf
#Section "InputClass"
#        Identifier "libinput pointer catchall"
#        MatchIsPointer "on"
#        MatchDevicePath "/dev/input/event*"
#        Driver "libinput"
#EndSection

Boot problems

Slow boot time

You may see the following errors if VMWare's memory hot-add feature is enabled.

  • add_memory failed
  • acpi_memory_enable_device() error

Disable the memory hot-add feature by setting mem.hotadd = "FALSE" to the .vmx.

~/vmware/<Virtual Machine name>/<Virtual Machine name>.vmx
mem.hotadd = "FALSE"

Shutdown/Reboot hangs

Adjust the timeout for the vmtoolsd service (defaults to 90 seconds).

/etc/systemd/system/vmtoolsd.service.d/timeout.conf
[Service]
TimeoutStopSec=1

Window resolution autofit problems

Autofit means that when you resize the VMWare window in the host, ArchLinux should automatically follow and readjust its resolution to fit the new size of the host window.

Potential solution 1

Make sure you have enabled autofit.

For VMware Worksation you can find the setting in: View -> Autosize -> Autofit Guest

Potential solution 2

For some reason autofit requires packages gtkmm and gtk2, so you should check that you have them installed. If you don't have X windows installed or you are using a non GTK-based desktop environment such as KDE, you might have to install them manually.

Potential solution 3

You may need to add the modules to mkinitcpio.conf.

/etc/mkinitcpio.conf
MODULES="vsock vmw_vsock_vmci_transport vmw_balloon vmw_vmci vmwgfx"

Do not forget to run:

# mkinitcpio -p linux

Potential solution 4

Enable vmtoolsd.service.

Drag and drop, copy/paste

Tip: There is an unspecified relationship between it and gtkmm3 that causes it to silently fail. This is documented in FS#43159.

The drag-and-drop (copy/paste) feature requires both open-vm-tools and gtkmm packages to be installed in order to work.

Make the command vmware-user run after X11 by either:

  • Ensuring etc/xdg/autostart/vmware-user.desktop exists, and if not, run:
# cp /etc/vmware-tools/vmware-user.desktop /etc/xdg/autostart/vmware-user.desktop

OR

Problems when running as a shared VM on Workstation 11

Workstation 11 has a bug where vmware-hostd crashes if an Arch guest is running as a shared VM and vmtoolsd is running in the guest. A patch to open-vm-tools to work around the bug is here.

Shared folder not mounted after system upgrade

Most likely, this should only happen to open-vm-tools. Since the vmhgfs module belongs to open-vm-tools-dkmsAUR, the legacy filesystem driver would not be upgraded by using the command pacman -Syu. Therefor, open-vm-tools-dkmsAUR should be manually upgraded before the official repositories.

If a shared folder is not mounted after a system upgrade, then remove the shared filesystem automount, upgrade open-vm-tools-dkmsAUR, run pacman -Syu, and finally execute mkinitcpio -p linux. Don't forget to restore the filesystem automount.