Frame Agent Setup Tool
The Frame Agent Setup Tool (FAST) is a utility which updates the Frame Guest Agent as well as drivers and tools used by Frame to keep an image up-to-date, regardless of infrastructure or instance types being used. FAST can be used to update Frame non-essential components and to complete a Master Image creation. FAST will silently and automatically check for updates with every startup.
Before any action (installation or removal), ensure that there is a valid backup of the VM on which the Frame Agent Setup Tool is operating.
Supported Applications & Drivers
|Frame Audio Driver||Enables Frame to properly interface with the audio card on the workload VM for use in a Frame session.|
|Frame Video Driver||Enables Frame to properly interface with the video card on the workload VM for use in a Frame session.|
|Liquidware ProfileDisk||Enables support for Frame Enterprise Profiles in a Frame session (non-persistent only).|
|Frame Pen Driver||Enables support for digital pen tablets in a Frame session (requires supported endpoint device).|
|Frame Printer Driver||Enables support for Frame Printer in a Frame session.|
|Frame Scanner Driver||Enables support for WIA scanners in a Frame session (requires supported endpoint device).|
|Frame SmartCard Driver||Enables support for CAC/SmartCards in a Frame session (requires supported endpoint device).|
|Frame USB Driver||Enables support for Generic USB in a Frame session (requires supported endpoint device).|
|Frame AD Helper||Tool for troubleshooting issues with joining a Frame workload VM to an Active Directory domain.|
|Frame Proxy Helper||Tool for configuring Frame Agent to function properly with proxy servers.|
|Frame Sysprep Helper||Tool for troubleshooting and automatically resolving issues related to Windows Sysprep.|
The Frame Agent Setup Tool is not able to resolve problems with broken MSI installations on the machine. Frame Agent Setup Tool is not a package repair tool. If you run into this issue, try resolving it manually or by using 3rd party software.
Navigate to the account Sandbox where you would like to install the Frame Agent Setup Tool.
Open FAST in the
C:\ProgramData\Nutanix\Frame\ToolsFolder. For the latest version of FAST, you can download the tool from the Nutanix Portal or the Frame control plane.
Run the executable to launch the Frame Agent Setup Tool.
When you start the application, it will try to determine the infrastructure (AHV, GPC, Azure, or AWS) and attempt to obtain the Frame platform type (government or commercial) for that infrastructure. In cases where the machine still cannot determine the Frame platform type, a popup dialog box will appear:
Once the FAST utility has determined its environment, it will continue.
The FAST utility has two different views: Bundle View and Updater View. When you run the FAST utility, it will try to find Frame Agent and Streaming component. If it locates Frame Agent, it will start in Updater View. If Frame Agent cannot be found but streaming components are installed on the instance (e.g. clean Windows image), it will start in Bundle View.
Frame recommends removing the FAST utility from the Sandbox when you have finished using it, before moving on to the publishing process.
A dialog prompt will open, accept the terms and conditions. Click the “Next” button to continue.
Select the desired packages for installation by checking the associated boxes. Click the Install button to continue.
Each package will be downloaded and then installed, one by one. See the example below:
Select the desired packages for installation by checking the associated boxes.
Click the toggle located at the bottom of the window to acknowledge the machine has been backed up.
Click the gear icon at the top left of the application to download and install your selected programs.
Accept the prompt by clicking OK.
|Up to Date||A package found on the machine is already up-to-date with the latest version.|
|Update Required||An installed package requires an update. Failure to update could result in system instability or compatibility conflicts.|
|Update Available||An installed package has an optional update. While not required, this update could improve performance or add new features.|
|Not Installed||An optional package is not installed.|
You may want to automate Frame Agent Setup Tool to update all components of their Frame Virtual Machines programmatically. In that case, Frame Agent Setup Tool can be executed with various to orchestrate updates and installation. For example:
This argument will list all missing or obsolete packages.
|Display a list of all missing/obsolete packages|
|Display a list of all missing/obsolete packages in json format|
|Install all missing/obsolete packages|
|Install only provided packages|
|Install all missing/obsolete packages except provided packages|
|Install all system and Frame components|
|Install only provided applications and all Frame system components|
|Install all available application except listed ones after installation of Frame system components|
For VMs still not connected to Frame platform (BYO Master Image preparation),
registrationmetadata argument must provided:
FrameAgentSetupTool.exe getpackages registrationmetadata=YOUR-DOMAIN.com
FrameAgentSetupTool.exe install bundle registrationmetadata=YOUR-DOMAIN.com
The Frame Agent Setup Tool generates a log file for troubleshooting which is located in:
Take a look at these and if you need further assistent, open a support ticket.