scripts/puppet4ccb/neals_playground/modules/fmw_jdk

fmw_jdk

Table of Contents

1. Overview - What is the fmw_jdk module?
2. Module Description - What does the module do?
3. Setup - The basics of getting started with fmw_jdk
4. Usage - The manifests available for configuration
   • Manifests
     • Manifest: init
     • Manifest: install
     • Manifest: rng_service
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module
   • Contributing to the fmw_jdk module
   • Running tests - A quick guide

Overview

The fmw_jdk module allows you to install and configure an Oracle JDK on a Windows, Linux or Solaris host. Also it can configure the rng service ( random number generator, urandom) on a linux node, this will fix the lack of Entropy on a linux VM.

Module description

This modules allows you to install any JDK version 7 or 8 on any Windows, Linux or Solaris host or VM. Besides installing the JDK you will also be able to control which JDK will the default by setting all symbolic links for java, javac, keytool etc. For Linux hosts you are also be able to configure and start the rng service ( random number generator, urandom, Hardware RNG Entropy Gatherer Daemon) which solves the lack of Entropy (urandom)

Setup

Add this module to your puppet environment modules folder

Usage

Manifests

Manifest init

This is an empty manifest and does not do anything

Manifest install

This will install the JDK on a host

rpm can only be used on a RedHat family platform

class { 'fmw_jdk::install':
  java_home_dir => '/usr/java/jdk1.8.0_45',
  source_file   => '/software/jdk-8u45-linux-x64.rpm',
}

All other linux distributions ( RedHat family included) can also use tar.gz source_file

class { 'fmw_jdk::install':
  java_home_dir => '/usr/java/jdk1.8.0_40',
  source_file   => '/software/jdk-8u40-linux-x64.tar.gz',
}

Windows

class { 'fmw_jdk::install':
  java_home_dir => 'c:\\java\\jdk1.7.0_75',
  source_file   => 'c:\\software\\jdk-7u75-windows-x64.exe',
}

Solaris ( tar.gz or tar.Z SVR4 package)

class { 'fmw_jdk::install':
  java_home_dir => '/usr/jdk/instances/jdk1.8.0_40',
  source_file   => '/software/jdk-8u40-solaris-x64.tar.gz',
}

class { 'fmw_jdk::install':
  java_home_dir => '/usr/jdk/instances/jdk1.8.0',
  source_file   => '/software/jdk-8u40-solaris-x64.tar.Z',
}

Solaris JDK 7 with x64 entensions

class { 'fmw_jdk::install':
  java_home_dir   => '/usr/jdk/instances/jdk1.7.0_75',
  source_file     => '/software/jdk-7u75-solaris-i586.tar.gz',
  source_x64_file => '/software/jdk-7u75-solaris-x64.tar.gz',
}

class { 'fmw_jdk::install':
  java_home_dir   => '/usr/jdk/instances/jdk1.7.0',
  source_file     => '/software/jdk-7u75-solaris-i586.tar.Z',
  source_x64_file => '/software/jdk-7u75-solaris-x64.tar.Z',
}

Manifest rng_service

This will install and configure the rng package on any RedHat or Debian family linux distributions. For windows or solaris platforms this is not necessary and this manifest will do just a return when this manifest is executed on one of those hosts.

include fmw_jdk::rng_service

Limitations

This should work on Windows, Solaris, Linux (Any RedHat or Debian platform family distribution)

Development

Contributing

Community contributions are essential for keeping them great. We want to keep it as easy as possible to contribute changes so that our cookbooks work in your environment. There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things.

Running-tests

This project contains tests for puppet-lint, puppet-syntax, puppet-rspec, rubocop and beaker. For in-depth information please see their respective documentation.

Quickstart:

yum install -y ruby-devel gcc zlib-devel libxml2 libxslt
yum install -y libxml2-devel libxslt-devel
gem install bundler --no-rdoc --no-ri
bundle install --without development

bundle exec rake syntax
bundle exec rake lint
# symbolic error under windows , https://github.com/mitchellh/vagrant/issues/713#issuecomment-13201507. start vagrant in admin cmd session
bundle exec rake spec
bundle exec rubocop

SOFTWARE_FOLDER=/software BEAKER_destroy=onpass BEAKER_debug=true bundle exec rspec spec/acceptance
SOFTWARE_FOLDER=/software BEAKER_destroy=onpass BEAKER_debug=true BEAKER_set=centos-70-x64 bundle exec rspec spec/acceptance
SOFTWARE_FOLDER=/software BEAKER_destroy=onpass BEAKER_debug=true BEAKER_set=debian-78-x64 bundle exec rspec spec/acceptance

# Ruby on Windows
use only 32-bits, its more stable, http://rubyinstaller.org/downloads/

Ruby 2.0.0-p598 to C:\Ruby\200_puppet
Ruby Development kit to C:\Ruby\2_devkit, so you can optionally build your gems

set PATH=%PATH%;C:\Ruby\200_puppet\bin
C:\Ruby\2_devkit\devkitvars.bat
ruby -v

set SOFTWARE_FOLDER=c:/software
set BEAKER_destroy=onpass
set BEAKER_debug=true
set BEAKER_set=centos-70-x64
set BEAKER_set=debian-78-x64
set BEAKER_set=oel-5.8-x64
set BEAKER_set=solaris-10-x64
set BEAKER_set=solaris-11.2-x64

bundle exec rspec spec/acceptance

bundle exec rake yard