<commit_before>tomcat
====


Overview
--------

The Apache Tomcat module installs and maintains the configuration of the Tomcat Jave EE server.


Module Description
-------------------

The Apache Tomcat module allows Puppet to install, configure and maintain the Tomcat Java EE server.

Setup
-----

**What tomcat affects:**

* installation directory for Tomcat
* init script located in /etc/init.d/
	
### Beginning with Apache Tomcat

To setup Apache Tomcat on a server

    tomcat::setup { 'example.com-tomcat':
      ensure        => 'running',
      enable        => true,
      source        => 'apache-tomcat-7.0.39.tar.gz',
      deploymentdir => '/home/example.com/apps/apache-tomcat',
      user          => 'example.com',
      serverxml     => 'example.com-server.xml',
      webxml        => 'example.com-web.xml',
      init_script   => 'example.com-init_script',
      default_webapp_docs        => 'present',
      default_webapp_examples    => 'present',
      default_webapp_hostmanager => 'present',
      default_webapp_manager     => 'present',
      default_webapp_root        => 'present'
    }

Usage
------

The `tomcat::setup` resource definition has several parameters to assist installation of tomcat.

**Parameters within `tomcat`**

####`ensure`

This parameter specifies whether the tomcat service should be running or not.
Valid arguments are "running" or "stopped". Default "running"

####`enable`

This parameter specifies whether tomcat should be enabled to start automatically on system boot.
Valid arguments are true or false. Default true

####`source`

This parameter specifies the source for the tomcat archive. 
This file must be in the files directory in the caller module. 
Only .tar.gz source archives are supported.

####`deploymentdir`

This parameter specifies the directory where tomcat will be installed.

####`user`

This parameter is used to set the permissions for the installation directory of tomcat.

####`serverxml`

This parameter specifies the server.xml file to be placed in the deployed tomcat installation.
This file must be in the files directory in the caller module.

####`webxml`

This parameter specifies the web.xml file to be placed in the deployed tomcat installation.
This file must be in the files directory in the caller module.<commit_msg>Updated README.markdown<commit_after>tomcat
====


Overview
--------

The Apache Tomcat module installs and maintains the configuration of the Tomcat Jave EE server.


Module Description
-------------------

The Apache Tomcat module allows Puppet to install, configure and maintain the Tomcat Java EE server.

Setup
-----

**What tomcat affects:**

* installation directory for Tomcat
* init script located in /etc/init.d/
	
### Beginning with Apache Tomcat

To setup Apache Tomcat on a server

    tomcat::setup { 'example.com-tomcat':
      ensure        => 'running',
      enable        => true,
      source        => 'apache-tomcat-7.0.39.tar.gz',
      deploymentdir => '/home/example.com/apps/apache-tomcat',
      user          => 'example.com',
      serverxml     => 'example.com-server.xml',
      webxml        => 'example.com-web.xml',
      init_script   => 'example.com-init_script',
      default_webapp_docs        => 'present',
      default_webapp_examples    => 'present',
      default_webapp_hostmanager => 'present',
      default_webapp_manager     => 'present',
      default_webapp_root        => 'present'
    }

Usage
------

The `tomcat::setup` resource definition has several parameters to assist installation of tomcat.

**Parameters within `tomcat`**

####`ensure`

This parameter specifies whether the tomcat service should be running or not.
Valid arguments are "running" or "stopped". Default "running"

####`enable`

This parameter specifies whether tomcat should be enabled to start automatically on system boot.
Valid arguments are true or false. Default true

####`source`

This parameter specifies the source for the tomcat archive. 
This file must be in the files directory in the caller module. 
**Only .tar.gz source archives are supported.**

####`deploymentdir`

This parameter specifies the directory where tomcat will be installed.

####`user`

This parameter is used to set the permissions for the installation directory of tomcat.

####`serverxml`

This parameter specifies the server.xml file to be placed in the deployed tomcat installation.
This file must be in the files directory in the caller module.

####`webxml`

This parameter specifies the web.xml file to be placed in the deployed tomcat installation.
This file must be in the files directory in the caller module.
{'fraction_non_alphanumeric': 0.10025873221216042, 'fraction_numerical': 0.0017248814144027599, 'mean_word_length': 3.252062328139322, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 29, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 16}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6150569', 'n_tokens_mistral': 1236, 'n_tokens_neox': 1200, 'n_words': 510}