...
Preparing the Server Machine
Ensure that IIS is running (if you are going to debug IIS)
Ensure that Shibboleth is installed
Download and install the appropriate Remote Debugging tools
You need to start the Remote Debugger Tool (as admin) everytime you log/reboot the system. It defaults to using port 4020.
If will use the debug build ensure that the debug directories are on the system PATH
Stop IIS (from the console).
Setup The Visal Studio Project
...
Make the following settings:
Debugger to Launch | Remote Windows Debugger |
Remote Command | C:\Windows\System32\inetsrv\w3wp.exe |
Remote Command Arguments | -debug |
Working Directory | c:\opt\shibboleth-sp\.... |
Remote Server name | whatever.example.org:4020 (gotta have the port) |
Debugger Type | default (auto) or "Native Only" |
Deployment Directory | Probably C:\opt\shibboleth-sp\lib64\shibboleth\debug |
Set an appropriate break point. When you try to run the project for the first time there will be a login dialogue (login with an admin user) then the Remote Debugger tool will show you to be logged in. Finally a command window will pop up as IIS starts.
...
These are the settings I use
Debugger to Launch | Remote Windows Debugger |
Remote Command | C:\opt\shibboleth-sp\sbin64\debug\shibd.exe |
Remote Command Arguments | -console |
Remote Server name | whatever.example.org:4020 (gotta have the port) |
Connection | default (auto) or "Native Only" |
Deployment Directory | C:\opt\shibboleth-sp\sbin64\debug |
Attaching to a running process
It is also possible to attach to a running process ( shibd.exe
, w3wp.exe
, httpd.exe
). Start at the Debug→Attach to Process..
dialog. Leave Connection type as Default and put in the name of the remote host in the "Connection Target" dialog.