source: extensions/net.sf.basedb.ftp/trunk/README @ 717

Requirements

1. BASE 2.8.0 or later.

Introduction

This package is an extension package to BASE that installs a small FTP server as part of the web server. The code in this package currently uses non-released software from the Apache foundation. Thus, we can't make any guarantee about functionality or stability of this extension. We recommend testing on a development server before using this software in a production environment. For the same reason we can't make any promises about API compatibility between releases. The API may change at any time.

• The homepage for this extension: ​http://baseplugins.thep.lu.se/wiki/net.sf.basedb.ftp
• The Apache FTP server site: ​http://mina.apache.org/ftpserver.html

Installation

1. Download the base-ftpserver-*.tar.gz file.
2. Unpack the downloaded file to a directory of your choice.
3. Copy the ftp.config file to WEB-INF/classes directory.
4. The default ftp.config file creates a regular FTP service with the control connection on port 2121 accepting connections from the local host only. To allow extenal connections the three settings listed below needs to be changed. It should work to change the 127.0.0.1 value to the ip number (using names doesn't seem to work) of your BASE server. For more information about configuration options see: ​http://mina.apache.org/ftpserver-documentation.html

• config.listeners.default.address
• config.listeners.default.data-connection.passive.address
• config.listeners.default.data-connection.passive.external-address

5. Copy the base-ftpserver.jar file and the lib directory, including sub- directories and files, to your BASE extensions directory, WEB-INF/extensions.
6. Run the Extensions -> Manual scan command to install the extension. If you have enabled automatic installation, just sit back and wait for it to find the FTP server extension.
7. The FTP Server should now be running, but it only allows the root user to login. To enable other users to login you have to start an FTP client, connect to your BASE FTP server and login as root. This will register the FTP server as a new client application that is shared to Everyone. To limit which users that can access the FTP server go to Adminstrate -> Clients and change the sharing options for the FTP Server.
8. Done.

Known issues / limitation

• It is not possible to specify a user-manager or file-system-manager in the ftp.config file. Those settings will be replaced by BASE-specific options.

• BASE allows that a directory has the same name as a file. This may confuse FTP clients since that is normally not allowed. The result for certain operations is undefined for files and directories that has the same name.

Compiling

To compile this package you also need:

1. Ant 1.6
2. Java 1.6

Follow these instructions:

1. Download the source code from the subversion repository. See ​http://baseplugins.thep.lu.se/wiki/net.sf.basedb.ftp for instructions.

2. Type ant download-lib to automatically download the BASE core JAR file that are neeed for compilation. You can also do this manually by copying the BASE2Core.jar and BASE2Webclient.jar from the BASE installation directory (<basedir>/www/WEB-INF/lib/) to the ./lib/compile directory.

3. Type ant to compile the code and generate the base-ftpserver.jar file in the project directory.

4. Use ant package to create a downloadable tar.gz package.

Tip: If you need different values for any of the properties defined in the 'build.xml' file, create a file named 'build.properties' and set the values there.