VMware Tools Installation Guide For Operating System Specific Packages

Transcription

1 VMware Tools Installation Guide For Operating System Specific Packages ESXi 5.0 or later VMware Tools This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see EN

2 VMware Tools Installation Guide For Operating System Specific Packages You can find the most up-to-date technical documentation on the VMware Web site at: The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: Copyright 2015 VMware, Inc. All rights reserved.. VMware, Inc Hillview Ave. Palo Alto, CA VMware, Inc.

3 Contents VMware, Inc. 3

4 VMware Tools Installation Guide For Operating System Specific Packages 4 VMware, Inc.

5 About This Book Intended Audience VMware Technical Publications Glossary Document Feedback VMware, Inc. 5

6 VMware Tools Installation Guide For Operating System Specific Packages Technical Support and Education Resources Online and Telephone Support Support Offerings VMware Professional Services 6 VMware, Inc.

7 Introduction to Operating System 1 Specific Packages for VMware Tools Benefits of Installing VMware Tools OSPs Separate Updates Standards-compliant VMware, Inc. 7

8 VMware Tools Installation Guide For Operating System Specific Packages Version Manageability Supported Guest Operating Systems for VMware Tools OSPs Weak Versioning for VMware Tools OSPs PLDP/DUP Weak Versioning 8 VMware, Inc.

9 Chapter 1 Introduction to Operating System Specific Packages for VMware Tools Requires: Provides: Requires: Enforcing ABI Compatibility When Kernels Are Updated /lib/modules/ el5/extra/vmware/vmci.ko /lib/modules/ el5/weak-updates/vmware-tools-vmci/vmci.ko -> /lib/modules/ el5/extra/vmware/vmci.ko Weak Versioning and Distribution Supplied Kernel Module Packages vmxnet3vmw_pvscsivmware_balloon VMware, Inc. 9

10 VMware Tools Installation Guide For Operating System Specific Packages Changing the Behavior of Distribution Supplied Kernel Module Packages /etc/depmod.d vmw_pvscsi/etc/depmod.d/vmw_pvscsi.conf Option RHEL systems SUSE systems Description /etc/depmod.d/vmw_pvscsi.conf override vmw_pvscsi * extra/vmware-tools-pvscsi /etc/depmod.d/vmw_pvscsi.conf override vmw_pvscsi * kernel/drivers/scsi Weak Versioning for RHEL 4, RHEL 3, and SLES 9 /lib/modules/kernel_version/extra/ modprobe /lib/modules/running_kernel/extra/ depmod -a mkinitrd modprobe 10 VMware, Inc.

11 Preparing for VMware Tools OSP Installation 2 Uninstall Existing VMware Tools # vmware-uninstall-tools.pl VMware, Inc. 11

12 VMware Tools Installation Guide For Operating System Specific Packages Ubuntu 8.10 OSP Installation Exception Uninstall Existing Ubuntu open-vm-tools Packages for Ubuntu and earlier releases open-vm-tools open-vm-tools $ sudo dpkg-query -s open-vm-tools open-vm-tools open-vm-tools $ sudo apt-get remove open-vm-tools open-vm-tools $ sudo dpkg-query -s open-vm-tools open-vm-tools Determining the Configuration Method for Installing VMware Tools OSPs Package manager Manual configuration 12 VMware, Inc.

13 Chapter 2 Preparing for VMware Tools OSP Installation Table 2 1. Supported Package Managers Package Manager Guest Operating Systems Installing the VMware Tools OSPs with a Package Manager vmware-tools-esx-kmods-kernel_type vmware-tools-esxvmware-tools-esx-nox Table 2 2. VMware Tools Packages Description Packages vmware-tools-esx-kmods-kernel_type vmware-tools-esx vmware-tools-esx-kmods-kernel_type vmware-tools-esx-nox VMware, Inc. 13

