Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. You should read the OpenJPA Release Policy to decide on the name of the new release, based on the content.
  2. You should read the Apache Release FAQ
  3. You must have shell access to people.apache.org
  4. You must have the following utilities installed on your local machine and available in your path:

...

  1. For Windows users, install Cygwin in addition to the above utilities
    • Make sure the Net/openssh and Utils/gnupg packages are installed that come with Cygwin installation.
    • Optional: Putty

Tasks that need to be performed for each release

...

Description

The "maven-stage-plugin" is very sensitive to the parameters being passed to it, i.e. the source and target URL properties. When this plugin is used under Cygwin, make sure the following practices are used:

  • Use absolute path in the find command's root directory.
    Problem symptom:
    Code Block
    $ find . -name m2-repository -not -path "*openjpa-project*" \
        -exec mvn -f "c:/tmp/maven-stage-plugin/pom.xml" stage:copy \
        -Dsource=file://{} -Dtarget=scp://allee8285@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository \
        -Dversion=1.0.1 \;
    [INFO] Scanning for projects...
    [INFO] Searching repository for plugin with prefix: 'stage'.
    ........
    [INFO] Downloading file from the source repository:
    [INFO] ------------------------------------------------------------------------
    [ERROR] BUILD ERROR
    [INFO] ------------------------------------------------------------------------
    [INFO] Error copying repository from file://./openjpa-all/target/site/m2-repository to \
           scp://allee8285@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository
    
  • Quote and use the drive name in the path.
    Problem symptom:
    Code Block
    $ find /cygdrive/c/OpenJPA.1.0.1.Release/1.0.1 -name m2-repository -not -path "*openjpa-project*" \
        -exec mvn -f /cygwin/c/tmp/maven-stage-plugin/pom.xml stage:copy \
        -Dsource=file://{} -Dtarget=scp://allee8285@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository \
        -Dversion=1.0.1 \;
    [INFO] Scanning for projects...
    [INFO] Searching repository for plugin with prefix: 'stage'.
    ........
    [INFO] Downloading file from the source repository:
    [INFO] ------------------------------------------------------------------------
    [ERROR] BUILD ERROR
    [INFO] ------------------------------------------------------------------------
    [INFO] Error copying repository from file:///cygdrive/c/OpenJPA.1.0.1.Release/1.0.1/openjpa-all/target/site/m2-repository to
           scp://allee8285@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository
    
    Embedded error: Could not read from file: c:\cygdrive\c\OpenJPA.1.0.1.Release\1.0.1\openjpa-all\target\site\m2-repository
    \cygdrive\c\OpenJPA.1.0.1.Release\1.0.1\openjpa-all\target\site\m2-repository (Access is denied.)
    
  • Specify the people.apache.org user id in the target property.
    Problem symptom:
    Code Block
    $ find "c:/OpenJPA.1.0.1.Release/1.0.1" -name m2-repository -not -path "*openjpa-project*" \
       -exec mvn -f "c:/tmp/maven-stage-plugin/pom.xml" stage:copy 
       -Dsource=file://{} -Dtarget=scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository \
       -Dversion=1.0.1 \;
    [INFO] Scanning for projects...
    [INFO] Searching repository for plugin with prefix: 'stage'.
    [INFO] ----------------------------------------------------------------------------
    ........
    [INFO] Downloading file from the source repository: /org/apache/openjpa/openjpa/maven-metadata.xml.sha1
    [INFO] Downloading metadata from the target repository.
    Password:: *********
    ........
    Password:: *********
    [INFO] ------------------------------------------------------------------------
    [ERROR] BUILD ERROR
    [INFO] ------------------------------------------------------------------------
    [INFO] Error copying repository from file://c:/OpenJPA.1.0.1.Release/1.0.1/openjpa-all/target/site/m2-repository to \
           scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository
    

Solution

As recommended in the descriptions.

Note

For example:

Code Block
find "c:/OpenJPA.1.0.1.Release/1.0.1" -name m2-repository -not -path "*openjpa-project*" \
    -exec mvn -f "c:/tmp/maven-stage-plugin/pom.xml" stage:copy \
    -Dsource=file://{} \
    -Dtarget=scp://allee8285@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository \
    -Dversion=1.0.1 \;

Cygwin/Windows File Path

Description

For Cygwin/Windows user: file and folder path names using drive identifier (e.g. C:\OpenJPA Release\1.0.1 ) in commands can be expressed as /cygwin/c/OpenJPA Release/1.0.1/. This form of path name specification may have inconsistent and undesirable behaviors.

Solution

Consistently use the following naming conventions:

  • Continue to use the Windows form of path name, e.g. C:\a\b\c
  • Use '/' instead of '\' character as file separator, e.g. C:/a/b/c
  • Quote all path name using '"' character, e.g. "C:/a/b/c"
  • Avoid using space characters in path name, e.g. "C:/OpenJPA.Release/1.0.1"

Resources