This is an old revision of the document!

Reporting Bug or Asking for Support

Help Yourself

First, try to troubleshoot your issue yourself.

Advertisement

How to Effectively Report Bug or Ask for Support

When posting your request for support or reporting bug, please include as much of the following information as you know. If you do not know some of these information or if you suppose that some are irrelevant for the issue, please mention that as well.

  • Version of WinSCP you are using (you should be using the latest version if possible).
  • If the problem started to occur after upgrade, mention the last version of WinSCP which was working for you1.
  • Version of Microsoft Windows you are running WinSCP on.
  • Transfer protocol (SFTP, FTP or SCP).
  • Mention if you use GUI or scripting/automation. If you use GUI, specify interface style you are using (Commander or Explorer).
  • If you experience an error, include full error message. You may use Ctrl+C to copy the message, then paste it (Ctrl+V) to the post. Also check list of common error messages.
  • Try to describe precise steps that lead to the problem (where do you click, what keys do you press, what do you see, etc.). If you are not able to reproduce the problem with the steps, it is probably not worth to report it as I will not be able to reproduce it (and solve) too.
    Particularly, if the problem relates to user interface, consider recording your steps or even full video. E.g. using Steps Recorder in Windows 7 and 82 or screenr.com or similar service.
  • If your problems relates to interaction with remote server, please post a full log file showing the problem.
    To generate log file, enable session logging, log in to your server and do the operation and only the operation that causes the error.
    Always attach your log to the post as a file, never paste the log into post text. When posting extensive logs please compress them before attaching.
    Note that passwords and passphrases are not stored in the log. You may want to remove other data you consider sensitive though, such as host names, IP addresses, account names or file names (unless they are relevant to the problem).
    If you do not want to post the log publicly, you may email it to me. Though still you need to first post on the support forum, just mention that you are going to email the log. Otherwise your email will be ignored. Please include link back to your post in your email. You will find my address (if you log in) in my forum profile.
  • For scripting/automation-related issues, include your full script, command-line you use to run WinSCP, and output you see on WinSCP console.

Register on the forum before you post. I may be able to deal with your issue only after some time, so I would appreciate if I have a contact to you.

Example of Bug Report

Subject: Open session in new window

While session is opened and the main window is shown, hold Shift and click on a saved session (in Session > Saved Sessions menu) in subfolder in order to open the session in new window. It does not work. Instead error message pops up saying: “Host does not exist”.

Using WinSCP 4.1.4 with “Commander” interface on Windows XP SP3. It happens for any stored session in subfolder, regardless of protocol or server. So I’m not posting session log file as it seems irrelevant.

Advertisement

Subject: changed access to FTP client.

I used FTP client during about ten years and started it by calling: D:\Installer\SSH-client-portable\winscp417.exe

I had only

   to select:  1 of my 2 domains listed there

and

  to enter a password.

Today, for calling the FTP client suddenly the reply to my call has ben massively changed. A complex field shows up with a menue:

  1. Session
  2. ---Stored sessions
  3. Environment
  4. ---Diectories
            SSS
            ---- Preferences

Now the followig input is requested from me:

            Host name       Port number
            User Name    Password
            Private key file
            Protocol

After about 10 years I forgot all this data except the password.

I need your help.

Greetings from

Prof. Dr.-Ing. Reiner Hartenstein http://hartenstein.de http://helios.informatik.uni-kl.de/staff/Hartenstein.html

  1. Even better would be if you can try to install all intermediate versions (if any) to find exact version of WinSCP that introduced the problem.Back
  2. To start Problem Steps Recorder in Windows 7, go to Start menu and type psr into a search field. To start Steps Recorder in Windows 8, go to Start screen or Search charm and type psr.Back

Advertisement

Last modified: by 87.178.190.142