diff --git a/Troubleshooting-Steps.md b/Troubleshooting-Steps.md index b0b1130..95e1ad1 100644 --- a/Troubleshooting-Steps.md +++ b/Troubleshooting-Steps.md @@ -1,18 +1,12 @@ -If sshd won't start: - -* Ensure that `sshd_config` is in the same directory as `sshd.exe` -* Ensure that host keys are generated and have the [correct file permissions][Secure file]: - * Ensure that private host keys are [secured][Secure file] - * Ensure that `NT service\sshd` has `Read` access to public and private key files - -Troubleshooting steps for typical connection issues: +Troubleshooting steps for typical service startup and connection issues: * Server side: run `sshd` in debug mode - * `net stop sshd` - * In an elevated Administrator console, run `sshd` in debug mode - * `sshd.exe -d` + * `Stop-Service sshd` (if sshd service is running) + * Open cmd as SYSTEM. Download psexec from [here](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec). + * `psexec -i -s cmd` + * `sshd.exe -d` * This will dump debug logs in real time to stdout on the console - * You can also add additional `d`s to get more debug information: + * You can also add additional `d`s for more detailed loggin: * `sshd.exe -dd` or `sshd.exe -ddd` * Client side: start `ssh` in verbose mode * `ssh.exe -v ...` @@ -22,11 +16,11 @@ Troubleshooting steps for typical connection issues: Troubleshooting more complex issues: * Server side - * Stop `sshd` and `ssh-agent` services - * `Get-Service ssh* | Stop-Service` + * Stop `sshd` + * `Stop-Service sshd` * Delete `sshd.log` and `ssh-agent.log` (in the `logs` directory of your installation path) * Set `LogLevel` to `DEBUG` (or `DEBUG2`/`DEBUG3` for higher levels of logging) in `sshd_config` - * Rerun the workflow that's giving you problems. `logs\sshd.log` and `logs\ssh-agent.log` will contain `sshd` and `ssh-agent` related traces respectively. + * Rerun the workflow that's giving you problems. `logs\sshd.log` will contain `sshd` related traces. * If the problem isn't clear, please post these logs along with some steps to help us reproduce your problem in [our GitHub Issues](https://github.com/powershell/Win32-OpenSSH/issues). * Client side * Set `LogLevel` to `DEBUG` (or `DEBUG2`/`DEBUG3` for higher levels of logging) in `ssh_config`.