Java SE Cookbook

Installs Oracle's Java SE JDK version
7u79.

How is this different from Java cookbook?

• Only supports Oracle's Java SE JDK
• Oracle JDK versions are tied to java_se cookbook versions (e.g. java_se 7.79.x is bound to JDK 7u79)
• Checksums are included in java_se cookbook and should not be overridden
• Downloads directly from Oracle on all supported platforms
• Can specify an alternative URI directory to download from (e.g. https://s3.amazonaws.com/mybucket/java/)
• Lightweight, no cookbook dependencies
• Can globally skip Java installation
• Only supports Linux (.tar.gz), Mac OS X (.dmg), and Windows (.exe) file extensions

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

Requirements

• Chef 11+

Platforms

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

Usage

Include the java_se recipe wherever you would like Java installed, such as a run list (recipe[java_se])
or a cookbook (include_recipe 'java_se'). By default, the latest Oracle SE JDK is installed.

By adding java_se to a run list or a cookbook you are accepting the
Oracle Binary Code License Agreement for Java SE.

It is recommended that you constrain
java_se cookbook version to a release e.g. '~> 7.0' or an update e.g. '~> 7.79.0' in your metadata.rb
cookbook or environment.

Windows JAVA_HOME and PATH environment variables are not available during initial chef-client run. Attribute
node['java_se']['win_javalink'] provides a symbolic link to installed Java JDK bin directory and is available
during initial chef-client run.

Note that you may need to stub java_version_on_macosx? method when testing with rspec:

allow_any_instance_of(Chef::Recipe).to receive(:java_version_on_macosx?).and_return(false)

Examples

Constrain java_se cookbook in metadata.rb

depends 'java_se', '~> 7.0'

Constrains install to latest available Java SE JDK 7.

Constrain java_se cookbook in environment

cookbook 'java_se', '~> 7.79'

Constrains install to Java SE JDK 7u79.

Download JDK from alternative location

override_attributes(
  "java_se": {
    "uri": "https://s3.amazonaws.com/mybucket/java/"
  }
)

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-8u66-windows-i586.exe. Note that JDK file names must be the
same as that found on Oracle's download page.

A script to download JDKs from Oracle and upload them to Amazon S3 is
available here.

Attributes

• node['java_se']['uri'] - The URI to the Java SE JDKs. If a directory is provided, it will then automatically assign a file name that best matches platform criteria. The JDK file names must be the same as that found on Oracle's download page. Leave nil to download directly from Oracle. Default nil.
• node['java_se']['skip'] - Skips installing Java SE. Default false.
• node['java_se']['force_i586'] - Install i586 Java on x64 machine if true. For Linux and Windows only. Default false.
• node['java_se']['java_home'] - Alternative java_home location. Leave nil to use default location. For Linux and Windows only. Default nil.

Linux Only

• node['java_se']['set_default'] - Indicates whether or not you want the JDK installed to be default on the system. Default true.
  
• node['java_se']['owner'] - The owner of extracted directory. Default root.
• node['java_se']['group'] - The group of extracted directory. Default root.
• node['java_se']['alternatives_priority'] - A priority of the alternatives. Default 1061.
• node['java_se']['set_etc_environment'] - Optionally sets JAVA_HOME in /etc/environment for. Default false.
• node['java_se']['reset_alternatives'] - Whether alternatives is reset. Default true.
  
• node['java_se']['use_alt_suffix'] whether '_alt' suffix is used for none default java install. Default false.
• node['java_se']['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.

Windows Only

• node['java_se']['win_addlocal'] - JDK features to install. Default ToolsFeature,SourceFeature,PublicjreFeature.
• node['java_se']['win_javalink'] - Symbolic link to Java JDK bin directory. Since Windows PATH and JAVA_HOME are not available during chef-client run, this provides a way for cookbooks to access the latest installed version. Default %SYSTEMDRIVE%\java\bin.
• node['java_se']['win_jre_home'] - Location to install public JRE. Leave nil to use default location. Default nil.

Bind (Do not override)

• node['java_se']['version'] - The JDK version to install.
• node['java_se']['build'] - The build number to download from Oracle.
• node['java_se']['sha256'][type][arch] - The checksum to validate the installer with. Where type is one of 'dmg', 'exe', or 'tar', and arch is one of 'x64' or 'i586'

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. 7
2. UPDATE is the Java update e.g. 79
3. MINOR is the *cookbook release for an enhancement or bugfix e.g. 0

*All MINOR versions 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.