Modified: websites/staging/mina/trunk/content/ftpserver/running_ftpserver_standalone.html ============================================================================== --- websites/staging/mina/trunk/content/ftpserver/running_ftpserver_standalone.html (original) +++ websites/staging/mina/trunk/content/ftpserver/running_ftpserver_standalone.html Wed Oct 31 17:30:49 2012 @@ -112,35 +112,35 @@ <h2 id="installing">Installing</h2> <p>Now you should have a ZIP or TARed file with the entire distribution. Let's go.</p> <p>First of all, unpack it. If you're on Linux/Unix, you can use:</p> -<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent"> -<PRE>tar -xzvf ftpserver-1.0.0.tar.gz -</PRE> -</DIV></DIV></p> +<div class="codehilite"><pre><span class="n">tar</span> <span class="o">-</span><span class="n">xzvf</span> <span class="n">ftpserver</span><span class="o">-</span><span class="mf">1.0.0</span><span class="o">.</span><span class="n">tar</span><span class="o">.</span><span class="n">gz</span> +</pre></div> + + <p>On Windows and Linux/Unix, you can use any ZIP tool, like <a href="http://www.7-zip.org/";>7-zip</a> or <a href="http://fileroller.sourceforge.net/";>Gnome File Roller</a> to unzip the file at a location of your liking.</p> <h2 id="running-a-basic-server">Running a basic server</h2> <p>Now, open a shell/command prompt where you unpacked the files. On Linux/Unix, run:</p> -<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent"> -<PRE>bin/ftpd.sh -</PRE> -</DIV></DIV></p> +<div class="codehilite"><pre><span class="n">bin</span><span class="o">/</span><span class="n">ftpd</span><span class="o">.</span><span class="n">sh</span> +</pre></div> + + <p>On Windows, the same command is:</p> -<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent"> -<PRE>bin/ftpd.bat -</PRE> -</DIV></DIV></p> +<div class="codehilite"><pre><span class="n">bin</span><span class="o">/</span><span class="n">ftpd</span><span class="o">.</span><span class="n">bat</span> +</pre></div> + + <p>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 .</p> <p>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.</p> <h2 id="configuring">Configuring</h2> <p>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:</p> -<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent"> -<PRE>bin/ftpd.sh res/conf/ftpd-typical.xml -</PRE> -</DIV></DIV></p> +<div class="codehilite"><pre><span class="n">bin</span><span class="sr">/ftpd.sh res/co</span><span class="n">nf</span><span class="o">/</span><span class="n">ftpd</span><span class="o">-</span><span class="n">typical</span><span class="o">.</span><span class="n">xml</span> +</pre></div> + + <p>On Windows:</p> -<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent"> -<PRE>bin/ftpd.bat res/conf/ftpd-typical.xml -</PRE> -</DIV></DIV></p> +<div class="codehilite"><pre><span class="n">bin</span><span class="sr">/ftpd.bat res/co</span><span class="n">nf</span><span class="o">/</span><span class="n">ftpd</span><span class="o">-</span><span class="n">typical</span><span class="o">.</span><span class="n">xml</span> +</pre></div> + + <p>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.</p> </div><!-- rightColumn -->
Modified: websites/staging/mina/trunk/content/ftpserver/source.html ============================================================================== --- websites/staging/mina/trunk/content/ftpserver/source.html (original) +++ websites/staging/mina/trunk/content/ftpserver/source.html Wed Oct 31 17:30:49 2012 @@ -114,37 +114,35 @@ <p>The following is a link to the <a href="http://svn.apache.org/viewvc/mina/ftpserver";>online source repository</a>.</p> <h2 id="anonymous-access">Anonymous access</h2> <p>The source can be checked out anonymously from SVN with this command:</p> -<p><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></p> +<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">checkout</span> <span class="n">http:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/mina/</span><span class="n">ftpserver</span><span class="o">/</span><span class="n">trunk</span> <span class="n">ftpserver</span> +</pre></div> + + <h2 id="developer-access">Developer access</h2> <p>Everyone can access the Subversion repository via HTTPS, but Committers must checkout the Subversion repository via HTTPS.</p> -<p><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></p> +<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">checkout</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/mina/</span><span class="n">ftpserver</span><span class="o">/</span><span class="n">trunk</span> <span class="n">ftpserver</span> +</pre></div> + + <p>To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)</p> -<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent"> -<PRE>$ svn commit --username your-username -m "A message" -</PRE> -</DIV></DIV></p> +<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">commit</span> <span class="o">--</span><span class="n">username</span> <span class="n">your</span><span class="o">-</span><span class="n">username</span> <span class="o">-</span><span class="n">m</span> <span class="s">"A message"</span> +</pre></div> + + <h2 id="access-from-behind-a-firewall">Access from behind a firewall</h2> <p>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:</p> -<p><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></p> +<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">checkout</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/mina/</span><span class="n">ftpserver</span><span class="o">/</span><span class="n">trunk</span> <span class="n">ftpserver</span> +</pre></div> + + <h2 id="access-through-a-proxy">Access through a proxy</h2> <p>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.)</p> <p>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.</p> <p>Example : Edit the 'servers' file and add something like :</p> -<p><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></p> +<div class="codehilite"><pre><span class="k">[global]</span> +<span class="na">http-proxy-host</span> <span class="o">=</span> <span class="s">your.proxy.name</span> +<span class="na">http-proxy-port</span> <span class="o">=</span> <span class="s">3128</span> +</pre></div> </div><!-- rightColumn --> <div id="endContent"></div>
