#java

####Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with java
   • What java affects
   • Setup requirements
   • Beginning with java
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

##Overview

This is the java module. It allows to install Java OpenJDK and configure the default java alternative.

##Module Description

The module provides classes and defines to install Java OpenJDK and configure the java alternative on Debian and RedHat family distributions. It allows to install multiple Java versions on the same node. It allows to install java 8 even if it is not in the standard repository in Ubuntu 12.04 and 14.04 via ppa.

##Setup

###What java affects

The module install the OpenJDK package from the repositories and set up the alternative system for the java command.

If hiera defines a value for the parameter java::java_default_version the alternative system link for the command java is set to manual mode according to specified version. Otherwise it is left as it is.

In case java 8 installation is required on Ubuntu 12.04 or Ubuntu 14.04 the repository ppa:openjdk-r/ppa is added.

###Setup Requirements

The module has no special requirements.

###Beginning with java

The module provides three classes to install Java OpenJDK 6, 7 and 8 respectively. This is done, for example, by declarations as the following:

include java_7

##Usage

It is possible to install multiple versions of Java on a single node and to specify via hiera the default java to be set in the alternative system. An example hiera (JSON) declaration for a node could be as follows:

{
  "classes" : [
    "java::java_6",
    "java::java_7"
    ],
  "java::java_default_version" : "6"
}

##Reference

###Classes

####Public Classes

• java::java_6: Installs open-jdk-6.
• java::java_7: Installs open-jdk-7.
• java::java_8: Installs open-jdk-8.

###Defines

####Public Defines

• java::java: Install a specific version of java jdk and possibly sets update-alternative default

####Private Defines

• java::java_install_config: Installs a specific java open-jdk package and configures the update-alternative default java

###java::java_6 Installs OpenJDK-6 from the repositories.

###java::java_7 Installs OpenJDK-7 from the repositories.

###java::java_8 Installs OpenJDK-8 from the repositories.

###java::java Install a specific version of java jdk and possibly sets update-alternative default. If hiera defines a value for the parameter java::java_default_version on the target node the command update-alternatives is issued to set the default java accordingly.

Declares all other defines in the java module needed for installing Java. Currently, these consists of java::install, and java::config.

####Parameters

#####java_version Specifies the java version to install. Valid options: '6', '7' or '8'. Defaults to the resource title.

#####java_default_version Specifies the default java in case multiple versions are installed. Valid options: '6', '7' or '8'. Defaults to the hiera defined key java::java_default_version.

##Limitations

At the moment the module targets only OpenJDK 6, 7 and 8 on Debian, Ubuntu, RedHat and CentOS platforms. Specifically, it was tested on Ubuntu 12.04, 14.04, 16.04 and CentOS 6.6 distributions; although probably it will work also on different versions.

##Development

If you need some feature please send me a (pull) request and send me an email at: dsestero 'at' gmail 'dot' com.