Frame Guest Agent Proxy Server Support

Frame Guest Agent (FGA) has native support for proxy servers. Customers may configure the FGA to use an outbound proxy server, if a proxy server required for all outbound traffic to the Internet. Windows administrators must explicitly set the FGA proxy settings and have those settings persist after a sysprep (during publishing of production VMs that must be joined to a Windows domain), after the domain-joined production VMs are powered on, or when an end user logs into their Windows domain (changes to UEM policy or GPOs). The FGA proxy configuration does not affect the Windows OS, user, or third-party application proxy settings.

Configuration

Using the FrameProxyHelper tool which is available in C:\ProgramData\Nutanix\Frame\Tools, configure all required fields and verify the configuration by clicking the “Start test” button. The images below show a successful proxy test.

../../_images/proxy1.jpg

Depending on your environment, you can test predefined Commercial or Government endpoints. You can also use custom endpoints by clicking on the “Custom” button, adding your endpoints to the list and confirming with the green check mark button.

../../_images/proxy2.jpg

Lastly, save your settings by clicking the “Save Settings” button. Reboot the VM in order for your changes to take effect.

../../_images/proxy3.jpg

Note

For AHV, we recommend this proxy server configuration be done in the Windows template images. If sysprep removes the proxy server settings, you will have to connect into the Sandbox using RDP, after the Frame account is created, to update the FGA’s proxy server settings.

Troubleshooting

To remove the Frame Guest Agent proxy server configuration to troubleshoot, go to the Sandbox and (using regedit) delete the contents of:

HKLM\Software\Nutanix\Frame\Fga\ProxySettings\