FTP Set-up and Troubleshooting

Ephox, November 2001

Summary

This article outlines the properties and methods that should be used to configure EditLive! for FTP support. It also looks at common problems and issues encountered.

More Information

FTP Set-up

Setting the Server

To set the FTP server there are only two EditLive! properties that need to be configured.

• FTPServer which configures the name of the FTP server you want to connect to, and
• WebRoot which configures the equivalent HTTP address for the FTP server.

For example, an FTP server may have an address of ftp.myserver.com and the equivalent WebRoot for this sever might be http://www.myserver.com.  If an FTP server has multiple users who use individual logins, the FTP server for a user named bob might be ftp.myserver.com but the WebRoot might be http://www.myserver.com/home/~bob.

 

editLive1.setFTPServerName('ftp.yourserver.com'); editLive1.setWebRoot('http://www.yourdomain.com');

FTP Username and Password

The FTP server login details can be set using the FTPUsername and FTPPassword properties. For example:

editLive1.setFTPUsername('joebloggs');
editLive1.setFTPPassword('drowssap');

Please note: It is not necessary to set the login details to the FTP server. If no username or password is specified then EditLive! will prompt the user for the details. It is also possible to set just the username so that the user is prompted for the password only.

FTP Port

If your FTP server is not running on port 21 then you must specify the port EditLive! will try to connect by using the FTPServerPort property.

editLive1.setFTPServerPort(19);

Please note: It is important that you do not enclose the port value in single quotes.

FTP Initial Directory

It is possible to specify a directory other than the one a user logs into as their root directory. An example of where this can be useful is if you are only using FTP for image insertion and you want to specify a special images directory for users. This is achieved using the FTPInitialDirectory property.

editLive1.setFTPInitialDirectory('images');
editLive1.setWebRoot('http://www.yourserver.com/images');

Please note: It is important to ensure any initial directory set is included in the WebRoot.

FTP Troubleshooting

EditLive! appears to hang when connecting or trying to load a file

If the FTP settings are incorrect or you are behind a firewall EditLive! may appear to hang. We suggest checking your FTP settings as well as trying to connect to the server using another FTP program and see if it is successful.