java_ng

Java Headless Puppet Module - java_ng

Table of Contents

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

Module Description

This puppet module performs more parametrized Java installation. Various options may be specified:

• major version: 7, 8
• flavor: headless, jdk, jre
• repositories: native, ppa

By default the headless flavor is installed, default version depends on the platform (8 or 7), and native repository is preferred.

Setup

What java_ng affects

• Packages: Java (JRE/JDK, JCE policy)
• Files:
• webupd8 ppa repository if enabled and needed (Debian, Ubuntu) + apt keys

No changes to the alternatives are done (only a switching in the packages triggers).

Usage

Example: basic usage

include ::java_ng

Example: specify version and flavor

class { '::java_ng':
  flavor  => 'jdk',
  version => 8,
}

Example: lock the package version (Debian, Ubuntu)

class { '::java_ng':
  ensure  => 'held',
  version => 8,
}

Example: Oracle Java (using only ppa, not the native OS repository)

class { '::java_ng':
  repo    => 'ppa',
  version => 8,
}

Reference

Classes

• java_ng: Install Java
• java_ng::install: Setup repositories and install packages
• java_ng::config

java_ng class

Parameters

ensure

ensure parameter for the Java packages. Default: undef.

Set to held, if the Java version is held in Debian or Ubuntu.

flavor

Java flavor. Default: 'headless'.

Values:

• headless
• jdk
• jre

version

Java major version. Default: [8, 7].

It may be array or single value.

repo

Repository to use. Default: ['native', 'ppa'].

It may be array or single value.

Values:

• native: native OS repository (mostly with OpenJDK Java)
• ppa: webupd8 PPA repository (with the Oracle Java)

prefer_version

Sets the heuristics for selecting default Java version and repository. Default: false.

It is used only when more Java versions is specified.

When true: the first specified version is used, if available in any repository.

When false: the repositories ordering is considered first (native OS goes first by default).

Functions

• java_ng_avail: Construct list of Java versions

Limitations

PPA repository is permitted also on Debian, there is always used the Ubuntu 14/trusty version.

Alternatives are not touched.

Development

• Repository: https://github.com/MetaCenterCloudPuppet/cesnet-java_ng
• Tests:
• basic: see .travis.yml
• Email: František Dvořák <valtri@civ.zcu.cz>

#Changelog

See https://github.com/MetaCenterCloudPuppet/cesnet-java_ng/commits/master.