14 VMware Tools Installation Guide For Operating System Specific Packages VMware Tools Operating System Specific Installation Packages VMware Tools Kernel Module Packages /lib/modules vmware-tools-module-kmp-kernel_type kmod-vmware-tools-module-kernel_type Table 2 3. VMware Tools Kernel Module Packages Package vmware-tools-vmblock vmware-tools-vmblock-common vmware-tools-vmci vmware-tools-vmci-common vmware-tools-vmmemctl vmware-tools-vmblock-kmpkernel_type vmware-tools-vmci-kmpkernel_type vmware-tools-vmmemctlcommon vmware-tools-vmmemctl-kmpkernel_type Description vmware-tools-module-kmp-kernel_typevmware-toolsmodule-modules-kernel_type vmware-tools-esx-kmodskernel_type vmware-tools-esxvmware-toolsesx-nox vmblock vmblock vmblock vmblock vmci vmci vmmemctl vmmemctlvmmemctl-kmp vmmemctl 14 VMware, Inc.

15 Chapter 2 Preparing for VMware Tools OSP Installation Table 2 3. VMware Tools Kernel Module Packages (Continued) Package vmware-tools-vmxnet vmware-tools-vmxnet-common vmware-tools-vmxnet3 vmware-tools-vmxnet3-common vmware-tools-pvscsi vmware-tools-pvscsi-common vmware-tools-vmsync-common vmware-tools-vsock vmware-tools-vsock-common vmware-tools-vmxnet-kmpkernel_type vmware-tools-vmxnet3-kmpkernel_type vmware-tools-pvscsi-kmpkernel_type vmware-tools-vmsync-kmpkernel_type vmware-tools-vsock-kmpkernel_type Description vmhgfs vmxnet vmxnet vmxnet3 vmxnet3 vmxnet3 pvscsi pvscsi pvscsi vmsync vmsync vmsock vsock Table 2 4. VMware Tools Guest SDK Package Package vmware-tools-guestsdk Description VMware, Inc. 15

16 VMware Tools Installation Guide For Operating System Specific Packages VMware Tools Plug-in Packages vmtoolsd Table 2 5. VMware Tools Services Plug-ins Package vmware-tools-plugins-vix vmware-tools-pluginsautoupgrade vmware-tools-pluginsdeploypkg vmware-tools-pluginsguestinfo vmware-tools-pluginshgfsserver vmware-tools-pluginspowerops vmware-tools-pluginstimesync vmware-tools-pluginsvmbackup vmware-tools-services Description autoupgrade vmtoolsd vmtoolsd vmtoolsd vmtoolsd vmtoolsd timesync vmtoolsd GuestOperationsManager vmtoolsd vmbackup vmtoolsd vmtoolsd 16 VMware, Inc.

17 Chapter 2 Preparing for VMware Tools OSP Installation Table 2 6. VMware Tools User Plug-ins Package vmware-tools-plugins-dndcp vmware-tools-pluginsgrabbitmqproxy vmware-tools-pluginsresolutionset vmware-tools-user vmware-tools-vgauth Description vmtoolsd vmtoolsd VMware Tools Packages Without Graphics Components Table 2 7. VMware Tools Packages Without Graphics Components Package vmware-tools-core vmware-tools-foundation vmware-tools-guestlib vmware-tools-help vmware-tools-libraries-nox vmware-tools-esx-nox Description VMware, Inc. 17

18 VMware Tools Installation Guide For Operating System Specific Packages VMware Tools Packages With Graphics Components Table 2 8. VMware Tools Packages With Graphics Components Package vmware-tools-esx vmware-tools-libraries-x Description Table 2 9. VMware Tools Xorg Packages Package vmware-tools-xorg-drvdisplay vmware-tools-xorg-drvmouse Description 18 VMware, Inc.

19 Installing VMware Tools OSPs 3 Distribution Supplied Display and Mouse Packages VMware, Inc. 19

