vmwaretools
Version information
This version is compatible with:
- Puppet Enterprise 3.x
- Puppet >=2.7.20 <4.0.0
- , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'razorsedge-vmwaretools', '4.9.0'
Learn more about managing modules with a PuppetfileDocumentation
Puppet VMware Tools OSP Module
master branch: develop branch:
Introduction
This module manages the installation of the Operating System Specific Packages for VMware Tools. This allows you to use your operating system's native tools to install and update the VMware Tools.
Actions:
- Removes old VMwareTools package or runs vmware-uninstall-tools.pl if found.
- Installs a VMware YUM repository (defaults to the 'latest' package repository).
- Installs the OSP VMware Tools.
- Starts the vmware-tools service.
OS Support:
- RedHat family - tested on CentOS 5.5+, CentOS 6.2+, RHEL 5.9, RHEL 6.4, and OEL 5.5+
- SuSE family - tested on SLES 11.1
- Ubuntu - tested on Ubuntu 12.04 Precise
Class documentation is available via puppetdoc.
Examples
Top Scope variable (i.e. via Dashboard):
$vmwaretools_tools_version = '4.1'
$vmwaretools_autoupgrade = true
include 'vmwaretools'
Parameterized Class:
class { 'vmwaretools':
tools_version => '4.0u3',
autoupgrade => true,
}
Mirror packages.vmware.com to a local host and point the vmwaretools class at it.
class { 'vmwaretools':
yum_server => 'http://yumserver.example.lan',
yum_path => '/yumdir/v2.3.0',
just_prepend_yum_path => true,
}
Turn off configuration of the software repository so that some other tool (ie RHN Satellite) or class can take care of it.
class { 'vmwaretools':
manage_repository => false,
}
Notes
- Only tested on CentOS 5.5+ and CentOS 6.2+ x86_64 with 4.0latest.
- Not supported on Fedora or Debian as these distros are not supported by the OSP.
- Not supported on RHEL/CentOS/OEL 7+ or SLES 12 as VMware is recommending open-vm-tools instead.
- Supports yumrepo proxy, proxy_username, proxy_password, yum priorities, yum repo protection, and using a local mirror for the yum_server and yum_path.
- Supports not managing the yumrepo configuration via
manage_repository => false
. - No other VM tools (ie Open Virtual Machine Tools) will be supported.
Issues
- Does not install Desktop (X Window) components.
TODO
- Support installation of Desktop (X Window) packages.
- Add logic to handle RHEL5 i386 PAE kernel on OSP 5.0+.
Contributing
Please see DEVELOP.md for contribution information.
License
Please see LICENSE file.
Copyright
Copyright (C) 2012 Mike Arnold mike@razorsedge.org
2015-04-06 Michael Arnold github@razorsedge.org - 4.9.0
Michael Arnold github@razorsedge.org (14):
- Update metadata.json.
- Update rspec-puppet ~> 2.0 and metadata-json-lint >= 0.0.4 with modulesync.
- 'subject' method no longer exists in rspec-puppet.
- Fix puppetlint rake task with modulesync.
- Stick with rspec 2 for unit tests.
- Update metadata summary and tags to be compliant with the Forge.
- Get code ready for Puppet 4 via modulesync.
- Fix lint: class included by relative name.
- Add proper SuSE support with zypprepo and not yumrepo.
- Add Ubuntu support.
- Fix zypprepo gpgkey parameter.
- Add rspec test for Ubuntu to main class.
- Update supported OS in metadata.json.
- Update versions for 4.9.0 release.
2015-01-02 Michael Arnold github@razorsedge.org - 4.8.1
Michael Arnold github@razorsedge.org (9):
- Update to newer Gemfile, Rakefile, and spec_helper.
- Fix spacing errors.
- Fix license and unbounded ranges in metadata.json.
- Add .sync.yml to override puppet-lint tests.
- Manage common files with modulesync.
- Override puppet-lint tests in .puppet-lint.rc.
- Manage .puppet-lint.rc with modulesync.
- Fix regular expressions for GH #26.
- Update versions for 4.8.1 release.
2014-12-07 Michael Arnold github@razorsedge.org - 4.8.0
Michael Arnold github@razorsedge.org (5):
- Added tags to metadata.json.
- Fix issues_url in metadata.json.
- Drop support of OSs not supported by VMware.
- Update README.md with OS support limits.
- Update versions for 4.8.0 release.
2014-09-22 Michael Arnold github@razorsedge.org - 4.7.0
Michael Arnold github@razorsedge.org (15):
-
Add a directory filter for Geppetto.
-
Deal with the people who wipe /etc/yum.repos.d .
-
Simplify rspec failure tests.
-
Fix rspec tests to pass.
-
Convert fixtures repositories to use https.
-
Expand Puppet versions tested in Travis-CI.
-
Update Modulefile source to use https.
-
Update Geppetto .project to version 4.
-
Allow tracking of metadata.json.
-
Expand Puppet versions tested in Travis-CI.
-
Switch to depending on wolfspyre/vmware_puppetfact.
-
Also update the Modulefile for the dependency.
-
Switch to using metadata.json vs Modulefile.
-
Update rspec to work with regex fix.
-
Update versions for 4.7.0 release.
salderma salderman1@udayton.edu (8):
-
adding param for supported platform. changing fail to notify
-
adding if supported wrapper around actions in vmware case logic
-
fixup for puppet-lint
-
syntax error on notify
-
another syntax error.
-
replacing notify with notice
-
adding param supported to class parameters from params.pp
-
adjusting declaration of $supported, removing from class params
John Gallo jgallo@cpg.org (1):
-
Change regex from +(one or more) to *(zero or more) because it fails on ESX 5.0
2013-08-18 Michael Arnold github@razorsedge.org - 4.6.0
Michael Arnold github@razorsedge.org (2):
-
Add LICENSE reference to README.md.
-
Update versions for 4.6.0 release.
Wolf Noble wnoble@datapipe.com (1):
-
Merge in vmware_puppetfact module
2013-07-22 Michael Arnold github@razorsedge.org - 4.5.0
Michael Arnold github@razorsedge.org (16):
- Update tests/init.pp to local standards.
- Update .travis.yml to support updated Puppet versions.
- Update Modulefile to use correct license name.
- Moved package repo config into vmwaretools::repo.
- Clean up vmwaretools_ntp_spec.rb.
- Removed last references to open-vm-tools.
- Refactor vmwaretools_spec.rb.
- Renamed vmwaretools_spec.rb.
- Cleaned out unused code from Rspec tests.
- Move $ensure to top of class to make lint happy.
- Fix typos in README.md.
- Expand Puppet versions tested in Travis-CI.
- Rake validate to also check ERB for syntax errors.
- Remove git-log-to-changelog from Modulefile.
- Install $majdistrelease pattern in params.pp.
- Update versions for 4.5.0 release.
2013-05-25 Michael Arnold github@razorsedge.org - 4.4.1
Michael Arnold github@razorsedge.org (2):
- Add CHANGELOG generation during module build.
- Update versions for 4.4.1 release.
2013-05-25 Michael Arnold github@razorsedge.org - 4.4.0
Michael Arnold github@razorsedge.org (6):
- Use puppetlabs-stdlib 2.6.0 for testing.
- Added manage_repository parameter.
- Update README.md about manage_repository parameter.
- Updated README.md.
- Fix Markdown code blocks in README.md.
- Update versions for 4.4.0 release.
2013-02-05 Michael Arnold github@razorsedge.org - 4.3.0
Michael Arnold github@razorsedge.org (5):
- Add parameters to customize vmware-tools yumrepo.
- Update README for yumrepo parameters.
- Update rake and Travis testing environment.
- Increase puppetlabs/stdlib dependency to 2.3.0.
- Update versions for 4.3.0 release.
2013-01-12 Michael Arnold github@razorsedge.org - 4.2.0
Michael Arnold github@razorsedge.org (4):
- Update Travis config file.
- Allow tools to report version to vCenter.
- Update README.md
- Update versions for 4.2.0 release.
2012-10-27 Michael Arnold github@razorsedge.org - 4.1.2
Michael Arnold github@razorsedge.org (3):
- Converted to puppetlabs_spec_helper.
- Support upstart in VMware Tools 5.1 on EL6
- Forge 4.1.2 release.
2012-10-21 Michael Arnold github@razorsedge.org - 4.1.1
Michael Arnold github@razorsedge.org (3):
- OSP 5.0+ rhel does not have i686 directory.
- Converted to puppetlabs_spec_helper.
- Forge 4.1.1 release.
2012-08-05 Michael Arnold github@razorsedge.org - 4.1.0
Geoff Davis gadavis@ucsd.edu (15):
-
Update module for ESX tools 5.0
-
Restore compatibility with 3.x series
-
Make ntp class compatible with parameterized base class
-
Update copyright info with UC
-
Fix handling of multiple gpgkeys for the yum repo
-
fix regression on 5x packagename
-
Fix variable check in ntp class
-
remove variable check completely from ntp class
-
re-add variable check, fully qual the variable
-
put the condition in the right block
-
qualify variable in vmwaretools::ntp
-
Fix tests for existing cases on main class
-
Change ntp test to check for vmwaretools base class
-
readability enhancements to init.pp
-
Add specific tests for 3.x, 4.0x, 4.1x, and 5.0u1 to RedHat
Michael Arnold github@razorsedge.org (10):
-
Touch-ups for OSP 5.0 support
-
Update rspec integration.
-
Add support for Top Scope variables.
-
Move $majdistrelease into case statement.
-
Update Geppetto and Travis-CI configs.
-
Add additional package to vmwaretools::ntp rspec.
-
Update Modulefile documentation.
-
Fixed error in vmwaretools::ntp and added tests.
-
More documentation updates.
-
Forge 4.1.0 release.
2012-07-18 Michael Arnold github@razorsedge.org - 4.0.2
Michael Arnold github@razorsedge.org (1):
- Fix the yumrepo gpgkey URL due to upstream move.
2012-05-26 Michael Arnold github@razorsedge.org - 4.0.1
Michael Arnold github@razorsedge.org (1):
- Change github account to razorsedge
2012-04-21 Michael Arnold github@razorsedge.org - 4.0.0
Michael Arnold github@razorsedge.org (25):
- Parameterized Class
- First attempt at rspec tests.
- First attempt at rspec tests.
- Added support for Travis-CI.
- Fix errors discovered by puppet-lint.
- Added Travis-CI graphic to README.
- Remove puppet-module from Rakefile.
- Update Travis-CI config file.
- Massive update to unit tests.
- Small refactor of ::params.
- Removed unneeded path value from Execs.
- Reverse the descriptions in Rakefile.
- Fixed class syntax in README.md.
- Fix Travis-CI configs to use the master branch.
- ISSUE: Rpm install fails
- Consolidate yumrepo.
- Reformat and update puppet documentation.
- TODO: Confirm that vmtoolsd works the same
- TODO: split vmware-tools.syncTime out to a module
- Forgot to fully qualify $::virtual.
- Update the Travis-CI config file.
- Drop support for Fedora
- More mods to Rakefile.
- Forge 4.0.0 release.
- Fixed missing doco entry.
2012-03-29 Michael Arnold github@razorsedge.org - 3.0.1
Michael Arnold github@razorsedge.org (4):
- Style Guide - Quotes
- 4.1 tools service name is vmtoolsd
- Accidentally removed Fedora support.
- Forge 3.0.1 release.
2012-03-18 Michael Arnold github@razorsedge.org - 3.0.0
Michael Arnold github@razorsedge.org (3):
- Added a little more documentation.
- Slight formatting fixes.
- Refactored and renamed for Forge 3.0.0 release.
2012-03-10 Michael Arnold github@razorsedge.org - 2.0.0
Michael Arnold github@razorsedge.org (2):
-
Refactored for 2.0.0 release.
-
Removed $lsbmajdistrelease.
Mike Arnold mike@razorsedge.org (1):
-
Added TODO file.
2011-09-04 Mike Arnold mike@razorsedge.org - 1.0.0
Dependencies
- puppetlabs/stdlib (>=2.3.0 <5.0.0)
- darin/zypprepo (1.x)
- puppetlabs/apt (1.x)
- wolfspyre/vmware_puppetfact (>=0.2.1)
Copyright (C) 2011 Mike Arnold <mike@razorsedge.org> Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.