Line 1: |
Line 1: |
− | ==Intent== | + | ==Introduction== |
− | SME Server requires an encrypted connection (like SFTP and SCP) to do file management.
| |
| | | |
− | Ibays can be accessed with unencrypted FTP if they are configured that way in the server-manager.
| + | This document describes how to configure SFTP/FTP client software packages (Windows & Linux) for use with SME Server. |
| | | |
− | This HowTo will show you clients for this together with some tips and tricks.
| + | The primary function of a SFTP/FTP client software is, secure file transfer between a local (client) and a remote (server) computer. |
| | | |
− | ==Remote access==
| + | Beyond this, some SFTP/FTP clients offer various features such as basic file manager, file synchronization and integrated file editing functionality. |
− | If you need remote access (e.g. over internet) to your server, SME Server requires some additional configuration for use with SFTP/ FTP clients like WinSCP.
| |
| | | |
− | Information on configuring SME Server for Remote access can be found in the [[SME_Server:Documentation:Administration_Manual:Chapter11#Security|SME Server Administration Manual]].
| + | For secure transfers, SFTP/FTP clients use Secure Shell [http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol (SSH)] and support the [http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol SCP] protocol in addition to [http://en.wikipedia.org/wiki/SFTP SFTP]. |
| | | |
− | ==WinSCP== | + | ==Additional Information== |
− | WinSCP is an open source free sFTP client and FTP client for Windows. Legacy SCP protocol is also supported. Its main function is safe copying of files between a local and a remote computer.
| + | |
| + | *[http://en.wikipedia.org/wiki/Comparison_of_SSH_clients Comparison of some of the more popular SSH clients] |
| + | |
| + | * See Also [[FTP Access to Ibays]] |
| + | |
| + | ==Editors== |
| + | There are many basic and advanced editors that can be used with SFTP/FTP client software packages to provide remote editing functionality. |
| + | Example integration is included with each SFTP/FTP client software package below. |
| + | |
| + | IF you use an editor that you think others might enjoy, then please feel free to list them below and thank you. |
| + | |
| + | *[http://notepad-plus.sourceforge.net/uk/site.htm notepad-plus] Multi-Tabbed Linux or Windows editor. |
| + | |
| + | *[http://www.liquidninja.com/metapad/download.html MetaPad] A NotePad work alike Single-Window for use in editing Linux or Windows files. Note: NotePad should not be used to edit Linux files. |
| + | |
| + | ==Configuring SME Server== |
| + | SME Server requires some additional "Remote Access" configuration for use with all SFTP/FTP client software. |
| + | It is important at this point to decide if you will need Remote (internet) Access or Local Lan access only, for your SFTP/ FTP remote client. |
| + | Information on configuring SME Server for "Remote Access" can be found in the [[SME_Server:Documentation:Administration_Manual:Chapter11#Security|SME Server Administration Manual]]. |
| + | |
| + | *SFTP (port 22) is the preferred protocol for use with SME Server. |
| + | *If your FQDN (hostname) resolution is setup and working you can substitute the [IP.of.your.server] with your FQDN (hostname). |
| + | |
| + | ==Cautionary Notes== |
| + | * Enabling "Remote (internet) Access" on SME Server imposes an additional Network Security Risk to SME Server and any associated networks. |
| + | *Therefore, one should read all documentation and corporate policies carefully and understand the Network Security risks involved as they apply to your particular situation and or network configuration. |
| + | *'''It is highly advised to have Written Authorization before enabling "Remote (internet) Access" on any server you do not have authoritative control.''' |
| + | *Most countries have implemented specific laws regarding Remote System Access as well as most companies having specific Remote System Access policies. |
| + | *If your doing business with a company without a written policy, you should work closely with them to develop a written policy before you enable "Remote (internet) Access" on their system. |
| | | |
− | ===Download & Install WinSCP=== | + | *There is a very fine line between "someone authorized, employee or contractor" and a "not authorized hacker". |
| + | *It is very important to have proper written authorization in your possession (employee or contractor) to avoid any possible legal ramifications. CYA |
| + | *"Remote (internet) Access" should be diligently maintained and or disabled when not being used. |
| + | |
| + | ==Windows Clients== |
| + | |
| + | ===WinSCP=== |
| + | [http://winscp.net/eng/index.php WinSCP] is an open source free sFTP/FTP client for Windows and the prefered choice for remote file management and editing. [http://winscp.net/eng/docs/start WinSCP documentation.] |
| + | |
| + | Legacy SCP protocol is also supported. Its main function is safe copying of files between a local and a remote computer. |
| + | |
| + | ====Download & Install WinSCP==== |
| # Download the Windows installer from the [http://winscp.net/eng/download.php WinSCP Download Page]. | | # Download the Windows installer from the [http://winscp.net/eng/download.php WinSCP Download Page]. |
| # After successfully downloading the file execute it to install the program, your best bet is to run a typical install. | | # After successfully downloading the file execute it to install the program, your best bet is to run a typical install. |
− | # After the installation we also can install PuTTy, which can be downloaded [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html here]. Save the putty.exe file in the WinSCP folder tree C:\Program Files\WinSCP\PuTTY | + | # After the installation of WinSCP we also can also integrate [http://en.wikipedia.org/wiki/PuTTY PuTTY], which can be downloaded [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html here]. Save the putty.exe file in the WinSCP folder tree C:\Program Files\WinSCP\PuTTY |
| | | |
− | ===Configuring PuTTy Integration=== | + | ====Configuring PuTTy Integration==== |
| | | |
− | PuTTY is a free implementation of Telnet and SSH for Win32 and Unix platforms, along with an xterm terminal emulator. | + | [http://en.wikipedia.org/wiki/PuTTY PuTTY] is a free implementation of Telnet and SSH for Win32 and Unix platforms, along with an xterm terminal emulator. |
| | | |
| # Open WinSCP | | # Open WinSCP |
Line 30: |
Line 67: |
| # When done click OK. | | # When done click OK. |
| | | |
− | Putty can also be used as standalone ssh-client to execute terminal commands on the server.
| + | ====Choosing a Preferred Editor==== |
− | | + | WinSCP allows for defining preferred editors based on file extensions to add, remove, '''edit''' remote files. |
− | ===Choosing a Preferred Editor=== | |
− | WinSCP allows for defining preferred editors based on file extensions, to add, edit, remove Editor Preferences: | |
| # Open WinSCP | | # Open WinSCP |
| # Select Preferences from the left tree | | # Select Preferences from the left tree |
Line 41: |
Line 76: |
| # Within the Add Editor popup window make the appropriate changes and select the OK button | | # Within the Add Editor popup window make the appropriate changes and select the OK button |
| | | |
− | ===Using WinSCP=== | + | ====Using WinSCP==== |
| The first time use of WinSCP requires connection information to login to your server: | | The first time use of WinSCP requires connection information to login to your server: |
| # Start WinSCP | | # Start WinSCP |
| # Enter the hostname or IP number of your server | | # Enter the hostname or IP number of your server |
| # Set the port number to 22. | | # Set the port number to 22. |
− | # Enter your credentials (root username and password) Note: The root password is the same as the admin password unless you have changed the admin password. | + | # Enter your credentials (username=root and associated password). The root password is the same as the admin password unless you have changed the admin password. |
| # Click Save | | # Click Save |
| # Click Login | | # Click Login |
| | | |
| + | ===FileZilla=== |
| + | {{Incomplete}} |
| + | [http://filezilla-project.org/index.php FileZilla] is an open source free sFTP/FTP client for Windows. [http://wiki.filezilla-project.org/Documentation FileZilla documentation.] |
| | | |
− | ==Nautilus== | + | ====Download & Install FileZilla==== |
− | This program is the standard graphical file manager in many Linux distributions and it supports several protocols, including FTP and SFTP.
| + | # Download the Windows installer from the [http://filezilla-project.org/download.php FileZilla Download Page]. |
| + | # After successfully downloading the file execute it to install the program, your best bet is to run a typical install. |
| | | |
− | If you omit the [:port], it uses the default one. If your name resolution works you can replace [IP.of.your.server] with a hostname. [root] can be replaced with any valid username.
| + | ====Using FileZilla==== |
| + | The first time use of FileZilla requires connection information to login to your server: |
| + | # Start FileZilla |
| + | # Enter the hostname or IP number of your server |
| + | # Set the port number to 22. |
| + | # Enter your credentials (username=root and your associated password). The root password is the same as the admin password unless you have changed the admin password. |
| | | |
− | To connect to your server with SFTP (default port 22):
| + | ===SmartFTP=== |
− | sftp://root@IP.of.your.server:port/
| + | {{Incomplete}} |
− | To connect to your server with FTP (default port 21):
| + | [http://www.smartftp.com/ SmartFTP] is a 30-day trail sFTP/FTP client for Windows. |
− | ftp://root@IP.of.your.server:port/
| + | [http://www.smartftp.com/ftplib/documentation/html/frames.html SmartFTP documentation] |
| | | |
− | ==FileZilla== | + | ====Download & Install SmartFTP==== |
− | {{Incomplete}}
| + | # Download the Windows installer from the [http://www.smartftp.com/download/ SmartFTP Download Page]. |
− | This program can be downloaded [http://filezilla-project.org/download.php here].
| + | # After successfully downloading the file execute it to install the program, your best bet is to run a typical install. |
| | | |
− | ==SmartFTP== | + | ====Using SmartFTP==== |
− | {{Incomplete}}
| + | The first time use of SmartFTP requires connection information to login to your server: |
− | This program can be downloaded [http://www.smartftp.com/download/ here].
| + | # Start SmartFTP |
| + | # Enter the hostname or IP number of your server |
| + | # Set the port number to 22. |
| + | # Enter your credentials (username=root and your associated password). The root password is the same as the admin password unless you have changed the admin password. |
| | | |
− | ==Additional Information== | + | == Other Windows SFTP Clients == |
− | *[[FTP Access to Ibays]]
| |
| | | |
− | *[http://en.wikipedia.org/wiki/SFTP wikipedia.org SFTP] | + | *[http://www.enginsite.com/ssh-webdav-ftp-sftp-client.htm DataFreeway] |
| | | |
− | There are many editors that can be used with WinSCP.
| + | ==Linux Clients== |
| + | ===Nautilus=== |
| + | {{Incomplete}} |
| + | [http://live.gnome.org/Nautilus Nautilus] is a popular graphical file manager available in many Linux distributions and supports several protocols, FTP and SFTP. |
| | | |
− | IF you use an editor that you think others might enjoy then list it below and thank you.
| + | To connect to your server with SFTP (default port 22): |
| + | sftp://root@IP.of.your.server:port/ |
| + | To connect to your server with FTP (default port 21): |
| + | ftp://root@IP.of.your.server:port/ |
| | | |
− | *[http://notepad-plus.sourceforge.net/uk/site.htm notepad-plus]
| + | Notes: |
| | | |
− | *[http://www.liquidninja.com/metapad/download.html MetaPad]
| + | # If you omit the [:port], Nautilus will use it's default port setting. |
| + | # [root] can be replaced with any valid username. |
| | | |
| ---- | | ---- |
| [[Category:Howto]] | | [[Category:Howto]] |