From commits-return-31996-apmail-directory-commits-archive=directory.apache.org@directory.apache.org Thu Jun 23 08:43:22 2011 Return-Path: X-Original-To: apmail-directory-commits-archive@www.apache.org Delivered-To: apmail-directory-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id AC7704382 for ; Thu, 23 Jun 2011 08:43:22 +0000 (UTC) Received: (qmail 17891 invoked by uid 500); 23 Jun 2011 08:43:22 -0000 Delivered-To: apmail-directory-commits-archive@directory.apache.org Received: (qmail 17838 invoked by uid 500); 23 Jun 2011 08:43:21 -0000 Mailing-List: contact commits-help@directory.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@directory.apache.org Delivered-To: mailing list commits@directory.apache.org Received: (qmail 17825 invoked by uid 99); 23 Jun 2011 08:43:21 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 23 Jun 2011 08:43:21 +0000 X-ASF-Spam-Status: No, hits=-1994.3 required=5.0 tests=ALL_TRUSTED,HTML_MESSAGE,MIME_HTML_ONLY X-Spam-Check-By: apache.org Received: from [140.211.11.22] (HELO thor.apache.org) (140.211.11.22) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 23 Jun 2011 08:43:20 +0000 Received: from thor (localhost [127.0.0.1]) by thor.apache.org (8.13.8+Sun/8.13.8) with ESMTP id p5N8h0x7015567 for ; Thu, 23 Jun 2011 08:43:00 GMT Date: Thu, 23 Jun 2011 04:43:00 -0400 (EDT) From: confluence@apache.org To: commits@directory.apache.org Message-ID: <11071120.4475.1308818580055.JavaMail.confluence@thor> Subject: [CONF] Apache Directory Development > Releasing ApacheDS MIME-Version: 1.0 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Auto-Submitted: auto-generated

Releasing ApacheDS

Page edited by Emmanuel L=C3=A9charny


Changes (1)

=20 =20
=20 =20
{warning:title=3DOutdated}{w= arning}

{toc:type=3Dlist|minLeve= l=3D2|maxLevel=3D2}
...

Full Content

=20

Introduction

This will show you how to build and release the ApacheDS subproject. Ke= ep an eye out for warning and note sections that show version specific diff= erences in this process.

Manual Step

Some things have not yet been automated with maven and require users to = manually edit some files. Below are the steps to follow.

Update service/apacheds.sh and service/apacheds.bat

Edit the apacheds.sh/bat files in the service project directory to updat= e the revision numbers used in that file to reference non-SNAPSHOT releases= .

Release process

Since we are using Nexus for releases the release process is as follows = (see also http://www.apac= he.org/dev/publishing-maven-artifacts.html#staging-maven).

1. Test the Project<= /h3>
$ mvn release:prepare -DdryRun=3Dtrue

Replace the version by the new version. Be careful, and remove the 'apac= heds-parent-' which is proposed for the new tag. We should just use the ver= sion number.

2. Deploy a Snapsho= t

$ mvn deploy

This is useful to verify your settings in ~/.m2/settings.xml (Nexus pass= word and GPG key)

3. Prepare the Re= lease

$ mvn release:clean
$ mvn release:prepare

This creates a tag here: http://svn.apac= he.org/viewvc/directory/apacheds/tags/

4. Stage the Releas= e

$ mvn release:perform

This deploys the release to a staging repository. Go to https://repository.apache.org/index.html#stagingRepo= sitories and close the staging repository.

5. Deploy the Site
$ cd target/checkout
$ mvn site-deploy

This creates and deploys the site via ssh to people.apache.org/www/direc= tory.apache.org/apacheds/gen-docs.

Edit the people.apache.org/www/directory.apache.org/apacheds/gen-docs/in= dex.html file and add the deployed site to the list.

3D""Now, you have to sign the binary package= s which are in apacheds/target/checkout/target.

Use your PGP key ID (the pub key, 4096R/[XXXXXXX] where [XXXXXXX] is the= key ID)

6. Publish Source and Binary Distribution Packages

$ cd target/checkout/target
$ scp apacheds-parent-<version>-source-release.zip.* people.apache.or=
g:public_html/

Test the new versio= n

The best way to do that is to download the sources, extract them, build = the server and the installers, and check if the installers are correctly wo= rking. Then check that the server is correctly running.

8. Vote

Start a 72h vote at the dev mailing list.

9. Release

If the vote succeeds Apacheds project can be released.

Go to https://repository.apache.o= rg/index.html#stagingRepositories and release the staging repository so= all artifacts are published to Maven central.

Move the distribution packages to people.apache.org/www/www.apache.org/d= ist/directory/apacheds/stable.