Python vSphere Client with a dialog(1) interface¶

PVC is an interactive text-mode VMware vSphere Client with a dialog(1) interface for GNU/Linux systems built on top of the pyVmomi VMware vSphere API Python bindings.

Using PVC allows you to quickly navigate in your VMware vSphere environment and perform common tasks against various VMware vSphere Managed Entities.

PVC is Open Source and licensed under the BSD License.

Status¶

Experimental. PVC is in early development stage. Using PVC in a production environment is not (yet) recommended.

Contributions¶

PVC is hosted on Github. Please contribute by reporting issues, suggesting features or by sending patches using pull requests.

Bugs¶

Probably. If you experience a bug issue, please report it to the PVC issue tracker on Github.

Getting Started¶

Getting started with PVC is easy - simply go over the Installation of PVC and Configuration of PVC pages, which provide all the details about how to install and configure PVC.

Make sure to also check the Example screenshots of PVC page, which contains example screenshots of using PVC in a VMware vSphere environment.

Contents¶

Installation of PVC¶

This document walks you through the installation of PVC.

The easiest way to install PVC is by using pip, which would automatically install any dependencies for you or you could use the latest development version of PVC from the Github repository.

Requirements¶

The following list provides information about the PVC dependencies.

Some of the PVC features require additional packages to be present in order to take advantage of these features. The list below provides information about any optional dependencies of PVC.

Note, that these dependencies are not required and are only needed if you intend to use the features provided by them.

gnuplot - Used for plotting performance graphs
VMware Player - Used for establishing a remote console session
A VNC client - Used for establishing a remote console VNC session

Installation with pip¶

In order to install PVC using pip, simply execute this command:

$ pip install pvc

If you would like to install PVC in a virtualenv, then follow these steps instead:

$ virtualenv pvc-venv
$ source pvc-venv/bin/activate
$ pip install pvc

Installation from source¶

The master branch of PVC is where main development happens.

In order to install the latest version of PVC follow these simple steps:

$ git clone https://github.com/dnaeon/pvc.git
$ cd pvc
$ sudo python setup.py install

If you would like to install PVC in a virtualenv follow these steps instead:

$ virtualenv pvc-venv
$ source pvc-venv/bin/activate
$ git clone https://github.com/dnaeon/pvc.git
$ cd pvc
$ python setup.py install

This would take care of installing all dependencies for you as well.

Configuration of PVC¶

By default PVC does not require any special configuration to work.

If you are using gnuplot for plotting perfomance graphs with PVC and you want to customize the gnuplot terminal being used you could set the GNUPLOT_TERM environment variable to your desired terminal.

If GNUPLOT_TERM is not set then PVC will use a dumb terminal when plotting a performance graph.