Troubleshooting VMware App Volumes using the Ruby on Rails console
search cancel

Troubleshooting VMware App Volumes using the Ruby on Rails console

book

Article ID: 323583

calendar_today

Updated On:

Products

VMware

Issue/Introduction

This article provides information on troubleshooting VMware App Volumes using the Ruby on Rails console.

Environment

VMware App Volumes 2.7.x
VMware App Volumes 2.6.0
VMware App Volumes 2.9.x
VMware App Volumes 2.5.x
VMware App Volumes 4.x

Resolution

The Ruby on Rails console can be used to execute queries and run scripts when troubleshooting an App Volumes environment. The most common use case is to look at an internal object that may not be fully displayed in the App Volumes Manager console. Any Ruby command can be run from the Ruby on Rails console. For more information on Ruby commands, see the Ruby documentation.

Caution: The Ruby on Rails console should be used with caution. Modifications made within this console can cause data corruption.
 

Accessing the Ruby on Rails Console

To access the Ruby on Rails console:

 

  1. In the App Volumes Manager server, go to Start > Programs, and right-click Command Prompt. Click Run as administrator.
  2. Navigate to C:\Program Files(x86)\CloudVolumes\Manager.
  3. Run this command to launch the Ruby on Rails console:

    svmanager_run script\rails console



     

Sample Ruby Commands

Example Ruby commands:

 

  • Prefix any Ruby command with ap to make the output human-readable. For example, ap Machine.all lists the App Volumes agent machines.


     
  • Another example command is Svconfiguration, which lists a summary of App Volumes Manager configurations, including licensing, Active Directory, vCenter Server, and App Volumes template information.


     
  • You can run queries in the Ruby on Rails console to determine specific information. For example, to query for a particular App Volumes Agent machine named dgt3, run the command:

    ap Machine.where((name: ”dgt3”))


     
  • To query a specific AppStack or writable volume, such as VLC_Media_Player_App, run the command:

    ap Snapvol.where(name: “VLC_Media_Player_App”)

 
For guidance on Ruby commands, check the Ruby on Rails Guides and A Guide to The Rails Command Line.


Additional Information

Ruby on Rails コンソールを使用した VMware App Volumes のトラブルシューティング