This is an automated email from the ASF dual-hosted git repository. elecharny pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/mina-site.git
The following commit(s) were added to refs/heads/master by this push: new a8a2f9838 Updated the site for teh FtpServer 1.2.1 release a8a2f9838 is described below commit a8a2f9838211059d34417839da845465f943d78f Author: emmanuel lecharny <elecha...@apache.org> AuthorDate: Sat Feb 1 23:24:03 2025 +0100 Updated the site for teh FtpServer 1.2.1 release --- config.toml | 2 +- source/downloads-ftpserver_1_2.md | 3 +- source/ftpserver-project/__index.md | 12 +++++--- source/ftpserver-project/contributors.md | 11 ++++++- source/ftpserver-project/download_1_2.md | 46 +++++++++++++++++++---------- source/ftpserver-project/getting_source.md | 11 +++++++ source/ftpserver-project/old-downloads.md | 8 +++++ source/ftpserver-project/releasing.md | 26 ++++++++-------- source/ftpserver-project/reporting_bug.md | 2 ++ static/ftpserver-project/gen-docs/.htaccess | 4 +-- 10 files changed, 86 insertions(+), 39 deletions(-) diff --git a/config.toml b/config.toml index 3b5ac0636..46753383d 100644 --- a/config.toml +++ b/config.toml @@ -44,6 +44,6 @@ version_mina_2_0 = "2.0.27" version_mina_2_1 = "2.1.10" version_mina_2_2 = "2.2.4" version_ftpserver_1_1 = "1.1.4" -version_ftpserver_1_2 = "1.2.0" +version_ftpserver_1_2 = "1.2.1" version_sshd = "2.14.0" version_vysper = "0.7" diff --git a/source/downloads-ftpserver_1_2.md b/source/downloads-ftpserver_1_2.md index 655f09717..7a0f4dc69 100644 --- a/source/downloads-ftpserver_1_2.md +++ b/source/downloads-ftpserver_1_2.md @@ -4,10 +4,11 @@ title: Downloads # Latest FTPServer Releases -The latest release is the [Apache FtpServer 1.2.0 Release](ftpserver-project/download_1_2.html) +The latest release is the [Apache FtpServer 1.2.1 Release](ftpserver-project/download_1_2.html) # All Releases +* [Apache FtpServer 1.2.1 Release - Feb 1th, 2025](ftpserver-project/download_1_2.html) * [Apache FtpServer 1.2.0 Release - Mar 13th, 2022](ftpserver-project/download_1_2.html) * [Apache FtpServer 1.1.4 Release - Mar 13th, 2022](ftpserver-project/download_1_1.html) * [Apache FtpServer 1.1.3 Release - Feb 25th, 2022](https://archive.apache.org/dist/mina/ftpserver/1.1.3) diff --git a/source/ftpserver-project/__index.md b/source/ftpserver-project/__index.md index df3d8dc89..8d9f2e2b9 100644 --- a/source/ftpserver-project/__index.md +++ b/source/ftpserver-project/__index.md @@ -8,17 +8,21 @@ slug: index ## 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://www.springsource.org/) applications and provide our releases as OSGi bundles. +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://www.springsource.org/) applications and provide our releases as **OSGi** bundles. -The default network support is based on [Apache MINA](/), a high performance asynchronous IO library. Using MINA, FtpServer can scale to a large number of concurrent users. +The default network support is based on [Apache MINA](/), 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. +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. +You can also have a look at the documentation for how to configure **FtpServer** to suite your needs. + +## History + +The inital code comes from the defunct **[Apache Avalon](https://avalon.apache.org/closed.html)** project. It was brought to incubator by _Paul Hammant_, the initial contributor, and graduated as a **MINA** subproject in December 2007. diff --git a/source/ftpserver-project/contributors.md b/source/ftpserver-project/contributors.md index 838a53de2..d831832ae 100644 --- a/source/ftpserver-project/contributors.md +++ b/source/ftpserver-project/contributors.md @@ -7,12 +7,21 @@ title: FtpServer Contributors ## Committers -The following is a list of developers with commit privileges that have directly contributed to the project in one way or another. +The following is a list of developers with commit privileges that have directly contributed to the project in one way or another (in alphabetic order). * Rana Battacharyya +* Sebastan Bazley +* Herv{{< html "é" >}} Boutemy +* Gary Gregory * [Niklas Gustavsson](http://protocol7.com/) * Paul Hammant +* Nikola Ken Barozzi * David Latorre +* Trustin Lee * Emmanuel L{{< html "é" >}}charny * Sai Pullabhotla +* Johnny Valiere +* Julien Vermillard * Sergey M Vladimirov +* Mark Webb +* XenoAmess \ No newline at end of file diff --git a/source/ftpserver-project/download_1_2.md b/source/ftpserver-project/download_1_2.md index 68be54764..ca4b474d0 100644 --- a/source/ftpserver-project/download_1_2.md +++ b/source/ftpserver-project/download_1_2.md @@ -1,22 +1,36 @@ --- type: ftpserver -title: Apache FtpServer 1.2.0 Release +title: Apache FtpServer 1.2.1 Release --- -# Apache FtpServer 1.2.0 Release +# Apache FtpServer 1.2.1 Release -## New Features in 1.2.0 +## New Features in 1.2.1 -This release contains a change in the API. You can now select more than one supported TLS algorithm when configuring a server. +This release includes many fixes, and now depends on MINA core 2.2.4. +Here is the list of fixes and modifications: + +o [FTPSERVER-515](https://issues.apache.org/jira/projects/FTPSERVER-515): Bump Apache Log4j from 2.17.2 to 2.19.0 +o [FTPSERVER-510](https://issues.apache.org/jira/projects/FTPSERVER-510):Update Apache parent POM from 25 to 26 +o [FTPSERVER-509](https://issues.apache.org/jira/projects/FTPSERVER/issues/FTPSERVER-509): Enable GitHub Action build +o [FTPSERVER-506](https://issues.apache.org/jira/projects/FTPSERVER-506): Fix binary compatibility issues. +o [FTPSERVER-499](https://issues.apache.org/jira/projects/FTPSERVER/issues/FTPSERVER-499): FtpResponseEncoder is not thread safe +o [FTPSERVER-446](https://issues.apache.org/jira/projects/FTPSERVER-446): Implementing User Manager not possible in OSGi environment + + +Otherwise, the following features have been added: +o Support for SHA256 and SHA512 encryption +o Use ThreadLocal for FtpResponseEncoder.ENCODER and SimpleDateFormat +o Make build reproductible ## Getting the Binary Distributions | Description | Download Link | SHA256 hashes | SHA512 hashes | PGP Signature file of download | |---|---|---|---|---| -| zip distribution | [apache-ftpserver-1.2.0-bin.zip](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.zip) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.zip.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.zip.sha512) |[ASC](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.zip.asc) | -| tar.gz distribution | [apache-ftpserver-1.2.0-bin.tar.gz](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.gz) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.gz.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.gz.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.gz.asc) | -| tar.bz2 distribution | [apache-ftpserver-1.2.0-bin.tar.bz2](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.bz2) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.bz2.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.bz2.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-bin.tar.bz2.asc) | +| zip distribution | [apache-ftpserver-1.2.1-bin.zip](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.zip) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.zip.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.zip.sha512) |[ASC](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.zip.asc) | +| tar.gz distribution | [apache-ftpserver-1.2.1-bin.tar.gz](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.gz) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.gz.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.gz.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.gz.asc) | +| tar.bz2 distribution | [apache-ftpserver-1.2.1-bin.tar.bz2](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.bz2) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.bz2.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.bz2.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-bin.tar.bz2.asc) | ## Verify the Integrity of Downloads @@ -27,17 +41,17 @@ It is essential that you verify the integrity of the downloaded files using the 3. Verify the signatures using the following commands, depending on your use of PGP or GPG: $ pgpk -a KEYS - $ pgpv apache-ftpserver-1.2.0-bin.tar.gz.asc + $ pgpv apache-ftpserver-1.2.1-bin.tar.gz.asc or $ pgp -ka KEYS - $ pgp apache-ftpserver-1.2.0-bin.tar.gz.asc apache-ftpserver-1.2.0-bin.tar.gz + $ pgp apache-ftpserver-1.2.1-bin.tar.gz.asc apache-ftpserver-1.2.1-bin.tar.gz or $ gpg --import KEYS - $ gpg --verify apache-ftpserver-1.2.0-bin.tar.gz.asc apache-ftpserver-1.2.0-bin.tar.gz + $ gpg --verify apache-ftpserver-1.2.1-bin.tar.gz.asc apache-ftpserver-1.2.1-bin.tar.gz ## Getting the Binaries using Maven 2 @@ -47,7 +61,7 @@ To use this release in your maven project, the proper dependency configuration t <dependency> <groupId>org.apache.ftpserver</groupId> <artifactId>ftpserver-core</artifactId> - <version>1.2.0</version> + <version>1.2.1</version> </dependency> ``` @@ -57,13 +71,13 @@ To use this release in your maven project, the proper dependency configuration t | Description | Download Link | SHA256 hashes | SHA512 hashes | PGP Signature file of download | |---|---|---|---|---| -| zip sources | [apache-ftpserver-1.2.0-src.zip](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.zip) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.zip.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.zip.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.zip.asc) | -| tar.gz sources | [apache-ftpserver-1.2.0-src.tar.gz](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.gz) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.gz.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.gz.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.gz.asc) | -| tar.bz2 sources | [apache-ftpserver-1.2.0-src.tar.bz2](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.bz2) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.bz2.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.bz2.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.0/apache-ftpserver-1.2.0-src.tar.bz2.asc) | +| zip sources | [apache-ftpserver-1.2.1-src.zip](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.zip) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.zip.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.zip.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.zip.asc) | +| tar.gz sources | [apache-ftpserver-1.2.1-src.tar.gz](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.gz) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.gz.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.gz.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.gz.asc) | +| tar.bz2 sources | [apache-ftpserver-1.2.1-src.tar.bz2](https://www.apache.org/dyn/closer.lua/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.bz2) | [SHA256](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.bz2.sha256) | [SHA512](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.bz2.sha512) | [ASC](https://downloads.apache.org/mina/ftpserver/1.2.1/apache-ftpserver-1.2.1-src.tar.bz2.asc) | ### Git Tag Checkout $ git clone https://gitbox.apache.org/repos/asf/mina-ftpserver.git - $ git checkout ftpserver-parent-1.2.0 + $ git checkout ftpserver-parent-1.2.1 -You are now on 1.2.0 branch. +You are now on 1.2.1 branch. diff --git a/source/ftpserver-project/getting_source.md b/source/ftpserver-project/getting_source.md index f1faae53b..5715ee66f 100644 --- a/source/ftpserver-project/getting_source.md +++ b/source/ftpserver-project/getting_source.md @@ -7,6 +7,8 @@ title: FtpServer Getting Source Sources for the Apache MINA projects are currently managed through GIT. Instructions on GIT use can be found at <http://git-scm.com/book/>. +There is also a mirror on [GitHub](https://github.com/apache/mina-ftpserver) + ## Normal Git Access Anyone can check code out of Git. You only need to specify a username and password in order to update the Git repository, and only MINA committers have the permissions to do that. We run Git over standard HTTPS, so hopefully you won't have problems with intervening firewalls. @@ -29,6 +31,15 @@ write access : You will not be able to commit into the project if you are not a committer. +There are currently two working branches: + +* 1.2.X, the mot recent development branch +* 1.1.X, a maintainance branche + +All the other branches are dead wood, including the 'master' branch + +Be sure to checkout the **1.2.X** branch if you want to participate in the latest branch. + # Documentation The Website documentation is published via Apache SVN pubsub. The website source resides at diff --git a/source/ftpserver-project/old-downloads.md b/source/ftpserver-project/old-downloads.md index 4ea6a5dc9..76b799bc0 100644 --- a/source/ftpserver-project/old-downloads.md +++ b/source/ftpserver-project/old-downloads.md @@ -5,6 +5,14 @@ title: FtpServer Older Downloads # Older FtpServer Releases +## FtpServer 1.2.x + +<center> + +| Version| Download Links | Date | +|:-:|:-:|:-:| +| Apache FtpServer 1.2.0 | [Download](https://archive.apache.org/dist/mina/ftpserver/1.2.0/) | 13/Mar/2022 | + ## FtpServer 1.1.x <center> diff --git a/source/ftpserver-project/releasing.md b/source/ftpserver-project/releasing.md index eb5245b64..162975c17 100644 --- a/source/ftpserver-project/releasing.md +++ b/source/ftpserver-project/releasing.md @@ -348,7 +348,7 @@ Then copy the packages : ```bash $ cd target/checkout/distributions/target -$ cp apache-ftpserver-<vversion>-* ~/mina/dist/dev/mina/ftpserver/<version>/ +$ cp apache-ftpserver-<version>-* ~/mina/dist/dev/mina/ftpserver/<version>/ ``` Last, not least, commit your changes @@ -433,10 +433,10 @@ The packages should now be available on https://dist.apache.org/repos/dist/relea ### Step 12: Deploy Web Reports (JavaDoc and JXR) -The javadoc and xref files have been generated in step 6, it's now time to push them into the production site. They are generated in the following directory : +The javadoc has been generated in step 6, it's now time to push them into the production site. It has been generated in the following directory : ```text -target/checkout/target/site +target/checkout/target/reports ``` We will copy the ```apidocs``` directory. @@ -447,7 +447,7 @@ First create the folder for the version (change the <version> part): ``` $ curl -u <your asf id> -X MKCOL 'https://nightlies.apache.org/mina/ftpserver/<version>/' -$ curl -u <your asf id> -X MKCOL 'https://nightlies.apache.org/mina/mina/<version>/apidocs' +$ curl -u <your asf id> -X MKCOL 'https://nightlies.apache.org/mina/ftpserver/<version>/apidocs' ``` Each of those commands will ask for your ASF password. @@ -469,7 +469,7 @@ pass: <your asf password> (will be stored encrypted) Then copy the directory (change the <version> part): ``` -cd target/checkout/target/site +cd target/checkout/target/reports rclone copy --progress apidocs nightlies:/mina/ftpserver/<version>/apidocs ``` @@ -482,25 +482,23 @@ RewriteRule ^latest/(.*)$ https://nightlies.apache.org/mina/ftpserver/<version>/ Save and commit the file, the web site should be automatically generated and published. -### Step 13: Wait 24 hours - -We have to wait at least 24 hours for all mirrors to retrieve the uploaded files before making any announcement. I'd recommend you to wait for 48 hours because some mirrors might lag due to various issues. - -### Step 14: Update the Links in Web Site +### Step 13: Update the Links in Web Site Some pages have to be updated. Assuming the MINA site has been checked out in ~/mina/site (this can be done with the command <em>$ git clone http://gitbox.apache.org/repos/asf/mina-site.git ~/mina/mina-site</em>), here are the pages that need to be changed : * /config.toml: update the `version_ftpserver` variable with the new version. -* /source/ftpserver-project/downloads-<version>.md: Add the page for this version -* /source/downloads.md: Refer to the previous page +* /source/ftpserver-project/downloads.md: Refer to the previous page +* /source/ftpserver-project/downloads_1_2.md: Refer to the previous page +* /source/ftpserver-project/old_downloads.md: Refer to the previous page +* /source/donwloads-ftpserver_1_2.md: Update the version Commit the changes, and publish the web site, you are done ! -### Step 15: Wait another 24 hours +### Step 14: Wait 24 hours We need to wait until any changes made in the web site and metadata file(s) go live. -### Step 16: Announce the New Release +### Step 15: Announce the New Release An announcement message can be sent to [mailto:annou...@apache.org], [mailto:annou...@apachenews.org], [mailto:us...@mina.apache.org] and [mailto:d...@mina.apache.org]. Please note that announcement messages are rejected unless your from-address ends with `@apache.org`. Plus, you shouldn't forget to post a news to the MINA site main page. diff --git a/source/ftpserver-project/reporting_bug.md b/source/ftpserver-project/reporting_bug.md index 5720b1cb8..aaa49dac4 100644 --- a/source/ftpserver-project/reporting_bug.md +++ b/source/ftpserver-project/reporting_bug.md @@ -7,6 +7,8 @@ title: FtpServer Reporting Bugs 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. +As an alternative you can also create some **[GitHub issues](https://github.com/apache/mina-ftpserver/issues)** + ## How to report a bug Writing a bug report with detailed information will help us to fix your problem sooner. diff --git a/static/ftpserver-project/gen-docs/.htaccess b/static/ftpserver-project/gen-docs/.htaccess index e28957b4d..a6ae10573 100644 --- a/static/ftpserver-project/gen-docs/.htaccess +++ b/static/ftpserver-project/gen-docs/.htaccess @@ -5,8 +5,8 @@ RewriteEngine On RewriteRule ^latest-1.1$ https://nightlies.apache.org/mina/ftpserver/1.1.4/ [QSA,L] RewriteRule ^latest-1.1/(.*)$ https://nightlies.apache.org/mina/ftpserver/1.1.4/$1 [QSA,L] -RewriteRule ^latest-1.2$ https://nightlies.apache.org/mina/ftpserver/1.2.0/ [QSA,L] -RewriteRule ^latest-1.2/(.*)$ https://nightlies.apache.org/mina/ftpserver/1.2.0/$1 [QSA,L] +RewriteRule ^latest-1.2$ https://nightlies.apache.org/mina/ftpserver/1.2.1/ [QSA,L] +RewriteRule ^latest-1.2/(.*)$ https://nightlies.apache.org/mina/ftpserver/1.2.1/$1 [QSA,L] # Redirect everything else RewriteRule ^(.*)$ https://nightlies.apache.org/mina/ftpserver/$1 [QSA,L]