vagrant-parallels 0.2.2.rc1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7dc8645c874f88dad88e5cef3d9303ed1a5a1198
-  data.tar.gz: 8849d44c11e2497a6e9dd94e24575935cc737ce3
+  metadata.gz: 178317a43fb02ed49d4eb27f1a025e8f62d5c4d0
+  data.tar.gz: c70b4668ae2e493fa210329edb3dff36a2e77bbc
 SHA512:
-  metadata.gz: e26dc00d7c793352c15a5273d6a24d0e3c0d5b612a1d6ca6ae07fceeb9ba313558b38e510c0075e59eb6c766fa0159ea89e23673c07ae4068418b81d0557edeb
-  data.tar.gz: 6bc694be3862ba1985b775ab7ab3c349f031efdbeb226455794618b61340055843b415b76a360acb60bc68932a2e7bbf14ec96ee948111bbc15bcd78528b1dc4
+  metadata.gz: df41060d1e8712890643f19f2444eef2df81d12224655169a3637128fc629786de900c37fbeac16773d668a18d03b986266bbd2531b0c462aae57495e0966ba2
+  data.tar.gz: cc37ea2f852f56da279a4697b656187842d94e924bf00b897dbe63083f51ccb267d8587eb3e5c473eda5c661cbd4fb43d898845da3064c893e5e3a0ebcccca0a

data/README.md

@@ -1,26 +1,41 @@
 # Vagrant Parallels Provider
