[Geotools-devel] Review: Developer Guide/Building/Install

[Kenneth G. <ken...@gm...>]

Hi!

Found some errors in the install section of the developer guide:

*Page ../building/install<http://docs.geotools.org/latest/developer/guide/building/install/install.html>
*


   1. Link https://jai.dev.java.net/binary-builds.html is broken.

   The direct link I found to 1.1.3 is this one:

   http://download.java.net/media/jai/builds/release/1_1_3/
   (install instructions:
   http://download.java.net/media/jai/builds/release/1_1_3/INSTALL.html)

   2. Link http://java.net/projects/jai-imageio/binary-builds.html is
   broken.

   The direct link I found to 1.1 is this one:

   http://download.java.net/media/jai-imageio/builds/release/1.1/
   (install instructions:
   http://download.java.net/media/jai-imageio/builds/release/1.1/INSTALL-jai_imageio.html
   )


I believe that these links broke when Oracle relaunched
java.net<http://www.oracle.com/us/dm/68364-java-nl-mar11-332886.html?msgid=3-3570419141>
(Java
Developer Newsletter, March 2011)

... and I have a improvement suggestion

*Page ../building/install/mvn<http://docs.geotools.org/latest/developer/guide/building/install/mvn.html>
*

Yes, I'm developing on ubuntu, and yes, I was using Apache Maven 2.2.1
(rdebian-1).

After removing it (as "suggested"), I installed it manually using these
commands (adapted from
here<http://usingmaven.bachew.net/manually-install-maven-on-linux>
)

   1. Download apache-maven-2.2.1-bin.tar.gz<http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-2.2.1-bin.tar.gz>
   2. Unpack into /usr/local/lib (or any other path you choose)
   > cd /usr/local/lib
   > sudo tar -xzf apache-maven-2.2.1-bin.tar.gz
   This unpacks the folder apache-maven-2.2.1 to pwd

   *at this point *> usr/local/lib/apache-maven-2.2.1/bin/mvn --version* will
   complain:
   Warning: JAVA_HOME environment variable is not set. *Step 4 solves this
   using a application specific environment (profile.d) script. This script
   also set the M2_HOME and PATH variables. Note that step 5 registers the
   script with current session.

   3. Link apache-maven-2.2.1 to apache-maven (optional)
   > ln -sT apache-maven-2.2.1 apache-maven
   (this makes it easier to upgrade later on)
   4. Add maven script that set environment variables (su required)
   > cat > /etc/profile.d/apache-maven.sh* *export
   JAVA_HOME=/usr/lib/jvm/java-6-sun/jre export
   M2_HOME=/usr/local/lib/apache-maven export PATH=$PATH:$M2_HOME/bin <Ctrl-D>
   > . /etc/profile
   5. Test Maven2. The following command should not produce any warnings:
   > mvn --version Apache Maven 2.2.1 (r801777; 2009-08-06 21:16:01+0200)
   Java version: 1.6.0_24 Java home: /usr/lib/jvm/java-6-sun-1.6.0.24/jre
   Default locale: nb_NO, platform encoding: UTF-8 OS name: "linux" version:
   "2.6.32-30-generic" arch: "amd64" Family: "unix"

Maybe these commands could be added to the Guide as an service to other
developers using Ubuntu/Linux?

Kenneth