-
Notifications
You must be signed in to change notification settings - Fork 1
Preparing the host machine
The host machine requires the appropriate software and configuration to support the building of images. These steps prepare the host machine for building of virtual machine images.
VirtualBox is used to build (and run) virtual machine images.
Download the appropriate installer from https://www.virtualbox.org/wiki/Downloads and install.
Windows 7 note: Use VirtualBox test build r96191 (4.3.17) [https://www.virtualbox.org/download/testcase/VirtualBox-4.3.17-96191-Win.exe] -- several earlier builds fail to start virtual machines on this version of windows
Windows 7 note: 4.3.20 now available for Windows. Intend to test on Windows 7 (11/21/2014).
| Windows 7: adding directory to the PATH environment variable |
|---|
To allow VirtualBox's commands to be executed from the Windows Command Prompt, add VirtualBox's directory (for example, C:\Program Files\Oracle\VirtualBox) to the PATH environment variable for ether the System or the User. |
Packer is used to manage the building of virtual machine images.
Note: Brew will not install the latest version of Packer. Use the instructions below to install the latest version of Packer.
-
Download the appropriate package from http://www.packer.io/downloads.html.
-
Extract the Packer package to the /usr/local/packer directory.
-
Update the file ~/.bash_profile to include the line
export PATH=$PATH:/usr/local/packer. -
To force the current shell session to use the new PATH, source the .bash_profile file by executing the command
. ~/.bash_profile
- Download the appropriate package from http://www.packer.io/downloads.html.
- Extract the Packer package to the %UserProfile%\Programs\Packer directory.
- Edit the Path environment variable (Control Panel > User Accounts > Change my environment variables) for the current user to include the above directory, adding a semicolon to separate it from any existing folder.
Additional installation instructions are available at http://www.packer.io/intro/getting-started/setup.html.
Puppet (with Facter) are used to manage the software and configuration of an image.
Download both Puppet and Facter from http://puppetlabs.com/misc/download-options and install.
Download a single MSI installer containing both Puppet and Facter and install. Use default options when installing.
Vagrant is used to manage individual VirtualBox machine images.
Download Vagrant from https://www.vagrantup.com/downloads.html and install. (Windows 7: Use the default options when installing.)
Vagrant Host Manager is used to update the hosts file on the host and guest systems so that hostnames can refer to virtual machines.
To install, execute the command:
vagrant plugin install vagrant-hostmanagerNote: See https://github.com/smdahlen/vagrant-hostmanager#passwordless-sudo for instructions on how to allow hostmanager to make changes without asking for the password.
For additional information see https://github.com/smdahlen/vagrant-hostmanager.
Note: Configuration for using Vagrant Cachier has been removed due to an issue on Windows host systems.
The Vagrant Cachier plugin can be used to manage a common package cache. See https://github.com/fgrehm/vagrant-cachier for more information.
vagrant plugin install vagrant-cachierTo allow command line programs to display text using ANSI colors, install ANSICON. See https://github.com/adoxa/ansicon
To SSH to a machine from Windows using PuTTY, install vagrant-multi-putty. See https://github.com/nickryand/vagrant-multi-putty
Installation notes:
- Ensure that PATH includes the directory containing PuTTY's executable.
- Step 5 of instructions--save the converted .ppk private key file to the ~/.vagrant.d folder using the name provided.
After completing installation:
vagrant putty