Introduction to RVC – VSAN Trouble Shooting Tool

Recently I had an issue with the VMware VSAN where the health status was listing a number of inaccessible objects .
inaccessible1.png

It issue was due to an MTU mismatch on a Nexus 5k that was configured incorrectly. But prior to figuring that out I had to do some troubleshooting and that was my first introduction to RVC – Ruby vCenter Console

Logon –  How do I access it ? – Pretty straight forward right .. ?
First of enable Bash Shell on the VCSA – http://bit.ly/drenablebash – See David Ring’s Post on Bash and advanced settings

Once at the shell screen type rvc administrator@vsphere.local@localhost
where vsphere.local is your vsphere SSO domain. Do not forget the second @localhost
login

From here you can interact from the menu system like any Linux O/S

CD to change Directory
LS to list Directory Items

Containers are referenced with a number beside them so you can list the numbers as variables when running commands from the console. Tab works here and I used it extensively to figure out the commands.

Few Sample Command examples:

Check Cluster Status
vsan.health.cluster_status 1
where 1 is a vsan enabled cluster
vsan-health-cluster_status

Purge inaccessible objects 
vsan.purge_inaccessible_vswp_objects 1
vsanpurge

If the purge inaccessible object command doesn’t remove all the orphaned objects you will have to remove them manually. But before that you can run some cool commands to get some more detail on the objects.

vsan.cmmds_find -u guid 1
vsan-cmmd-find-2

You can get futher detail by running the following commands on one of the ESX hosts in the vsan enabled cluster.
/usr/lib/vmware/osfs/bin/objtool getAttr -u guid

host-find

Finally to remove the object run this command from any host in the cluster

/usr/lib/vmware/osfs/bin/objtool delete -u ‘guid’ -f -v 10

The RVC has many other powerful capabilities and is a really cool tool to use. I really recommend you to go play with it.  For more info

https://blogs.vmware.com/vsphere/2014/07/managing-vsan-ruby-vsphere-console.html

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s