App Volumes Toolbox

This utility connects to App Volumes 2.x, 3.x and Horizon Air Hybrid-Mode (Enzo) environments, pulling data from the native REST APIs into a single interface for ease of management. Configuration items such as deleting AppStacks and managing Writable Volumes, which are not available in the App Volumes 3.x interface, are easily managed with this utility. The utility leverages native REST API calls for all actions.

  • Windows 7, 8, 10, Windows Server 2008R2 and Windows Server 2012R2
  • Microsoft .NET Framework 4.5 must be installed on the system running the application.
  • Access to VMware App Volumes 2.x, 3.x or Horizon Air Hybrid-Mode (Enzo) Environment. Note: This application will work with App Volumes 2.x as well, but several of the tabs relevant to App Volumes 3.x will be disabled.
  • User must be part of the Admin group in App Volumes 3.x or Horizon Air Hybrid Mode (Enzo) in order to connect to the APIs and return data.

Logging in

Connecting to App Volumes
  1. Make sure that "Connect to an Enzo Instance" is unchecked.
  2. Enter the URL of the App Volumes server in the "App Volumes Manager" textbox (https://avmanager.company.com). Click "Connect to App Volumes API".
  3. Enter Username, Password and Domain of an account that is in the App Volumes Admin group.
  4. If the certificate on the App Volumes manager is not a trusted certificate (self-signed, CA generated) you will receive a warning that the certificate is not trusted. Review the details of the certificate provided and if everything looks good, click "Accept" to accept the certificate and add an exception (you won't be prompted again for this certificate). Click "Cancel" if you don't trust the certificate - in this case you will be unable to connect to the App Volumes manager until the certificate installed is trusted. Certificate trust exceptions are stored on a per user basis in HKCU\Software\VMware Flings\App Volumes Toolbox\Trusted Certs. This value can be cleared or deleted to remove any trusted exceptions.
Connecting to Horizon Air Hybrid-Mode (Enzo):
  1. Check the box "Connect to an Enzo Instance".
  2. The server URL will automatically be set to "https://cloud.horizon.vmware.com".
  3. Click "Connect to App Volumes API".
  4. Login to My VMware with the account associated with the Horizon Air Hybrid-Mode account. Once logged into My VMware, you will now be prompted to log into the tenant domain. Log in with an account that is in the Admin Users group.
  5. If the certificate on the App Volumes manager is not a trusted certificate (self-signed, CA generated) you will receive a warning that the certificate is not trusted. Review the details of the certificate provided and if everything looks good, click "Accept" to accept the certificate and add an exception (you won't be prompted again for this certificate). Click "Cancel" if you don't trust the certificate - in this case you will be unable to connect to the App Volumes manager until the certificate installed is trusted. Certificate trust exceptions are stored on a per user basis in HKCU\Software\VMware Flings\App Volumes Toolbox\Trusted Certs. This value can be cleared or deleted to remove any trusted exceptions.

Using the Application

There are several tabs in the App Volumes Toolbox. They will each be detailed below:

Online Entities

This shows any users and computers which are currently connected to the App Volumes Manager. This is helpful for determining if an App Volumes agent is properly connecting to the AV Manager.

App Volumes Logs

This tab allows one to view the App Volumes logs, which are great for troubleshooting and watching the status of events such as AppStacks importing. You are able to show the entire log file, a tail of the log file, and have the page auto-refresh on a specified interval. You can also download the entire file by clicking "Download App Volumes Server Log".

View / Delete AppStacks

This tab allows one to view the available AppStacks inventory, and details on those AppStacks. At a quick glance you can see how many applications each AppStack contains, when it was last updated and the Operating System it is targeting. If you select and right-click on an AppStack you will see a menu item called "Show Installed Applications". By clicking this menu item you will able to see details on each application installed within the AppStack, the file share associated with the AppStack and also force a sync of that file share.

You can also delete AppStacks, which is something that is not available in the current App Volumes administrative interface. Deleting an AppStack removes it from the UI and also from the underlying datastores. You can optionally delete the files associated with the AppStack from the file share as well.

Deleting Appstacks

Select one or more AppStacks you wish to delete. If you wish to also remove the associated .vmdk, .vhk and .json files from the file share, you can check the "Delete Files from FileShare when Deleting AppStack" checkbox. Click "Delete Selected AppStacks". If any of the selected AppStacks have a current Assignment or Attachment, the deletion process will fail and you will receive a message indicating that that AppStack cannot be deleted. Any AppStacks without an Assigment or Attachment will be deleted from the UI, underlying datastores and if selected, the file share. You will receive a status message after the deletion process completes.

NOTE: This tab is not enabled for App Volumes 2.x

Writable Volumes

This tab allows management of user Writable Volumes, which is not currently available in the App Volumes 3.x Admin console. You can view utilization, if a Writable Volume is currently attached, check if enabled or disabled and see the last time it was mounted. You can also enable or disable, expand and delete Writable Volumes.

Attachments

This tab shows any currently attached AppStacks or Writable Volumes, as well as the endpoint they are connected to, when they were attached and the duration.

Assignments

This tab shows any current assignments, whether desktop pool or Application. You can right-click an assignment and choose the "View Assignment Details" menu to show detailed information on the Assignment. This information includes which Applications are contained in the Assignment, the Operating System version and which users/groups will receive the Assignment.

NOTE: This tab is not enabled for App Volumes 2.x

Applications

This tab shows a listing of each Application available, the Parent AppStack, how many assignments the Application is a member of and which Operating System version is supported. This is very helpful in correlating Applications to AppStacks and understanding which applications are currently Assigned to users.

NOTE: This tab is not enabled for App Volumes 2.x.

Add a Comment
Report a Bug