20 VMware Tools Installation Guide For Operating System Specific Packages Distribution Supplied Kernel Module Packages Operating System Package vmxnet3 vmw_pvscsi vmware_balloon Corresponding VMware Tools Package vmware-tools-vmxnet3 vmware-tools-pvscsi vmware-tools-vmmemctl vmware_balloon zypperapt Installing VMware Tools Using OSPs for RHEL 6.x, RHEL 5.x, CentOS 6.x, and CentOS 5.x Guest Operating Systems Register RHEL 6 and RHEL 5 with the Red Hat Network Prepare to Install OSPs for RHEL 6.x, RHEL 5.x, CentOS 6.x, and CentOS 5.x Guest Operating Systems /5.0latest/ Prerequisites 20 VMware, Inc.

21 Chapter 3 Installing VMware Tools OSPs # rpm --import /key_path/key_name /etc/yum.conf proxy= proxy_username=proxyuser proxy_password=proxypass.repo /etc/yum.repos.d/vmware-tools.repo [vmware-tools] name=vmware Tools baseurl= enabled=1 gpgcheck= u1 rhel5rhel u1 vmware-tools-repo-rhel x86_64 vmware-tools-repo-rhel i686 VMware, Inc. 21

22 VMware Tools Installation Guide For Operating System Specific Packages Install VMware Tools for RHEL 6.x, RHEL 5.x, CentOS 6.x, and CentOS 5.x Guest Operating Systems Prerequisites `uname -r` `uname -r` el5-pae el5 PAE PAEpae yum # yum install vmware-tools-esx-kmods vmware-tools-esx vmware-tools-vmxnet3 vmware-tools-pvscsi vmware-tools-vmmemctl What to do next 22 VMware, Inc.

23 Chapter 3 Installing VMware Tools OSPs Installing VMware Tools Using OSPs for RHEL 4, CentOS 4, and RHEL 3 Guest Operating Systems Download OSPs for the RHEL 4, CentOS 4, and RHEL 3 Guest Operating Systems /latest/ /latest/ Prerequisites VMWARE- PACKAGING-GPG-DSA-KEY.pub # rpm --import /key_path/key_name u1 rhel4 Option x86_64/ Description i386/ /vmware-tools-path/ VMware, Inc. 23

24 VMware Tools Installation Guide For Operating System Specific Packages Install VMware Tools for RHEL 4, CentOS 4, and RHEL 3 Guest Operating Systems Prerequisites Option 32-bit 64-bit Description # cp /usr/x11r6/lib/modules/drivers/vmware_drv.o /usr/x11r6/lib/modules/drivers/vmware_drv.o.backup # cp /usr/x11r6/lib64/modules/drivers/vmware_drv.o /usr/x11r6/lib64/modules/drivers/vmware_drv.o.backup # rpm -ivh --force vmware-tools-*.rpm What to do next 24 VMware, Inc.

25 Chapter 3 Installing VMware Tools OSPs Installing VMware Tools Using OSPs for SLES 11 and later service packs, SLED 11 and later service packs Guest Operating Systems Prepare to Install OSPs for SLES 11 and later service packs, SLED 11 and later service packs Guest Operating Systems /latest/ /latest/ Prerequisites # rpm --import /key_path/key_name # export http_proxy= VMware, Inc. 25

26 VMware Tools Installation Guide For Operating System Specific Packages # zypper addservice --type=yum vmware-tools-collection u1 sles11.2sles11.1sles11.0 i586x86_64 # zypper packages vmware-tools-collection u1 vmware-tools-repo-sles x86_64 vmware-tools-repo-sles i586 Install VMware Tools for SLES 11 and later service packages, SLED 11 and later service packages Guest Operating Systems Prerequisites `uname -r` defaultpaevmi # zypper install vmware-tools-collection vmware-tools-esx-kmods-kernel_type vmware-tools-esx defaultvmware-tools-esx-kmods-default 26 VMware, Inc.

27 Chapter 3 Installing VMware Tools OSPs vmware-tools-vmxnet3 vmware-tools-pvscsi The following packages are not supported by their vendor: package names What to do next Installing VMware Tools Using OSPs for SLES 10 and SLED 10 Guest Operating Systems Prepare to Install OSPs for the SLES 10 and SLED 10 Guest Operating System /latest/ /latest/ Prerequisites # rpm --import /key_path/key_name VMware, Inc. 27

