Puppet Class: apache::mod::jk

Defined in:
manifests/mod/jk.pp

Summary

Installs `mod_jk`.

Overview

Note:

shm_file and log_file Depending on how these files are specified, the class creates their final path differently:

Relative path: prepends supplied path with logroot (see below) Absolute path or pipe: uses supplied path as-is

“‘ shm_file => ’shm_file’ # Ends up in $shm_path = ‘/var/log/httpd/shm_file’

shm_file => ‘/run/shm_file’ # Ends up in $shm_path = ‘/run/shm_file’

shm_file => ‘“|rotatelogs /var/log/httpd/mod_jk.log.%Y%m%d 86400 -180”’ # Ends up in $shm_path = ‘“|rotatelogs /var/log/httpd/mod_jk.log.%Y%m%d 86400 -180”’ “‘

Note:

All parameters are optional. When undefined, some receive default values, while others cause an optional directive to be absent

Additionally, There is no official package available for mod_jk and thus it must be made available by means outside of the control of the apache module. Binaries can be found at Apache Tomcat Connectors download page

Examples:

class { '::apache::mod::jk':
  ip                   => '192.168.2.15',
  workers_file         => 'conf/workers.properties',
  mount_file           => 'conf/uriworkermap.properties',
  shm_file             => 'run/jk.shm',
  shm_size             => '50M',
  workers_file_content => {
    <Content>
  },
}

Parameters:

  • ip (Optional[Stdlib::IP::Address]) (defaults to: undef)

    IP for binding to mod_jk. Useful when the binding address is not the primary network interface IP.

  • port (Stdlib::Port) (defaults to: 80)

    Port for binding to mod_jk. Useful when something else, like a reverse proxy or cache, is receiving requests at port 80, then needs to forward them to Apache at a different port.

  • add_listen (Boolean) (defaults to: true)

    Defines if a Listen directive according to parameters ip and port (see below), so that Apache listens to the IP/port combination and redirect to mod_jk. Useful when another Listen directive, like Listen *:<Port> or Listen <Port>, can conflict with the one necessary for mod_jk binding.

  • workers_file (Optional[String]) (defaults to: undef)

    The name of a worker file for the Tomcat servlet containers.

  • worker_property (Hash) (defaults to: {})

    Enables setting worker properties inside Apache configuration file.

  • logroot (Optional[Stdlib::Absolutepath]) (defaults to: undef)

    The base directory for shm_file and log_file is determined by the logroot parameter. If unspecified, defaults to apache::params::logroot. The default logroot is sane enough therefore it is not recommended to override it.

  • shm_file (String) (defaults to: 'jk-runtime-status')

    Shared memory file name.

  • shm_size (Optional[String]) (defaults to: undef)

    Size of the shared memory file name.

  • mount_file (Optional[String]) (defaults to: undef)

    File containing multiple mappings from a context to a Tomcat worker.

  • mount_file_reload (Optional[String]) (defaults to: undef)

    This directive configures the reload check interval in seconds.

  • mount (Hash) (defaults to: {})

    A mount point from a context to a Tomcat worker.

  • un_mount (Hash) (defaults to: {})

    An exclusion mount point from a context to a Tomcat worker.

  • auto_alias (Optional[String]) (defaults to: undef)

    Automatically Alias webapp context directories into the Apache document space

  • mount_copy (Optional[String]) (defaults to: undef)

    If this directive is set to “On” in some virtual server, the mounts from the global server will be copied to this virtual server, more precisely all mounts defined by JkMount or JkUnMount.

  • worker_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable that can be used to set worker names in combination with SetHandler jakarta-servlet.

  • watchdog_interval (Optional[Integer]) (defaults to: undef)

    This directive configures the watchdog thread interval in seconds.

  • log_file (String) (defaults to: 'mod_jk.log')

    Full or server relative path to the mod_jk log file.

  • log_level (Optional[String]) (defaults to: undef)

    The mod_jk log level, can be debug, info, warn error or trace.

  • log_stamp_format (Optional[String]) (defaults to: undef)

    The mod_jk date log format, using an extended strftime syntax.

  • request_log_format (Optional[String]) (defaults to: undef)

    Request log format string.

  • extract_ssl (Optional[String]) (defaults to: undef)

    Turns on SSL processing and information gathering by mod_jk.

  • https_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable that contains SSL indication.

  • sslprotocol_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable that contains the SSL protocol name.

  • certs_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable that contains SSL client certificates.

  • cipher_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable that contains SSL client cipher.

  • certchain_prefix (Optional[String]) (defaults to: undef)

    Name of the Apache environment (prefix) that contains SSL client chain certificates.

  • session_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable that contains SSL session.

  • keysize_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable that contains SSL key size in use.

  • local_name_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded local name.

  • ignore_cl_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which forces to ignore an existing Content-Length request header.

  • local_addr_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded local IP address.

  • local_port_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded local port.

  • remote_host_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded remote (client) host name.

  • remote_addr_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded remote (client) IP address.

  • remote_port_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded remote (client) IP address.

  • remote_user_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded user name.

  • auth_type_indicator (Optional[String]) (defaults to: undef)

    Name of the Apache environment variable which can be used to overwrite the forwarded authentication type.

  • options (Array) (defaults to: [])

    Set one of more options to configure the mod_jk module.

  • env_var (Hash) (defaults to: {})

    Adds a name and an optional default value of environment variable that should be sent to servlet-engine as a request attribute.

  • strip_session (Optional[String]) (defaults to: undef)

    If this directive is set to On in some virtual server, the session IDs ;jsessionid=… will be removed for URLs which are not forwarded but instead are handled by the local server.

  • location_list (Array) (defaults to: [])

    Global locations for mod_jk are defined in array location_list. Each array item is a hash with quoted* property name as key and value as value itself. You can define a comment in a special ‘comment’ key

    Example: <Location /jkstatus/>

    # Configures jkstatus
    JkMount status
    Order deny,allow
    Deny from all
    Allow from 127.0.0.1
    

    </Location>

    Is defined as: location_list = [

    {
      'Location'   => '/jkstatus/',
      'Comment'    => 'Configures jkstatus',
      'JkMount'    => 'status',
      'Order'      => 'deny,allow',
      'Deny from'  => 'all',
      'Allow from' => '127.0.0.1',
    },
    

    ]

    • Keys must be quoted to allow arbitrary case and/or multi-word keys

    (BTW, note the case of ‘Location’ and ‘Comment’ keys)

  • workers_file_content (Hash) (defaults to: {})

    Each directive has the format worker.<Worker name>.<Property>=<Value>. This maps as a hash of hashes, where the outer hash specifies workers, and each inner hash specifies each worker properties and values. Plus, there are two global directives, ‘worker.list’ and ‘worker.maintain’ For example, the workers file below should be parameterized as follows:

    Worker file: “‘ worker.list = status worker.list = some_name,other_name

    worker.maintain = 60

    # Optional comment worker.some_name.type=ajp13 worker.some_name.socket_keepalive=true

    # I just like comments worker.other_name.type=ajp12 (why would you?) worker.other_name.socket_keepalive=false “‘

    Puppet file: “‘ $workers_file_content = {

    worker_lists    => ['status', 'some_name, other_name'],
    worker_maintain => 60,
    some_name       => {
      comment          => 'Optional comment',
      type             => 'ajp13',
      socket_keepalive => 'true',
    },
    other_name      => {
      comment          => 'I just like comments',
      type             => 'ajp12',
      socket_keepalive => 'false',
    },
    

    } “‘

  • mount_file_content (Hash) (defaults to: {})

    Each directive has the format <URI> = <Worker name>. This maps as a hash of hashes, where the outer hash specifies workers, and each inner hash contains two items:

    • uri_list-an array with URIs to be mapped to the worker

    • comment-an optional string with a comment for the worker. For example, the mount file below should be parameterized as Figure 2:

    Worker file: “‘ # Worker 1 /context_1/ = worker_1 /context_1/* = worker_1

    # Worker 2 / = worker_2 /context_2/ = worker_2 /context_2/* = worker_2 “‘

    Puppet file: “‘ $mount_file_content = {

    worker_1 => {
      uri_list => ['/context_1/', '/context_1/*'],
      comment  => 'Worker 1',
    },
    worker_2 => {
      uri_list => ['/context_2/', '/context_2/*'],
      comment  => 'Worker 2',
    },
    

    }, “‘

