You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mina.apache.org by ap...@apache.org on 2012/09/28 13:29:17 UTC

svn commit: r1391401 - in /mina/site/trunk/content/ftpserver: contributors.mdtext features.mdtext getting_involved.mdtext home.mdtext related_project.mdtext reporting_bug.mdtext source.mdtext testimonials.mdtext

Author: apaliwal
Date: Fri Sep 28 11:29:16 2012
New Revision: 1391401

URL: http://svn.apache.org/viewvc?rev=1391401&view=rev
Log:
More ftpserver pages moved

Added:
    mina/site/trunk/content/ftpserver/contributors.mdtext
    mina/site/trunk/content/ftpserver/features.mdtext
    mina/site/trunk/content/ftpserver/getting_involved.mdtext
    mina/site/trunk/content/ftpserver/home.mdtext
    mina/site/trunk/content/ftpserver/related_project.mdtext
    mina/site/trunk/content/ftpserver/reporting_bug.mdtext
    mina/site/trunk/content/ftpserver/source.mdtext
    mina/site/trunk/content/ftpserver/testimonials.mdtext

Added: mina/site/trunk/content/ftpserver/contributors.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/contributors.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/contributors.mdtext (added)
+++ mina/site/trunk/content/ftpserver/contributors.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,31 @@
+Title: Contributors
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Contributors
+
+## Commiters
+
+The following is a list of developers with commit privileges that have directly contributed to the project in one way or another.
+
+* Rana Battacharyya
+* Paul Hammant
+* [Niklas Gustavsson](http://protocol7.com/)
+* Sergey M Vladimirov
+* Sai Pullabhotla
+* David Latorre

Added: mina/site/trunk/content/ftpserver/features.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/features.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/features.mdtext (added)
+++ mina/site/trunk/content/ftpserver/features.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,36 @@
+Title: Features
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Features
+
+* 100% pure Java, free, open source resumable FTP server
+* Multi platform support and multithreaded design.
+* User virtual directory, write permission, idle time-out and upload/download bandwidth limitation support.
+* Anonymous login support.
+* Both upload and download files are resumable.
+* Handles both ASCII and binary data transfers.
+* IP restriction support to ban IPs.
+* Database and file can be used to store user data.
+* All the FTP messages are customizable.
+* Implicit/explicit SSL/TLS support.
+* MDTM support - your users can change the date-time stamp of files.
+* "MODE Z" support for faster data upload/download.
+* Custom user manager, IP restrictor, logger can be added easily.
+* User event notifications can be added (Ftplet).
+

Added: mina/site/trunk/content/ftpserver/getting_involved.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/getting_involved.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/getting_involved.mdtext (added)
+++ mina/site/trunk/content/ftpserver/getting_involved.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,27 @@
+Title: Getting Involved
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Getting Involved
+
+Apache FtpServer communicates using our [Mailing Lists](mailing_list.html). If you have any questions, feedback or suggestions, you're very welcome to join the list and send an email. We are also happy to receive [bug reports and feature requests in our JIRA](https://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=FTPSERVER&title=Reporting%20a%20Bug%20in%20FtpServer&linkCreation=true&fromPageId=82723).
+
+# Patches
+
+The best chance of getting your bug or feature fixed is to provide a patch, if they fit our goals we will usually have them commited within a few days. The Apache Contributors page has excellent {information on how to produce patches](http://apache.org/dev/contributors.html#patches).
+

Added: mina/site/trunk/content/ftpserver/home.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/home.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/home.mdtext (added)
+++ mina/site/trunk/content/ftpserver/home.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,37 @@
+Title: Home
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Welcome to Apache FtpServer
+
+## Overview
+
+The Apache FtpServer is a 100% pure Java FTP server. It's designed to be a complete and portable FTP server engine solution based on currently available open protocols. FtpServer can be run standalone as a Windows service or Unix/Linux daemon, or embedded into a Java application. We also provide support for integration within [Spring](http://springframework.org/) applications and provide our releases as OSGi bundles.
+
+The default network support is based on [Apache MINA](http://mina.apache.org/), a high performance asynchronous IO library. Using MINA, FtpServer can scale to a large number of concurrent users.
+
+It is also an FTP application platform. We have developed a Java API to let you write Java code to process FTP event notifications that we call the Ftplet API. Apache FtpServer provides an implementation of an FTP server to support this API.
+
+To get started, have a look at one of our tutorials:
+
+* [Embedding FtpServer in 5 minutes](embedding_ftpserver.html)
+* [Running FtpServer stand-alone in 5 minutes](running_ftpserver_standalone.html)
+
+You can also have a look at the documentation for how to configure FtpServer to suite your needs.
+
+

Added: mina/site/trunk/content/ftpserver/related_project.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/related_project.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/related_project.mdtext (added)
+++ mina/site/trunk/content/ftpserver/related_project.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,34 @@
+Title: Related Projects
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Related Projects
+
+## [Milton WebDAV over FTP](http://milton.ettrema.com/index.html)
+
+Using FtpServer to provide FTP support in the WebDAV server Milton. This means that for each resource managed by Milton, you can configure so that it is available both over WebDAV/HTTP and FTP.
+
+## [VFS FTPServer Bridge](http://vfs-utils.sourceforge.net/ftpserver/index.html)
+
+This project provides an Apache Commons VFS implementation for the Apache FTPServer project. Instead of working only on local files, with this VFS bridge you can connect to any VFS provider. You can still use a local file system, but you can also use a ZIP file, loop through to another FTP server, or use any other available VFS implementation such as DctmVFS.
+
+## [HDFS over FTP](https://sites.google.com/a/iponweb.net/hadoop/Home/hdfs-over-ftp)
+
+FTP server which works on a top of HDFS. It aAllows to connect to HDFS using any FTP client. FTP server is configurable by hdfs-over-ftp.conf and users.conf. Also it allows to use secure connection over SSL and supports all HDFS permissions
+
+

Added: mina/site/trunk/content/ftpserver/reporting_bug.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/reporting_bug.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/reporting_bug.mdtext (added)
+++ mina/site/trunk/content/ftpserver/reporting_bug.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,35 @@
+Title: Reporting Bugs
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Reporting a Bug
+
+We are using JIRA to track all FtpServer issues including bugs. Please visit our [issue tracker page](http://issues.apache.org/jira/browse/FTPSERVER) to report a bug. 
+
+## How to report a bug
+
+Writing a bug report with detailed information will help us to fix your problem sooner.
+
+* Make sure if the bug you are going to report doesn't exist yet.
+* Attaching JUnit test case which reproduces the problem will put your report in our highest priority.
+* Attach full thread stack dump if you suspect a dead lock.
+* Attach full heap dump if you suspect a memory leak.
+* Specify the environment in detail as much as possible.
+    * Operating system version, distribution, architecture, ...
+    * JVM vendor, version, build number, command line arguments, ...
+    * Network settings

Added: mina/site/trunk/content/ftpserver/source.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/source.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/source.mdtext (added)
+++ mina/site/trunk/content/ftpserver/source.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,78 @@
+Title: Source
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Source
+
+## Overview
+
+This project uses Subversion to manage its source code. Instructions on Subversion use can be found at http://svnbook.red-bean.com/. If you are on Windows, the excellent TortoiseSVN client is highly recommended.
+
+## Web Access
+
+The following is a link to the [online source repository](http://svn.apache.org/viewvc/mina/ftpserver).
+
+## Anonymous access
+
+The source can be checked out anonymously from SVN with this command:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn checkout http://svn.apache.org/repos/asf/mina/ftpserver/trunk ftpserver
+</PRE>
+</DIV></DIV>
+
+## Developer access
+
+Everyone can access the Subversion repository via HTTPS, but Committers must checkout the Subversion repository via HTTPS.
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn checkout https://svn.apache.org/repos/asf/mina/ftpserver/trunk ftpserver
+</PRE>
+</DIV></DIV>
+
+To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn commit --username your-username -m "A message"
+</PRE>
+</DIV></DIV>
+
+## Access from behind a firewall
+
+For those users who are stuck behind a corporate firewall which is blocking http access to the Subversion repository, you can try to access it via the developer connection:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn checkout https://svn.apache.org/repos/asf/mina/ftpserver/trunk ftpserver
+</PRE>
+</DIV></DIV>
+
+## Access through a proxy
+
+The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The files location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)
+
+There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.
+
+Example : Edit the 'servers' file and add something like :
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>[global]
+http-proxy-host = your.proxy.name
+http-proxy-port = 3128
+</PRE>
+</DIV></DIV>
+

Added: mina/site/trunk/content/ftpserver/testimonials.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/testimonials.mdtext?rev=1391401&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/testimonials.mdtext (added)
+++ mina/site/trunk/content/ftpserver/testimonials.mdtext Fri Sep 28 11:29:16 2012
@@ -0,0 +1,28 @@
+Title: Testimonials
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+
+# Testimonials
+
+__Daniel Frank__ says:
+
+> Apache FtpServer has proven to be a stable and reliable platform for our
+customers. It is easy to customize, and this was an important factor when
+deciding to use Apache FtpServer as the FTP server for our cloud based file
+sharing solution, [HostedFTP](HostedFTP)
+