Puppet Class: apache::mod::passenger

Inherits:
apache::params
Defined in:
manifests/mod/passenger.pp

Summary

Installs `mod_pasenger`. > **Note**: This module support Passenger 4.0.0 and higher.

Overview

The current set of server configurations settings were taken directly from the Passenger Reference. To enable deprecation warnings and removal failure messages, set the passenger_installed_version to the version number installed on the server.

Change Log:

- As of 08/13/2017 there are 84 available/deprecated/removed settings.
- Around 08/20/2017 UnionStation was discontinued options were removed.
- As of 08/20/2017 there are 77 available/deprecated/removed settings.
Note:

In Passenger source code you can strip out what are all the available options by looking in

- src/apache2_module/Configuration.cpp
- src/apache2_module/ConfigurationCommands.cpp

There are also several undocumented settings.

Note:

For Red Hat based systems, ensure that you meet the minimum requirements described in the passenger docs.

Parameters:

  • manage_repo (Boolean) (defaults to: true)

    Toggle whether to manage yum repo if on a RedHat node.

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

    Specifies the package id.

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

    Defines the module’s shared object name. Do not configure manually without special reason.

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

    Specifies a path to the module’s libraries. Do not manually set this parameter without special reason. The ‘path` parameter overrides this value.

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

    Name of the module package to install.

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

    Determines whether Puppet ensures the module should be installed.

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

    Specifies a path to the module. Do not manually set this parameter without a special reason.

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

    Specifies a Fuse Panel URL that the Passenger to to enable monitoring, administering, analysis and troubleshooting of this Passenger instance and apps.

  • passenger_admin_panel_auth_type (Optional[Enum['basic']]) (defaults to: undef)

    Specifies the authentication type to use for the Fuse Panel. Currently it support only basic type of authentiction. Ref : www.phusionpassenger.com/library/config/apache/reference/#passengeradminpanelauthtype

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

    The username that Passenger should use when connecting to the Fuse Panel with basic authentication.

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

    The password that Passenger should use when connecting to the Fuse Panel with basic authentication.

  • passenger_allow_encoded_slashes (Optional[Apache::OnOff]) (defaults to: undef)

    Toggle whether URLs with encoded slashes (%2f) can be used (by default Apache does not support this).

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

    Set an intermediate proxy for the Passenger anonymous telemetry reporting.

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

    This option sets, for the current application, the value of the following environment variables:

    • RAILS_ENV

    • RACK_ENV

    • WSGI_ENV

    • NODE_ENV

    • PASSENGER_APP_ENV

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

    Sets the name of the application group that the current application should belong to.

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

    File path to application specifile log file. By default passenger will write all application log messages to the Passenger log file.

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

    Path to the application root which allows access independent from the DocumentRoot.

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

    Specifies the type of the application. If you set this option, then you must also set PassengerAppRoot, otherwise Passenger will not properly recognize your application.

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

    Used to specify that the given URI is an distinct application that should be served by Passenger.

  • passenger_buffer_response (Optional[Apache::OnOff]) (defaults to: undef)

    Toggle whether application-generated responses are buffered by Apache. Buffering will happen in memory.

  • passenger_buffer_upload (Optional[Apache::OnOff]) (defaults to: undef)

    Toggle whether HTTP client request bodies are buffered before they are sent to the application.

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

    Specifies the I/O concurrency model that should be used for Ruby application processes.

  • passenger_conf_file (String) (defaults to: $apache::params::passenger_conf_file)
  • passenger_conf_package_file (Optional[String]) (defaults to: $apache::params::passenger_conf_package_file)
  • passenger_data_buffer_dir (Optional[Stdlib::Absolutepath]) (defaults to: undef)

    Specifies the directory in which to store data buffers.

  • passenger_debug_log_file (Optional[String]) (defaults to: undef)
  • passenger_debugger (Optional[Apache::OnOff]) (defaults to: undef)

    Turns support for Ruby application debugging on or off.

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

    Allows you to specify the group that applications must run as, if user switching fails or is disabled.

  • passenger_default_ruby (Optional[String]) (defaults to: $apache::params::passenger_default_ruby)

    File path to desired ruby interpreter to use by default.

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

    Allows you to specify the user that applications must run as, if user switching fails or is disabled.

  • passenger_disable_anonymous_telemetry (Optional[Boolean]) (defaults to: undef)

    Whether or not to disable the Passenger anonymous telemetry reporting.

  • passenger_disable_log_prefix (Optional[Boolean]) (defaults to: undef)

    Whether to stop Passenger from prefixing logs when they are written to a log file.

  • passenger_disable_security_update_check (Optional[Apache::OnOff]) (defaults to: undef)

    Allows disabling the Passenger security update check, a daily check with securitycheck.phusionpassenger.com for important security updates that might be available.

  • passenger_enabled (Optional[Apache::OnOff]) (defaults to: undef)

    Toggles whether Passenger should be enabled for that particular context.

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

    Dumps the configuration manifest to the given file.

  • passenger_error_override (Optional[Apache::OnOff]) (defaults to: undef)

    Toggles whether Apache will intercept and handle responses with HTTP status codes of 400 and higher.

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

    Log file descriptor debug tracing messages to the given file.

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

    Enables the Flying Passenger mode, and configures Apache to connect to the Flying Passenger daemon that’s listening on the given socket filename.

  • passenger_force_max_concurrent_requests_per_process (Optional[Variant[Integer, String]]) (defaults to: undef)

    Use this option to tell Passenger how many concurrent requests the application can handle per process.

  • passenger_friendly_error_pages (Optional[Apache::OnOff]) (defaults to: undef)

    Toggles whether Passenger should display friendly error pages whenever an application fails to start.

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

    Allows you to override that behavior and explicitly set a group to run the web application as, regardless of the ownership of the startup file.

  • passenger_high_performance (Optional[Apache::OnOff]) (defaults to: undef)

    Toggles whether to enable PassengerHighPerformance which will make Passenger will be a little faster, in return for reduced compatibility with other Apache modules.

  • passenger_installed_version (Optional[String]) (defaults to: undef)
  • passenger_instance_registry_dir (Optional[String]) (defaults to: undef)

    Specifies the directory that Passenger should use for registering its current instance.

  • passenger_load_shell_envvars (Optional[Apache::OnOff]) (defaults to: undef)

    Enables or disables the loading of shell environment variables before spawning the application.

  • passenger_preload_bundler (Optional[Boolean]) (defaults to: undef)

    Enables or disables loading bundler before loading your Ruby app.

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

    File path to log file. By default Passenger log messages are written to the Apache global error log.

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

    Specifies how much information Passenger should log to its log file. A higher log level value means that more information will be logged.

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

    When using Passenger on a LVE-enabled kernel, a security check (enter) is run for spawning application processes. This options tells the check to only allow processes with UIDs equal to, or higher than, the specified value.

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

    The maximum number of application processes that may simultaneously exist for an application.

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

    The maximum number of application processes that may simultaneously exist for a single application.

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

    The maximum number of application processes that may simultaneously exist.

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

    Set the preloader’s idle timeout, in seconds. A value of 0 means that it should never idle timeout.

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

    Specifies the maximum size for the queue of all incoming requests.

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

    The maximum amount of time, in seconds, that an application process may take to process a request.

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

    The maximum number of requests an application process will process.

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

    The maximum amount of time, in seconds, that a request may be queued before Passenger will return an error. This option specifies the maximum time a request may spend in that queue. If a request in the queue reaches this specified limit, then Passenger will send a “504 Gateway Timeout” error for that request.

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

    The maximum amount of memory that an application process may use, in megabytes.

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

    When using a Meteor application in non-bundled mode, use this option to specify a JSON file with settings for the application.

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

    Specifies the minimum number of application processes that should exist for a given application.

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

    Specifies the Node.js command to use for serving Node.js web applications.

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

    The maximum number of seconds that an application process may be idle.

  • passenger_pre_start (Optional[Variant[String, Array[String]]]) (defaults to: undef)

    URL of the web application you want to pre-start.

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

    Specifies the Python interpreter to use for serving Python web applications.

  • passenger_resist_deployment_errors (Optional[Apache::OnOff]) (defaults to: undef)

    Enables or disables resistance against deployment errors.

  • passenger_resolve_symlinks_in_document_root (Optional[Apache::OnOff]) (defaults to: undef)

    This option is no longer available in version 5.2.0. Switch to PassengerAppRoot if you are setting the application root via a document root containing symlinks.

  • passenger_response_buffer_high_watermark (Optional[Variant[Integer, String]]) (defaults to: undef)

    Configures the maximum size of the real-time disk-backed response buffering system.

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

    Path to directory containing restart.txt file. Can be either absolute or relative.

  • passenger_rolling_restarts (Optional[Apache::OnOff]) (defaults to: undef)

    Enables or disables support for zero-downtime application restarts through restart.txt.

  • passenger_root (Optional[String]) (defaults to: $apache::params::passenger_root)

    Refers to the location to the Passenger root directory, or to a location configuration file.

  • passenger_ruby (Optional[String]) (defaults to: $apache::params::passenger_ruby)

    Specifies the Ruby interpreter to use for serving Ruby web applications.

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

    Allows use of an intermediate proxy for the Passenger security update check.

  • passenger_show_version_in_header (Optional[Apache::OnOff]) (defaults to: undef)

    Toggle whether Passenger will output its version number in the X-Powered-By header in all Passenger-served requests:

  • passenger_socket_backlog (Optional[Variant[Integer, String]]) (defaults to: undef)

    This option can be raised if Apache manages to overflow the backlog queue.

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

    The directory in which Passenger will record progress during startup

  • passenger_spawn_method (Optional[Enum['smart', 'direct', 'smart-lv2', 'conservative']]) (defaults to: undef)

    Controls whether Passenger spawns applications directly, or using a prefork copy-on-write mechanism.

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

    Specifies a timeout for the startup of application processes.

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

    Specifies the startup file that Passenger should use when loading the application.

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

    Setting this option to a value of x means that certain filesystem checks will be performed at most once every x seconds.

  • passenger_sticky_sessions (Optional[Apache::OnOff]) (defaults to: undef)

    Toggles whether all requests that a client sends will be routed to the same originating application process, whenever possible.

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

    Sets the name of the sticky sessions cookie.

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

    Sets the attributes of the sticky sessions cookie.

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

    Specifies the number of threads that Passenger should spawn per Ruby application process.

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

    N/A.

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

    Allows you to override that behavior and explicitly set a user to run the web application as, regardless of the ownership of the startup file.

  • passenger_user_switching (Optional[Apache::OnOff]) (defaults to: undef)

    Toggles whether to attempt to enable user account sandboxing, also known as user switching.

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

    Alias for PassengerAppEnv.

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

    Alias for PassengerAppEnv.

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

    This option is no longer available in version 4.0.0. There is no alternative because framework spawning has been removed altogether. You should use smart spawning instead.

See Also:



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
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
# File 'manifests/mod/passenger.pp', line 309

class apache::mod::passenger (
  Boolean $manage_repo                                                                       = true,
  Optional[String] $mod_id                                                                   = undef,
  Optional[String] $mod_lib                                                                  = undef,
  Optional[String] $mod_lib_path                                                             = undef,
  Optional[String] $mod_package                                                              = undef,
  Optional[String] $mod_package_ensure                                                       = undef,
  Optional[String] $mod_path                                                                 = undef,
  Optional[Integer] $passenger_max_request_queue_time                                        = undef,
  Optional[String] $passenger_admin_panel_url                                                = undef,
  Optional[Enum['basic']] $passenger_admin_panel_auth_type                                   = undef,
  Optional[String] $passenger_admin_panel_username                                           = undef,
  Optional[String] $passenger_admin_panel_password                                           = undef,
  Optional[String] $passenger_app_log_file                                                   = undef,
  Optional[Apache::OnOff] $passenger_allow_encoded_slashes                                   = undef,
  Optional[String] $passenger_anonymous_telemetry_proxy                                      = undef,
  Optional[String] $passenger_app_env                                                        = undef,
  Optional[String] $passenger_app_group_name                                                 = undef,
  Optional[String] $passenger_app_root                                                       = undef,
  Optional[String] $passenger_app_type                                                       = undef,
  Optional[String] $passenger_base_uri                                                       = undef,
  Optional[Apache::OnOff] $passenger_buffer_response                                         = undef,
  Optional[Apache::OnOff] $passenger_buffer_upload                                           = undef,
  Optional[String] $passenger_concurrency_model                                              = undef,
  String $passenger_conf_file                                                                = $apache::params::passenger_conf_file,
  Optional[String] $passenger_conf_package_file                                              = $apache::params::passenger_conf_package_file,
  Optional[Stdlib::Absolutepath] $passenger_data_buffer_dir                                  = undef,
  Optional[String] $passenger_debug_log_file                                                 = undef,
  Optional[Apache::OnOff] $passenger_debugger                                                = undef,
  Optional[String] $passenger_default_group                                                  = undef,
  Optional[String] $passenger_default_ruby                                                   = $apache::params::passenger_default_ruby,
  Optional[String] $passenger_default_user                                                   = undef,
  Optional[Boolean] $passenger_disable_anonymous_telemetry                                   = undef,
  Optional[Boolean] $passenger_disable_log_prefix                                            = undef,
  Optional[Apache::OnOff] $passenger_disable_security_update_check                           = undef,
  Optional[Apache::OnOff] $passenger_enabled                                                 = undef,
  Optional[String] $passenger_dump_config_manifest                                           = undef,
  Optional[Apache::OnOff] $passenger_error_override                                          = undef,
  Optional[String] $passenger_file_descriptor_log_file                                       = undef,
  Optional[String] $passenger_fly_with                                                       = undef,
  Optional[Variant[Integer, String]] $passenger_force_max_concurrent_requests_per_process    = undef,
  Optional[Apache::OnOff] $passenger_friendly_error_pages                                    = undef,
  Optional[String] $passenger_group                                                          = undef,
  Optional[Apache::OnOff] $passenger_high_performance                                        = undef,
  Optional[String] $passenger_installed_version                                              = undef,
  Optional[String] $passenger_instance_registry_dir                                          = undef,
  Optional[Apache::OnOff] $passenger_load_shell_envvars                                      = undef,
  Optional[Boolean] $passenger_preload_bundler                                               = undef,
  Optional[Stdlib::Absolutepath] $passenger_log_file                                         = undef,
  Optional[Integer] $passenger_log_level                                                     = undef,
  Optional[Integer] $passenger_lve_min_uid                                                   = undef,
  Optional[Integer] $passenger_max_instances                                                 = undef,
  Optional[Integer] $passenger_max_instances_per_app                                         = undef,
  Optional[Integer] $passenger_max_pool_size                                                 = undef,
  Optional[Integer] $passenger_max_preloader_idle_time                                       = undef,
  Optional[Integer] $passenger_max_request_queue_size                                        = undef,
  Optional[Integer] $passenger_max_request_time                                              = undef,
  Optional[Integer] $passenger_max_requests                                                  = undef,
  Optional[Integer] $passenger_memory_limit                                                  = undef,
  Optional[String] $passenger_meteor_app_settings                                            = undef,
  Optional[Integer] $passenger_min_instances                                                 = undef,
  Optional[String] $passenger_nodejs                                                         = undef,
  Optional[Integer] $passenger_pool_idle_time                                                = undef,
  Optional[Variant[String, Array[String]]] $passenger_pre_start                              = undef,
  Optional[String] $passenger_python                                                         = undef,
  Optional[Apache::OnOff] $passenger_resist_deployment_errors                                = undef,
  Optional[Apache::OnOff] $passenger_resolve_symlinks_in_document_root                       = undef,
  Optional[Variant[Integer, String]] $passenger_response_buffer_high_watermark               = undef,
  Optional[String] $passenger_restart_dir                                                    = undef,
  Optional[Apache::OnOff] $passenger_rolling_restarts                                        = undef,
  Optional[String] $passenger_root                                                           = $apache::params::passenger_root,
  Optional[String] $passenger_ruby                                                           = $apache::params::passenger_ruby,
  Optional[String] $passenger_security_update_check_proxy                                    = undef,
  Optional[Apache::OnOff] $passenger_show_version_in_header                                  = undef,
  Optional[Variant[Integer, String]] $passenger_socket_backlog                               = undef,
  Optional[String] $passenger_spawn_dir                                                      = undef,
  Optional[Enum['smart', 'direct', 'smart-lv2', 'conservative']] $passenger_spawn_method     = undef,
  Optional[Integer] $passenger_start_timeout                                                 = undef,
  Optional[String] $passenger_startup_file                                                   = undef,
  Optional[Integer] $passenger_stat_throttle_rate                                            = undef,
  Optional[Apache::OnOff] $passenger_sticky_sessions                                         = undef,
  Optional[String] $passenger_sticky_sessions_cookie_name                                    = undef,
  Optional[String] $passenger_sticky_sessions_cookie_attributes                              = undef,
  Optional[Integer] $passenger_thread_count                                                  = undef,
  Optional[String] $passenger_use_global_queue                                               = undef,
  Optional[String] $passenger_user                                                           = undef,
  Optional[Apache::OnOff] $passenger_user_switching                                          = undef,
  Optional[String] $rack_env                                                                 = undef,
  Optional[String] $rails_env                                                                = undef,
  Optional[String] $rails_framework_spawner_idle_time                                        = undef,
) inherits apache::params {
  include apache
  if $passenger_installed_version {
    if $passenger_anonymous_telemetry_proxy {
      if (versioncmp($passenger_installed_version, '6.0.0') < 0) {
        fail("Passenger config option :: passenger_anonymous_telemetry_proxy is not introduced until version 6.0.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_app_type {
      if (versioncmp($passenger_installed_version, '4.0.25') < 0) {
        fail("Passenger config option :: passenger_app_type is not introduced until version 4.0.25 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_buffer_upload {
      if (versioncmp($passenger_installed_version, '4.0.26') < 0) {
        fail("Passenger config option :: passenger_buffer_upload is not introduced until version 4.0.26 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_data_buffer_dir {
      if (versioncmp($passenger_installed_version, '5.0.0') < 0) {
        fail("Passenger config option :: passenger_data_buffer_dir is not introduced until version 5.0.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_debug_log_file {
      if (versioncmp($passenger_installed_version, '5.0.5') > 0) {
        warning('DEPRECATED PASSENGER OPTION :: passenger_debug_log_file :: This option has been renamed in version 5.0.5 to PassengerLogFile.')
      }
    }
    if $passenger_disable_anonymous_telemetry {
      if (versioncmp($passenger_installed_version, '6.0.0') < 0) {
        fail("Passenger config option :: passenger_disable_anonymous_telemetry is not introduced until version 6.0.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_disable_log_prefix {
      if (versioncmp($passenger_installed_version, '6.0.2') < 0) {
        fail("Passenger config option :: passenger_disable_log_prefix is not introduced until version 6.0.2 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_disable_security_update_check {
      if (versioncmp($passenger_installed_version, '5.1.0') < 0) {
        fail("Passenger config option :: passenger_disable_security_update_check is not introduced until version 5.1.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_error_override {
      if (versioncmp($passenger_installed_version, '4.0.24') < 0) {
        fail("Passenger config option :: passenger_error_override is not introduced until version 4.0.24 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_file_descriptor_log_file {
      if (versioncmp($passenger_installed_version, '5.0.5') < 0) {
        fail("Passenger config option :: passenger_file_descriptor_log_file is not introduced until version 5.0.5 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_fly_with {
      if (versioncmp($passenger_installed_version, '4.0.45') < 0) {
        fail("Passenger config option :: passenger_fly_with is not introduced until version 4.0.45 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_force_max_concurrent_requests_per_process {
      if (versioncmp($passenger_installed_version, '5.0.22') < 0) {
        fail("Passenger config option :: passenger_force_max_concurrent_requests_per_process is not introduced until version 5.0.22 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_friendly_error_pages {
      if (versioncmp($passenger_installed_version, '4.0.42') < 0) {
        fail("Passenger config option :: passenger_friendly_error_pages is not introduced until version 4.0.42 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_instance_registry_dir {
      if (versioncmp($passenger_installed_version, '5.0.0') < 0) {
        fail("Passenger config option :: passenger_instance_registry_dir is not introduced until version 5.0.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_load_shell_envvars {
      if (versioncmp($passenger_installed_version, '4.0.20') < 0) {
        fail("Passenger config option :: passenger_load_shell_envvars is not introduced until version 4.0.20 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_preload_bundler {
      if (versioncmp($passenger_installed_version, '6.0.13') < 0) {
        fail("Passenger config option :: passenger_preload_bundler is not introduced until version 6.0.13 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_log_file {
      if (versioncmp($passenger_installed_version, '5.0.5') < 0) {
        fail("Passenger config option :: passenger_log_file is not introduced until version 5.0.5 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_lve_min_uid {
      if (versioncmp($passenger_installed_version, '5.0.28') < 0) {
        fail("Passenger config option :: passenger_lve_min_uid is not introduced until version 5.0.28 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_max_request_queue_size {
      if (versioncmp($passenger_installed_version, '4.0.15') < 0) {
        fail("Passenger config option :: passenger_max_request_queue_size is not introduced until version 4.0.15 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_meteor_app_settings {
      if (versioncmp($passenger_installed_version, '5.0.7') < 0) {
        fail("Passenger config option :: passenger_meteor_app_settings is not introduced until version 5.0.7 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_nodejs {
      if (versioncmp($passenger_installed_version, '4.0.24') < 0) {
        fail("Passenger config option :: passenger_nodejs is not introduced until version 4.0.24 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_response_buffer_high_watermark {
      if (versioncmp($passenger_installed_version, '5.0.0') < 0) {
        fail("Passenger config option :: passenger_response_buffer_high_watermark is not introduced until version 5.0.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_security_update_check_proxy {
      if (versioncmp($passenger_installed_version, '5.1.0') < 0) {
        fail("Passenger config option :: passenger_security_update_check_proxy is not introduced until version 5.1.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_show_version_in_header {
      if (versioncmp($passenger_installed_version, '5.1.0') < 0) {
        fail("Passenger config option :: passenger_show_version_in_header is not introduced until version 5.1.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_socket_backlog {
      if (versioncmp($passenger_installed_version, '5.0.24') < 0) {
        fail("Passenger config option :: passenger_socket_backlog is not introduced until version 5.0.24 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_spawn_dir {
      if (versioncmp($passenger_installed_version, '6.0.3') < 0) {
        fail("Passenger config option :: passenger_spawn_dir is not introduced until version 6.0.3 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_start_timeout {
      if (versioncmp($passenger_installed_version, '4.0.15') < 0) {
        fail("Passenger config option :: passenger_start_timeout is not introduced until version 4.0.15 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_startup_file {
      if (versioncmp($passenger_installed_version, '4.0.25') < 0) {
        fail("Passenger config option :: passenger_startup_file is not introduced until version 4.0.25 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_sticky_sessions {
      if (versioncmp($passenger_installed_version, '4.0.45') < 0) {
        fail("Passenger config option :: passenger_sticky_sessions is not introduced until version 4.0.45 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_sticky_sessions_cookie_name {
      if (versioncmp($passenger_installed_version, '4.0.45') < 0) {
        fail("Passenger config option :: passenger_sticky_sessions_cookie_name is not introduced until version 4.0.45 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_sticky_sessions_cookie_attributes {
      if (versioncmp($passenger_installed_version, '6.0.5') < 0) {
        fail("Passenger config option :: passenger_sticky_sessions_cookie_attributes is not introduced until version 6.0.5 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_max_request_queue_time {
      if (versioncmp($passenger_installed_version, '5.1.12') < 0) {
        fail("Passenger config option :: passenger_base_uri is not introduced until version 5.1.12 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_admin_panel_url {
      if (versioncmp($passenger_installed_version, '5.2.2') < 0) {
        fail("Passenger config option :: passenger_admin_panel_url is not introduced until version 5.2.2 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_admin_panel_auth_type {
      if (versioncmp($passenger_installed_version, '5.2.2') < 0) {
        fail("Passenger config option :: passenger_admin_panel_auth_type is not introduced until version 5.2.2 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_admin_panel_username {
      if (versioncmp($passenger_installed_version, '5.2.2') < 0) {
        fail("Passenger config option :: passenger_admin_panel_username is not introduced until version 5.2.2 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_admin_panel_password {
      if (versioncmp($passenger_installed_version, '5.2.2') < 0) {
        fail("Passenger config option :: passenger_admin_panel_password is not introduced until version 5.2.2 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_dump_config_manifest {
      if (versioncmp($passenger_installed_version, '5.2.2') < 0) {
        fail("Passenger config option :: passenger_dump_config_manifest is not introduced until version 5.2.2 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_app_log_file {
      if (versioncmp($passenger_installed_version, '5.3.0') < 0) {
        fail("Passenger config option :: passenger_app_log_file is not introduced until version 5.3.0 :: ${passenger_installed_version} is the version reported")
      }
    }
    if $passenger_resist_deployment_errors {
      if (versioncmp($passenger_installed_version, '5.2.0') > 0) {
        fail('REMOVED PASSENGER OPTION :: passenger_resist_deployment_errors :: -- no message on the current passenger reference webpage -- ')
      }
    }
  }
  # Managed by the package, but declare it to avoid purging
  if $passenger_conf_package_file {
    file { 'passenger_package.conf':
      path => "${apache::confd_dir}/${passenger_conf_package_file}",
    }
  }

  $_package = $mod_package
  $_package_ensure = $mod_package_ensure
  $_lib = $mod_lib
  if $facts['os']['family'] == 'FreeBSD' {
    if $mod_lib_path {
      $_lib_path = $mod_lib_path
    } else {
      $_lib_path = "${passenger_root}/buildout/apache2"
    }
  } else {
    $_lib_path = $mod_lib_path
  }

  if $facts['os']['family'] == 'RedHat' and $manage_repo {
    if $facts['os']['name'] == 'Amazon' {
      if $facts['os']['release']['major'] == '2' {
        $baseurl = 'https://oss-binaries.phusionpassenger.com/yum/passenger/el/7/$basearch'
      } else {
        $baseurl = 'https://oss-binaries.phusionpassenger.com/yum/passenger/el/6/$basearch'
      }
    } else {
      $baseurl = 'https://oss-binaries.phusionpassenger.com/yum/passenger/el/$releasever/$basearch'
    }

    yumrepo { 'passenger':
      ensure        => 'present',
      baseurl       => $baseurl,
      descr         => 'passenger',
      enabled       => '1',
      gpgcheck      => '0',
      gpgkey        => 'https://oss-binaries.phusionpassenger.com/auto-software-signing-gpg-key.txt',
      repo_gpgcheck => '1',
      sslcacert     => '/etc/pki/tls/certs/ca-bundle.crt',
      sslverify     => '1',
      before        => Apache::Mod['passenger'],
    }
  }

  unless ($facts['os']['name'] == 'SLES') {
    $_id = $mod_id
    $_path = $mod_path
    ::apache::mod { 'passenger':
      package        => $_package,
      package_ensure => $_package_ensure,
      lib            => $_lib,
      lib_path       => $_lib_path,
      id             => $_id,
      path           => $_path,
      loadfile_name  => 'zpassenger.load',
    }
  }

  # Template uses:
  # - $passenger_allow_encoded_slashes : since 4.0.0.
  # - $passenger_app_env : since 4.0.0.
  # - $passenger_app_group_name : since 4.0.0.
  # - $passenger_app_root : since 4.0.0.
  # - $passenger_app_type : since 4.0.25.
  # - $passenger_base_uri : since 4.0.0.
  # - $passenger_buffer_response : since 4.0.0.
  # - $passenger_buffer_upload : since 4.0.26.
  # - $passenger_concurrency_model : since 4.0.0.
  # - $passenger_data_buffer_dir : since 5.0.0.
  # - $passenger_debug_log_file : since unkown. Deprecated in 5.0.5.
  # - $passenger_debugger : since 3.0.0.
  # - $passenger_default_group : since 3.0.0.
  # - $passenger_default_ruby : since 4.0.0.
  # - $passenger_default_user : since 3.0.0.
  # - $passenger_disable_security_update_check : since 5.1.0.
  # - $passenger_enabled : since 4.0.0.
  # - $passenger_error_override : since 4.0.24.
  # - $passenger_file_descriptor_log_file : since 5.0.5.
  # - $passenger_fly_with : since 4.0.45.
  # - $passenger_force_max_concurrent_requests_per_process : since 5.0.22.
  # - $passenger_friendly_error_pages : since 4.0.42.
  # - $passenger_group : since 4.0.0.
  # - $passenger_high_performance : since 2.0.0.
  # - $passenger_instance_registry_dir : since 5.0.0.
  # - $passenger_load_shell_envvars : since 4.0.20.
  # - $passenger_preload_bundler : since 6.0.13
  # - $passenger_log_file : since 5.0.5.
  # - $passenger_log_level : since 3.0.0.
  # - $passenger_lve_min_uid : since 5.0.28.
  # - $passenger_max_instances : since 3.0.0.
  # - $passenger_max_instances_per_app : since 3.0.0.
  # - $passenger_max_pool_size : since 1.0.0.
  # - $passenger_max_preloader_idle_time : since 4.0.0.
  # - $passenger_max_request_queue_size : since 4.0.15.
  # - $passenger_max_request_time : since 3.0.0.
  # - $passenger_max_requests : since 3.0.0.
  # - $passenger_memory_limit : since 3.0.0.
  # - $passenger_meteor_app_settings : since 5.0.7.
  # - $passenger_min_instances : since 3.0.0.
  # - $passenger_nodejs : since 4.0.24.
  # - $passenger_pool_idle_time : since 1.0.0.
  # - $passenger_pre_start : since 3.0.0.
  # - $passenger_python : since 4.0.0.
  # - $passenger_resist_deployment_errors : since 3.0.0.
  # - $passenger_resolve_symlinks_in_document_root : since 3.0.0.
  # - $passenger_response_buffer_high_watermark : since 5.0.0.
  # - $passenger_restart_dir : since 3.0.0.
  # - $passenger_rolling_restarts : since 3.0.0.
  # - $passenger_root : since 1.0.0.
  # - $passenger_ruby : since 4.0.0.
  # - $passenger_security_update_check_proxy : since 5.1.0.
  # - $passenger_show_version_in_header : since 5.1.0.
  # - $passenger_socket_backlog : since 5.0.24.
  # - $passenger_spawn_method : since 2.0.0.
  # - $passenger_start_timeout : since 4.0.15.
  # - $passenger_startup_file : since 4.0.25.
  # - $passenger_stat_throttle_rate : since 2.2.0.
  # - $passenger_sticky_sessions : since 4.0.45.
  # - $passenger_sticky_sessions_cookie_name : since 4.0.45.
  # - $passenger_thread_count : since 4.0.0.
  # - $passenger_user : since 4.0.0.
  # - $passenger_user_switching : since 3.0.0.
  # - $passenger_dump_config_manifest : since 5.2.2
  # - $passenger_admin_panel_url : since 5.2.2
  # - $passenger_admin_panel_auth_type : since 5.2.2
  # - $passenger_admin_panel_username : since 5.2.2
  # - $passenger_admin_panel_password : since 5.2.2
  # - $passenger_app_log_file : since 5.3.0
  # - $passenger_max_request_queue_time : since 5.1.12

  $parameters = {
    'passenger_admin_panel_url'                           => $passenger_admin_panel_url,
    'passenger_admin_panel_auth_type'                     => $passenger_admin_panel_auth_type,
    'passenger_admin_panel_username'                      => $passenger_admin_panel_username,
    'passenger_admin_panel_password'                      => $passenger_admin_panel_password,
    'passenger_allow_encoded_slashes'                     => $passenger_allow_encoded_slashes,
    'passenger_anonymous_telemetry_proxy'                 => $passenger_anonymous_telemetry_proxy,
    'passenger_app_env'                                   => $passenger_app_env,
    'passenger_app_group_name'                            => $passenger_app_group_name,
    'passenger_app_log_file'                              => $passenger_app_log_file,
    'passenger_app_root'                                  => $passenger_app_root,
    'passenger_app_type'                                  => $passenger_app_type,
    'passenger_base_uri'                                  => $passenger_base_uri,
    'passenger_buffer_response'                           => $passenger_buffer_response,
    'passenger_buffer_upload'                             => $passenger_buffer_upload,
    'passenger_concurrency_model'                         => $passenger_concurrency_model,
    'passenger_data_buffer_dir'                           => $passenger_data_buffer_dir,
    'passenger_debug_log_file'                            => $passenger_debug_log_file,
    'passenger_debugger'                                  => $passenger_debugger,
    'passenger_default_group'                             => $passenger_default_group,
    'passenger_default_ruby'                              => $passenger_default_ruby,
    'passenger_default_user'                              => $passenger_default_user,
    'passenger_disable_anonymous_telemetry'               => $passenger_disable_anonymous_telemetry,
    'passenger_disable_log_prefix'                        => $passenger_disable_log_prefix,
    'passenger_disable_security_update_check'             => $passenger_disable_security_update_check,
    'passenger_enabled'                                   => $passenger_enabled,
    'passenger_error_override'                            => $passenger_error_override,
    'passenger_file_descriptor_log_file'                  => $passenger_file_descriptor_log_file,
    'passenger_fly_with'                                  => $passenger_fly_with,
    'passenger_force_max_concurrent_requests_per_process' => $passenger_force_max_concurrent_requests_per_process,
    'passenger_friendly_error_pages'                      => $passenger_friendly_error_pages,
    'passenger_group'                                     => $passenger_group,
    'passenger_high_performance'                          => $passenger_high_performance,
    'passenger_instance_registry_dir'                     => $passenger_instance_registry_dir,
    'passenger_load_shell_envvars'                        => $passenger_load_shell_envvars,
    'passenger_preload_bundler'                           => $passenger_preload_bundler,
    'passenger_log_file'                                  => $passenger_log_file,
    'passenger_dump_config_manifest'                      => $passenger_dump_config_manifest,
    'passenger_log_level'                                 => $passenger_log_level,
    'passenger_lve_min_uid'                               => $passenger_lve_min_uid,
    'passenger_max_instances'                             => $passenger_max_instances,
    'passenger_max_instances_per_app'                     => $passenger_max_instances_per_app,
    'passenger_max_pool_size'                             => $passenger_max_pool_size,
    'passenger_max_preloader_idle_time'                   => $passenger_max_preloader_idle_time,
    'passenger_max_request_queue_size'                    => $passenger_max_request_queue_size,
    'passenger_max_request_queue_time'                    => $passenger_max_request_queue_time,
    'passenger_max_request_time'                          => $passenger_max_request_time,
    'passenger_max_requests'                              => $passenger_max_requests,
    'passenger_memory_limit'                              => $passenger_memory_limit,
    'passenger_meteor_app_settings'                       => $passenger_meteor_app_settings,
    'passenger_min_instances'                             => $passenger_min_instances,
    'passenger_nodejs'                                    => $passenger_nodejs,
    'passenger_pool_idle_time'                            => $passenger_pool_idle_time,
    'passenger_pre_start'                                 => $passenger_pre_start,
    'passenger_python'                                    => $passenger_python,
    'passenger_resist_deployment_errors'                  => $passenger_resist_deployment_errors,
    'passenger_resolve_symlinks_in_document_root'         => $passenger_resolve_symlinks_in_document_root,
    'passenger_response_buffer_high_watermark'            => $passenger_response_buffer_high_watermark,
    'passenger_restart_dir'                               => $passenger_restart_dir,
    'passenger_rolling_restarts'                          => $passenger_rolling_restarts,
    'passenger_root'                                      => $passenger_root,
    'passenger_ruby'                                      => $passenger_ruby,
    'passenger_security_update_check_proxy'               => $passenger_security_update_check_proxy,
    'passenger_show_version_in_header'                    => $passenger_show_version_in_header,
    'passenger_socket_backlog'                            => $passenger_socket_backlog,
    'passenger_spawn_dir'                                 => $passenger_spawn_dir,
    'passenger_spawn_method'                              => $passenger_spawn_method,
    'passenger_start_timeout'                             => $passenger_start_timeout,
    'passenger_startup_file'                              => $passenger_startup_file,
    'passenger_stat_throttle_rate'                        => $passenger_stat_throttle_rate,
    'passenger_sticky_sessions'                           => $passenger_sticky_sessions,
    'passenger_sticky_sessions_cookie_name'               => $passenger_sticky_sessions_cookie_name,
    'passenger_sticky_sessions_cookie_attributes'         => $passenger_sticky_sessions_cookie_attributes,
    'passenger_thread_count'                              => $passenger_thread_count,
    'passenger_use_global_queue'                          => $passenger_use_global_queue,
    'passenger_user'                                      => $passenger_user,
    'passenger_user_switching'                            => $passenger_user_switching,
    'rack_env'                                            => $rack_env,
    'rails_env'                                           => $rails_env,
    'rails_framework_spawner_idle_time'                   => $rails_framework_spawner_idle_time,
  }

  file { 'passenger.conf':
    ensure  => file,
    path    => "${apache::mod_dir}/${passenger_conf_file}",
    content => epp('apache/mod/passenger.conf.epp', $parameters),
    require => Exec["mkdir ${apache::mod_dir}"],
    before  => File[$apache::mod_dir],
    notify  => Class['apache::service'],
  }
}