VMware Documentation Downloader v11.08.30

Please login or register to download

Information

Title: 

VMware Documentation Downloader v11.08.30

Author(s): 

Xtravirt

Target Audience: 

Technical - All

First Published: 

17 July 2009

Products: 

VMware Product Documentation

UID: 

XD10109

VMware Documentation Downloader (GetVMwareDocs) is a small DOS batch script that creates and maintains a local copy of all VMware’s product documentation, making it an ideal utility for consultants or administrators that require offline access to these resources, such as when at a customer site without immediate internet access.

A free tool for those on the move who need information FAST - Updated Aug 2011

Updates

August 2011 - v11.08.30 released to include vSphere 5

Note: This version deletes the .html files so that they can be re-created to ensure new layouts are captured. Also, due to the new format of the VMware website you may receive an ActiveX control prompt. If you do not enable this, then some of the tabs will not work.

Overview

GetVMwareDocs is a small DOS batch script that creates and maintains a local copy of all VMware’s product documentation, making it an ideal utility for consultants or administrators that require offline access to these resources, such as when at a customer site without immediate internet access.

The script downloads all the HTML pages and PDF documents referenced on the VMware Documentation pages at http://www.vmware.com/support/pubs/index.html, including those for previous product versions.

In order to control its “reach” and avoid unnecessary downloads, the script follows explicit links from this page. As a result, when the index page changes (typically each time VMware release a new product or a product update), it may require modification to include the new links, so check the Xtravirt website periodically as we will endeavour to maintain an up to date version.

On first use, the total volume of data downloaded will approach 677MB (as at 13 August 2010). It therefore makes sense that if you have already performed a download (even if it is incomplete or out of date) and wish to provide a colleague with the same utility, that you also provide them with your previously downloaded files. Subsequent script executions will refresh this repository, only downloading any “missing” or updated documents.

Once the repository has been built, access to it is via a local copy of the VMware documentation index page, meaning that the offline navigation process is identical to the online one. The script will automatically load the index page into a browser session, whether or not a check for updates is elected to be performed first.

Requirements

• Microsoft Windows
• GetVMwareDocs.bat script (download latest version above)
• wget.exe utility (wiki available here and download utility at http://users.ugent.be/~bpuype/wget)
• Minimum of 800MB free disk space (this requirement will increase over time as VMware publish new documentation)
• Internet access (direct, or via an HTTP proxy)
• .txt files have been associated with a document viewer
• .html files have been associated with a web browser

Installation

• Create a folder to contain the script and the downloaded files (eg. C:\VMwarePDFs).
• Download GetVMwareDocs.bat and wget.exe and save them to this folder.

Alternatively, copy an existing “installation” from another machine.

Operation

• In Explorer, navigate to and execute GetVMwareDocs.bat.
  (Note, it is important that the script is executed from the directory it resides in. Additionally, it cannot be executed from a UNC path.)
• If a log file from a previous execution does not exist, a check for updates will be initiated.
• If a log file from a previous execution does exist, you are asked if you wish to check for updates or not.
• If you do not check for updates, the documentation index page is loaded into your default web browser.
• If you check for updates, you are asked for HTTP proxy details.
• Specify your HTTP proxy details in the described format or press Enter if not applicable.
• The update process will start and will take a few minutes to complete, varying according to the capabilities of your Internet connection - activity is reported in the window title bar. The first task performed is to delete any .html files from within the directories to ensure the most current versions are made available.
  (Note, if the download process is interrupted, the links in the local web pages will not be updated to reference each other properly. If this occurs, simply run the script again, check for updates, and allow the process to compete.)
• The filenames of any updates downloaded are displayed and you are asked to review the log file or not.
  (Note, only PDF updates are listed.)
• If you review the log file, it is loaded into your default .txt file viewer.
• Whether you review the log file or not, the documentation index page is loaded into your default web browser.

Notes

• Navigate the local documentation repository using the links in the right hand side column of the main index page, as opposed to those in the main body of it. The links on the right all explicitly reference an HTML page, which is not always the case for the others. When a specific page is not referenced, the link will point to the online instance of the target and not the local one.

Version History

• Date: 13 Jul 2009
• Version: 9.07.13
• Detail: Initial release
• Date: 14 Apr 2010
• Version: 10.04.10
• Detail: Second release

• Date: 13 Aug 2010
• Version: 10.08.13
• Detail: Third release

• Date: 30 Aug 2011
• Version: 11.08.30
• Detail: Fourth release

References

Links: 

1. VMware Documentation, http://www.vmware.com/support/pubs/index.html
2. About wget, http://en.wikipedia.org/wiki/Wget
3. Download Win32 port of wget, http://users.ugent.be/~bpuype/wget