Until few years back setting up Java development environment based on Sun/Oracle JDK was fairly a simple task. Since most of the linux distributions included Oracle/Sun JDK as part of their default package repository (here read as Canonical’s partner repository ;-)) it was as easy as installing any other core linux pacakge. But in recent times due to license restrictions Oracle JDK is not included in any of the linux distribution repositories by default. Setting up Java development environment manually from scratch on linux has become a tedious job (though still easier doing tha on Microsoft Windows). Nowadays I avoid doing it, given a chance to use a preconfigured virtual machines or chroot tar balls - created specifically for development/build requirements.

As for the intent of this post, it is to serve as a guide on best practices of setting up a Java development / build environment from scratch if such need arises in the future.

Prerequisites:

  1. Oracle JDK version of your choice (in our case v1.7.0_79_)
  2. Apache Ant version of your choice (in our case 1.9.7) )which works with the JDK version chosen in step 1
  3. Apache Maven version of your choice (in our case 3.0.5) which works with the JDK version chosen in step 1
  4. Gradle version of your choice (in our case 2.13) which works with the JDK version chosen in step 1

Download tar ball archives of all the above packages. RPM package is available for Oracle JDK but it kills the “distro independent” part of this post.

Extract all the tar balls to a location of your convenience. If I have root or sudo access (which happens to be most of the time), I usually prefer /opt/tools/java.

After completing the extraction of tarballs to the /opt/tools/java direcory add the environment config scripts based on the below given template to /etc/profile.d directory of you linux file system.

  • 00700_java_home.sh
if [ -z ${JAVA_HOME} ]; then
	export JAVA_HOME=/opt/tools/java/jdk1.7.0_79
	export PATH=${PATH}:${JAVA_HOME}/bin
fi
  • 00701_ant_home.sh
if [ -z ${ANT_HOME} ]; then
	export ANT_HOME=/opt/tools/java/apache-ant-1.9.7
	export PATH=${PATH}:${ANT_HOME}/bin
fi

  • 00702_m2_home.sh
if [ -z ${M2_HOME} ]; then
	export M2_HOME=/opt/tools/java/apache-maven-3.0.5
	export PATH=${PATH}:${M2_HOME}/bin
fi
  • 00703_gradle_home.sh
if [ -z ${GRADLE_HOME} ]; then
	export GRADLE_HOME=/opt/tools/java/gradle-2.13
	export PATH=${PATH}:${GRADLE_HOME}/bin
fi

At the end of the setup, your /etc/profile.d directory should look something like this

/etc/profile.d
├── 00700_java_home.sh
├── 00701_ant_home.sh
├── 00702_m2_home.sh
└── 00703_gradle_home.sh

And your /opt/tools/java should look something like this

/opt/tools/java
├── apache-ant-1.9.7
├── apache-maven-3.0.5
├── gradle-2.13
└── jdk1.7.0_79