Java SE Cookbook

Installs Oracle's Java SE JDK.

The next scheduled critical patch update:

• 20 October 2015

How is this different from Java cookbook?

• Allows for downloads directly from Oracle on all supported platforms
• Can specify an alternative URI directory to download from
• Easily lock version to Java release '~> 8.0' or critical patch update '~> 8.60.0'
• Lightweight, no cookbook dependencies
• Only supports Oracle's Java SE JDK
• Does not support RPM installations on Linux

Note that this cookbook does not yet support JCE Unlimited Strength Jurisdiction Policy Files.

Requirements

• Chef 11 or higher

Platforms

• CentOS, Red Hat, Fedora
• Debian, Ubuntu
• Mac OS X
• Windows

Usage

By adding java_se to a run_list or as a dependency you are accepting the
Oracle Binary Code License Agreement for Java SE.

Windows platform requires a reboot for JAVA_HOME and PATH to be set.

Attributes

• node['java_se']['uri'] - The URI to the Java SE JDKs. This can be a URI to a local or remote directory or file. If a directory is provided, then it will download the JDK that best matches platform criteria. Note that JDK file names must be the same as that found on Oracle's download page. For local directories or files, use file:// prefix e.g., 'file:///c:/path/to/jdk.exe'. Leave nil to download directly from Oracle. Default is nil.
• node['java_se']['force_i586'] - Install i586 Java on x64 machine if true. For Linux and Windows only. Default is false.
• node['java_se']['java_home'] - Alternative java_home location. Leave nil to use default location. For Linux and Windows only. Default is nil.
• node['java']['set_default'] - Indicates whether or not you want the JDK installed to be default on the system. For Linux only. Defaults to true.
  
• node['java']['owner'] - The owner of extracted directory. For Linux only. Default to root.
• node['java']['group'] - The group of extracted directory. For Linux only. Default to root.
• node['java']['alternatives_priority'] - A priority of the alternatives. For Linux only. Defaults to 1061.
• node['java']['set_etc_environment'] - Optionally sets JAVA_HOME in /etc/environment for. For Linux only. Default false.
• node['java']['reset_alternatives'] - Whether alternatives is reset. For Linux only. Defaults to true.
  
• node['java']['use_alt_suffix'] whether '_alt' suffix is used for none default java install. For Linux only. Defaults to false.
• node['java']['bin_cmds'] - Array of binary commands to symlink /usr/bin to, and set alternative on.
  Examples are mvn, java, javac, etc. These cmds must be in the bin subdirectory of the extracted folder. Will be ignored if set_default is not true. For Linux only.
• node['java_se']['url'] - Deprecated in favor of uri and will be removed in Java 9 release.
• node['java_se']['file'] - Deprecated in favor of uri and will be removed in Java 9 release.

Examples

Example role to download JDK from alternative location:

name "java_se"
description "Install Java SE"
default_attributes(
  "java_se": {
    "uri": "https://s3.amazonaws.com/mybucket/java/"
  }
)
run_list(
  "recipe[java_se]"
)

This will download the JDK that best matches platform criteria e.g., Windows 64-bit with force_i586 flag set to true
will match https://s3.amazonaws.com/mybucket/java/jdk-8u60-windows-i586.exe.
Note that JDK file names must be the same as that found on Oracle's download page.

Versioning

This cookbook does NOT use SemVer for versioning.

The versioning scheme is RELEASE.UPDATE.MINOR where:

1. RELEASE is the release of Java e.g. 8
2. UPDATE is the Java critical patch update e.g. 60
3. MINOR is the *cookbook release for an enhancement or bugfix e.g. 0

*All cookbook releases will strive to be backwards-compatible.

Getting Help

• Ask specific questions on Stack Overflow.
• Report bugs and discuss potential features in Github issues.

Contributing

Please refer to CONTRIBUTING.

License

MIT - see the accompanying LICENSE file
for details.