28 VMware Tools Installation Guide For Operating System Specific Packages # rug set-prefs proxy-url # rug service-add --type=yum vmware-tools-collection u1 # rug packages vmware-tools-collection # rug subscribe -a Install VMware Tools for the SLES 10 and SLED 10 Guest Operating System Prerequisites `uname -r` defaultsmpbigsmpvmivmipae # rug install -c vmware-tools-collection vmware-tools-esx-kmods-kernel_type vmware-tools-esx defaultvmware-tools-esx-kmods-default What to do next 28 VMware, Inc.

29 Chapter 3 Installing VMware Tools OSPs Installing VMware Tools Using OSPs for SLES 9 Guest Operating System Download OSPs for the SLES 9 Guest Operating System /latest/ /latest/ Prerequisites VMWARE- PACKAGING-GPG-DSA-KEY.pub # rpm --import /key_path/key_name u1 Option x86_64/ Description i586/ /vmware-tools-path/ VMware, Inc. 29

30 VMware Tools Installation Guide For Operating System Specific Packages Install VMware Tools for the SLES 9 Guest Operating System Prerequisites Option 32-bit 64-bit Description # cp /usr/x11r6/lib/modules/drivers/vmware_drv.o /usr/x11r6/lib/modules/drivers/vmware_drv.o.backup # rpm -ivh --force vmware-tools-*.rpm Warning vmware-tools el4.i686.rpm: V3 RSA/MD5 signature: NOKEY, key ID 66fd4949. What to do next Installing VMware Tools Using OSPs for Ubuntu Guest Operating System Prepare to Install OSPs for the Ubuntu Guest Operating System /latest/ /latest/ 30 VMware, Inc.

31 Chapter 3 Installing VMware Tools OSPs Prerequisites $ sudo apt-key add /key_path/key_name /etc/apt/apt-get conf ACQUIRE { " } ACQUIRE { " }.list /etc/apt/sources.list.d/vmware-tools.list deb dist main u1 precise oneiricnattymavericklucid karmicjauntyintrepid hardy $ sudo apt-get update VMware, Inc. 31

32 VMware Tools Installation Guide For Operating System Specific Packages u1 vmware-tools-repoubuntu10.10_8.6.0_amd64.deb vmware-tools-repo-ubuntu10.10_8.6.0_i386.deb Install VMware Tools for Ubuntu Guest Operating Systems open-vm-tools open-vm-tools Prerequisites apt-get $ `uname -r` generic server virtual generic-pae $ sudo apt-get install vmware-tools-esx-kmods-kernel_release `uname -r` 32 VMware, Inc.

33 Chapter 3 Installing VMware Tools OSPs $ sudo apt-get install vmware-tools-esx $ sudo apt-get install vmware-tools-esx-nox $ sudo apt-get install vmware-tools-pvscsi-modules-`uname -r` Verify VMware Tools Installation vmtoolsd $ pgrep -fl vmtoolsd $ /sbin/lsmod vmmemctlvmxnetvmxnet3pvscsi vmxnet3pvscsivmmemctl Status of VMware Tools in vsphere Client VMware, Inc. 33

35 Installing Customized Kernel Module 4 Packages Prerequisites gcckernel-source/headers/develrpm-buildredhad-rpmconfig rpmdeb Building Customized Kernel Module Packages for Red Hat Enterprise Linux and SUSE Linux Enterprise Distributions Build the Binary Kernel Module Packages for RHEL 6, RHEL 5, CentOS 6, and CentOS 5 vmsyncvmhgfs VMware, Inc. 35

36 VMware Tools Installation Guide For Operating System Specific Packages vmware-tools-module-version.src.rpm u1 rhel6rhel5 yum-utils # yum install yum-utils yum-utilsyum-builddep yum-builddep # yum-builddep vmware-tools-module-version.src.rpm rpmbuildvsockvmhgfs vmci # rpmbuild --rebuild vmware-tools-module-version.src.rpm What to do next Build the Binary Kernel Module Packages for RHEL 4, RHEL 3, and CentOS 4 vmware-tools-module-version.src.rpm u1 rhel4rhel3 gccrpm-build 36 VMware, Inc.

