The following instructions, are describing the configuration steps, regarding the Remote Debugging with VS17 on an Azure VM.
Preliminary, you must check the VS version. Each version, corresponds to different Remote Tools
Visual Studio Version | Link |
2017 | download |
2015 Upd 3 | download |
2013 | download |
Install Remote Tools
At the first step, check Accept the license terms and conditions and click Install.
setup is running…
And finally, the setup is successful
Remote Tools Configuration
Open the Remote Debugger icon
Tools – Options, check No Authentication / Allow any user to debug and click OK
After having downloaded and installed the correct VS version you need to configure both Windows & Azure Firewalls.
Visual Studio Version | Port |
2017 | 4022 |
2015 | 4020 |
2013 | 4018 |
Windows Firewall Configuration
PURPOSE | TCP PORT | NOTES |
Remote Tools | 4022 | Default TCP Port for Visual Studio 2017 Remote Debugger |
Azure Firewall Configuration
*** If a Load Balancer exists then you must add the following Inbound Rule *** |
Azure Load Balancer NAT Rule
……One step away debugging
Open Visual Studio, Debug – Attach to Process…
Type on Connection Target field, IP address:Port, e.g XXX.XXX.XXX.XXX:4022, and Click Refresh.
Possible Error Messages
Error Message 1:
Causes :
1.Possible firewall (Windows or Azure), Azure Load Balancer (if exists) misconfiguration.
2. Remote Tools process is not running
Error Message 2:
Causes:
1. On the Remote Debugger, check if the Options are not configured correctly.
Related Links:
https://social.technet.microsoft.com/wiki/contents/articles/51443.configure-remote-debugging-tool-on-azure-vm.aspx