0 Understanding How Mirroring Works

Read the Apache mirroring guidelines and thenStefan Bodewig's Step-By-Step Guide. Also read and digest this document before starting.

1 Create Directory Structure

The mirrored releases are stored on Daedalus (www.apache.org). The base directory is:

        /www/www.apache.org/dist/commons/foo                      
    

You need to create this directory and the following subdirectories:

      |--- source/
      |--- binaries/
         |--- platform/  [optional if produce platform-specific binaries]  
    

Please double check that the permissions and ownership are correct. (Everyone should be able to change and read, the group (commons) should be able to write as well.)

The new directory should be automatically mirrored within forty-eight hours.

2 Add Releases To Mirrored Directories

Follow the standard release process (sections 0-10) to create the distributions and upload into the newly created directories.

3 Add Component Entries To Commons Downloads

Add entries for component foo to the Commons download pages.

Edit commons-build/downloads/downloads.xml. Add a new entry for the component, if one does not exist. Please make make sure that your component fits in with the alphabetic ordering.

Test the changes but don't forget that the mirror links won't work until the pages are uploaded. Commit and update the Commons web site in the usual way (see standard release procedure section 11).

4 Update commons release directory

Log on to people.apache.org

> cd /www/www.apache.org/dist/commons/foo
    

If a README.html already exists, then edit it. Otherwise, create a new one. This document should tell users that they should download newer releases from the mirrors.

5 Wait Until The Mirrors Are Updated

Please wait until you component's directory appears on the mirrors before continuing with the release and posting your announcements. It's also good practice to test the download once it's been mirrored.