37 Chapter 4 Installing Customized Kernel Module Packages # rpmbuild --rebuild vmware-tools-module-version.src.rpm What to do next Build the Binary Kernel Module Packages for SLES 10, SLES 11 and later packages, SLED 10, SLED 11 and later packages vmware-tools-module-version.src.rpm u1 gcckernel-sourcekernel-syms rpmbuildvsockvmhgfs vmci # rpmbuild --rebuild vmware-tools-module-version.src.rpm What to do next Build the Binary Kernel Module Packages for SLES 9 vmware-tools-module-version.src.rpm VMware, Inc. 37

38 VMware Tools Installation Guide For Operating System Specific Packages u1 gcckernel-sourcekernel-syms # rpmbuild --rebuild /vmware-tools-module-version.src.rpm What to do next Install Custom Built Binary Module Packages Prerequisites vmware-tools-module-commonvmware-tools-foundation module vmblockvmware-tools-module-commonvmware-tools-foundationvmwaretools-corevmware-tools-libraries-noxvmware-tools-guestlib # rpm -ivh /path/kmod-vmware-tools-module-version.arch.rpm vsockvmhgfs # rpm -ivh --nodeps /path/kmod-vmware-tools-module-version.arch.rpm # rpm -ivh /path/vmware-tools-module-version.arch.rpm Option RHEL 6 RHEL 3 through 5, and CentOS 4 and 5 SLES and SLED Option x86_64 i386 i586 Description $HOME/rpmbuild/RPMS/arch /usr/src/redhat/rpms/arch /usr/src/packages/rpms/arch Description 38 VMware, Inc.

39 Chapter 4 Installing Customized Kernel Module Packages Build Customized Kernel Module Packages for Ubuntu module-assistantmodule-assistant Prerequisites apt-get $ sudo apt-get update $ sudo apt-get install vmware-tools-foundation vmblock $ sudo apt-get install vmware-tools-core vmware-tools-libraries-nox vmware-tools-guestlib Deb-Helper $ sudo apt-get install debhelper $ sudo apt-get install vmware-tools-module-modules-source vmware-tools-module-common $ sudo module-assistant prepare $ sudo module-assistant build vmware-tools-module-modules-source $ sudo module-assistant install vmware-tools-module-modules-source Configure Ubuntu 8.10 Systems to Use the Correct Repository apt-get /etc/apt/sources.list /etc/apt/sources.listus.archive.ubuntu.com old-releases.ubuntu.com VMware, Inc. 39

41 Maintaining VMware Tools OSPs 5 Across Linux OS Upgrades VMware, Inc. 41

43 Uninstalling VMware Tools OSPs 6 Uninstall VMware Tools OSPs With a Package Manager remove Option SLES 11 and later service packages, SLED 11 and later service packages SLES 10 Action # zypper remove 'vmware-tools-*' # rug remove 'vmware-tools-*' Ubuntu $ sudo apt-get remove --purge 'vmware-tools-*' vmware-tools-xorg-drvdisplayvmware-tools-xorg-drv-mousevmware-tools-foundation VMware, Inc. 43

44 VMware Tools Installation Guide For Operating System Specific Packages $ sudo apt-get install xserver-xorg-video-all $ sudo apt-get install xserver-xorg-input-all Manually Uninstall VMware Tools # rpm -e vmware-tools-esx # rpm -e vmware-tools-esx-nox # for file in `rpm -qa grep vmware-tools-esx-kmods`; do rpm -e $file done # rpm -e vmware-tools-thinprint # rpm -e vmware-tools-hgfs # for file in `rpm -qa grep vmware-tools-plugins`; do rpm -e $file done # rpm -e vmware-tools-user # rpm -e vmware-tools-services 44 VMware, Inc.

