Installing Native VMware ESX/ESXi/vSphere Tools on Symantec Encryption Management Server

Article:TECH176852  |  Created: 2011-12-13  |  Updated: 2014-03-26  |  Article URL http://www.symantec.com/docs/TECH176852
Article Type
Technical Solution

Product(s)


Subject

Issue



This article provides the basic steps for installation of the Native ESX VMware Tools on Symantec Encryption Management Server (previously PGP Universal Server). Please refer to the VMware documentation for any special use-cases.

  • Symantec Encryption Management Server supports the Native VMware tools package that is installed from the VMware ESXi or VMware vSphere server.
  • PGP Universal Server version 3.0 and later the Native ESX VMware Tools are supported.
  • On versions of PGP Universal Server prior to version 3.0, a package of pre-bundled PGP VMware tools was included to install the VMware tools for PGP Universal Server.
     

Pre-requisites:

Make sure that the Guest Operating System version of Linux (chosen for compatability reasons) on the VMware server to install Symantec Encryption Management Server (or PGP Universal Server) is CentOS 4/5 or RHEL 5 (depending on which is available).  Change it if necessary.  Changing this option will require a power down of the Symantec Encryption Management Server Guest VM.

Note: Guest Operating System set to Other 32-bit Linux is no longer supported

Any PGP-Bundled VMware tools should be uninstalled before attempting to install the Native VMware tools.  Please consult with Symantec Support for assistance uninstalling the PGP-Bundled VMware tools.

Running the following installation requires command-line access to the Symantec Encryption Management Server (SEMS).  For information on how to access SEMS via SSH, read article www.symantec.com/docs/TECH171773

If you need just to reinstall VMware Tools after a PUP update of the server, see this article.


Environment



VMware Hypervisor ESXi

VMware vSphere 5+

VMware ESX

Note: VMware ESX 3.5 is no longer supported by VMware on Symantec Encryption Management Server 3.3.1. For a list of supported VMware platforms per release of Symantec Encryption Management Server or PGP Universal Server, see TECH149547 


Solution



Installing VMware Native Tools:

1. Choose to install the VMware tools from within the VMware vSphere client user interface (right-click on the virutal machine and then select Guest > Install/Upgrade VMware tools). This will make the VMware tools installer CD available to the virtual machine as a CD-ROM that contains the necessary installation files.

2. Connect to SEMS via SSH connection and run the following command to create a saved session. Running this script through SSH connection will cause network services to stop and may exit the installer prematurely.

# screen

(If the SSH session terminates, reopen the SSH session and type # screen -r, this will allow you to connect to the same session and continue the installation process)

3. Create a folder to mount the CD-ROM contents:

# mkdir /mnt/cdrom

4. Mount the CD-ROM to the new directory you created "/mnt/cdrom".

# mount /dev/cdrom /mnt/cdrom

5. List or display the contents of the Virtual CD-ROM (ISO) for VMware Tools:

# ls /mnt/cdrom

For this example "VMwareTools-8.4.6-385536.tar.gz" is displayed it may be newer than that based on the release of VMware you are using.

6. Create a directory to copy the contents of the VMware tools:

# mkdir /temp-vmware-tools

7. Navigate to the new directory:

# cd /temp-vmware-tools

8. Extract the contents of the Virtual CD-ROM "VMware tools"

tar zxpf /mnt/cdrom/VMwareTools-*.tar.gz

9. This will extract all the contents of the CD-ROM needed to install VMware tools into a directory named vmware-tools-distrib. Navigate to this new directory and run the script.

# cd /temp-vmware-tools/vmware-tools-distrib

10. List or display the contents of the folder and find the installer script

# ls -al

11. Run the installer script which is a file called "vmware-install.pl" and accept all the default answers to prompts:

# ./vmware-install.pl -d

Once the installation is complete reboot the server

# pgpsysconf --reboot

13. Watch the machine reboot from console connection and view the VMware tools startup for errors

14. Confirm the VMware toolsd is running, use the following commands:

# ps aux |grep vm

or

#ps aux |grep vmtoolsd

This should display the running process for VMware Tools "vmtoolsd"

15. Ensure VmWare Tools are loaded into run level 3.

# chkconfig --list |grep vmware

After running the command it should display :Vmware-tools 0:off 2:0n 3:on 4:off 6:off

16. Remove the installation files:

# rm -fr /temp-vmware-tools

 

Uninstalling Vmware Native Tools:

1. To Unistall VMware tools, run the following command:

# ./usr/bin/vmware-uninstall-tools.pl

This will stop the VMware Tools services and remove the VMware Tools. A message similar to this should appear "The removal of VMware Tools 8.4.6 build-385536 for Linux completed successfully.."

2. Reboot the Symantec Encryption Management Server with the following command

# pgpsysconf --reboot





Article URL http://www.symantec.com/docs/TECH176852


Terms of use for this information are found in Legal Notices