Differences
This shows you the differences between the selected revisions of the page.
| 2009-01-19 | 2009-01-19 | ||
| 444 (58.26.154.98) (hidden) | Restored revision 1225439921. Undoing revisions 1232328906, 1232328937. (martin) (hidden) | ||
| Line 1: | Line 1: | ||
| ====== WinSCP Technical Requirements ====== | ====== WinSCP Technical Requirements ====== | ||
| - | 5 | + | ===== Server Requirements ===== |
| + | Using WinSCP, you can connect to a [[SSH]] (Secure Shell) server with [[protocols#sftp|SFTP]] (SSH File Transfer Protocol) or [[protocols#scp|SCP]] (Secure Copy Protocol) service or to a [[protocols#ftp|FTP]] (File Transfer Protocol) server. | ||
| + | |||
| + | SFTP is a standard part of SSH-2 package. SCP is a standard part of SSH-1 package. You can also run both protocols on the latter SSH version. WinSCP supports both SSH-1 and SSH-2. For authentication, you can use user name and password or [[public key]] (RSA or DSA). Other authorization types include TIS, Cryptocard, Keyboard-interactive, and Kerberos. | ||
| + | |||
| + | For FTP, only basic FTP is supported. Secure alternatives (FTP over SSL) are not supported. Neither are compressed transfers (Zlib). | ||
| ===== [[sftp]] SFTP Requirements ===== | ===== [[sftp]] SFTP Requirements ===== | ||
| For SFTP, the only requirement beyond the server requirements above is to run SFTP on the server. It is best to run it as a SSH-2 subsystem. If you select SFTP-only on the login screen and the SFTP subsystem is not found, WinSCP will try to find the SFTP server in some common directories (''/usr/lib/sftp-server'', ''/usr/local/lib/sftp-server'', etc.). This way, it is possible to use SFTP even with SSH-1, which does not support subsystems. | For SFTP, the only requirement beyond the server requirements above is to run SFTP on the server. It is best to run it as a SSH-2 subsystem. If you select SFTP-only on the login screen and the SFTP subsystem is not found, WinSCP will try to find the SFTP server in some common directories (''/usr/lib/sftp-server'', ''/usr/local/lib/sftp-server'', etc.). This way, it is possible to use SFTP even with SSH-1, which does not support subsystems. | ||
| - | 5455---- | + | ===== [[scp]] SCP Requirements ===== |
| - | - ====== Ordered List Item ====== | + | To transfer files, ''scp1'' is used (it is called from within ''scp''). If only ''scp2'' is allowed on your server, check the //[[ui_login_scp#other_options|Use scp2 with scp1 compatibility]]// option on the [[ui_login_scp|SCP/Shell tab]] in the Login dialog. |
| + | |||
| + | For correct functionality, you must do the following. The ''bash'' shell is recommended for working with WinSCP. If your default shell doesn't work with WinSCP, you can make WinSCP use [[ui_login_scp#shell|other shell]]. | ||
| + | |||
| + | For its operation, WinSCP needs several commands: ''cd'', ''chgrp'', ''chmod'', ''chown'', ''echo'', ''groups'', ''ls'', ''mkdir'', ''mv'', ''pwd'', ''scp'', ''rm'', ''ln'', ''unalias'' and ''unset''. These commands have to be placed in the path and user must have sufficient permissions to execute them. WinSCP expects "standard" behavior of these commands. You can avoid needing these commands by not using some of WinSCP functions (''mkdir'', ''chown'', ''ln'', etc.) or by changing some configuration options (''groups'', ''unalias'' and ''unset''). | ||
| + | |||
| + | Just after establishing the connection with server, all [[ui_login_scp#other_options|aliases on the above commands are cleared]]. This helps avoid unexpected behavior. | ||
| + | |||
| + | Another precondition is that the output of all commands is in English. This mostly concerns names of months in directory listings (''ls -la''). Because of this, WinSCP [[ui_login_scp#other_options|clears all user variables that govern command output]] after login. If command output also reflects some other server settings, it may be necessary to change this before WinSCP can be used. | ||
| + | |||
| + | The last necessary condition is the proper output of ''ls -la'' command. Particularly standard number and ordering of the columns. If the default output does not satisfy WinSCP need, you can use //[[ui_login_scp#directory_listing|Listing command]]// option on the //SCP/Shell tab// in the Login dialog to modify it. | ||
| + | WinSCP will attempt detect support for ''%%--full-time%%'' switch of the ''ls'' command. If the detection causes you problems, you can [[ui_login_scp#directory_listing|disable]] it. | ||
| ===== Using WinSCP with Restricted Shell Environments ===== | ===== Using WinSCP with Restricted Shell Environments ===== | ||