45 Chapter 6 Uninstalling VMware Tools OSPs # for file in `rpm -qa grep vmware-tools grep kmod grep -v vmci`; do rpm -e $file done # for file in `rpm -qa grep vmware-tools grep kmod grep vmci`; do rpm -e $file done # for file in `rpm -qa grep vmware-tools grep kmp grep -v vmci`; do rpm -e $file done # for file in `rpm -qa grep vmware-tools grep kmp grep vmci`; do done rpm -e $file # for file in `rpm -qa grep vmware-tools grep common`; do done rpm -e $file # rpm -e vmware-tools-help # rpm -e vmware-tools-guestsdk # rpm -e vmware-tools-core # rpm -e vmware-tools-libraries-x # rpm -e vmware-tools-libraries-nox # rpm -e vmware-tools-guestlib # rpm -e --nodeps vmware-tools-xorg-drv-mouse # rpm -e --nodeps vmware-tools-xorg-drv-display # rpm -e vmware-tools-foundation vmware-tools-xorg-drv-displayvmware-tools-xorg-drv-mousevmwaretools-foundation yum install xorg-x11-drv-vmware xorg-x11-drv-vmmouse VMware, Inc. 45

47 Index A ABI compatibility, enforcing with updated kernel 9 apt 12 B binary module packages, installing 38 C CentOS 4 building customized packages 36 downloading 23 installing 23 rmp installation 24 CentOS 5 building customized packages 35 installing 20 CentOS 6, installing 20 customized kernel module packages, installing 35 customized packages building 35 installing 38 installing on Ubuntu 39 D display packages, distribution supplied 19 distribution supplied packages changing the default behavior 10 precedence in weak versioning 9 distribution supplied packages, list of supplied packages 20 G graphics components packages with X Window support 18 packages without X Windows 17 I Installation, VMware Tools 19 K kernel, identifying kernel type 22 kernel module packages building customized packages 35 installing in customized kernels 35 M mouse packages, distribution supplied 19 O open-vm-tools package, removing for Ubuntu 12 operating system specific packages 7 operating system upgrades, maintaining OSPs 41 OSP 7 OSPs, installation packages 14 P package managers 12 PLDP/DUP weak versioning 8 plug-in packages 16 prerequisites 11 R repository file 20 RHEL 3 building customized packages 36 downloading 23 installing 23 rpm installation 24 RHEL 4 building customized packages 36 downloading 23 installing 23 rpm installation 24 RHEL 5 building customized packages 35 installing 20 register with Red Hat Network 20 RHEL 6 building customized packages 35 installing 20 register with Red Hat Network 20 rug, installing SLES 10 and SLED S selecting OSPs to download 13 SLED 10 building customized packages 37 downloading 27 installing 27 VMware, Inc. 47

48 VMware Tools Installation Guide For Operating System Specific Packages SLED 11 building customized packages 37 downloading packages 25 installing 25 SLED 11 SP1, downloading packages 25 SLED 11 SP2, downloading packages 25 SLES 10 building customized packages 37 downloading 27 installing 27 SLES 11 building customized packages 37 downloading packages 25 installing 25 SLES 9 building customized packages 37 downloading 29 installing 29 rpm installation 30 SLES 11 SP1 building customized packages 37 downloading packages 25 installing 25 SLES 11 SP2 building customized packages 37 downloading packages 25 installing 25 supported, guest operating system 8 distribution supplied packages 9 OSPs 8 RHEL 3 and 4 10 SLES 9 10 X X Window components packages with X Window support 18 packages without X Window 17 Y yum, install command 22 Z zypper installing SLED packages 26 installing SLES packages 26 U Ubuntu 8.10 OSP installation exception 12 downloading 30 installing 30, 32 installing customized kernel module packages 39 using the correct 8.10 repository 39 uname, identifying kernel type 22 uninstalling rpm-based distributions 44 VMware Tools OSPs 43 unmanaged VMware Tools 33 updating kernel, enforcing ABI compatibility 9 upgrading, maintaining OSPs across OS upgrades 41 V verifying, VMware Tools installation 33 VMware Tools, uninstall 11 VMware packaging public key 20 VMware Tools weak versioning 8 W weak versioning changing the defaults for distribution supplied packages VMware, Inc.