+[![Gem Version](https://badge.fury.io/rb/vagrant-parallels.png)](http://badge.fury.io/rb/vagrant-parallels)
 [![Build Status](https://travis-ci.org/Parallels/vagrant-parallels.png?branch=master)](https://travis-ci.org/Parallels/vagrant-parallels)
 [![Code Climate](https://codeclimate.com/github/Parallels/vagrant-parallels.png)](https://codeclimate.com/github/Parallels/vagrant-parallels)
 
-This is a [Vagrant](http://www.vagrantup.com) 1.3+ plugin that adds a [Parallels Desktop](http://www.parallels.com/products/desktop/)
-provider to Vagrant, allowing Vagrant to control and provision machines using Parallels Desktop instead of the default Virtualbox.
+This is a plugin for [Vagrant](http://www.vagrantup.com),
+allowing to power virtual machines by
+[Parallels Desktop for Mac](http://www.parallels.com/downloads/desktop/).
 
-## Note
+### Requirements
+- Parallels Desktop for Mac 8 or 9
+- Vagrant v1.4 or higher
 
-This project is still in active development and not all vagrant features have been developed, so please report any issues you might find.
-Almost all features are available except for exporting/packaging VM's.  This will be available soon.
+If you're just getting started with Vagrant, it is highly recommended that you
+read the official [Vagrant documentation](http://docs.vagrantup.com/v2/) first.
 
-We look forward to hearing from you with any issues or features.  Thank you!
+## Features
+Parallels provider supports all basic Vagrant features, except one: **"Forwarded ports" configuration is not available yet**.
+
+It might be implemented in the future, after the next release of Parallels Desktop for Mac.
 
 ## Installation
-The latest version of this provider is supporting **only Vagrant 1.4 or higher**.
-If you are still using Vagrant 1.3.*, please, specify the plugin version '0.0.9':
+First of all make sure that you have [Parallels Desktop for Mac](http://www.parallels.com/products/desktop/)
+and [Vagrant](http://www.vagrantup.com/downloads) properly installed.
+We recommend that you use the latest versions of these products.
+
+Since Parallels provider is a Vagrant plugin, installing is easy:
 
-- For Vagrant 1.4 or higher execute `vagrant plugin install vagrant-parallels`.
-- For Vagrant 1.3.x execute `vagrant plugin install vagrant-parallels --plugin-version 0.0.9`.
+```
+$ vagrant plugin install vagrant-parallels
+```
 
 ## Usage
-After installing, then do a `vagrant up` and specify the `parallels` provider. An example is shown below.
+Parallels provider is used just like any other provider. Please read the general
+[basic usage](http://docs.vagrantup.com/v2/providers/basic_usage.html) page for
+providers.
+
+The value to use for the `--provider` flag is `parallels`:
 
 ```
 $ vagrant init
@@ -28,43 +43,52 @@ $ vagrant up --provider=parallels
 ...
 ```
 
-You need to have a parallels compatible box specified in your `Vagrantfile` before doing a `vagrant up`, please refer to the coming section for instructions.
+You need to have a parallels compatible box specified in your `Vagrantfile`
+before doing a `vagrant up`, please refer to the *Boxes* section for instructions.
 
 ### Default Provider
 
-When using parallels as your vagrant provider after almost every command you will need to append `--provider=parallels`. To simplify this you can set your default vagrant provider as **parallels**
-
-If you're using BASH
+You can use `VAGRANT_DEFAULT_PROVIDER` environmental variable to specify the
+default provider. Just set it to `parallels` and then it wont be necessary
+to add `--provider` flag to vagrant commands.
 
 ```
-# Append to bash
-echo "export VAGRANT_DEFAULT_PROVIDER=parallels" | tee -a ~/.bashrc
-source ~/.bashrc
+export VAGRANT_DEFAULT_PROVIDER=parallels
 ```
 
-If you're using ZSH
+You can also add this command to your `~/.bashrc` file
+(or `~/.zshrc` if your shell is Zsh) to make this setting permanent.
 
-```
-# Append to zsh
-echo "export VAGRANT_DEFAULT_PROVIDER=parallels" | tee -a ~/.zshrc
-source ~/.zshrc
-```
+## Boxes
+
+Every provider in Vagrant must introduce a custom box format.
+
+As with every provider, Parallels provider has a custom box format.
+There is a list of popular base boxes for Parallels provider:
+
+- Ubuntu 12.04 x86_64:
+[http://download.parallels.com/desktop/vagrant/precise64.box]
+(http://download.parallels.com/desktop/vagrant/precise64.box)
 
-## Box Format
+- Ubuntu 13.10 x86_64:
+[http://download.parallels.com/desktop/vagrant/saucy64.box]
+(http://download.parallels.com/desktop/vagrant/saucy64.box)
 
-Every provider in Vagrant must introduce a custom box format. This
-provider introduces `parallels` boxes. You can download one using this [link](http://download.parallels.com/desktop/vagrant/precise64.box).
+- CentOS 6.5 x86_64:-
+[http://download.parallels.com/desktop/vagrant/CentOS-6.5-x86_64.box]
+(http://download.parallels.com/desktop/vagrant/CentOS-6.5-x86_64.box)
 
-Download the box file, then use vagrant to add the downloaded box using this command. Remember to use `bundle exec` before `vagrant` command if you are in development mode
+- CentOS 5.9 x86_64:-
+[http://download.parallels.com/desktop/vagrant/CentOS-5.9-x86_64.box]
+(http://download.parallels.com/desktop/vagrant/CentOS-5.9-x86_64.box)
+
+
+You can add one of these boxes using the next command:
 
 ```
 $ vagrant box add --provider=parallels precise64 http://download.parallels.com/desktop/vagrant/precise64.box
 ```
 
-The box format is basically just the required `metadata.json` file
-along with a `Vagrantfile` that does default settings for the
-provider-specific configuration for this provider.
-
 ## Networking
 By default Vagrant Parallels provider uses the basic Vagrant networking
 approach. Initially VM has one adapter assigned to the 'Shared' network
@@ -114,14 +138,14 @@ end
 
 ## Development
 
-To work on the `vagrant-parallels` plugin, clone this repository out
+To work on the `vagrant-parallels` plugin development, clone this repository:
 
 ```
 $ git clone https://github.com/Parallels/vagrant-parallels
 $ cd vagrant-parallels
 ```
 
-Use [Bundler](http://gembundler.com) to get the dependencies:
+Use [Bundler](http://gembundler.com) to get the dependencies (Ruby 2.0 is needed):
 
 ```
 $ bundle
@@ -135,14 +159,14 @@ $ bundle exec rake
 
 If those pass, you're ready to start developing the plugin. You can test
 the plugin without installing it into your Vagrant environment by just
-creating a `Vagrantfile` in the top level of this directory (it is gitignored)
+creating a `Vagrantfile` in the top level of this directory (it is added to *.gitignore*)
 and add the following line to your `Vagrantfile`
 
 ```ruby
 Vagrant.require_plugin "vagrant-parallels"
 ```
 
-You need to have a compatible box file installed, refer to box file section
+You need to have a compatible box file installed, refer to the *Boxes* section
 
 Use bundler to execute Vagrant:
 
@@ -150,29 +174,48 @@ Use bundler to execute Vagrant:
 $ bundle exec vagrant up --provider=parallels
 ```
 
-After testing you can also build a gem-package by yourself and then install it as a plugin:
-(if you have 'vagrant-parallels' plugin already installed, delete it first)
+###Installing Parallels Provider From Source
+
+If you want to globally install your locally built plugin from source, use the following method:
 
 ```
-$ git clone https://github.com/Parallels/vagrant-parallels
 $ cd vagrant-parallels
-$ rake build
+$ bundle install
 ...
-$ vagrant plugin install ./pkg/vagrant-parallels-<version>.gem
+$ bundle exec rake build
+...
+$ vagrant plugin install pkg/vagrant-parallels-<version>.gem
 ...
 ```
-So, now that you have your own plugin installed, check it with the command `vagrant plugin list`
+So, now that you have your own plugin installed, check it with the command
+`vagrant plugin list`
+
+## Contributing
+
+1. Fork it.
+2. Create a branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am "Added a sweet feature"`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a pull request from your `my-new-feature` branch into master
+
+## Getting help
+Having problems while using our provider? Ask your question to our mailing list:
+[Google Group](https://groups.google.com/group/vagrant-parallels)
+
+If you've got a strange error while using Parallels provider, or found a bug
+there  - please, report it on [Issue Tracker](https://github.com/Parallels/vagrant-parallels).
 
-## Contributors
+## Credits
+Great thanks to *Youssef Shahin* `@yshahin` for having initiated the development
+of this provider. You've done a great job, Youssef!
 
-A great thanks to the people who helping this project stand on its feet, thank you
+Also, thanks to the people who helping this project stand on its feet, thank you
 
-* Youssef Shahin `@yshahin` - plugin's author
 * Mikhail Zholobov `@legal90`
 * Kevin Kaland `@wizonesolutions`
 * Konstantin Nazarov `@racktear`
 * Dmytro Vasylenko `@odi-um`
 * Thomas Koschate `@koschate`
 
-and to all the people who are using and testing this provider
+and to all the people who are using and testing this provider.
 

data/Rakefile

@@ -4,9 +4,6 @@ require 'rubygems'
 require 'bundler/setup'
 require 'rspec/core/rake_task'
 
-#Load i18-tasks
-load 'tasks/i18n-tasks.rake'
-
 # Immediately sync all stdout so that tools like buildbot can
 # immediately load in the output.
 $stdout.sync = true

data/lib/vagrant-parallels/action/network.rb

@@ -153,9 +153,9 @@ module VagrantPlugins
 
             # Search for a matching bridged interface
             bridgedifs.each do |interface|
-              if [interface[:name].downcase, interface[:bound_to]].include? config[:bridge].downcase
+              if interface[:name].downcase == config[:bridge].downcase
                 @logger.debug("Specific bridge found as configured in the Vagrantfile. Using it.")
-                chosen_bridge = interface
+                chosen_bridge = interface[:name]
                 break
               end
             end
@@ -174,7 +174,7 @@ module VagrantPlugins
           if !chosen_bridge
             if bridgedifs.length == 1
               # One bridgable interface? Just use it.
-              chosen_bridge = bridgedifs[0]
+              chosen_bridge = bridgedifs[0][:name]
               @logger.debug("Only one bridged interface available. Using it by default.")
             else
               # More than one bridgable interface requires a user decision, so
@@ -196,18 +196,17 @@ module VagrantPlugins
                 choice = choice.to_i
               end
 
-              chosen_bridge = bridgedifs[choice - 1]
+              chosen_bridge = bridgedifs[choice - 1][:name]
             end
           end
 
-          @logger.info("Bridging adapter #{config[:adapter]} to #{chosen_bridge[:name]} (#{chosen_bridge[:bound_to]})")
+          @logger.info("Bridging adapter #{config[:adapter]} to #{chosen_bridge}")
 
           # Given the choice we can now define the adapter we're using
           return {
             :adapter     => config[:adapter],
             :type        => :bridged,
-            :bridge      => chosen_bridge[:name],
-            :bound_to    => chosen_bridge[:bound_to],
+            :bridge      => chosen_bridge,
             :mac_address => config[:mac],
             :nic_type    => config[:nic_type]
           }
@@ -321,7 +320,6 @@ module VagrantPlugins
           return {
             :adapter  => config[:adapter],
             :hostonly => interface[:name],
-            :bound_to => interface[:bound_to],
             :mac      => config[:mac],
             :nic_type => config[:nic_type],
             :type     => :hostonly
@@ -392,7 +390,7 @@ module VagrantPlugins
         end
 
         # This determines the next free network name
-        def next_network_name
+        def next_network_id
           # Get the list of numbers
           net_nums = []
           @env[:machine].provider.driver.read_virtual_networks.each do |net|
@@ -416,7 +414,7 @@ module VagrantPlugins
         # This creates a host only network for the given configuration.
         def hostonly_create_network(config)
           options = {
-              :name       => next_network_name,
+              :network_id => next_network_id,
               :adapter_ip => config[:adapter_ip],
               :netmask    => config[:netmask],
           }

data/lib/vagrant-parallels/driver/pd_8.rb

@@ -41,7 +41,7 @@ module VagrantPlugins
 
         def create_host_only_network(options)
           # Create the interface
-          execute(:prlsrvctl, "net", "add", options[:name], "--type", "host-only")
+          execute(:prlsrvctl, "net", "add", options[:network_id], "--type", "host-only")
 
           # Configure it
           args = ["--ip", "#{options[:adapter_ip]}/#{options[:netmask]}"]
@@ -51,16 +51,15 @@ module VagrantPlugins
                          "--ip-scope-end", options[:dhcp][:upper]])
           end
 
-          execute(:prlsrvctl, "net", "set", options[:name], *args)
+          execute(:prlsrvctl, "net", "set", options[:network_id], *args)
 
           # Determine interface to which it has been bound
-          net_info = json { execute(:prlsrvctl, 'net', 'info', options[:name], '--json', retryable: true) }
-          bound_to = net_info['Bound To']
+          net_info = json { execute(:prlsrvctl, 'net', 'info', options[:network_id], '--json', retryable: true) }
+          iface_name = net_info['Bound To']
 
           # Return the details
           return {
-            :name => options[:name],
-            :bound_to => bound_to,
+            :name => iface_name,
             :ip   => options[:adapter_ip],
             :netmask => options[:netmask],
             :dhcp => options[:dhcp]
@@ -123,15 +122,15 @@ module VagrantPlugins
               args.concat(["--device-add", "net"])
             end
 
-            if adapter[:hostonly] or adapter[:bridge]
+            if adapter[:type] == :hostonly
               # Oddly enough, but there is a 'bridge' anyway.
               # The only difference is the destination interface:
               # - in host-only (private) network it will be bridged to the 'vnicX' device
               # - in real bridge (public) network it will be bridged to the assigned device
-              args.concat(["--type", "bridged", "--iface", adapter[:bound_to]])
-            end
-
-            if adapter[:type] == :shared
+              args.concat(["--type", "bridged", "--iface", adapter[:hostonly]])
+            elsif adapter[:type] == :bridge
+              args.concat(["--type", "bridged", "--iface", adapter[:bridge]])
+            elsif adapter[:type] == :shared
               args.concat(["--type", "shared"])
             end
 
@@ -199,8 +198,7 @@ module VagrantPlugins
             info = {}
             ifconfig = execute(:ifconfig, iface['Bound To'])
             # Assign default values
-            info[:name]    = iface['Network ID'].gsub(/\s\(.*?\)$/, '')
-            info[:bound_to] = iface['Bound To']
+            info[:name]    = iface['Bound To']
             info[:ip]      = "0.0.0.0"
             info[:netmask] = "0.0.0.0"
             info[:status]  = "Down"
@@ -235,8 +233,7 @@ module VagrantPlugins
             info = {}
             net_info = json { execute(:prlsrvctl, 'net', 'info', iface['Network ID'], '--json') }
             # Really we need to work with bounded virtual interface
-            info[:name]     = net_info['Network ID']
-            info[:bound_to] = net_info['Bound To']
+            info[:name]     = net_info['Bound To']
             info[:ip]       = net_info['Parallels adapter']['IP address']
             info[:netmask]  = net_info['Parallels adapter']['Subnet mask']
             # Such interfaces are always in 'Up'

data/lib/vagrant-parallels/driver/pd_9.rb

@@ -41,7 +41,7 @@ module VagrantPlugins
 
         def create_host_only_network(options)
           # Create the interface
-          execute(:prlsrvctl, "net", "add", options[:name], "--type", "host-only")
+          execute(:prlsrvctl, "net", "add", options[:network_id], "--type", "host-only")
 
           # Configure it
           args = ["--ip", "#{options[:adapter_ip]}/#{options[:netmask]}"]
@@ -51,16 +51,15 @@ module VagrantPlugins
                          "--ip-scope-end", options[:dhcp][:upper]])
           end
 
-          execute(:prlsrvctl, "net", "set", options[:name], *args)
+          execute(:prlsrvctl, "net", "set", options[:network_id], *args)
 
           # Determine interface to which it has been bound
-          net_info = json { execute(:prlsrvctl, 'net', 'info', options[:name], '--json', retryable: true) }
-          bound_to = net_info['Bound To']
+          net_info = json { execute(:prlsrvctl, 'net', 'info', options[:network_id], '--json', retryable: true) }
+          iface_name = net_info['Bound To']
 
           # Return the details
           return {
-            :name => options[:name],
-            :bound_to => bound_to,
+            :name => iface_name,
             :ip   => options[:adapter_ip],
             :netmask => options[:netmask],
             :dhcp => options[:dhcp]
@@ -123,15 +122,15 @@ module VagrantPlugins
               args.concat(["--device-add", "net"])
             end
 
-            if adapter[:hostonly] or adapter[:bridge]
+            if adapter[:type] == :hostonly
               # Oddly enough, but there is a 'bridge' anyway.
               # The only difference is the destination interface:
               # - in host-only (private) network it will be bridged to the 'vnicX' device
               # - in real bridge (public) network it will be bridged to the assigned device
-              args.concat(["--type", "bridged", "--iface", adapter[:bound_to]])
-            end
-
-            if adapter[:type] == :shared
+              args.concat(["--type", "bridged", "--iface", adapter[:hostonly]])
+            elsif adapter[:type] == :bridge
+              args.concat(["--type", "bridged", "--iface", adapter[:bridge]])
+            elsif adapter[:type] == :shared
               args.concat(["--type", "shared"])
             end
 
@@ -199,8 +198,7 @@ module VagrantPlugins
             info = {}
             ifconfig = execute(:ifconfig, iface['Bound To'])
             # Assign default values
-            info[:name]    = iface['Network ID'].gsub(/\s\(.*?\)$/, '')
-            info[:bound_to] = iface['Bound To']
+            info[:name]    = iface['Bound To']
             info[:ip]      = "0.0.0.0"
             info[:netmask] = "0.0.0.0"
             info[:status]  = "Down"
@@ -235,8 +233,7 @@ module VagrantPlugins
             info = {}
             net_info = json { execute(:prlsrvctl, 'net', 'info', iface['Network ID'], '--json') }
             # Really we need to work with bounded virtual interface
-            info[:name]     = net_info['Network ID']
-            info[:bound_to] = net_info['Bound To']
+            info[:name]     = net_info['Bound To']
             info[:ip]       = net_info['Parallels adapter']['IP address']
             info[:netmask]  = net_info['Parallels adapter']['Subnet mask']
             # Such interfaces are always in 'Up'

data/lib/vagrant-parallels/guest_cap/linux/mount_parallels_shared_folder.rb

@@ -4,25 +4,35 @@ module VagrantPlugins
       class MountParallelsSharedFolder
 
         def self.mount_parallels_shared_folder(machine, name, guestpath, options)
+          # Expand the guest path so we can handle things like "~/vagrant"
+          expanded_guest_path = machine.guest.capability(
+            :shell_expand_guest_path, guestpath)
+
           machine.communicate.tap do |comm|
             # clear prior symlink
-            if comm.test("test -L \"#{guestpath}\"", :sudo => true)
-              comm.sudo("rm \"#{guestpath}\"")
+            if comm.test("test -L \"#{expanded_guest_path}\"", :sudo => true)
+              comm.sudo("rm \"#{expanded_guest_path}\"")
             end
 
             # clear prior directory if exists
-            if comm.test("test -d \"#{guestpath}\"", :sudo => true)
-              comm.sudo("rm -Rf \"#{guestpath}\"")
+            if comm.test("test -d \"#{expanded_guest_path}\"", :sudo => true)
+              comm.sudo("rm -Rf \"#{expanded_guest_path}\"")
             end
 
             # create intermediate directories if needed
-            intermediate_dir = File.dirname(guestpath)
+            intermediate_dir = File.dirname(expanded_guest_path)
             if !comm.test("test -d \"#{intermediate_dir}\"", :sudo => true)
               comm.sudo("mkdir -p \"#{intermediate_dir}\"")
             end
 
             # finally make the symlink
-            comm.sudo("ln -s \"/media/psf/#{name}\" \"#{guestpath}\"")
+            comm.sudo("ln -s \"/media/psf/#{name}\" \"#{expanded_guest_path}\"")
+
+            # Emit an upstart event if we can
+            if comm.test("test -x /sbin/initctl")
+              comm.sudo(
+                "/sbin/initctl emit --no-wait vagrant-mounted MOUNTPOINT=#{expanded_guest_path}")
+            end
           end
         end
       end