Differences
This shows you the differences between the selected revisions of the page.
| troubleshooting 2024-12-02 | troubleshooting 2024-12-02 (current) | ||
| Line 1: | Line 1: | ||
| - | 317 | ||
| - | |||
| - | |||
| ====== Troubleshooting ====== | ====== Troubleshooting ====== | ||
| Line 8: | Line 5: | ||
| * 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. | * 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 the 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 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. | + | * 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. | * 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 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 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 the documentation of the 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). | ||
| Line 20: | Line 17: | ||
| * Try if you can connect with other clients using the same protocol. | * Try if you can connect with other clients using the same protocol. | ||
| * If you can connect with another client, see [[faq_connection_refused|*]]. | * If you can connect with another client, see [[faq_connection_refused|*]]. | ||
| - | * 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. | + | * 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|F.A.Q. on connection]]. | * Check other [[faq#connecting|F.A.Q. on connection]]. | ||
| * If you are getting an error message, check the list of [[messages|common error messages]]. | * If you are getting an error message, check the list of [[messages|common error messages]]. | ||
| Line 30: | Line 27: | ||
| * 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 the 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 [[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. \\ &lt;code batch&gt; | + | * 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> |
| winscp.com /ini=nul /script=script.txt /log=script.log /loglevel=* | winscp.com /ini=nul /script=script.txt /log=script.log /loglevel=* | ||
| - | &lt;/code&gt; | + | </code> |
| - | * 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). \\ &amp;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. | + | * 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|*]] | * 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|*]] | * 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|*]] | ||
| Line 49: | Line 46: | ||
| * Directory listing, including UTC file modification timestamps: | * Directory listing, including UTC file modification timestamps: | ||
| - | &lt;code&gt; | + | <code> |
| - | ..;D;0;2013-04-24T08:43:23.000Z;&quot;&quot; [0];&quot;&quot; [0];rw-rw-rw-;1 | + | ..;D;0;2013-04-24T08:43:23.000Z;"" [0];"" [0];rw-rw-rw-;1 |
| - | .htaccess;-;33;2004-11-10T20:46:46.000Z;&quot;&quot; [0];&quot;&quot; [0];rw-rw-rw-;3 | + | .htaccess;-;33;2004-11-10T20:46:46.000Z;"" [0];"" [0];rw-rw-rw-;3 |
| - | commandline.txt;-;9390;2013-04-15T09:01:52.000Z;&quot;&quot; [0];&quot;&quot; [0];rw-rw-rw-;1 | + | commandline.txt;-;9390;2013-04-15T09:01:52.000Z;"" [0];"" [0];rw-rw-rw-;1 |
| - | config.txt;-;4490;2013-04-17T06:31:36.000Z;&quot;&quot; [0];&quot;&quot; [0];rw-rw-rw-;1 | + | config.txt;-;4490;2013-04-17T06:31:36.000Z;"" [0];"" [0];rw-rw-rw-;1 |
| - | contributions.txt;-;1865;2012-08-24T07:08:58.000Z;&quot;&quot; [0];&quot;&quot; [0];rw-rw-rw-;1 | + | contributions.txt;-;1865;2012-08-24T07:08:58.000Z;"" [0];"" [0];rw-rw-rw-;1 |
| - | directory_cache.txt;-;1892;2011-07-30T18:24:52.000Z;&quot;&quot; [0];&quot;&quot; [0];rw-rw-rw-;1 | + | directory_cache.txt;-;1892;2011-07-30T18:24:52.000Z;"" [0];"" [0];rw-rw-rw-;1 |
| - | dragext.txt;-;4329;2013-04-09T11:50:48.000Z;&quot;&quot; [0];&quot;&quot; [0];rw-rw-rw-;1 | + | dragext.txt;-;4329;2013-04-09T11:50:48.000Z;"" [0];"" [0];rw-rw-rw-;1 |
| - | &lt;/code&gt; | + | </code> |
| * Modification timestamp being set on target file after file transfer (SFTP): | * Modification timestamp being set on target file after file transfer (SFTP): | ||
| - | &lt;code&gt; | + | <code> |
| Preserving timestamp [2009-02-26T21:15:50.000Z] | Preserving timestamp [2009-02-26T21:15:50.000Z] | ||
| - | &lt;/code&gt; | + | </code> |
| * Timestamp comparing during synchronization: | * Timestamp comparing during synchronization: | ||
| - | &lt;code&gt; | + | <code> |
| Local file 'D:\Documents\wiki\config.txt' [2013-04-24T09:41:04.922Z] [4546] is modified | Local file 'D:\Documents\wiki\config.txt' [2013-04-24T09:41:04.922Z] [4546] is modified | ||
| comparing to remote file '/home/martinp/httpdocs/wiki/config.txt' [2013-04-17T06:31:36.000Z] [4490] | comparing to remote file '/home/martinp/httpdocs/wiki/config.txt' [2013-04-17T06:31:36.000Z] [4490] | ||
| - | &lt;/code&gt; | + | </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 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. | 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. | ||
| Line 76: | Line 73: | ||
| ===== 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. | ||
| - | |||
| - | 1 | ||