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 12:35:26 UTC
svn commit: r1391386 - in /mina/site/trunk: content/ftpserver/
templates/ftpserver/
Author: apaliwal
Date: Fri Sep 28 10:35:25 2012
New Revision: 1391386
URL: http://svn.apache.org/viewvc?rev=1391386&view=rev
Log:
Moved few more ftpserver pages
Added:
mina/site/trunk/content/ftpserver/
mina/site/trunk/content/ftpserver/building.mdtext
mina/site/trunk/content/ftpserver/embedding_ftpserver.mdtext
mina/site/trunk/content/ftpserver/getting_source.mdtext
mina/site/trunk/content/ftpserver/index.mdtext
mina/site/trunk/content/ftpserver/mailing_list.mdtext
mina/site/trunk/content/ftpserver/releasing.mdtext
mina/site/trunk/content/ftpserver/running_ftpserver_standalone.mdtext
mina/site/trunk/templates/ftpserver/page.html
Added: mina/site/trunk/content/ftpserver/building.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/building.mdtext?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/building.mdtext (added)
+++ mina/site/trunk/content/ftpserver/building.mdtext Fri Sep 28 10:35:25 2012
@@ -0,0 +1,52 @@
+Title: Building
+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.
+
+
+# Building
+
+You need [Subversion](http://svnbook.red-bean.com/) to [check out the source code](http://apache.org/dev/version-control.html) from [our source code repository](sources.html), and [Maven 2](http://maven.apache.org/download.html) to build the source code. Currently, Maven 2.0.5 or 2.0.7 or newer is required for the build.
+
+The following example shows how to build the trunk.
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn co http://svn.apache.org/repos/asf/mina/ftpserver/trunk/ ftpserver
+$ cd ftpserver
+$ mvn install
+</PRE>
+</DIV></DIV>
+
+If you run into any problems running these steps, please report on the [mailing lists](mailing_list.html)
+
+If you want to generate Eclipse project files, run:
+
+<P>If you want to generate Eclipse project files, run:</P>
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ mvn eclipse:eclipse # Generate Eclipse project files if you want
+</PRE>
+</DIV></DIV>
+
+To generate to distribution packages, including shell scripts and example configuration, run:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>cd distribution
+$ mvn package
+</PRE>
+</DIV></DIV>
+
+The build requires a minimum Java 1.5 JDK to compile.
+
Added: mina/site/trunk/content/ftpserver/embedding_ftpserver.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/embedding_ftpserver.mdtext?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/embedding_ftpserver.mdtext (added)
+++ mina/site/trunk/content/ftpserver/embedding_ftpserver.mdtext Fri Sep 28 10:35:25 2012
@@ -0,0 +1,85 @@
+Title: Embedding FtpServer in 5 minutes
+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.
+
+
+# Embedding FtpServer in 5 minutes
+
+FtpServer is designed to be easily embedded into your application. Getting a basic server up and running is as simple as
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+FtpServerFactory serverFactory = <SPAN class="code-keyword">new</SPAN> FtpServerFactory();
+FtpServer server = serverFactory.createServer();
+<SPAN class="code-comment">// start the server
+</SPAN>server.start();
+</PRE>
+</DIV></DIV>
+
+To get this running, you need the following JAR files in your classpath:
+
+* mina-core, 2.0-M3 or later
+* slf4j-api
+* A SLF4J implementation of your choice, for example slf4j-simple-1.5.3.jar
+* ftplet-api
+* ftpserver-core
+
+Now, you will probably like to configure the server for your specific needs. For example, you might want to run on a non-privileged port to get around running as a root on Linux/Unix. To do that you need to configure a listener. Listeners are the part of FtpServer where network management is done. By default, a listener named "default" is created but you can add as many listeners as you like, for example to provide one for use outside of your firewall and one on the inside.
+
+Now, let's configure the port on which the default listener waits for connections.
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+FtpServerFactory serverFactory = new FtpServerFactory();
+ListenerFactory factory = new ListenerFactory();
+// set the port of the listener
+factory.setPort(2221);
+// replace the default listener
+serverFactory.addListener("default", factory.createListener());
+// start the server
+FtpServer server = serverFactory.createServer();
+server.start();
+</PRE>
+</DIV></DIV>
+
+Now, let's make it possible for a client to use FTPS (FTP over SSL) for the default listener.
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+FtpServerFactory serverFactory = new FtpServerFactory();
+ListenerFactory factory = new ListenerFactory();
+// set the port of the listener
+factory.setPort(2221);
+// define SSL configuration
+SslConfigurationFactory ssl = new SslConfigurationFactory();
+ssl.setKeystoreFile(new File("src/test/resources/ftpserver.jks"));
+ssl.setKeystorePassword("password");
+// set the SSL configuration for the listener
+factory.setSslConfiguration(ssl.createSslConfiguration());
+factory.setImplicitSsl(true);
+// replace the default listener
+serverFactory.addListener("default", factory.createListener());
+PropertiesUserManagerFactory userManagerFactory = new PropertiesUserManagerFactory();
+userManagerFactory.setFile(new File("myusers.properties"));
+serverFactory.setUserManager(userManagerFactory.createUserManager());
+// start the server
+FtpServer server = serverFactory.createServer();
+server.start();
+</PRE>
+</DIV></DIV>
+
+There you have it, that's the basics that you usually need. For more advanced features, have a look at our configuration documentation.
Added: mina/site/trunk/content/ftpserver/getting_source.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/getting_source.mdtext?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/getting_source.mdtext (added)
+++ mina/site/trunk/content/ftpserver/getting_source.mdtext Fri Sep 28 10:35:25 2012
@@ -0,0 +1,72 @@
+Title: Getting 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](http://tortoisesvn.tigris.org/) 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/index.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/index.mdtext?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/index.mdtext (added)
+++ mina/site/trunk/content/ftpserver/index.mdtext Fri Sep 28 10:35:25 2012
@@ -0,0 +1,24 @@
+Title: FtpServer
+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.
+
+
+# Apache FtpServer
+
+## Documentation
+
+
Added: mina/site/trunk/content/ftpserver/mailing_list.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/mailing_list.mdtext?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/mailing_list.mdtext (added)
+++ mina/site/trunk/content/ftpserver/mailing_list.mdtext Fri Sep 28 10:35:25 2012
@@ -0,0 +1,95 @@
+Title: Mailing Lists
+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.
+
+
+# Mailing List
+
+General information about the FtpServer mailing lists can be found here.
+
+## For Users
+
+Please use this list for any questions regarding how to use FtpServer in your application.
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Subscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:ftpserver-users-subscribe@mina.apache.org" class="external-link" rel="nofollow">ftpserver-users-subscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Unsubscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:ftpserver-users-unsubscribe@mina.apache.org" class="external-link" rel="nofollow">ftpserver-users-unsubscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Post </TH>
+<TD class="confluenceTd"> <A href="mailto:ftpserver-users@mina.apache.org" class="external-link" rel="nofollow">ftpserver-users@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Archive </TH>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/ftpserver-users@mina.apache.org/" class="external-link" rel="nofollow">http://www.mail-archive.com/ftpserver-users@mina.apache.org/</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+## For Developers
+
+We use the MINA developers list for asking technical questions, discussing feature suggestions or general questions regarding the project.
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Subscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:dev-subscribe@mina.apache.org" class="external-link" rel="nofollow">dev-subscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Unsubscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:dev-unsubscribe@mina.apache.org" class="external-link" rel="nofollow">dev-unsubscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Post </TH>
+<TD class="confluenceTd"> <A href="mailto:dev@mina.apache.org" class="external-link" rel="nofollow">dev@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Archive </TH>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/dev@mina.apache.org/" class="external-link" rel="nofollow">http://www.mail-archive.com/dev@mina.apache.org/</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+## Subversion commits
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Subscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:commits-subscribe@mina.apache.org" class="external-link" rel="nofollow">commits-subscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Unsubscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:commits-unsubscribe@mina.apache.org" class="external-link" rel="nofollow">commits-unsubscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Post </TH>
+<TD class="confluenceTd"> <A href="mailto:commits@mina.apache.org" class="external-link" rel="nofollow">commits@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Archive </TH>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/commits@mina.apache.org/" class="external-link" rel="nofollow">http://www.mail-archive.com/commits@mina.apache.org/</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
Added: mina/site/trunk/content/ftpserver/releasing.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/releasing.mdtext?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/releasing.mdtext (added)
+++ mina/site/trunk/content/ftpserver/releasing.mdtext Fri Sep 28 10:35:25 2012
@@ -0,0 +1,74 @@
+Title: Releasing
+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.
+
+
+# Releasing
+
+## Before calling a vote
+
+* Update the README.txt file
+* Copy trunk revision to branch
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>svn copy -m "Branching for release" -r <revision> https://svn.apache.org/repos/asf/mina/ftpserver/trunk/ https://svn.apache.org/repos/asf/mina/ftpserver/branches/<release version>
+svn co https://svn.apache.org/repos/asf/mina/ftpserver/branches/<release version>
+</PRE>
+</DIV></DIV>
+* Up version in trunk
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>mvn versions:set -DnewVersion=<next version>-SNAPSHOT -DgenerateBackupPoms=false
+svn -m "Increasing version for new development in trunk" commit
+</PRE>
+</DIV></DIV>
+* Update version in branch
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>mvn versions:set -DnewVersion=<release version> -DgenerateBackupPoms=false
+svn -m "Setting version for release of <release version>" commit
+</PRE>
+</DIV></DIV>
+* mvn -Papache-release clean deploy
+* Close staging repository on http://repository.apache.org
+* Gather distribution files and upload to people.apache.org
+* Start vote
+
+## After a successful vote
+
+* Update site,
+* Run the auto-export plugin (else the news on the first page won't be updated correctly)
+* Wait until replication to /www/confluence-exports/FTPSERVER has run
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>/home/ngn/ftpserver-zip.sh
+</PRE>
+</DIV></DIV>
+* Upload XML schema
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>scp core/src/main/resources/org/apache/ftpserver/config/spring/ftpserver-1.0.xsd <username>@people.apache.org:/www/mina.apache.org/ftpserver
+</PRE>
+</DIV></DIV>
+* Build and tag
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>mvn -Papache-release clean deploy
+svn move -m "Tagging <release version>" https://svn.apache.org/repos/asf/mina/ftpserver/branches/<release version> https://svn.apache.org/repos/asf/mina/ftpserver/tags/<release version>
+</PRE>
+</DIV></DIV>
+* Upload to people.apache.org /www/www.apache.org/dist/mina/ftpserver
+* Release in JIRA
+* Update MINA site (add news and update latest downloads in navigation)
+* Wait for mirrors to sync
+* Send out announcement
+
+Run script to create documentation ZIP file, on people.apache.org
Added: mina/site/trunk/content/ftpserver/running_ftpserver_standalone.mdtext
URL: http://svn.apache.org/viewvc/mina/site/trunk/content/ftpserver/running_ftpserver_standalone.mdtext?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/content/ftpserver/running_ftpserver_standalone.mdtext (added)
+++ mina/site/trunk/content/ftpserver/running_ftpserver_standalone.mdtext Fri Sep 28 10:35:25 2012
@@ -0,0 +1,73 @@
+Title: FtpServer
+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.
+
+
+# Running FtpServer stand-alone in 5 minutes
+
+To get FtpServer up and running in stand-alone mode, you need to have a full distribution. Check out to build the source code and make sure you include the build for the distribution module
+
+## Installing
+
+Now you should have a ZIP or TARed file with the entire distribution. Let's go.
+
+First of all, unpack it. If you're on Linux/Unix, you can use:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>tar -xzvf ftpserver-1.0.0.tar.gz
+</PRE>
+</DIV></DIV>
+
+On Windows and Linux/Unix, you can use any ZIP tool, like [7-zip](http://www.7-zip.org/) or [Gnome File Roller](http://fileroller.sourceforge.net/) to unzip the file at a location of your liking.
+
+## Running a basic server
+
+Now, open a shell/command prompt where you unpacked the files. On Linux/Unix, run:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>bin/ftpd.sh
+</PRE>
+</DIV></DIV>
+
+On Windows, the same command is:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>bin/ftpd.bat
+</PRE>
+</DIV></DIV>
+
+FtpServer should now start as expected and you should be able to use a FTP client to access the server at localhost on port 21. The default .
+
+Note that on Linux this command will require root privileges as it tried to listen on port 21, something only root can do. If you're not root, you will get an exception saying "java.net.SocketException: Permission denied". Let's have a look at how to solve this without running as root.
+
+## Configuring
+
+In the res/conf directory in the unpackaged directory you will find some example configuration files. For this tutorial, we will use the ftpd-typical.xml configuration file. It will set the listener port to 2121, thus fixing the issue with not being able to run the server as non-root on Linux. It will also use a provided user database, allowing logging in as admin (password admin) or anonymous. To run, on Linux/Unix:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>bin/ftpd.sh res/conf/ftpd-typical.xml
+</PRE>
+</DIV></DIV>
+
+On Windows:
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>bin/ftpd.bat res/conf/ftpd-typical.xml
+</PRE>
+</DIV></DIV>
+
+That's it. Now you can configure the server to your likings. Have a look at either the ftpd-full.xml example or the configuration documentation. You can also set up FtpServer to run as a service on Windows or daemon on Linux/Unix.
Added: mina/site/trunk/templates/ftpserver/page.html
URL: http://svn.apache.org/viewvc/mina/site/trunk/templates/ftpserver/page.html?rev=1391386&view=auto
==============================================================================
--- mina/site/trunk/templates/ftpserver/page.html (added)
+++ mina/site/trunk/templates/ftpserver/page.html Fri Sep 28 10:35:25 2012
@@ -0,0 +1,11 @@
+{% extends "header.html" %}
+ {% block css %}
+ <link href="{{base}}css/common.css" rel="stylesheet" type="text/css">
+ <link href="{{base}}css/mina.css" rel="stylesheet" type="text/css">
+ {% endblock %}
+{% endextends %}
+
+{% block content %}{{ content|markdown }}{% endblock %}
+{{ headers.test }}
+
+{% include "footer.html" %}