The Ruby vSphere Console (RVC) is an interactive command-line console user interface for VMware vSphere and Virtual Center. The Ruby vSphere Console is based on the popular RbVmomi Ruby interface to the vSphere API.
The Ruby vSphere Console comes bundled with the vCenter Server Appliance (VCSA) and the Windows version of vCenter Server. It is free of charge and is fully supported. We recommend deploying a vCenter Server Appliance (minimum version 5.5u1b) to act as a dedicated server for the Ruby vSphere Console and Virtual SAN Observer. This will remove any potential performance or security issues from the primary production vCenter Server. After deploying the vCenter Server Appliance, no additional configuration is required to begin using the Ruby vSphere Console to manage your vSphere infrastructure. To begin using the Ruby vSphere Console, simply ssh to the dedicated vCenter Server Appliance and log in as a privileged user.
++ More detailed Virtual SAN insights vSphere Web Client
++ Cluster view of VSAN while esxcli can only offer host perspective
++ Mass operations via wildcards
++ Works against ESX host directly, even if VC is down
How do you set up ??
To begin using the Ruby vSphere Console to manage your vSphere infrastructure, simply deploy the vCenter Server Appliance and configure network connectivity for the appliance. SSH to the dedicated vCenter Server Appliance and log in as a privileged user. No additional configuration is required to begin.
Accessing and Logging In Below you will find the steps to log in and begin using the Ruby vSphere Console (RVC):
1. SSH to the VCSA dedicated to RVC and Virtual SAN Observer usage. login as: root VMware vCenter Server Appliance email@example.com password :
2. Login to the VCSA as a privileged OS user (e.g. root or custom privileged user).
3. Login to RVC using a privileged user from vCenter. Syntax: rvc [options] [username[:password]@]hostname
vcsa:~ # rvc firstname.lastname@example.org password:
0 / 1 x.x.x.x/ > cd 1 /localhost> ls 0 Test-Datacenter /localhost>cd 0
I will then proceed by typing ‘cd 0’ and then ‘ls’ to view the contents of my ‘Test-Datacenter’ which will then provide me with 5 more options as seen below.
The vSphere environment is broken up into 5 areas:
++ Storage: vSphere Storage Profiles
++ Computers: ESXi Hosts
++ Networks: Networks and network components
++ Datastores: Datastores and datastore components
++ VMs: Virtual Machines and virtual machine components
/localhost/Test-Datacenter>ls 0 storage 1 computer [host]/ 2 network [network]/ 3 datastores [datastore]/ 4 vms [vm]/ /localhost/Test-Datacenter>
You can use TAB twice to view the namespace
Once you login you can use help command to check the options (add the ‘-help’ parameter to the end of the command OR you can type ‘help’ followed by what is called the command ).For example :
help vsan help cluster help host help vm
Viewing Virtual SAN Datastore Capacity: “show vsanDatastore” Here is an example of using “ls” to list out datastores within the infrastructure and then using “show” to obtain high-level information on the “vsanDatastore”. Notice the capacity and free space of the vsanDatastore.
/localhost/Test-Datacenter/datastores> ls 0 datastore1: 99.21GB 0.7% 1 datastore1 (1): 99.14GB 0.1% 2 vsanDatastore: 700.43GB 17.7% /localhost/Test-Datacenter/datastores> show vsanDatastore/ path: /localhost/Test-Datacenter/datastores/vsanDatastore type: vsan url: ds:///vmfs/volumes/vsan:5207cb725036c9fc-3e560cb2fb96f36d/ multipleHostAccess: true capacity: 700.43GB free space: 684.14GB
Page 14 onwards.
I am working on the rvc commands as of now, and I will update the details in my next post: Ruby vSphere Console (RVC): Part 2