Puppet Glassfish module

Original puppet-glassfish author - Lars Tobias Skjong-Børsting [email protected]
Copyright - Gavin Williams [email protected]

License: GPLv3

####Table of Contents

• Puppet Glassfish module
  • Overview
  • Features
  • Requirements
  • Usage
  • Limitations
  • Contributors
  • Development
  • Testing

##Overview This module adds support for installing and managing the Glassfish J2EE application server. It supports Glassfish J2EE version 3.1 and 4.0, running on EL and Debian linux distributions.

##Features This module can do the following:

• Install Glassfish J2EE Application server, either by downloading a Zip file or installing from a package.
• Install and configure Java if appropriate.
• Manage user accounts if appropriate.
• Configure PATH to support Glassfish.
• Create Linux service to run Glassfish on system startup.
• Create asadmin password files for different users or locations.
• Install additional JARs if appropriate.
• Create and manage Glassfish clusters, including:
• Domain Administration Service (DAS)
• Nodes
• Instances
• Manage various configuration elements of Glassfish, including:
• Applications
• Auth Realm
• Custom Resources
• Log Attribute properties
• Javamail Resources
• JDBC Connection Pools
• JDBC Resources
• JMS Resources
• JVM Options
• Network Listeners
• Resource references
• Set options
• System properties

Further features that are likely to be added include:

• Additional support for Cluster environments, such as targeting resources at cluster.

##Requirements This module requires the Puppetlabs-Stdlib module >= 3.2.0.

##Usage Glassfish can be installed and configured with a default configuration with:

include glassfish

This will install Java 7 OpenJDK, create a Glassfish group and user account, download and install Glassfish J2EE v3.1.2.2 using a Zip file. No domains are created by default.

To install Glassfish using a package manager, such as yum or apt, you could do:

class { 'glassfish':
  install_method => 'package', 
  package_prefix => 'glassfish'
}

package_prefix can be used to change the package naming structure. The required version is appended to the end to form the package name, e.g.: glassfish3-3.1.2.2

To create and configure a domain upon installation, you could do:

class { 'glassfish': 
  create_domain => true, 
  domain_name   => 'gf_domain', 
  portbase      => '8000'
}

This will install Glassfish and create a domain called 'gf_domain' using portbase 8000, with a default username/password of 'admin/adminadmin'.

If you are using other means to manage user accounts on this host, then you can stop this module managing user accounts by doing:

class { 'glassfish':
  manage_accounts => false 
}

This module also provides several defined types which can be used to simplify other tasks, such as creating a domain using glassfish::create_domain to create a new domain, or glassfish::create_cluster to create a new cluster.

It is also possible to use the types directly.
E.g.

  jdbcconnectionpool { 'ConPool':
    ensure       => present,
    resourcetype => 'javax.sql.ConnectionPoolDataSource',
    dsclassname  => 'oracle.jdbc.pool.OracleConnectionPoolDataSource',
    properties   => {
      'user'     => 'con_user', 
      'password' => 'con_password',
      'url'      => 'jdbc\:oracle\:thin\:@localhost\:1521\:XE'
    },
    portbase     => '8000',
    asadminuser  => 'admin',
    user         => 'glassfish'
  }

  jdbcresource { 'jdbc/ConPool':
    ensure         => present,
    connectionpool => 'ConPool',
    portbase       => '8000',
    target         => 'aCluster',
    asadminuser    => 'admin',
    user           => 'glassfish'
  }

##Limitations This module has primarily been developed and tested on CentOS 6. It has also been lightly tested on Debian and Ubuntu, so should support most common Linux distributions.

##Contributors Thanks to the following people who have helped with this module:

• Stepan Stipl - Features and testing
• Jon Black - Testing
• Alex Jennings - Features
• joliveira - Bug fixes
• Jesse Cotton - Features
• Bjoern Lippert - Bug fixes
• Doug Neal - Features
• Svante Paldan - Features and bug fixes

##Development If you have any features that you feel are missing or find any bugs for this module, feel free to raise an issue on Github, or even better submit a PR and I will review as soon as I can.

##Testing This module has been written to support Rspec testing of both the manifests and types/providers. In order to execute the tests, run the following from the root of the module: bundle install && bundle exec rake spec