Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
cloudappliance/sftpsetup [2019_11_12 11:58] dancloudappliance/sftpsetup [2020_01_14 15:42] dan
Line 1: Line 1:
 # FTP/SFTP Configuration # FTP/SFTP Configuration
-##### last updated: Nov122019+##### last updated: Jan142020
  
 The File Fabric Appliance and SaaS support a number of protocol gateways allowing applications to natively access the File Fabric using FTP/FTPS, SFTP or WebDAV. These are ideal for retrofitting existing applications for object storage. The File Fabric Appliance and SaaS support a number of protocol gateways allowing applications to natively access the File Fabric using FTP/FTPS, SFTP or WebDAV. These are ideal for retrofitting existing applications for object storage.
Line 14: Line 14:
  * [[cloudftp]]  * [[cloudftp]]
  * [[cloudappliance/appliance-troubleshooting|]]  * [[cloudappliance/appliance-troubleshooting|]]
 +
 +<WRAP center round info 100%>
 +CloudFTP and the File Fabric's other protocol gateways allow your client program to work with the File Fabric using the enabled protocol. Communication between the File Fabric and the underlying storage, however, still occurs using the storage protocol as implemented by the specific connector used to connect the File Fabric to the storage.
 +
 +For example, you may upload a file to SwiftStack through the File Fabric storage using the File Fabric's CloudFTP gateway, but the File Fabric will upload the file to the SwiftStack storage using the Swift protocol.  This means that the settings you chose when you attached the SwiftStack storage to the File Fabric will be used.
 +
 +Continuing with our example, if the file you are uploading is larger than the storage's single object size limit (often 5GB) then you will need to have either static large objects or dynamic large objects enabled in the provider settings.  Otherwise the upload will fail.
 +</WRAP>
  
 ## Initial Setup ## Initial Setup
Line 19: Line 27:
  
 <WRAP center round info 100%> <WRAP center round info 100%>
-Setting the domain name during [[cloudappliance:applinstallation|Appliance Installation]] allows **FTP** and **FTPS** to be be accessed through the domain name.  To access the File Fabric using **SFTP** through CloudFTP you must first manually reset the value of the serversme variable in /var/www/smestorage/ftpserver/sftpserver/sftpserver.conf to the File Fabric's domain name.+Setting the domain name during [[cloudappliance:applinstallation|Appliance Installation]] allows **FTP** and **FTPS** to be be accessed through the domain name.  To access the File Fabric using **SFTP** through CloudFTP when using a File Fabric version before v1906.04, you must first manually reset the value of the serversme variable in /var/www/smestorage/ftpserver/sftpserver/sftpserver.conf to the File Fabric's domain name
 + 
 +Additionally, you may find that it is necessary to regenerate the File Fabric's SFTP RSA keys before using **SFTP** to access the File Fabric with CloudFTP.  Instructions for doing that can be found later in this document.
 </WRAP> </WRAP>
  
Line 41: Line 51:
 ## Enabling the Service ## Enabling the Service
  
-The File Fabric's FTP/FTPS/SFTP service may not be enabled on installation.  To ensure that it is turned on and enabled, log in as smeconfiguser then become root and start and enable and start the service:+The File Fabric's FTP/FTPS/SFTP service may not be enabled on installation.  To ensure that it is turned on and enabled, log in as smeconfiguser then become root and enable and start the service:
  
 ``` ```
Line 48: Line 58:
 systemctl start cloudftp  systemctl start cloudftp 
 ``` ```
 +
 ## Using an Additional Subdomain ## Using an Additional Subdomain
  
Line 71: Line 82:
 ## Advanced FTP/FTPS Setup ## Advanced FTP/FTPS Setup
  
-Systems publicly exposing FTP based protocols might need additional setup to meet the needs of security administrations. Common changes are detailed below, for advanced changes contact SME Support.+Systems publicly exposing FTP based protocols might need additional setup to meet the needs of security administrators. Common changes are detailed below, for advanced changes contact SME Support.
  
 ### FTP configuration files ### FTP configuration files