116 lines
3.5 KiB
Plaintext
116 lines
3.5 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Installation - VMware Provider"
|
|
sidebar_current: "providers-vmware-utility"
|
|
description: |-
|
|
The Vagrant VMware Utility works with the Vagrant VMware Provider to
|
|
interact with the system VMware installation.
|
|
---
|
|
|
|
# Vagrant VMware Utility Installation
|
|
|
|
## System Packages
|
|
|
|
The Vagrant VMware Utility is provided as a system package. To install the
|
|
utility, download and install the correct system package from the downloads
|
|
page.
|
|
|
|
<center>
|
|
<a class="button" href="/vmware/downloads.html">Download <%= vmware_utility_version %></a>
|
|
</center>
|
|
|
|
## Manual Installation
|
|
|
|
If there is no officially supported system package of the utility available,
|
|
it may be possible to manually install utility. This applies to Linux platforms
|
|
only. First, download the latest zip package from the releases page.
|
|
|
|
Next create a directory for the executable and unpack the executable as
|
|
root.
|
|
|
|
```shell
|
|
sudo mkdir /opt/vagrant-vmware-desktop/bin
|
|
sudo unzip -d /opt/vagrant-vmware-desktop/bin vagrant-vmware-utility_1.0.0_x86_64.zip
|
|
```
|
|
|
|
After the executable has been installed, the utility setup tasks must be run. First,
|
|
generate the required certificates:
|
|
|
|
```shell
|
|
sudo /opt/vagrant-vmware-desktop/bin/vagrant-vmware-utility certificate generate
|
|
```
|
|
|
|
The path provided from this command can be used to set the [`utility_certificate_path`]
|
|
(/docs/vmware/configuration.html#utility_certificate_path) in the Vagrantfile
|
|
configuration if installing to a non-standard path.
|
|
|
|
Finally, install the service. This will also enable the service.
|
|
|
|
```shell
|
|
sudo /usr/local/vagrant-vmware-desktop/vagrant-vmware-utility service install
|
|
```
|
|
|
|
# Usage
|
|
|
|
The Vagrant VMware Utility provides the Vagrant VMware provider plugin access
|
|
to various VMware functionalities. The Vagrant VMware Utility is required by
|
|
the Vagrant VMware Desktop provider plugin.
|
|
|
|
## Vagrant VMware Utility Access
|
|
|
|
The Vagrant VMware Utility provides support for all users on the system using
|
|
the Vagrant VMware Desktop plugin. If access restrictions to the Utility need
|
|
to be applied to users on the system, this can be accomplished by restricting
|
|
user access to the certificates used for connecting to the service.
|
|
|
|
On Windows platforms these certificates can be found at:
|
|
|
|
* C:\ProgramData\HashiCorp\vagrant-vmware-desktop\certificates
|
|
|
|
On POSIX platforms these certificates can be found at:
|
|
|
|
* /opt/vagrant-vmware-desktop/certificates
|
|
|
|
## Vagrant VMware Utility Service
|
|
|
|
The Vagrant VMware Utility consists of a small service which runs on the
|
|
host platform. When the utility installer package is installed, the service
|
|
is configured to automatically start. If the plugin reports errors communicating
|
|
with the service, it may have stopped for some reason. The most common cause of
|
|
the service not being in a running state is the VMware application not being
|
|
installed. The service can be started again by using the proper command below:
|
|
|
|
### Windows
|
|
|
|
On Windows platforms a service is created called `vagrant-vmware-utility`. The
|
|
service can be manually started using the services GUI (`services.msc`) or by
|
|
running the following command from a `cmd.exe` in administrator mode:
|
|
|
|
```shell
|
|
> net.exe start vagrant-vmware-utility
|
|
```
|
|
|
|
### macOS
|
|
|
|
```shell
|
|
> sudo launchctl load -w /Library/LaunchDaemons/com.vagrant.vagrant-vmware-utility.plist
|
|
```
|
|
|
|
### Linux systemd
|
|
|
|
```shell
|
|
> sudo systemctl start vagrant-vmware-utility
|
|
```
|
|
|
|
### Linux SysVinit
|
|
|
|
```shell
|
|
> sudo /etc/init.d/vagrant-vmware-utility start
|
|
```
|
|
|
|
### Linux runit
|
|
|
|
```shell
|
|
> sudo sv start vagrant-vmware-utility
|
|
```
|