Differences

This shows you the differences between the selected revisions of the page.

troubleshooting 2017-01-11		troubleshooting 2024-09-25 (current)
	Line 3:		Line 3:
	===== General Hints =====		===== General Hints =====
	When facing an issue with WinSCP, following resources and hints may help you to resolve the issue yourself:		When facing an issue with WinSCP, following resources and hints may help you to resolve the issue yourself:
-	* Try to find solution in [[faq\|F.A.Q]] or in this [[start\|documentation]]. Use //Search// box on the right,	+	* Try to find solution in [[faq\|F.A.Q]], in our numerous [[guides\|guides]] or in this [[start\|documentation]]. Use //Search// box on the top right.
-	* If you are getting an error message, check list of [[messages\|common error messages]].	+	* If you are getting an error message, check the list of [[messages\|common error messages]].
-	* Try to find a solution in support forum. Again, use //Search// box on the right, this time check //Whole site//.	+	* Try to find a solution in tens of thousands answered questions on [[&forum/\|WinSCP support forum]]. Again, use the //Search// box on the top right, but navigate to the forum before you do so. -- Alternatively, select //"Support forum"// in the search results.
		+	* There are hundreds of [[https://stackoverflow.com/questions/tagged/winscp\|WinSCP questions answered on Stack Overflow]] and [[https://superuser.com/questions/tagged/winscp\|Super User]] sites.
	* Make sure you are using the [[&download\|latest version of WinSCP]].		* Make sure you are using the [[&download\|latest version of WinSCP]].
-	* If some feature of WinSCP is not working as you expect, check documentation of respective dialog box (use //Help// button). You may be missing configuration option or may not understand what the feature actually does.	+	* If some feature of WinSCP is not working as you expect, check the documentation of the respective dialog box (use //Help// button). You may be missing a configuration option or may not understand what the feature actually does.
-	* If you wonder why some feature of WinSCP is or not available (is disabled/grayed), check documentation of respective dialog box (use //Help// button).	+	* If you wonder why some feature of WinSCP is or not available (is disabled/grayed), check the documentation of the respective dialog box (use //Help// button).

-	===== Troubleshooting Connection Issues =====	+	===== [[connection]] Troubleshooting Connection Issues =====
	When you are not able to connect to the server:		When you are not able to connect to the server:
	* Make sure you use [[protocols\|protocol]] that the server supports.		* Make sure you use [[protocols\|protocol]] that the server supports.
	* Read guide for [[guide_connect\|connecting to FTP/SFTP server]].		* Read guide for [[guide_connect\|connecting to FTP/SFTP server]].
-	* Try if you can connect with other client using the same protocol.	+	* Try if you can connect with other clients using the same protocol.
-	* If you can connect with other client, check [[faq_connection_refused\|why WinSCP may not be able to connect to a server, when other clients are]].	+	* If you can connect with another client, see [[faq_connection_refused\|*]].
-	* When using SFTP/SCP, it may be useful to try to connect with SSH terminal client (such as [[&url(putty)\|PuTTY]]). You may get some useful message back on terminal screen.	+	* When using SFTP/SCP, it may be useful to try to connect with an SSH terminal client (such as [[&url(putty)\|PuTTY]]). You may get some useful messages back on the terminal screen.
-	* Check other [[faq#connecting_to_the_server\|F.A.Q. on connection]].	+	* Check other [[faq#connecting\|F.A.Q. on connection]].
-	* If you are getting an error message, check list of [[messages\|common error messages]].	+	* If you are getting an error message, check the list of [[messages\|common error messages]].
	* If the server refuses to accept your connection or drops the connection suddenly, you should better check the server (e.g. its log file) first to find out the reason. Contact the server administrator if you cannot check the server yourself.		* If the server refuses to accept your connection or drops the connection suddenly, you should better check the server (e.g. its log file) first to find out the reason. Contact the server administrator if you cannot check the server yourself.

	Line 25:		Line 26:
	* Read guide for [[guide_automation\|automation/scripting]] and other [[guides#scripting\|related guides]].		* Read guide for [[guide_automation\|automation/scripting]] and other [[guides#scripting\|related guides]].
	* Check [[faq#scripting\|F.A.Q. on scripting/automation]].		* Check [[faq#scripting\|F.A.Q. on scripting/automation]].
-	* If you are getting an error message, check list of [[messages\|common error messages]].	+	* If you are getting an error message, check the list of [[messages\|common error messages]].
-	* Turn on [[logging\|session logging]] using command-line switch ''[[commandline#logging\|/log]]'' and check the generated log file to see, if WinSCP actually does what you want it to do.	+	* Turn on [[logging\|session logging]] using [[commandline#logging\|''/log'' command-line switch]] and check the generated log file to see, if WinSCP actually does what you want it to do. If you are having problems with password authentication, enable password logging using [[commandline#logging\|''/loglevel=*'' command-line switch]] and check the log, if a correct password is being used. \\ <code batch>
-	* If no session log is created, chances are that some error prevented WinSCP from starting, creating a log or starting a session. Check WinSCP console output for any error. It is recommended to execute ''[[executable\|winscp.com]]'' from existing console window (such as from Windows ''cmd.exe''). The ''winscp.com'' inherits the console((A ''winscp.exe'' always creates a new console that closes when WinSCP finishes.)) and when it exits with an error, the error is preserved on the console, allowing you to inspect it.	+	winscp.com /ini=nul /script=script.txt /log=script.log /loglevel=*
-	* See also [[guide_debugging_scheduler\|Debugging transfer task running in Windows Scheduler, SSIS or other automation service]].	+	</code>
-	* If you cannot login or transfer file using script, yet you are able to login or transfer file in GUI, see [[faq_script_vs_gui\|Why I cannot connect/transfer using script, when I can using GUI?]]	+	* If no session log is created, chances are that some error prevented WinSCP from starting, creating a log, or starting a session. Check WinSCP console output for any error. It is recommended to execute ''[[executables\|winscp.com]]'' from an existing console window (such as from Windows Command Prompt – ''cmd.exe'' or PowerShell). \\ &screenshotpict(scripting_debugging) \\ The ''winscp.com'' inherits the console((A ''winscp.exe'' always creates a new console that closes when WinSCP finishes.)) and when it exits with an error, the error is preserved on the console, allowing you to inspect it.
		+	* See also [[guide_debugging_scheduler\|]] or \\ [[faq_batch_file\|]]
		+	* If you cannot log in or transfer the file using a script, yet you can log in or transfer the file in GUI, see [[faq_script_vs_gui\|*]]

	===== [[timestamps]] Troubleshooting Timestamp Issues =====		===== [[timestamps]] Troubleshooting Timestamp Issues =====
	Line 66:		Line 69:
	</code>		</code>

-	If this does not help you, and you decide to seek [[support]], make sure you include a complete session log in your report, showing above entries. Also mention a specific file that demonstrates the problem, what timestamp and behavior do you see; and what did you expect and why.	+	If this does not help you, and you decide to seek [[support]], make sure you include a complete session log in your report, showing the above entries. Also mention a specific file that demonstrates the problem, what timestamp and behavior do you see; and what did you expect and why.

	===== When you are not able to help yourself =====		===== When you are not able to help yourself =====
	Learn what [[support\|support]] you may get to WinSCP.		Learn what [[support\|support]] you may get to WinSCP.

troubleshooting 2017-01-11		troubleshooting 2024-09-25 (current)
	Line 3:		Line 3:
	===== General Hints =====		===== General Hints =====
	When facing an issue with WinSCP, following resources and hints may help you to resolve the issue yourself:		When facing an issue with WinSCP, following resources and hints may help you to resolve the issue yourself:
-	* Try to find solution in [[faq\|F.A.Q]] or in this [[start\|documentation]]. Use //Search// box on the right,	+	* Try to find solution in [[faq\|F.A.Q]], in our numerous [[guides\|guides]] or in this [[start\|documentation]]. Use //Search// box on the top right.
-	* If you are getting an error message, check list of [[messages\|common error messages]].	+	* If you are getting an error message, check the list of [[messages\|common error messages]].
-	* Try to find a solution in support forum. Again, use //Search// box on the right, this time check //Whole site//.	+	* Try to find a solution in tens of thousands answered questions on [[&forum/\|WinSCP support forum]]. Again, use the //Search// box on the top right, but navigate to the forum before you do so. -- Alternatively, select //"Support forum"// in the search results.
		+	* There are hundreds of [[https://stackoverflow.com/questions/tagged/winscp\|WinSCP questions answered on Stack Overflow]] and [[https://superuser.com/questions/tagged/winscp\|Super User]] sites.
	* Make sure you are using the [[&download\|latest version of WinSCP]].		* Make sure you are using the [[&download\|latest version of WinSCP]].
-	* If some feature of WinSCP is not working as you expect, check documentation of respective dialog box (use //Help// button). You may be missing configuration option or may not understand what the feature actually does.	+	* If some feature of WinSCP is not working as you expect, check the documentation of the respective dialog box (use //Help// button). You may be missing a configuration option or may not understand what the feature actually does.
-	* If you wonder why some feature of WinSCP is or not available (is disabled/grayed), check documentation of respective dialog box (use //Help// button).	+	* If you wonder why some feature of WinSCP is or not available (is disabled/grayed), check the documentation of the respective dialog box (use //Help// button).

-	===== Troubleshooting Connection Issues =====	+	===== [[connection]] Troubleshooting Connection Issues =====
	When you are not able to connect to the server:		When you are not able to connect to the server:
	* Make sure you use [[protocols\|protocol]] that the server supports.		* Make sure you use [[protocols\|protocol]] that the server supports.
	* Read guide for [[guide_connect\|connecting to FTP/SFTP server]].		* Read guide for [[guide_connect\|connecting to FTP/SFTP server]].
-	* Try if you can connect with other client using the same protocol.	+	* Try if you can connect with other clients using the same protocol.
-	* If you can connect with other client, check [[faq_connection_refused\|why WinSCP may not be able to connect to a server, when other clients are]].	+	* If you can connect with another client, see [[faq_connection_refused\|*]].
-	* When using SFTP/SCP, it may be useful to try to connect with SSH terminal client (such as [[&url(putty)\|PuTTY]]). You may get some useful message back on terminal screen.	+	* When using SFTP/SCP, it may be useful to try to connect with an SSH terminal client (such as [[&url(putty)\|PuTTY]]). You may get some useful messages back on the terminal screen.
-	* Check other [[faq#connecting_to_the_server\|F.A.Q. on connection]].	+	* Check other [[faq#connecting\|F.A.Q. on connection]].
-	* If you are getting an error message, check list of [[messages\|common error messages]].	+	* If you are getting an error message, check the list of [[messages\|common error messages]].
	* If the server refuses to accept your connection or drops the connection suddenly, you should better check the server (e.g. its log file) first to find out the reason. Contact the server administrator if you cannot check the server yourself.		* If the server refuses to accept your connection or drops the connection suddenly, you should better check the server (e.g. its log file) first to find out the reason. Contact the server administrator if you cannot check the server yourself.

	Line 25:		Line 26:
	* Read guide for [[guide_automation\|automation/scripting]] and other [[guides#scripting\|related guides]].		* Read guide for [[guide_automation\|automation/scripting]] and other [[guides#scripting\|related guides]].
	* Check [[faq#scripting\|F.A.Q. on scripting/automation]].		* Check [[faq#scripting\|F.A.Q. on scripting/automation]].
-	* If you are getting an error message, check list of [[messages\|common error messages]].	+	* If you are getting an error message, check the list of [[messages\|common error messages]].
-	* Turn on [[logging\|session logging]] using command-line switch ''[[commandline#logging\|/log]]'' and check the generated log file to see, if WinSCP actually does what you want it to do.	+	* Turn on [[logging\|session logging]] using [[commandline#logging\|''/log'' command-line switch]] and check the generated log file to see, if WinSCP actually does what you want it to do. If you are having problems with password authentication, enable password logging using [[commandline#logging\|''/loglevel=*'' command-line switch]] and check the log, if a correct password is being used. \\ <code batch>
-	* If no session log is created, chances are that some error prevented WinSCP from starting, creating a log or starting a session. Check WinSCP console output for any error. It is recommended to execute ''[[executable\|winscp.com]]'' from existing console window (such as from Windows ''cmd.exe''). The ''winscp.com'' inherits the console((A ''winscp.exe'' always creates a new console that closes when WinSCP finishes.)) and when it exits with an error, the error is preserved on the console, allowing you to inspect it.	+	winscp.com /ini=nul /script=script.txt /log=script.log /loglevel=*
-	* See also [[guide_debugging_scheduler\|Debugging transfer task running in Windows Scheduler, SSIS or other automation service]].	+	</code>
-	* If you cannot login or transfer file using script, yet you are able to login or transfer file in GUI, see [[faq_script_vs_gui\|Why I cannot connect/transfer using script, when I can using GUI?]]	+	* If no session log is created, chances are that some error prevented WinSCP from starting, creating a log, or starting a session. Check WinSCP console output for any error. It is recommended to execute ''[[executables\|winscp.com]]'' from an existing console window (such as from Windows Command Prompt – ''cmd.exe'' or PowerShell). \\ &screenshotpict(scripting_debugging) \\ The ''winscp.com'' inherits the console((A ''winscp.exe'' always creates a new console that closes when WinSCP finishes.)) and when it exits with an error, the error is preserved on the console, allowing you to inspect it.
		+	* See also [[guide_debugging_scheduler\|]] or \\ [[faq_batch_file\|]]
		+	* If you cannot log in or transfer the file using a script, yet you can log in or transfer the file in GUI, see [[faq_script_vs_gui\|*]]

	===== [[timestamps]] Troubleshooting Timestamp Issues =====		===== [[timestamps]] Troubleshooting Timestamp Issues =====
	Line 66:		Line 69:
	</code>		</code>

-	If this does not help you, and you decide to seek [[support]], make sure you include a complete session log in your report, showing above entries. Also mention a specific file that demonstrates the problem, what timestamp and behavior do you see; and what did you expect and why.	+	If this does not help you, and you decide to seek [[support]], make sure you include a complete session log in your report, showing the above entries. Also mention a specific file that demonstrates the problem, what timestamp and behavior do you see; and what did you expect and why.

	===== When you are not able to help yourself =====		===== When you are not able to help yourself =====
	Learn what [[support\|support]] you may get to WinSCP.		Learn what [[support\|support]] you may get to WinSCP.

Differences

Documentation

Support

Associations

Follow Us