Changeset 741 for extensions/net.sf.basedb.ftp/trunk/README

Timestamp:

Aug 13, 2008, 1:17:55 PM (14 years ago)

Author:

Nicklas Nordborg

Message:

References #114. Upgrading to 1.0.0-M2 release of Apache FTP server.

File:

• extensions/net.sf.basedb.ftp/trunk/README (modified) (4 diffs)

extensions/net.sf.basedb.ftp/trunk/README

@@ -7 +7 @@
 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
+uses beta 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
@@ -16 +16 @@
    http://baseplugins.thep.lu.se/wiki/net.sf.basedb.ftp
  * The Apache FTP server site: 
-   http://mina.apache.org/ftpserver.html
+   http://mina.apache.org/ftpserver/index.html
 
 == Installation ==
@@ -22 +22 @@
  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
-    
+ 3. Copy the `ftp-config.xml` file to `WEB-INF/classes` directory.
+ 4. The default `ftp-config.xml` file creates a regular FTP service with the
+    control connection on port 2121. There is also an example of an
+    SSL-enabled configuration. For more information about configuration 
+    options see: http://mina.apache.org/ftpserver/documentation.html  
  5. Copy the `base-ftpserver.jar` file and the `lib` directory, including sub-
     directories and files, to your BASE extensions directory, `WEB-INF/extensions`.
@@ -48 +40 @@
  8. Done.
 
-== Known issues / limitation ==
+== Known issues ==
 
- * 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.
+
+== Tips and tricks ==
+
+ * If you want to try out an SSL enabled FTP server, but doesn't have
+   a certificate, you may create one with the following command:
+   
+   `keytool -genkey -keystore test.jks -storetype JKS -storepass test -keypass test  -alias test`
 
 == Compiling ==