See Also:



272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
# File 'manifests/mod/jk.pp', line 272

class apache::mod::jk (
  # Binding to mod_jk
  Optional[Stdlib::IP::Address] $ip             = undef,
  Stdlib::Port     $port                        = 80,
  Boolean          $add_listen                  = true,
  # Conf file content
  Optional[String] $workers_file                = undef,
  Hash $worker_property                         = {},
  Optional[Stdlib::Absolutepath] $logroot       = undef,
  String $shm_file                              = 'jk-runtime-status',
  Optional[String] $shm_size                    = undef,
  Optional[String] $mount_file                  = undef,
  Optional[String] $mount_file_reload           = undef,
  Hash $mount                                   = {},
  Hash $un_mount                                = {},
  Optional[String] $auto_alias                  = undef,
  Optional[String] $mount_copy                  = undef,
  Optional[String] $worker_indicator            = undef,
  Optional[Integer] $watchdog_interval          = undef,
  String $log_file                              = 'mod_jk.log',
  Optional[String] $log_level                   = undef,
  Optional[String] $log_stamp_format            = undef,
  Optional[String] $request_log_format          = undef,
  Optional[String] $extract_ssl                 = undef,
  Optional[String] $https_indicator             = undef,
  Optional[String] $sslprotocol_indicator       = undef,
  Optional[String] $certs_indicator             = undef,
  Optional[String] $cipher_indicator            = undef,
  Optional[String] $certchain_prefix            = undef,
  Optional[String] $session_indicator           = undef,
  Optional[String] $keysize_indicator           = undef,
  Optional[String] $local_name_indicator        = undef,
  Optional[String] $ignore_cl_indicator         = undef,
  Optional[String] $local_addr_indicator        = undef,
  Optional[String] $local_port_indicator        = undef,
  Optional[String] $remote_host_indicator       = undef,
  Optional[String] $remote_addr_indicator       = undef,
  Optional[String] $remote_port_indicator       = undef,
  Optional[String] $remote_user_indicator       = undef,
  Optional[String] $auth_type_indicator         = undef,
  Array $options                                = [],
  Hash $env_var                                 = {},
  Optional[String] $strip_session               = undef,
  # Location list
  # See comments in template mod/jk.conf.epp
  Array $location_list                          = [],
  # Workers file content
  # See comments in template mod/jk/workers.properties.epp
  Hash $workers_file_content                    = {},
  # Mount file content
  # See comments in template mod/jk/uriworkermap.properties.epp
  Hash $mount_file_content                      = {},
) {
  # Provides important variables
  include apache
  # Manages basic module config
  ::apache::mod { 'jk': }

  # Ensure that we are not using variables with the typo fixed by MODULES-6225
  # anymore:
  if !empty($workers_file_content) and 'worker_mantain' in $workers_file_content {
    fail('Please replace $workers_file_content[\'worker_mantain\'] by $workers_file_content[\'worker_maintain\']. See MODULES-6225 for details.')
  }

  # Binding to mod_jk
  if $add_listen {
    $_ip = $ip ? {
      undef   => $facts['networking']['ip'],
      default => $ip,
    }
    ensure_resource('apache::listen', "${_ip}:${port}", {})
  }

  # File resource common parameters
  File {
    ensure  => file,
    mode    => $apache::file_mode,
    notify  => Class['apache::service'],
  }

  # Shared memory and log paths
  # If logroot unspecified, use default
  $log_dir = $logroot ? {
    undef   => $apache::logroot,
    default => $logroot,
  }
  # If absolute path or pipe, use as-is
  # If relative path, prepend with log directory
  # If unspecified, use default
  $shm_path = $shm_file ? {
    undef       => "${log_dir}/jk-runtime-status",
    /^\"?[|\/]/ => $shm_file,
    default     => "${log_dir}/${shm_file}",
  }
  $log_path = $log_file ? {
    undef       => "${log_dir}/mod_jk.log",
    /^\"?[|\/]/ => $log_file,
    default     => "${log_dir}/${log_file}",
  }

  $parameters = {
    'workers_file'          => $workers_file,
    'worker_property'       => $worker_property,
    'shm_path'              => $shm_path,
    'shm_size'              => $shm_size,
    'mount_file'            => $mount_file,
    'mount_file_reload'     => $mount_file_reload,
    'mount'                 => $mount,
    'un_mount'              => $un_mount,
    'auto_alias'            => $auto_alias,
    'mount_copy'            => $mount_copy,
    'worker_indicator'      => $worker_indicator,
    'watchdog_interval'     => $watchdog_interval,
    'log_path'              => $log_path,
    'log_level'             => $log_level,
    'log_stamp_format'      => $log_stamp_format,
    'request_log_format'    => $request_log_format,
    'extract_ssl'           => $extract_ssl,
    'https_indicator'       => $https_indicator,
    'sslprotocol_indicator' => $sslprotocol_indicator,
    'certs_indicator'       => $certs_indicator,
    'cipher_indicator'      => $cipher_indicator,
    'certchain_prefix'      => $certchain_prefix,
    'session_indicator'     => $session_indicator,
    'keysize_indicator'     => $keysize_indicator,
    'local_name_indicator'  => $local_name_indicator,
    'ignore_cl_indicator'   => $ignore_cl_indicator,
    'local_addr_indicator'  => $local_addr_indicator,
    'local_port_indicator'  => $local_port_indicator,
    'remote_host_indicator' => $remote_host_indicator,
    'remote_addr_indicator' => $remote_addr_indicator,
    'remote_port_indicator' => $remote_port_indicator,
    'remote_user_indicator' => $remote_user_indicator,
    'auth_type_indicator'   => $auth_type_indicator,
    'options'               => $options,
    'env_var'               => $env_var,
    'strip_session'         => $strip_session,
    'location_list'         => $location_list,
  }

  # Main config file
  $mod_dir = $apache::mod_dir
  file { 'jk.conf':
    path    => "${mod_dir}/jk.conf",
    content => epp('apache/mod/jk.conf.epp', $parameters),
    require => [
      Exec["mkdir ${mod_dir}"],
      File[$mod_dir],
    ],
  }

  # Workers file
  if $workers_file != undef {
    $workers_path = $workers_file ? {
      /^\//   => $workers_file,
      default => "${apache::httpd_dir}/${workers_file}",
    }
    file { $workers_path:
      content => epp('apache/mod/jk/workers.properties.epp', { 'workers_file_content' => $workers_file_content, }),
      require => Package['httpd'],
    }
  }

  # Mount file
  if $mount_file != undef {
    $mount_path = $mount_file ? {
      /^\//   => $mount_file,
      default => "${apache::httpd_dir}/${mount_file}",
    }
    file { $mount_path:
      content => epp('apache/mod/jk/uriworkermap.properties.epp', { 'mount_file_content' => $mount_file_content, }),
      require => Package['httpd'],
    }
  }
}