[Lucene-java Wiki] Update of "PublishMavenArtifacts" by SteveRowe

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Lucene-java Wiki" for change notification.

The "PublishMavenArtifacts" page has been changed by SteveRowe:
http://wiki.apache.org/lucene-java/PublishMavenArtifacts

New page:
= Publish Lucene Maven Release Artifacts =

See http://www.apache.org/dev/publishing-maven-artifacts.html for more general instructions.

 1. Download the Lucene/Solr Maven artifacts (if you don't already have them) using {{{dev-tools/scripts/crawl.maven.release.dist.sh}}} - they will be placed in {{{lucene/}}} and {{{solr/}}} directories in the current directory.
 1. You'll need either {{{~/.ant/settings.xml}}} or {{{~/.m2/settings.xml}}} with the following contents:
 {{{
<settings>
  <servers>
    <server>
      <id>apache.releases.https</id>
      <username>Your ASF username</username>
      <password>Your ASF password</password>
    </server>
  </servers>
</settings>
}}}
 Because Maven Ant Tasks, used by the Lucene/Solr build to stage Maven artifacts, can't handle encrypted passwords in {{{settings.xml}}} (as of version 2.1.3, anyway; see [[http://jira.codehaus.org/browse/MANTTASKS-177|MANTTASKS-177]]), your password must be in plaintext - make sure permissions on this file are set to disallow access by other people, e.g. 600.
 1. Stage the Lucene artifacts using the {{{stage-maven-artifacts}}} target run from the {{{lucene/}}} directory, e.g. 
 {{{
ant clean stage-maven-artifacts -Dmaven.dist.dir=~/temp/lucene -Dm2.repository.id=apache.releases.https -Dm2.repository.url=https://repository.apache.org/service/local/staging/deploy/maven2
}}}
   * {{{maven.dist.dir}}} is the directory contiaining the Lucene Maven artifacts
   * {{{m2.repository.id}}} is the repository ID, given in your {{{~/.ant/settings.xml}}} or {{{~/.m2/settings.xml}}}, for the ASF release repository.
   * {{{m2.repository.url}}} is the staging URL for the ASF release repository
 1. Close the staging repository created by {{{stage-maven-artifacts}}} - "closing" a staging repository disallows further artifact staging to the staging repository, and performs some quality checks, including POM and signature validation:
   1. Log into https://repository.apache.org/index.html using your ASF credentials.
   1. Select "Staging Repositories" under "Build Promotion" from the navigation bar on the left.
   1. Select the staging repository containing the Lucene artifacts.
   1. Click on the "Close" button above the repository list, then enter a description when prompted, e.g. "Lucene 3.6.0 RC1".
 1. To drop a staging repository, if for example a release candidate was staged but will not be released:
   1. Log into https://repository.apache.org/index.html using your ASF credentials.
   1. Select "Staging Repositories" under "Build Promotion" from the navigation bar on the left.
   1. Select the staging repository containing the Lucene artifacts.
   1. Click on the "Drop" button above the repository list, then enter a description when prompted, e.g. "not the final release candidate".
 1. Release the Lucene Maven artifacts:
   1. Log into https://repository.apache.org/index.html using your ASF credentials.
   1. Select "Staging Repositories" under "Build Promotion" from the navigation bar on the left.
   1. Select the staging repository containing the Lucene artifacts.
   1. Click on the "Release" button above the repository list, then enter a description when prompted, e.g. "Lucene 3.6.0".