astral303 / yajsw-cookbook

Installs and manages 'Yet Another Java Service Wrapper'

yajsw-cookbook

Installs and manages 'Yet Another Java Service Wrapper'.

Read more about YAJSW

Supported Platforms

• Ubuntu 14.x, 15.x
• Centos 6.x, 7.x
• Chef 12.5.x or higher. Chef 11 is NOT SUPPORTED.

Attributes

Key	Type	Description	Default
node['yajsw']['url']	String	Where to download YAJSW	http://softlayer-dal.dl.sourceforge.net/project/yajsw/yajsw/yajsw-stable-11.11/yajsw-stable-11.11.zip
node['yajsw']['checksum']	String	MD5 checksum of the downloaded archive.	3b4fff8475e48cb001c38a42c27c953b
node['yajsw']['dirname']	String	Name of the extracted directory.	yajsw-stable-11.11
node['yajsw']['basedir']	String	The base directory to use for the YAJSW installation.	/usr/local
node['yajsw']['apps_home']	String	The directory to use for YAJSW managed application.	/usr/local/yajsw_apps
node['yajsw']['piddir']	String	The directory to use for YAJSW application pids.	/var/run
node['yajsw']['user']	String	The owner of the YAJSW installation.	root
node['yajsw']['use_data_bag']	Boolean	Collect application info from a data bag instead of node attributes.	false
node['yajsw']['data_bag_name']	String	Name of the data bag to collect application information.	yajsw
node['yajsw']['use_env_data_bags']	Boolean	Appends the environment to the end of the data bag name. (ie. 'yajsw' becomes 'yajsw_prod')	true
node['yajsw']['apps']	Array	The array of application configurations (if not using data bags).	[{ 'name' => 'myapp', 'user' => 'yajsw', 'initmemory' => 64, 'maxmemory' => 256, 'mainclass' => 'com.company.myapp', 'jar' => 'lib/com.company.myapp.jar', 'classpath' => [], 'additional' => ['-server', '-Dfile.encoding=UTF-8'], 'parameters' => ['-a', '-b', 'foobar', '-c'], 'logfile' => { 'maxfiles' => 10, 'maxsize' => '10m', 'loglevel' => 'INFO' } }]

Usage

yajsw::default

Include yajsw in your node's run_list:

{
  "run_list": [
    "recipe[yajsw::default]"
  ]
}

The default implementation will install yajsw in /usr/local/ and create an application dir in /usr/local/yajsw_apps.

Custom Resources

If you prefer, you can use the YAJSW recipes individually, or configure your application with the included Custom Resources.

yajsw_install

yajsw_install will install the specified version of yajsw

    yajsw_install 'default' do
      marker 'stable'
      version '11.11'
      checksum 'aeb845a7d77184b8a1cbd68ae26c7f07a74952f6e79fb31d3f8f41ba52c4c872'
      user yajsw
      action :create
    end

yajsw_app

yajsw_app will configure an instance of YAJSW

  logfile = { 'maxfiles' => 10, 'maxsize' => '10m', 'loglevel' => 'INFO' }
  yajsw_app 'myapp' do
    user 'yajsw'
    mainclass 'com.company.myapp'
    jar 'lib/com.company.myapp.jar'
    classpath []
    additional ['-server', '-Dfile.encoding=UTF-8']
    parameters ['-a', '-b', 'foobar', '-c']
    initmemory 16
    maxmemory 256
    logfile logfile
    create_user true
    action [:create, :update]
  end

Data Bags

TODO: implement this functionality

If node['yajsw']['use_data_bag'] is true, yajsw will require a data bag in the following format:

License and Authors

Copyright (C) 2015-2016 NorthPage

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.