Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2026-03-21 15:53
📄 about_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2010-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' module PhusionPassenger module Config class AboutCommand < Command def self.help puts "Usage: passenger-config about <SUBCOMMAND>" puts puts " Show information about #{PROGRAM_NAME}." puts puts "Available subcommands:" puts " root Show #{PROGRAM_NAME}'s root." puts " ruby-libdir Show #{PROGRAM_NAME}'s Ruby library directory." puts " includedir Show the Nginx runtime library headers directory." puts " nginx-addon-dir Show #{PROGRAM_NAME}'s Nginx addon directory." puts " nginx-libs Show paths to #{PROGRAM_NAME}'s libraries" puts " for static linking to Nginx runtime." puts " nginx-dynamic-libs Show paths to #{PROGRAM_NAME}'s libraries" puts " for dynamic linking to Nginx runtime." puts " nginx-dynamic-compiled Check whether runtime libraries for dynamic" puts " linking to Nginx are compiled." puts " resourcesdir Show #{PROGRAM_NAME}'s resources directory." puts " support-binaries-dir Show #{PROGRAM_NAME}'s support binaries dir." puts " compiled Check whether runtime libraries are compiled." puts " custom-packaged Check whether Phusion Passenger is custom" puts " packaged." puts " installed-from-release-package Check whether this installation came from" puts " an official release package." puts " make-locations-ini Generate a locations.ini based on the current" puts " install paths." puts " detect-apache2 Autodetect Apache installations." puts " ruby-command Show the correct command for invoking the Ruby" puts " interpreter." puts " rubyext-compat-id Show the Ruby extension binary compatibility ID." puts " cxx-compat-id Show the C++ binary compatibility ID." puts " version Show the version number." end def run PhusionPassenger.require_passenger_lib 'platform_info' PhusionPassenger.require_passenger_lib 'platform_info/compiler' subcommand = @argv[0].to_s.dup # Compatibility with version <= 4.0.29: accept both # 'subcommand' and '--subcommand'. subcommand = "--#{subcommand}" if subcommand !~ /^--/ case subcommand when "--root" puts PhusionPassenger.install_spec when "--ruby-libdir" puts PhusionPassenger.ruby_libdir when "--includedir" puts PhusionPassenger.include_dir when "--nginx-addon-dir" puts PhusionPassenger.nginx_module_source_dir when "--nginx-libs" puts "#{common_library.link_objects_as_string} #{PhusionPassenger.lib_dir}/common/libboost_oxt.a" when "--nginx-dynamic-libs" puts "#{common_dynamic_library.link_objects_as_string} #{PhusionPassenger.lib_dir}/nginx_dynamic/libboost_oxt.a" when "--resourcesdir" puts PhusionPassenger.resources_dir when "--support-binaries-dir" puts PhusionPassenger.support_binaries_dir when "--compiled" common_library.link_objects.each do \|filename\| if !File.exist?(filename) exit 1 end end if File.exist?("#{PhusionPassenger.lib_dir}/common/libboost_oxt.a") exit 0 else exit 1 end when "--nginx-dynamic-compiled" common_dynamic_library.link_objects.each do \|filename\| if !File.exist?(filename) exit 1 end end if File.exist?("#{PhusionPassenger.lib_dir}/nginx_dynamic/libboost_oxt.a") exit 0 else exit 1 end when "--custom-packaged" if PhusionPassenger.custom_packaged? exit 0 else exit 1 end when "--installed-from-release-package" if PhusionPassenger.installed_from_release_package? exit 0 else exit 1 end when "--make-locations-ini" if @argv[1] =~ /^--for-(native-)?packaging-method=(.)/ packaging_method = $2 else packaging_method = nil end puts "[locations]" if packaging_method puts "packaging_method=#{packaging_method}" else if PhusionPassenger.custom_packaged? puts "packaging_method=#{PhusionPassenger.packaging_method}" else puts "packaging_method=unknown" end end PhusionPassenger::REQUIRED_LOCATIONS_INI_FIELDS.each do \|field\| puts "#{field}=#{PhusionPassenger.send(field)}" end PhusionPassenger::OPTIONAL_LOCATIONS_INI_FIELDS.each do \|field\| value = PhusionPassenger.send(field) puts "#{field}=#{value}" if value end when "--detect-apache2" PhusionPassenger.require_passenger_lib 'platform_info/apache_detector' detector = PhusionPassenger::PlatformInfo::ApacheDetector.new(STDOUT) STDOUT.write(Utils::AnsiColors::DEFAULT_TERMINAL_COLOR) STDOUT.flush begin detector.detect_all detector.report ensure detector.finish STDOUT.write(Utils::AnsiColors::RESET) STDOUT.flush end when "--ruby-command" PhusionPassenger.require_passenger_lib 'platform_info/ruby' ruby = PhusionPassenger::PlatformInfo.ruby_command puts "passenger-config was invoked through the following Ruby interpreter:" puts " Command: #{ruby}" STDOUT.write " Version: " STDOUT.flush system("/bin/sh -c '#{ruby} -v'") puts " To use in Apache: PassengerRuby #{ruby}" puts " To use in Nginx : passenger_ruby #{ruby}" puts " To use with Standalone: #{ruby} #{PhusionPassenger.bin_dir}/passenger start" puts ruby = PhusionPassenger::PlatformInfo.find_command('ruby') if ruby && !ruby.include?("rvm/rubies/") # If this is an RVM Ruby executable then we don't show it. We want people to # use the RVM wrapper scripts only. puts "The following Ruby interpreter was found first in $PATH:" puts " Command: #{ruby}" STDOUT.write " Version: " STDOUT.flush system("/bin/sh -c '#{ruby} -v'") puts " To use in Apache: PassengerRuby #{ruby}" puts " To use in Nginx : passenger_ruby #{ruby}" puts " To use with Standalone: #{ruby} #{PhusionPassenger.bin_dir}/passenger start" elsif !ruby.include?("rvm/rubies/") puts "No Ruby interpreter found in $PATH." end puts puts "## Notes for RVM users" puts "Do you want to know which command to use for a different Ruby interpreter? 'rvm use' that Ruby interpreter, then re-run 'passenger-config about ruby-command'." when "--rubyext-compat-id" PhusionPassenger.require_passenger_lib 'platform_info/binary_compatibility' puts PhusionPassenger::PlatformInfo.ruby_extension_binary_compatibility_id when "--cxx-compat-id" PhusionPassenger.require_passenger_lib 'platform_info/binary_compatibility' puts PhusionPassenger::PlatformInfo.cxx_binary_compatibility_id when "--version" if defined?(PhusionPassenger::PASSENGER_IS_ENTERPRISE) name = "#{PhusionPassenger::PROGRAM_NAME} Enterprise" else name = PhusionPassenger::PROGRAM_NAME end puts "#{name} #{PhusionPassenger::VERSION_STRING}" when "--help" self.class.help else self.class.help exit 1 end end private def common_library PhusionPassenger.require_passenger_lib 'common_library' return COMMON_LIBRARY. only(NGINX_LIBS_SELECTOR). set_output_dir("#{PhusionPassenger.lib_dir}/common/libpassenger_common") end def common_dynamic_library PhusionPassenger.require_passenger_lib 'common_library' return COMMON_LIBRARY. only(*NGINX_LIBS_SELECTOR). set_output_dir("#{PhusionPassenger.lib_dir}/nginx_dynamic/module_libpassenger_common") end end end # module Config end # module PhusionPassenger	10.02 KB	2025-11-20 11:36
📄 agent_compiler.rb # encoding: utf-8 # # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2010-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'fileutils' require 'logger' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'abstract_installer' PhusionPassenger.require_passenger_lib 'config/installation_utils' PhusionPassenger.require_passenger_lib 'platform_info' PhusionPassenger.require_passenger_lib 'utils/shellwords' PhusionPassenger.require_passenger_lib 'utils/progress_bar' PhusionPassenger.require_passenger_lib 'utils/tmpio' module PhusionPassenger module Config class AgentCompiler < AbstractInstaller protected def dependencies specs = [ 'depcheck_specs/compiler_toolchain', 'depcheck_specs/ruby', 'depcheck_specs/gems', 'depcheck_specs/libs', 'depcheck_specs/utilities' ] ids = [ 'cc', 'c++', 'rake', 'libcurl-dev', 'openssl-dev', 'zlib-dev' ].compact return [specs, ids] end def install_doc_url "https://www.phusionpassenger.com/library/install/standalone/" end def troubleshooting_doc_url "https://www.phusionpassenger.com/library/admin/standalone/troubleshooting/" end def run_steps check_source_code_available! if !@force check_whether_os_is_broken check_whether_system_has_enough_ram InstallationUtils.check_for_download_tool! end check_dependencies(false) \|\| abort puts @destdir = InstallationUtils.find_or_create_writable_support_binaries_dir! confirm_enable_optimizations compile_agent end def before_install super if !@working_dir @working_dir = PhusionPassenger::Utils.mktmpdir("passenger-install.", PlatformInfo.tmpexedir) @owns_working_dir = true end end def after_install super FileUtils.remove_entry_secure(@working_dir) if @owns_working_dir end private def check_source_code_available! if PhusionPassenger.build_system_dir.nil? puts "<red>Cannot compile agent binary</red>" puts puts "This #{PROGRAM_NAME} installation does not " + "come with any source code, so the agent binary cannot " + "be compiled. So instead, please try to download a " + "precompiled agent binary from the #{PROGRAM_NAME} website, " + "by running:\n\n" + " <b>passenger-config download-agent</b>" abort end end def confirm_enable_optimizations if @auto if @optimize puts "Compiling with optimizations." else puts "Not compiling with optimizations." end else if @optimize puts "Compiling with optimizations." else new_screen render_template 'config/agent_compiler/confirm_enable_optimizations', :total_ram => total_ram_gb puts @optimize = prompt_confirmation('Compile with optimizations?') puts end end end def compile_agent puts "<banner>Compiling #{PROGRAM_NAME} agent...</banner>" progress_bar = ProgressBar.new e_working_dir = Shellwords.escape(@working_dir) args = "#{e_working_dir}/support-binaries/#{AGENT_EXE}" \ " CACHING=false" \ " OUTPUT_DIR=#{e_working_dir} " \ " OPTIMIZE=#{!!@optimize}" begin progress_bar.set(0) Dir.chdir(PhusionPassenger.build_system_dir) do InstallationUtils.run_rake_task!(args) do \|progress, total\| progress_bar.set(0.05 + (progress / total.to_f) * 0.95) end end progress_bar.set(1) ensure progress_bar.finish end FileUtils.cp("#{@working_dir}/support-binaries/#{AGENT_EXE}", "#{@destdir}/#{AGENT_EXE}") puts "<green>Compilation finished!</green>" end def total_ram_gb begin meminfo = File.read("/proc/meminfo") if meminfo =~ /^MemTotal: *(\d+) kB$/ return sprintf("%.1f", $1.to_i / 1024 / 1024) end rescue Errno::ENOENT, Errno::EACCES # Don't do anything on systems without memory information. return nil end end end end # module Standalone end # module PhusionPassenger	5.65 KB	2025-11-20 11:36
📄 api_call_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'net/http' require 'socket' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'admin_tools/instance_registry' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/utils' PhusionPassenger.require_passenger_lib 'utils/json' module PhusionPassenger module Config class ApiCallCommand < Command include PhusionPassenger::Config::Utils def self.create_default_options { :agent_name => "core_api" } end def run parse_options initialize_objects infer_socket_path_and_credentials invoke end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config api-call <METHOD> <PATH> [OPTIONS]\n" opts.separator "" opts.separator " Makes an API call to one of the #{PROGRAM_NAME} agents. #{PROGRAM_NAME}" opts.separator " listens on a local HTTP server for admin commands. Many `passenger-config`" opts.separator " commands are just shortcuts for sending HTTP API calls to the" opts.separator " #{PROGRAM_NAME} admin HTTP server. `passenger-config api-call` allows" opts.separator " you to send API calls directly." opts.separator "" opts.separator " METHOD is an HTTP verb, like 'GET', 'POST', 'PUT' or 'DELETE'." opts.separator " PATH is the admin URI. You can pass POST data with '-d'." opts.separator "" opts.separator " Example 1: passenger-config api-call GET /server.json" opts.separator " Sends the 'GET /server.json' command to the Passenger core process." opts.separator "" opts.separator " Example 2: passenger-config api-call PUT /config.json \\" opts.separator " -d '{\"log_level\", 7}'" opts.separator " Sends the 'PUT /config.json' command to the Passenger core process, with" opts.separator " the given PUT data." opts.separator "" opts.separator " Example 3: passenger-config api-call POST /shutdown.json -a watchdog_api" opts.separator " Sends the 'POST /shutdown.json' command to the watchdog, with no POST data." opts.separator "" opts.separator " Example 4: passenger-config api-call POST /shutdown.json \\" opts.separator " -S /tmp/watchdog.sock" opts.separator " Sends the 'POST /shutdown.json' command to the watchdog listening at the" opts.separator " specific socket file /tmp/watchdog.sock. No POST data." opts.separator "" opts.separator "Options:" opts.on("-d", "--data DATA", String, "Specify HTTP request body data") do \|value\| options[:data] = value end opts.on("-i", "--stdin", "Read HTTP request body data from stdin") do options[:data_source] = :stdin end opts.on("-f", "--data-file PATH", String, "Read HTTP request body data from the given#{nl}" + "file") do \|value\| options[:data_source] = value end opts.on("-a", "--agent NAME", String, "The name of the socket to send the command#{nl}" + "to. This specifies which agent the request#{nl}" + "is sent to. Choices: watchdog_api,#{nl}" + "core_api.#{nl}" + "Default: core_api") do \|val\| options[:agent_name] = val end opts.on("-S", "--socket PATH", String, "Instead of inferring the socket path from#{nl}" + "the #{PROGRAM_NAME} instance directory#{nl}" + "and agent name, send the command to a#{nl}" + "specific Unix domain socket directly") do \|val\| options[:socket_path] = val end opts.on("--show-headers", "Show HTTP response headers") do options[:show_headers] = true end opts.on("--ignore-response-code", "Exit successfully even if a non-2xx#{nl}" + "response was returned") do options[:ignore_response_code] = true end opts.on("--instance NAME", String, "The #{PROGRAM_NAME} instance to select") do \|value\| options[:instance] = value end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def initialize_objects if @argv.size != 2 abort "You've passed to few arguments. See --help for more information." end @method = @argv[0] @path = @argv[1] case @method.upcase when "GET" @request = Net::HTTP::Get.new(@path) when "POST" @request = Net::HTTP::Post.new(@path) when "PUT" @request = Net::HTTP::Put.new(@path) when "DELETE" @request = Net::HTTP::Delete.new(@path) else abort "Unknown method #{@method.inspect}. Please specify either GET, POST, PUT or DELETE." end if @path !~ /\A\// abort "The path must start with a slash (/). See --help for more information." end if @options[:data] && @options[:data_source] abort "You cannot specify both --data and --stdin/--data-file. Please choose either one." end if @options[:data_source] == :stdin STDIN.binmode @options[:data] = STDIN.read elsif @options[:data_source] File.open(@options[:data_source], "rb") do \|f\| @options[:data] = f.read end end end def infer_socket_path_and_credentials if @options[:socket_path] @socket_path = @options[:socket_path] else select_passenger_instance @socket_path = "#{@instance.path}/agents.s/#{@options[:agent_name]}" begin @password = @instance.full_admin_password rescue Errno::EACCES end end end def invoke if @password @request.basic_auth("admin", @password) end @request["connection"] = "close" if @options[:data] @request.content_type = "application/json" @request.body = @options[:data] end sock = Net::BufferedIO.new(UNIXSocket.new(@socket_path)) begin @request.exec(sock, "1.1", @request.path) done = false while !done response = Net::HTTPResponse.read_new(sock) done = !response.kind_of?(Net::HTTPContinue) end response.reading_body(sock, @request.response_body_permitted?) do # Nothing end ensure sock.close end if @options[:show_headers] print_headers(response) end puts response.body if !@options[:ignore_response_code] && response.code.to_i / 100 != 2 abort end end def print_headers(response) puts "HTTP/1.1 #{response.message} #{response.code}" response.each_header do \|name, val\| puts "#{name}: #{val}" end puts end end end # module Config end # module PhusionPassenger	8.44 KB	2025-11-20 11:36
📄 build_native_support_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' module PhusionPassenger module Config class BuildNativeSupportCommand < Command def run parse_options PhusionPassenger.require_passenger_lib 'native_support' end private def self.create_option_parser(options) PhusionPassenger.require_passenger_lib 'platform_info/ruby' OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config build-native-support [OPTIONS]\n" opts.separator "" opts.separator " #{PROGRAM_NAME} utilizes a Ruby native extension, called native_support," opts.separator " for improving Ruby performance. The extension depends on the" opts.separator " #{PROGRAM_NAME} version and the Ruby version. Normally, every time you run" opts.separator " a #{PROGRAM_NAME} version with a Ruby version that it hasn't encountered" opts.separator " before, it will rebuild the native_support library for that Ruby version." opts.separator " By running this command, you can force the native_support to be built for" opts.separator " the current Ruby interpreter." opts.separator "" opts.separator " The current Ruby interpreter is:" opts.separator " Path: #{PlatformInfo.ruby_command}" opts.separator " Version: #{RUBY_VERSION}" opts.separator "" opts.separator "Options:" opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def parse_options super if @argv.size > 0 help abort end end end end # module Config end # module PhusionPassenger	3.13 KB	2025-11-20 11:36
📄 command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2010-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. module PhusionPassenger module Config class Command def initialize(argv) @argv = argv.dup @options = self.class.create_default_options end def run_and_get_exit_code begin run exit(0) rescue SystemExit => e e.status end end private def self.create_default_options return {} end def parse_options @parser = self.class.create_option_parser(@options) begin @parser.parse!(@argv) rescue OptionParser::ParseError => e STDERR.puts "*** ERROR: #{e}" abort @parser.to_s end if @options[:help] puts @parser exit end end end end # module Config end # module PhusionPassenger	2.04 KB	2025-11-20 11:36
📄 compile_agent_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/agent_compiler' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' module PhusionPassenger module Config class CompileAgentCommand < Command include InstallationUtils def run @options = { :auto => !STDIN.tty? \|\| !STDOUT.tty?, :colorize => :auto, :force_tip => true } parse_options initialize_objects sanity_check if !AgentCompiler.new(@options).run abort end end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config compile-agent [OPTIONS]\n" opts.separator "" opts.separator " Compile the #{PROGRAM_NAME} agent binary. The agent binary is required for" opts.separator " #{PROGRAM_NAME} to function properly." opts.separator "" opts.separator "Options:" opts.on("--working-dir PATH", String, "Store temporary files in the given#{nl}" + "directory, instead of creating one") do \|val\| options[:working_dir] = val end opts.on("--auto", "Run in non-interactive mode. Default when#{nl}" + "stdin or stdout is not a TTY") do options[:auto] = true end opts.on("--optimize", "Compile agent with optimizations") do options[:optimize] = true end opts.on("-f", "--force", "Skip sanity checks") do options[:force] = true end opts.on("--no-force-tip", "Do not print any tips regarding the --force parameter") do options[:force_tip] = false end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def initialize_objects @colors = Utils::AnsiColors.new(@options[:colorize]) end def sanity_check return if @options[:force] if PhusionPassenger.find_support_binary(AGENT_EXE) puts "#{@colors.green}The #{PROGRAM_NAME} agent is already installed.#{@colors.reset}" if @options[:force_tip] puts "If you want to recompile it, re-run this program with the --force parameter." end exit end end end end # module Config end # module PhusionPassenger	3.78 KB	2025-11-20 11:36
📄 compile_nginx_engine_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/nginx_engine_compiler' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' module PhusionPassenger module Config class CompileNginxEngineCommand < Command include InstallationUtils def run @options = { :colorize => :auto, :force_tip => true, :connect_timeout => 30, :idle_timeout => 30, :address_sanitizer => false, } parse_options initialize_objects sanity_check if !NginxEngineCompiler.new(@options).run abort end end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config compile-nginx-engine [OPTIONS]\n" opts.separator "" opts.separator " Compile an Nginx engine, for use in #{PROGRAM_NAME} Standalone." opts.separator "" opts.separator "Options:" opts.on("--working-dir PATH", String, "Store temporary files in the given#{nl}" + "directory, instead of creating one") do \|val\| options[:working_dir] = val end opts.on("--nginx-version VERSION", String, "Nginx version to compile. " + "Default: #{PREFERRED_NGINX_VERSION}") do \|val\| options[:nginx_version] = val end opts.on("--nginx-tarball PATH", String, "Use the given Nginx tarball instead of#{nl}" + "downloading it. You MUST also specify the#{nl}" + "Nginx version with --nginx-version") do \|val\| options[:nginx_tarball] = File.absolute_path(val) end opts.on("-f", "--force", "Skip sanity checks") do options[:force] = true end opts.on("--no-force-tip", "Do not print any tips regarding the --force#{nl}" + "parameter") do options[:force_tip] = false end opts.on("--connect-timeout SECONDS", Integer, "The maximum amount of time to spend on DNS#{nl}" + "lookup and establishing the TCP connection.#{nl}" + "Default: 30") do \|val\| options[:connect_timeout] = val end opts.on("--idle-timeout SECONDS", Integer, "The maximum idle read time. Default: 30") do \|val\| options[:idle_timeout] = val end opts.on("--address-sanitizer", "Compile with AddressSanitizer support") do options[:address_sanitizer] = true end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def initialize_objects @colors = Utils::AnsiColors.new(@options[:colorize]) if !@options[:nginx_version] if @options[:nginx_tarball] abort "#{@colors.red}Error: if you specify --nginx-tarball, " + "you must also specify --nginx-version.#{@colors.reset}" else @options[:nginx_version] = PREFERRED_NGINX_VERSION end end end def sanity_check return if @options[:force] if PhusionPassenger.find_support_binary("nginx-#{@options[:nginx_version]}") puts "#{@colors.green}The Nginx engine (version #{@options[:nginx_version]}) " + "is already installed.#{@colors.reset}" if @options[:force_tip] puts "If you want to recompile it, re-run this program with the --force parameter." end exit end end end end # module Config end # module PhusionPassenger	4.99 KB	2025-11-20 11:36
📄 detach_process_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'net/http' require 'socket' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'admin_tools/instance_registry' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/utils' PhusionPassenger.require_passenger_lib 'utils/json' module PhusionPassenger module Config class DetachProcessCommand < Command include PhusionPassenger::Config::Utils def run parse_options select_passenger_instance perform_detach end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config detach-process [OPTIONS] <PID>\n" opts.separator "" opts.separator " Remove an application process from the #{PROGRAM_NAME} process pool, and" opts.separator " shut it down. Has a similar effect to killing the application process" opts.separator " directly with `kill <PID>`. But `kill` aborts any active requests, while" opts.separator " this command shuts down the process after active requests are finished." opts.separator "" opts.separator " If you want to force abort a process and its active requests, just use `kill`." opts.separator "" opts.separator "Options:" opts.on("--instance NAME", String, "The #{PROGRAM_NAME} instance to select") do \|value\| options[:instance] = value end opts.on("--ignore-nonexistant-pid", "Exit successfully even if the specified#{nl}" + "PID is not in the process pool.") do options[:ignore_nonexistant_pid] = true end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def parse_options super if @argv.empty? abort "Please pass a PID. " + "See --help for more information." elsif @argv.size == 1 @pid = @argv[0].to_i elsif @argv.size > 1 help abort end end def perform_detach request = Net::HTTP::Post.new("/pool/detach_process.json") try_performing_full_admin_basic_auth(request, @instance) request.content_type = "application/json" request.body = PhusionPassenger::Utils::JSON.generate(:pid => @pid) response = @instance.http_request("agents.s/core_api", request) if response.code.to_i / 100 == 2 body = PhusionPassenger::Utils::JSON.parse(response.body) if body['detached'] puts "Process #{@pid} detached." elsif @options[:ignore_nonexistant_pid] puts "Could not detach process #{@pid}." else abort "Could not detach process #{@pid}." end elsif response.code.to_i == 401 print_full_admin_command_permission_error abort else STDERR.puts "*** An error occured while communicating with the #{PROGRAM_NAME} server:" STDERR.puts response.body abort end end end end # module Config end # module PhusionPassenger	4.49 KB	2025-11-20 11:36
📄 download_agent_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'logger' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/installation_utils' PhusionPassenger.require_passenger_lib 'platform_info' PhusionPassenger.require_passenger_lib 'platform_info/binary_compatibility' PhusionPassenger.require_passenger_lib 'utils/download' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' PhusionPassenger.require_passenger_lib 'utils/shellwords' PhusionPassenger.require_passenger_lib 'utils/tmpio' module PhusionPassenger module Config class DownloadAgentCommand < Command include InstallationUtils BINARY_NOT_USABLE_EXIT_CODE = 3 def run @options = { :log_level => Logger::INFO, :colors => :auto, :error_colors => true, :show_download_progress => STDOUT.tty?, :compilation_tip => true, :force_tip => true, :use_cache => true, :connect_timeout => 30, :idle_timeout => 30 } parse_options initialize_objects sanity_check download_and_extract end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config download-agent [OPTIONS]\n" opts.separator "" opts.separator " Download a precompiled #{PROGRAM_NAME} agent binary from the" opts.separator " #{PROGRAM_NAME} website. The agent binary is required for #{PROGRAM_NAME}" opts.separator " to function properly. Precompiled binaries are only available for Linux and" opts.separator " OS X." opts.separator "" opts.separator "Options:" opts.on("--url-root URL", String, "Download the binary from a custom URL") do \|value\| options[:url_root] = value end opts.on("--log-prefix PREFIX", String, "Prefix all logs with the given string") do \|value\| options[:log_prefix] = value end opts.on("--log-level LEVEL", String, "Set log level (fatal,error,warn,info,#{nl}" + "debug). Default: info") do \|value\| case value when "fatal" options[:log_level] = Logger::FATAL when "error" options[:log_level] = Logger::ERROR when "warn" options[:log_level] = Logger::WARN when "info" options[:log_level] = Logger::INFO when "debug" options[:log_level] = Logger::DEBUG else abort "Invalid log level #{value.inspect}" end end opts.on("-f", "--force", "Skip sanity checks") do options[:force] = true end opts.on("--no-colors", "Never output colors") do options[:colors] = false end opts.on("--no-error-colors", "Do not colorized error messages") do options[:error_colors] = false end opts.on("--no-download-progress", "Never show download progress") do options[:show_download_progress] = false end opts.on("--no-compilation-tip", "Do not present compilation as an#{nl}" + "alternative way to install the agent") do options[:compilation_tip] = false end opts.on("--no-force-tip", "Do not print any tips regarding the#{nl}" + "--force parameter") do options[:force_tip] = false end opts.on("--skip-cache", "Do not copy the agent binary from cache") do options[:use_cache] = false end opts.on("--suppress-binary-unusable-message", "Do not print anything if the downloaded#{nl}" + "binary turns out to be unusable") do options[:suppress_binary_unusable_message] = true end opts.on("--dry-run", "Do everything except actually installing#{nl}" + "the binary") do options[:dry_run] = true end opts.on("--connect-timeout SECONDS", Integer, "The maximum amount of time to spend on DNS#{nl}" + "lookup and establishing the TCP connection.#{nl}" + "Default: 30") do \|val\| options[:connect_timeout] = val end opts.on("--idle-timeout SECONDS", Integer, "The maximum idle read time. Default: 30") do \|val\| options[:idle_timeout] = val end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def initialize_objects if @options[:url_root] @sites = [{ :url => @options[:url_root] }] else @sites = PhusionPassenger.binaries_sites end @colors = Utils::AnsiColors.new(@options[:colors]) @logger = Logger.new(STDOUT) @logger.level = @options[:log_level] @logger.formatter = proc do \|severity, datetime, progname, msg\| if @options[:error_colors] && (severity == "FATAL" \|\| severity == "ERROR") color = @colors.red else color = nil end result = "" msg.split("\n", -1).map do \|line\| result << "#{color}#{@options[:log_prefix]}#{line}#{@colors.reset}\n" end result end end def sanity_check return if @options[:force] if PhusionPassenger.find_support_binary(AGENT_EXE) @logger.warn "#{@colors.green}The #{PROGRAM_NAME} agent is already installed." if @options[:force_tip] @logger.warn "If you want to redownload it, re-run this program with the --force parameter." end exit end if !PhusionPassenger.installed_from_release_package? @logger.fatal("#{PROGRAM_NAME} was not installed from an official release " + "package, so you cannot download our precompiled agent binary." + compile_tip_message) if @options[:force_tip] @logger.warn "If you want to download it anyway, re-run this program with the --force parameter." end abort end check_for_download_tool! end def download_and_extract destdir = find_or_create_writable_support_binaries_dir! exit if @options[:dry_run] PhusionPassenger::Utils.mktmpdir("passenger-install.", PlatformInfo.tmpexedir) do \|tmpdir\| basename = "agent-#{PlatformInfo.cxx_binary_compatibility_id}.tar.gz" tarball = "#{tmpdir}/#{basename}" if !download_support_file(basename, tarball) @logger.error "#{@colors.reset}------------------------------------------" @logger.fatal("Sorry, no precompiled agent binary is available for " + "your platform." + compile_tip_message) abort end @logger.info "Extracting precompiled agent binary to #{destdir}..." e_tmpdir = Shellwords.escape(tmpdir) e_tarball = Shellwords.escape(tarball) if !system("cd #{e_tmpdir} && tar xzf #{e_tarball}") @logger.fatal "The downloaded archive file could not be extracted." abort end if !File.exist?("#{tmpdir}/#{AGENT_EXE}") @logger.fatal "The downloaded archive file does not seem to " + "contain an agent binary. This is probably a problem in " + "the #{PROGRAM_NAME} website. Please report this problem to " + "the #{PROGRAM_NAME} authors." abort end @logger.info "Checking whether the downloaded binary is usable..." if test_binary("#{tmpdir}/#{AGENT_EXE}") @logger.info "The downloaded binary is usable." else if !@options[:suppress_binary_unusable_message] @logger.fatal "Sorry, the precompiled agent binary can not be run " + "your system.#{compile_tip_message}" end exit(BINARY_NOT_USABLE_EXIT_CODE) end FileUtils.mv("#{tmpdir}/#{AGENT_EXE}", "#{destdir}/#{AGENT_EXE}") @logger.info "#{@colors.green}Agent binary successfully downloaded and installed." end end def download_support_file(name, output) @sites.each_with_index do \|site, i\| if real_download_support_file(site, name, output) if i > 0 @logger.warn "#{@colors.green}Download OK!" else @logger.info "#{@colors.green}Download OK!" end return true elsif i != @sites.size - 1 @logger.warn "Trying next mirror..." end end return false end def real_download_support_file(site, name, output) if site[:url].include?('{{VERSION}}') url = site[:url].gsub('{{VERSION}}', VERSION_STRING) + "/#{name}" else url = "#{site[:url]}/#{VERSION_STRING}/#{name}" end options = { :cacert => site[:cacert], :logger => @logger, :use_cache => @options[:use_cache] } # connect_timeout and idle_timeout may be nil or 0, which means # that the default Utils::Download timeouts should be used. if @options[:connect_timeout] && @options[:connect_timeout] != 0 options[:connect_timeout] = @options[:connect_timeout] end if @options[:idle_timeout] && @options[:idle_timeout] != 0 options[:idle_timeout] = @options[:idle_timeout] end return PhusionPassenger::Utils::Download.download(url, output, options) end def test_binary(filename) output = `env LD_BIND_NOW=1 DYLD_BIND_AT_LAUNCH=1 #{Shellwords.escape(filename)} test-binary` return $? && $?.exitstatus == 0 && output == "PASS\n" end def compile_tip_message return "" if !@options[:compilation_tip] if PhusionPassenger.build_system_dir result = " Please compile the agent from source instead, by running:\n\n" result << " passenger-config compile-agent" else result = " Furthermore, this #{PROGRAM_NAME} installation does not " result << "come with any source code, so the agent binary cannot " result << "be compiled either. Please contact the person or " result << "organization who packaged #{PROGRAM_NAME} for help on this " result << "problem." end return result end # Override InstallationUtils def print_installation_error_header @logger.warn "------------------------------------------" @logger.fatal "Cannot store agent binary" @logger.fatal "" end end end # module Config end # module PhusionPassenger	12.03 KB	2025-11-20 11:36
📄 download_nginx_engine_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'logger' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/installation_utils' PhusionPassenger.require_passenger_lib 'platform_info' PhusionPassenger.require_passenger_lib 'platform_info/binary_compatibility' PhusionPassenger.require_passenger_lib 'utils/download' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' PhusionPassenger.require_passenger_lib 'utils/shellwords' PhusionPassenger.require_passenger_lib 'utils/tmpio' module PhusionPassenger module Config class DownloadNginxEngineCommand < Command include InstallationUtils BINARY_NOT_USABLE_EXIT_CODE = 3 def run @options = { :log_level => Logger::INFO, :colors => :auto, :error_colors => true, :show_download_progress => STDOUT.tty?, :compilation_tip => true, :force_tip => true, :use_cache => true, :connect_timeout => 30, :idle_timeout => 30 } parse_options initialize_objects sanity_check download_and_extract end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config download-nginx-engine [OPTIONS]\n" opts.separator "" opts.separator " Download an Nginx #{PREFERRED_NGINX_VERSION} engine " + "from the #{PROGRAM_NAME} website," opts.separator " for use with #{PROGRAM_NAME} Standalone. Precompiled engines are only" opts.separator " available for Linux and OS X." opts.separator "" opts.separator " It is not possible to customize the Nginx engine version. " + "It must be #{PREFERRED_NGINX_VERSION}." opts.separator "" opts.separator "Options:" opts.on("--url-root URL", String, "Download the engine from a custom URL") do \|value\| options[:url_root] = value end opts.on("--log-prefix PREFIX", String, "Prefix all logs with the given string") do \|value\| options[:log_prefix] = value end opts.on("--log-level LEVEL", String, "Set log level (fatal,error,warn,info,#{nl}" + "debug). Default: info") do \|value\| case value when "fatal" options[:log_level] = Logger::FATAL when "error" options[:log_level] = Logger::ERROR when "warn" options[:log_level] = Logger::WARN when "info" options[:log_level] = Logger::INFO when "debug" options[:log_level] = Logger::DEBUG else abort "Invalid log level #{value.inspect}" end end opts.on("-f", "--force", "Skip sanity checks") do options[:force] = true end opts.on("--no-colors", "Never output colors") do options[:colors] = false end opts.on("--no-error-colors", "Do not colorized error messages") do options[:error_colors] = false end opts.on("--no-download-progress", "Never show download progress") do options[:show_download_progress] = false end opts.on("--no-compilation-tip", "Do not present compilation as an#{nl}" + "alternative way to install the agent") do options[:compilation_tip] = false end opts.on("--no-force-tip", "Do not print any tips regarding the#{nl}" + "--force parameter") do options[:force_tip] = false end opts.on("--skip-cache", "Do not copy the Nginx engine from cache") do options[:use_cache] = false end opts.on("--suppress-binary-unusable-message", "Do not print anything if the downloaded#{nl}" + "binary turns out to be unusable") do options[:suppress_binary_unusable_message] = true end opts.on("--dry-run", "Do everything except actually installing#{nl}" + "the engine") do options[:dry_run] = true end opts.on("--connect-timeout SECONDS", Integer, "The maximum amount of time to spend on DNS#{nl}" + "lookup and establishing the TCP connection.#{nl}" + "Default: 30") do \|val\| options[:connect_timeout] = val end opts.on("--idle-timeout SECONDS", Integer, "The maximum idle read time. Default: 30") do \|val\| options[:idle_timeout] = val end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def initialize_objects if @options[:url_root] @sites = [{ :url => @options[:url_root] }] else @sites = PhusionPassenger.binaries_sites end @colors = Utils::AnsiColors.new(@options[:colors]) @logger = Logger.new(STDOUT) @logger.level = @options[:log_level] @logger.formatter = proc do \|severity, datetime, progname, msg\| if @options[:error_colors] && (severity == "FATAL" \|\| severity == "ERROR") color = @colors.red else color = nil end result = "" msg.split("\n", -1).map do \|line\| result << "#{color}#{@options[:log_prefix]}#{line}#{@colors.reset}\n" end result end end def sanity_check return if @options[:force] if PhusionPassenger.find_support_binary("nginx-#{PREFERRED_NGINX_VERSION}") @logger.warn "#{@colors.green}The Nginx engine (version #{PREFERRED_NGINX_VERSION}) is already installed." if @options[:force_tip] @logger.warn "If you want to redownload it, re-run this program with the --force parameter." end exit end if !PhusionPassenger.installed_from_release_package? @logger.fatal("#{PROGRAM_NAME} was not installed from an official release " + "package, so you cannot download our precompiled Nginx engine." + compile_tip_message) if @options[:force_tip] @logger.warn "If you want to download it anyway, re-run this program with the --force parameter." end abort end check_for_download_tool! end def download_and_extract destdir = find_or_create_writable_support_binaries_dir! exit if @options[:dry_run] PhusionPassenger::Utils.mktmpdir("passenger-install.", PlatformInfo.tmpexedir) do \|tmpdir\| basename = "nginx-#{PREFERRED_NGINX_VERSION}-#{PlatformInfo.cxx_binary_compatibility_id}.tar.gz" tarball = "#{tmpdir}/#{basename}" if !download_support_file(basename, tarball) @logger.error "#{@colors.reset}------------------------------------------" @logger.fatal("Sorry, no precompiled Nginx #{PREFERRED_NGINX_VERSION} engine is available for " + "your platform." + compile_tip_message) abort end @logger.info "Extracting precompiled Nginx #{PREFERRED_NGINX_VERSION} engine to #{destdir}" e_tmpdir = Shellwords.escape(tmpdir) e_tarball = Shellwords.escape(tarball) if !system("cd #{e_tmpdir} && tar xzf #{e_tarball}") @logger.fatal "The downloaded archive file could not be extracted." abort end if !File.exist?("#{tmpdir}/nginx-#{PREFERRED_NGINX_VERSION}") @logger.fatal "The downloaded archive file does not seem to " + "contain an Nginx #{PREFERRED_NGINX_VERSION} engine. This is probably " + "a problem in the #{PROGRAM_NAME} website. Please report this problem to " + "the #{PROGRAM_NAME} authors." abort end @logger.info "Checking whether the downloaded engine is usable..." if test_binary("#{tmpdir}/nginx-#{PREFERRED_NGINX_VERSION}") @logger.info "The downloaded engine is usable." else if !@options[:suppress_binary_unusable_message] @logger.fatal "Sorry, the precompiled Nginx engine can not be run " + "your system.#{compile_tip_message}" end exit(BINARY_NOT_USABLE_EXIT_CODE) end FileUtils.mv("#{tmpdir}/nginx-#{PREFERRED_NGINX_VERSION}", "#{destdir}/nginx-#{PREFERRED_NGINX_VERSION}") @logger.info "#{@colors.green}Nginx #{PREFERRED_NGINX_VERSION} engine successfully downloaded and installed." end end def download_support_file(name, output) @sites.each_with_index do \|site, i\| if real_download_support_file(site, name, output) if i > 0 @logger.warn "#{@colors.green}Download OK!" else @logger.info "#{@colors.green}Download OK!" end return true elsif i != @sites.size - 1 @logger.warn "Trying next mirror..." end end return false end def real_download_support_file(site, name, output) if site[:url].include?('{{VERSION}}') url = site[:url].gsub('{{VERSION}}', VERSION_STRING) + "/#{name}" else url = "#{site[:url]}/#{VERSION_STRING}/#{name}" end options = { :cacert => site[:cacert], :logger => @logger, :use_cache => @options[:use_cache], :show_progress => @options[:show_download_progress] } # connect_timeout and idle_timeout may be nil or 0, which means # that the default Utils::Download timeouts should be used. if @options[:connect_timeout] && @options[:connect_timeout] != 0 options[:connect_timeout] = @options[:connect_timeout] end if @options[:idle_timeout] && @options[:idle_timeout] != 0 options[:idle_timeout] = @options[:idle_timeout] end return PhusionPassenger::Utils::Download.download(url, output, options) end def test_binary(filename) output = `env LD_BIND_NOW=1 DYLD_BIND_AT_LAUNCH=1 #{Shellwords.escape(filename)} -v 2>&1` return $? && $?.exitstatus == 0 && output =~ /nginx version:/ end def compile_tip_message return "" if !@options[:compilation_tip] if PhusionPassenger.build_system_dir result = " Please compile the Nginx engine from source instead, by running:\n\n" result << " passenger-config compile-nginx-engine" else result = " Furthermore, this #{PROGRAM_NAME} installation does not " result << "come with any source code, so the Nginx engine cannot " result << "be compiled either. Please contact the person or " result << "organization who packaged #{PROGRAM_NAME} for help on this " result << "problem." end return result end end end # module Config end # module PhusionPassenger	12.3 KB	2025-11-20 11:36
📄 install_agent_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'logger' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/download_agent_command' PhusionPassenger.require_passenger_lib 'config/compile_agent_command' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' module PhusionPassenger module Config class InstallAgentCommand < Command def run @options = { :log_level => Logger::INFO, :colorize => :auto, :force => false, :force_tip => true, :compile => true, :download_args => [ "--no-error-colors", "--no-compilation-tip" ], :compile_args => [] } parse_options initialize_objects sanity_check if !download compile end end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config install-agent [OPTIONS]\n" opts.separator "" opts.separator " Install the #{PROGRAM_NAME} agent binary. The agent binary is required for" opts.separator " #{PROGRAM_NAME} to function properly. Installation is done either by" opts.separator " downloading it from the #{PROGRAM_NAME} website, or by compiling it from" opts.separator " source." opts.separator "" opts.separator "Options:" opts.on("--working-dir PATH", String, "Store temporary files in the given#{nl}" + "directory, instead of creating one") do \|val\| options[:compile_args] << "--working-dir" options[:compile_args] << val end opts.on("--url-root URL", String, "Download the binary from a custom URL") do \|value\| options[:download_args] << "--url-root" options[:download_args] << value end opts.on("--brief", "Report progress in a brief style") do options[:brief] = true options[:download_args] << "--log-level" options[:download_args] << "warn" options[:download_args] << "--log-prefix" options[:download_args] << " " options[:download_args] << "--no-download-progress" end opts.on("--auto", "Run in non-interactive mode. Default when#{nl}" + "stdin or stdout is not a TTY") do options[:compile_args] << "--auto" end opts.on("-f", "--force", "Skip sanity checks") do options[:force] = true options[:download_args] << "--force" options[:compile_args] << "--force" end opts.on("--no-force-tip", "Do not print any tips regarding the#{nl}" + "--force parameter") do options[:force_tip] = false options[:download_args] << "--no-force-tip" options[:compile_args] << "--no-force-tip" end opts.on("--no-compile", "Download, but do not compile") do options[:compile] = false end opts.on("--skip-cache", "Do not copy the agent binary from cache") do options[:download_args] << "--skip-cache" end opts.on("--connect-timeout SECONDS", Integer, "The maximum amount of time to spend on DNS#{nl}" + "lookup and establishing the TCP connection.#{nl}" + "Default: 30") do \|val\| options[:download_args] << "--connect-timeout" options[:download_args] << val.to_s end opts.on("--idle-timeout SECONDS", Integer, "The maximum idle read time. Default: 30") do \|val\| options[:download_args] << "--idle-timeout" options[:download_args] << val.to_s end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def initialize_objects @colors = Utils::AnsiColors.new(@options[:colorize]) @logger = Logger.new(STDOUT) @logger.level = @options[:log_level] @logger.formatter = proc do \|severity, datetime, progname, msg\| if severity == "FATAL" \|\| severity == "ERROR" color = @colors.red else color = nil end result = "" msg.split("\n", -1).map do \|line\| result << "#{color}#{@options[:log_prefix]}#{line}#{@colors.reset}\n" end result end end def sanity_check return if @options[:force] if PhusionPassenger.find_support_binary(AGENT_EXE) @logger.warn "#{@colors.green}The #{PROGRAM_NAME} agent is already installed." if @options[:force_tip] @logger.warn "If you want to redownload it, re-run this program with the --force parameter." end exit end end def download if @options[:brief] puts " --> Downloading a #{PROGRAM_NAME} agent binary for your platform" else puts "#{@colors.blue_bg}#{@colors.yellow}#{@colors.bold}Downloading a #{PROGRAM_NAME} agent " + "binary for your platform#{@colors.reset}" puts end begin DownloadAgentCommand.new(@options[:download_args]).run return true rescue SystemExit => e return e.success? end end def compile puts puts "---------------------------------------" puts if @options[:compile] puts "The #{PROGRAM_NAME} agent binary could not be downloaded. Compiling it from source instead." puts CompileAgentCommand.new(@options[:compile_args]).run else abort "No precompiled agent binary could be downloaded. Refusing to compile because --no-compile is given." end end end end # module Config end # module PhusionPassenger	7.2 KB	2025-11-20 11:36
📄 install_standalone_runtime_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'logger' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'platform_info' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/install_agent_command' PhusionPassenger.require_passenger_lib 'config/download_nginx_engine_command' PhusionPassenger.require_passenger_lib 'config/compile_nginx_engine_command' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' PhusionPassenger.require_passenger_lib 'utils/tmpio' module PhusionPassenger module Config class InstallStandaloneRuntimeCommand < Command def run @options = { :log_level => Logger::INFO, :colorize => :auto, :force => false, :force_tip => true, :compile => true, :install_agent => true, :install_agent_args => [], :download_args => [ "--no-error-colors", "--no-compilation-tip" ], :engine => "nginx", :compile_args => [] } parse_options initialize_objects sanity_check PhusionPassenger::Utils.mktmpdir("passenger-install.", PlatformInfo.tmpexedir) do \|tmpdir\| install_agent(tmpdir) if !download_nginx_engine compile_nginx_engine(tmpdir) end end end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config install-standalone-runtime [OPTIONS]\n" opts.separator "" opts.separator " Install the #{PROGRAM_NAME} Standalone runtime. This runtime consists of" opts.separator " the #{PROGRAM_NAME} agent, and an Nginx engine. Installation is done either" opts.separator " by downloading the necessary files from the #{PROGRAM_NAME} website, or" opts.separator " by compiling them from source." opts.separator "" opts.separator "Options:" opts.on("--working-dir PATH", String, "Store temporary files in the given#{nl}" + "directory, instead of creating one") do \|val\| options[:install_agent_args] << "--working-dir" options[:install_agent_args] << val options[:compile_args] << "--working-dir" options[:compile_args] << val end opts.on("--url-root URL", String, "Download binaries from a custom URL") do \|value\| options[:install_agent_args] << "--url-root" options[:install_agent_args] << value options[:download_args] << "--url-root" options[:download_args] << value end opts.on("--nginx-version VERSION", String, "Nginx version to compile. " + "Default: #{PREFERRED_NGINX_VERSION}") do \|val\| options[:nginx_version] = val options[:compile_args] << "--nginx-version" options[:compile_args] << val end opts.on("--nginx-tarball PATH", String, "Use the given Nginx tarball instead of#{nl}" + "downloading it. You MUST also specify the#{nl}" + "Nginx version with --nginx-version") do \|val\| options[:nginx_tarball] = val end opts.on("--engine ENGINE", String, "Engine to use. " + "Default: Nginx") do \|val\| options[:engine] = val.downcase options[:compile] = false unless options[:engine] == "nginx" end opts.on("--brief", "Report progress in a brief style") do options[:brief] = true options[:install_agent_args] << "--brief" options[:download_args] << "--log-level" options[:download_args] << "warn" options[:download_args] << "--log-prefix" options[:download_args] << " " options[:download_args] << "--no-download-progress" end opts.on("--auto", "Run in non-interactive mode. Default when#{nl}" + "stdin or stdout is not a TTY") do options[:install_agent_args] << "--auto" end opts.on("-f", "--force", "Skip sanity checks") do options[:force] = true options[:install_agent_args] << "--force" options[:download_args] << "--force" options[:compile_args] << "--force" end opts.on("--no-force-tip", "Do not print any tips regarding the#{nl}" + "--force parameter") do options[:force_tip] = false options[:install_agent_args] << "--no-force-tip" options[:download_args] << "--no-force-tip" options[:compile_args] << "--no-force-tip" end opts.on("--no-compile", "Download, but do not compile") do options[:compile] = false options[:install_agent_args] << "--no-compile" end opts.on("--skip-agent", "Do not install the agent") do options[:install_agent] = false end opts.on("--skip-cache", "Do not copy the binaries from cache") do options[:install_agent_args] << "--skip-cache" options[:download_args] << "--skip-cache" end opts.on("--connect-timeout SECONDS", Integer, "The maximum amount of time to spend on DNS#{nl}" + "lookup and establishing the TCP connection.#{nl}" + "Default: 30") do \|val\| options[:install_agent_args] << "--connect-timeout" options[:install_agent_args] << val.to_s options[:download_args] << "--connect-timeout" options[:download_args] << val.to_s options[:compile_args] << "--connect-timeout" options[:compile_args] << val.to_s end opts.on("--idle-timeout SECONDS", Integer, "The maximum idle read time. Default: 30") do \|val\| options[:install_agent_args] << "--idle-timeout" options[:install_agent_args] << val.to_s options[:download_args] << "--idle-timeout" options[:download_args] << val.to_s options[:compile_args] << "--idle-timeout" options[:compile_args] << val.to_s end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def initialize_objects @colors = Utils::AnsiColors.new(@options[:colorize]) @logger = Logger.new(STDOUT) @logger.level = @options[:log_level] @logger.formatter = proc do \|severity, datetime, progname, msg\| if severity == "FATAL" \|\| severity == "ERROR" color = @colors.red else color = nil end result = "" msg.split("\n", -1).map do \|line\| result << "#{color}#{@options[:log_prefix]}#{line}#{@colors.reset}\n" end result end if @options[:engine] == "nginx" if !@options[:nginx_version] if @options[:nginx_tarball] abort "#{@colors.red}Error: if you specify --nginx-tarball, " + "you must also specify --nginx-version.#{@colors.reset}" else @options[:nginx_version] = PREFERRED_NGINX_VERSION end end end end def sanity_check return if @options[:force] all_installed = PhusionPassenger.find_support_binary(AGENT_EXE) && PhusionPassenger.find_support_binary("nginx-#{@options[:nginx_version]}") if all_installed @logger.warn "#{@colors.green}The #{PROGRAM_NAME} Standalone runtime is already installed." if @options[:force_tip] @logger.warn "If you want to redownload it, re-run this program with the --force parameter." end exit end end def install_agent(tmpdir) if @options[:install_agent] args = @options[:install_agent_args].dup args << "--working-dir" args << tmpdir begin InstallAgentCommand.new(args).run rescue SystemExit => e raise e if !e.success? end puts end end def download_nginx_engine return true if @options[:engine] != "nginx" if @options[:nginx_version] != PREFERRED_NGINX_VERSION return false end if @options[:brief] puts " --> Installing Nginx #{@options[:nginx_version]} engine" else puts "#{@colors.blue_bg}#{@colors.yellow}#{@colors.bold}" + "Downloading an Nginx #{@options[:nginx_version]} engine " + "for your platform#{@colors.reset}" puts end begin DownloadNginxEngineCommand.new(@options[:download_args]).run true rescue SystemExit => e e.success? end end def compile_nginx_engine(tmpdir) if @options[:engine] != "nginx" puts "Not compiling Nginx engine, because builtin engine selected." return end puts puts "---------------------------------------" puts if @options[:compile] puts "No precompiled Nginx engine could be downloaded. Compiling it from source instead." puts args = @options[:compile_args].dup args << "--working-dir" args << tmpdir if @options[:nginx_version] args << "--nginx-version" args << @options[:nginx_version] end if @options[:nginx_tarball] args << "--nginx-tarball" args << @options[:nginx_tarball] end # The agent and the support libraries are compiled through Rake, which # already supports $USE_ASAN, so it makes sense to use that environment # variable here as well rather than introducing a CLI flag. if boolean_option('USE_ASAN') args << "--address-sanitizer" end CompileNginxEngineCommand.new(args).run else abort "No precompiled Nginx engine could be downloaded. Refusing to compile because --no-compile is given." end end def boolean_option(env_name) ["true", "on", "yes", "1"].include?(ENV[env_name]) end end end # module Config end # module PhusionPassenger	11.52 KB	2025-11-20 11:36
📄 installation_utils.rb # encoding: utf-8 # # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'fileutils' require 'pathname' require 'etc' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'ruby_core_enhancements' PhusionPassenger.require_passenger_lib 'console_text_template' PhusionPassenger.require_passenger_lib 'platform_info/ruby' PhusionPassenger.require_passenger_lib 'platform_info/depcheck' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' PhusionPassenger.require_passenger_lib 'utils/tmpio' module PhusionPassenger module Config module InstallationUtils extend self # Make methods available as class methods. def self.included(klass) # When included into another class, make sure that Utils # methods are made private. public_instance_methods(false).each do \|method_name\| klass.send(:private, method_name) end end def find_or_create_writable_support_binaries_dir! if File.exist?(PhusionPassenger.support_binaries_dir) result = directory_writable?(PhusionPassenger.support_binaries_dir) if result == true # return value can be a SystemCallError return PhusionPassenger.support_binaries_dir end if Process.euid == 0 if result == false print_installation_error_header render_template 'installation_utils/support_binaries_dir_not_writable_despite_running_as_root', :dir => PhusionPassenger.support_binaries_dir, :myself => myself else render_template 'installation_utils/unexpected_filesystem_problem', :dir => PhusionPassenger.support_binaries_dir, :exception => result end abort else return find_or_create_writable_user_support_binaries_dir! end else if Process.euid == 0 mkdir_p_preserve_parent_owner(PhusionPassenger.support_binaries_dir) return PhusionPassenger.support_binaries_dir else return find_or_create_writable_user_support_binaries_dir! end end end def check_for_download_tool! PlatformInfo::Depcheck.load('depcheck_specs/utilities') result = PlatformInfo::Depcheck.find('download-tool').check # Don't output anything if there is a download tool. # We want to be as quiet as possible. return if result && result[:found] colors = @colors \|\| Utils::AnsiColors.new puts colors.ansi_colorize("<banner>Checking for basic prerequities...</banner>") puts runner = PlatformInfo::Depcheck::ConsoleRunner.new(@colors) runner.add('download-tool') result = runner.check_all puts if !result puts "---------------------------------------" puts render_template 'installation_utils/download_tool_missing', :runner => runner abort end end # Override this method to print a different header def print_installation_error_header if @colors red = @colors.red reset = @colors.reset else red = nil reset = nil end @logger.warn "------------------------------------------" if @logger puts "#{red}Cannot proceed with installation#{reset}" puts end def rake return "env NOEXEC_DISABLE=1 #{PlatformInfo.rake_command}" end def run_rake_task!(target) total_lines = `#{rake} #{target} --dry-run STDERR_TO_STDOUT=1 2>&1`.split("\n").size - 1 partial_backlog = "" logfile = PhusionPassenger::Utils::TmpIO.new("passenger-install-log", :mode => File::WRONLY, :unlink_immediately => false) begin command = "#{rake} #{target} --trace STDERR_TO_STDOUT=1 2>&1" IO.popen(command, "rb") do \|io\| progress = 1 while !io.eof? line = io.readline logfile.write(line) yield(progress, total_lines) if line =~ /^\\ / partial_backlog.replace("") progress += 1 else partial_backlog << line end end end if $?.exitstatus != 0 colors = @colors \|\| PhusionPassenger::Utils::AnsiColors.new stderr = @stderr \|\| STDERR stderr.puts stderr.puts "#{colors.red}*** ERROR: a Rake command failed. You can find the full " + "log in #{logfile.path}. Below, you can find the last few lines of the command's output.#{colors.reset}" stderr.puts "#{colors.red}------------- Begin command output snippet -------------#{colors.reset}" stderr.puts(partial_backlog) stderr.puts "#{colors.red}------------- End command output snippet -------------#{colors.reset}" stderr.puts "#{colors.red}The full log can be found in #{logfile.path}#{colors.reset}" exit 1 end ensure logfile.close end end private # We can't use File.writable() and friends here because they # don't always work right with ACLs. Instead of we use 'real' # checks. def directory_writable?(path) filename = "#{path}/.__test_#{object_id}__.txt" @logger.debug "Checking whether we can write to #{path}..." if @logger begin File.new(filename, "w").close @logger.debug "Yes" if @logger return true rescue Errno::EACCES @logger.debug "No" if @logger return false rescue SystemCallError => e @logger.warn "Unable to check whether we can write to #{path}: #{e}" if @logger return e ensure File.unlink(filename) rescue nil end end def find_or_create_writable_user_support_binaries_dir! if !File.exist?(PhusionPassenger.user_support_binaries_dir) create_user_support_binaries_dir! end result = directory_writable?(PhusionPassenger.user_support_binaries_dir) case result when true return PhusionPassenger.user_support_binaries_dir when false print_installation_error_header render_template 'installation_utils/user_support_binaries_dir_not_writable' abort else print_installation_error_header render_template 'installation_utils/unexpected_filesystem_problem', :dir => PhusionPassenger.support_binaries_dir, :exception => result abort end end def create_user_support_binaries_dir! dir = PhusionPassenger.user_support_binaries_dir begin mkdir_p_preserve_parent_owner(dir) rescue Errno::EACCES print_installation_error_header render_template 'installation_utils/cannot_create_user_support_binaries_dir', :dir => dir, :myself => myself abort rescue SystemCallError => e print_installation_error_header render_template 'installation_utils/unexpected_filesystem_problem', :dir => dir, :exception => e abort end end # When creating PhusionPassenger.support_binaries_dir, preserve the # parent directory's UID and GID. This way, running `passenger-config compile-agent` # with sudo privilege, even though Phusion Passenger isn't installed as root, # won't mess up permissions. def mkdir_p_preserve_parent_owner(path) Pathname.new(path).descend do \|subpath\| if !subpath.exist? stat = subpath.parent.stat Dir.mkdir(subpath.to_s) if Process.euid == 0 File.lchown(stat.uid, stat.gid, subpath.to_s) end end end end def myself return `whoami`.strip end def render_template(name, options = {}) options.merge!(:colors => @colors \|\| PhusionPassenger::Utils::AnsiColors.new) # This check here is necessary for NginxEngineCompiler. NginxEngineCompiler # derives from AbstractInstaller but also includes InstallationUtils. We want # the AbstractInstaller methods to work when they call render_template. if !File.exist?("#{PhusionPassenger.resources_dir}/templates/#{name}.txt.erb") name = "config/#{name}" end puts ConsoleTextTemplate.new({ :file => name }, options).result end end end # module Config end # module PhusionPassenger	9.76 KB	2025-11-20 11:36
📄 list_instances_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'admin_tools/instance_registry' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/utils' PhusionPassenger.require_passenger_lib 'utils/json' module PhusionPassenger module Config class ListInstancesCommand < Command include PhusionPassenger::Config::Utils def run parse_options instances = AdminTools::InstanceRegistry.new.list if @options[:json] print_json(instances) elsif instances.empty? print_no_instances_running else print_instances(instances) end end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config list-instances [OPTIONS] <PID>\n" opts.separator "" opts.separator " List all running #{PROGRAM_NAME} instances." opts.separator "" opts.on("--json", "Print output in JSON format") do options[:json] = true end opts.on("-q", "--quiet", "Don't print anything if there are no #{PROGRAM_NAME} instances running") do options[:quiet] = true end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def parse_options super if !@argv.empty? help abort end end def print_no_instances_running if !@options[:quiet] puts "There are no #{PROGRAM_NAME} instances running." end end def print_json(instances) result = [] instances.each do \|instance\| result << instance.as_json end puts PhusionPassenger::Utils::JSON.generate(result) end def print_instances(instances) list_all_passenger_instances(instances, false) end end end # module Config end # module PhusionPassenger	3.35 KB	2025-11-20 11:36
📄 main.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2013-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. PhusionPassenger.require_passenger_lib 'constants' module PhusionPassenger # Core of the `passenger-config` command. Dispatches a subcommand to a specific class. module Config KNOWN_COMMANDS = [ ["detach-process", "DetachProcessCommand"], ["restart-app", "RestartAppCommand"], ["list-instances", "ListInstancesCommand"], ["reopen-logs", "ReopenLogsCommand"], ["api-call", "ApiCallCommand"], ["validate-install", "ValidateInstallCommand"], ["build-native-support", "BuildNativeSupportCommand"], ["install-agent", "InstallAgentCommand"], ["install-standalone-runtime", "InstallStandaloneRuntimeCommand"], ["download-agent", "DownloadAgentCommand"], ["download-nginx-engine", "DownloadNginxEngineCommand"], ["compile-agent", "CompileAgentCommand"], ["compile-nginx-engine", "CompileNginxEngineCommand"], ["system-metrics", "SystemMetricsCommand"], ["system-properties", "SystemPropertiesCommand"], ["about", "AboutCommand"] ] ABOUT_OPTIONS = [ "root", "includedir", "nginx-addon-dir", "nginx-libs", "nginx-dynamic-libs", "nginx-dynamic-compiled", "compiled", "custom-packaged", "installed-from-release-package", "make-locations-ini", "detect-apache2", "ruby-command", "ruby-libdir", "rubyext-compat-id", "cxx-compat-id", "version" ] def self.run!(argv) command_class, new_argv = lookup_command_class_by_argv(argv) if help_requested?(argv) help elsif help_all_requested?(argv) help(true) elsif command_class command = command_class.new(new_argv) command.run else help abort end end def self.help(all = false) puts "Usage: passenger-config <COMMAND> [OPTIONS...]" puts puts " Tool for managing, controlling and configuring a #{PROGRAM_NAME} instance" puts " or installation." puts puts "Management commands:" puts " detach-process Detach an application process from the process pool" puts " restart-app Restart an application" puts " reopen-logs Instruct #{PROGRAM_NAME} agents to reopen their log" puts " files" puts " api-call Makes an API call to a #{PROGRAM_NAME} agent." puts puts "Informational commands:" puts " list-instances List running #{PROGRAM_NAME} instances" puts " about Show information about #{PROGRAM_NAME}" puts puts "#{PROGRAM_NAME} installation management:" puts " validate-install Validate this #{PROGRAM_NAME} installation" puts " build-native-support Ensure that the native_support library for the current" puts " Ruby interpreter is built" puts " install-agent Install the #{PROGRAM_NAME} agent binary" puts " install-standalone-runtime" puts " Install the #{PROGRAM_NAME} Standalone" puts " runtime" if all puts " download-agent Download the #{PROGRAM_NAME} agent binary" puts " download-nginx-engine Download the Nginx engine for use with" puts " #{PROGRAM_NAME} Standalone" puts " compile-agent Compile the #{PROGRAM_NAME} agent binary" puts " compile-nginx-engine Compile an Nginx engine for use with #{PROGRAM_NAME}" puts " Standalone" end puts puts "Miscellaneous commands:" puts " system-metrics Display system metrics" puts " system-properties Display system properties" puts puts "Run 'passenger-config <COMMAND> --help' for more information about each" puts "command." if !all puts puts "There are also some advanced commands not shown in this help message. Run" puts "'passenger-config --help-all' to learn more about them." end end private def self.help_requested?(argv) return argv.size == 1 && (argv[0] == "--help" \|\| argv[0] == "-h" \|\| argv[0] == "help") end def self.help_all_requested?(argv) return argv.size == 1 && (argv[0] == "--help-all" \|\| argv[0] == "help-all") end def self.lookup_command_class_by_argv(argv) return nil if argv.empty? # Compatibility with version <= 4.0.29: try to pass all # --switch invocations to AboutCommand. if argv[0] =~ /^--/ name = argv[0].sub(/^--/, '') if ABOUT_OPTIONS.include?(name) command_class = lookup_command_class_by_class_name("AboutCommand") return [command_class, argv] else return nil end end # Convert "passenger-config help <COMMAND>" to "passenger-config <COMMAND> --help". if argv.size == 2 && argv[0] == "help" argv = [argv[1], "--help"] end KNOWN_COMMANDS.each do \|props\| if argv[0] == props[0] command_class = lookup_command_class_by_class_name(props[1]) new_argv = argv[1 .. -1] return [command_class, new_argv] end end return nil end def self.lookup_command_class_by_class_name(class_name) base_name = class_name.gsub(/[A-Z]/) do \|match\| "_" + match[0..0].downcase end base_name.sub!(/^_/, '') base_name << ".rb" PhusionPassenger.require_passenger_lib("config/#{base_name}") return PhusionPassenger::Config.const_get(class_name) end end end # module PhusionPassenger	6.84 KB	2025-11-20 11:36
📄 nginx_engine_compiler.rb # encoding: utf-8 # # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2010-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'fileutils' require 'logger' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'abstract_installer' PhusionPassenger.require_passenger_lib 'common_library' PhusionPassenger.require_passenger_lib 'config/installation_utils' PhusionPassenger.require_passenger_lib 'platform_info' PhusionPassenger.require_passenger_lib 'platform_info/ruby' PhusionPassenger.require_passenger_lib 'platform_info/openssl' PhusionPassenger.require_passenger_lib 'platform_info/pcre' PhusionPassenger.require_passenger_lib 'platform_info/compiler' PhusionPassenger.require_passenger_lib 'utils/shellwords' PhusionPassenger.require_passenger_lib 'utils/progress_bar' PhusionPassenger.require_passenger_lib 'utils/tmpio' module PhusionPassenger module Config class NginxEngineCompiler < AbstractInstaller include InstallationUtils def self.configure_script_options(address_sanitizer: false) extra_cflags = [ "-Wno-error", PlatformInfo.openssl_extra_cflags, PlatformInfo.pcre_extra_cflags, ].compact.join(" ").strip result = "--with-cc-opt=#{Shellwords.escape extra_cflags} " extra_ldflags = [ PlatformInfo.openssl_extra_ldflags, PlatformInfo.pcre_extra_ldflags, address_sanitizer ? PlatformInfo.address_sanitizer_flags : nil, ].compact.join(" ").strip if !extra_ldflags.empty? result << "--with-ld-opt=#{Shellwords.escape extra_ldflags} " end result << "--without-http_fastcgi_module " \ "--without-http_scgi_module " \ "--without-http_uwsgi_module " \ "--with-http_ssl_module " \ "--with-http_v2_module " \ "--with-http_realip_module " \ "--with-http_gzip_static_module " \ "--with-http_stub_status_module " \ "--with-http_addition_module" result end protected def dependencies specs = [ 'depcheck_specs/compiler_toolchain', 'depcheck_specs/ruby', 'depcheck_specs/libs', 'depcheck_specs/utilities' ] ids = [ 'cc', 'c++', 'gmake', 'rake', 'openssl-dev', 'zlib-dev', 'pcre2-dev' ].compact return [specs, ids] end def install_doc_url "https://www.phusionpassenger.com/library/install/standalone/" end def troubleshooting_doc_url "https://www.phusionpassenger.com/library/admin/standalone/troubleshooting/" end def run_steps check_source_code_available! check_precompiled_support_libs_available! if !@force check_whether_os_is_broken check_whether_system_has_enough_ram check_for_download_tool! end check_dependencies(false) \|\| abort puts @destdir = find_or_create_writable_support_binaries_dir! puts "<banner>Installing...</banner>" download_and_extract_nginx_sources determine_support_libraries if PhusionPassenger.build_system_dir compile_support_libraries end configure_and_compile_nginx end def before_install super if !@working_dir @working_dir = PhusionPassenger::Utils.mktmpdir("passenger-install.", PlatformInfo.tmpexedir) @owns_working_dir = true end @nginx_version \|\|= PREFERRED_NGINX_VERSION end def after_install super FileUtils.remove_entry_secure(@working_dir) if @owns_working_dir end private def check_source_code_available! return if File.exist?(PhusionPassenger.nginx_module_source_dir) if PhusionPassenger.originally_packaged? puts "<red>Broken #{PROGRAM_NAME} installation detected</red>" puts puts "This program requires the #{PROGRAM_NAME} Nginx module sources " + "before it can compile an Nginx engine. However, the #{PROGRAM_NAME} " + "Nginx module sources are not installed, even though they should have been. " + "This probably means that your #{PROGRAM_NAME} installation has somehow " + "become corrupted. Please re-install #{PROGRAM_NAME}." abort else case PhusionPassenger.packaging_method when "deb" command = "sudo sh -c 'apt-get update && apt-get install #{DEB_DEV_PACKAGE}'" when "rpm" command = "sudo yum install #{RPM_DEV_PACKAGE}-#{VERSION_STRING}" end if command if STDIN.tty? puts " --> Installing #{PROGRAM_NAME} Nginx module sources" puts " Running: #{command}" if !system(command) puts " <red>* Command failed: #{command}</red>" abort end else puts " --> #{PROGRAM_NAME} Nginx module sources not installed" puts " Please install them first: #{command}" abort end else puts " --> #{PROGRAM_NAME} Nginx module sources not installed" puts " <red>Please ask your #{PROGRAM_NAME} packager or operating " + "system vendor how to install these.</red>" abort end end end def check_precompiled_support_libs_available! return if PhusionPassenger.build_system_dir \|\| File.exist?("#{PhusionPassenger.lib_dir}/common/libboost_oxt.a") if PhusionPassenger.originally_packaged? puts "<red>Broken #{PROGRAM_NAME} installation detected</red>" puts puts "This program requires the #{PROGRAM_NAME} support libraries " + "before it can compile an Nginx engine. However, the #{PROGRAM_NAME} " + "support libraries are not installed, even though they should have been. " + "This probably means that your #{PROGRAM_NAME} installation has somehow " + "become corrupted. Please re-install #{PROGRAM_NAME}." abort else case PhusionPassenger.packaging_method when "deb" command = "sudo sh -c 'apt-get update && apt-get install #{DEB_DEV_PACKAGE}'" when "rpm" command = "sudo yum install #{RPM_DEV_PACKAGE}-#{VERSION_STRING}" end if command if STDIN.tty? puts " --> Installing #{PROGRAM_NAME} support libraries" puts " Running: #{command}" if !system(command) puts " <red>* Command failed: #{command}</red>" abort end else puts " --> #{PROGRAM_NAME} support libraries not installed" puts " Please install them first: #{command}" abort end else puts " --> #{PROGRAM_NAME} support libraries not installed" puts " <red>Please ask your #{PROGRAM_NAME} packager or operating " + "system vendor how to install these.</red>" abort end end end def download_and_extract_nginx_sources if @nginx_tarball tarball = @nginx_tarball else puts "Downloading Nginx #{@nginx_version} source code..." basename = "nginx-#{@nginx_version}.tar.gz" tarball = "#{@working_dir}/#{basename}" options = { :show_progress => @stdout.tty? } if @connect_timeout && @connect_timeout != 0 options[:connect_timeout] = @connect_timeout end if @idle_timeout && @idle_timeout != 0 options[:idle_timeout] = @idle_timeout end result = download("https://nginx.org/download/#{basename}", tarball, options) if !result puts show_possible_solutions_for_download_and_extraction_problems abort end end puts "Extracting tarball..." e_working_dir = Shellwords.escape(@working_dir) e_tarball = Shellwords.escape(tarball) result = system("cd #{e_working_dir} && tar xzf #{e_tarball}") if !result puts if @nginx_tarball new_screen puts "You specified --nginx-tarball, but the file could not be extracted. " + "Please check the path and format (tar.gz), and ensure Passenger can write to " + PlatformInfo.tmpexedir + "." puts else show_possible_solutions_for_download_and_extraction_problems end abort end end def show_possible_solutions_for_download_and_extraction_problems new_screen render_template "nginx_engine_compiler/possible_solutions_for_download_and_extraction_problems" puts end def determine_support_libraries if PhusionPassenger.build_system_dir lib_dir = "#{@working_dir}/common/libpassenger_common" @support_libs = COMMON_LIBRARY.only(NGINX_LIBS_SELECTOR). set_output_dir(lib_dir). link_objects @support_libs << "#{@working_dir}/common/libboost_oxt.a" else @support_libs = COMMON_LIBRARY.only(NGINX_LIBS_SELECTOR). set_output_dir("#{PhusionPassenger.lib_dir}/common/libpassenger_common"). link_objects @support_libs << "#{PhusionPassenger.lib_dir}/common/libboost_oxt.a" end @support_libs_string = @support_libs.join(" ") end def compile_support_libraries puts "Compiling support libraries (step 1 of 2)..." progress_bar = ProgressBar.new e_working_dir = Shellwords.escape(@working_dir) args = "#{@support_libs_string} CACHING=false OUTPUT_DIR=#{e_working_dir}" begin progress_bar.set(0.05) Dir.chdir(PhusionPassenger.build_system_dir) do run_rake_task!(args) do \|progress, total\| progress_bar.set(0.05 + (progress / total.to_f) * 0.95) end end progress_bar.set(1) ensure progress_bar.finish end end def configure_and_compile_nginx puts "Compiling Nginx engine (step 2 of 2)..." progress_bar = ProgressBar.new progress_bar.set(0) begin configure_nginx do progress_bar.set(0.25) end compile_nginx do \|progress\| progress_bar.set(0.25 + progress * 0.75) end progress_bar.set(1) ensure progress_bar.finish end FileUtils.cp("#{@working_dir}/nginx-#{@nginx_version}/objs/nginx", "#{@destdir}/nginx-#{@nginx_version}") puts "<green>Compilation finished!</green>" end def configure_nginx shell = PlatformInfo.find_command('bash') \|\| "sh" e_nginx_source_dir = Shellwords.escape("#{@working_dir}/nginx-#{@nginx_version}") command = "cd #{e_nginx_source_dir} && " command << "env PASSENGER_INCLUDEDIR=#{Shellwords.escape PhusionPassenger.include_dir} " << "PASSENGER_LIBS=#{Shellwords.escape(@support_libs_string)} " # RPM thinks it's being smart by scanning binaries for # paths and refusing to create package if it detects any # hardcoded thats that point to /usr or other important # locations. For Phusion Passenger Standalone we do not # care at all what the Nginx configured prefix is because # we pass it its resource locations during runtime, so # work around the problem by configure Nginx with prefix # /tmp. command << "#{shell} ./configure --prefix=/tmp " + "#{self.class.configure_script_options(address_sanitizer: @address_sanitizer)} " + "--add-module=#{Shellwords.escape PhusionPassenger.nginx_module_source_dir}" run_command_yield_activity(command) do yield end end def compile_nginx backlog = "" e_nginx_source_dir = Shellwords.escape("#{@working_dir}/nginx-#{@nginx_version}") # Capture and index the `make --dry-run` output for # progress determination. total_lines = 0 dry_run_output = {} `cd #{e_nginx_source_dir} && #{PlatformInfo.gnu_make} --dry-run`.split("\n").each do \|line\| total_lines += 1 dry_run_output[line] = true end IO.popen("cd #{e_nginx_source_dir} && #{PlatformInfo.gnu_make} 2>&1", "r") do \|io\| progress = 1 while !io.eof? line = io.readline backlog << line # If the output is part of what we saw when dry-running, # then increase progress bar. Otherwise it could be compiler # warnings or something, so ignore those. if dry_run_output[line.chomp] yield(progress / total_lines.to_f) progress += 1 end end end if $?.exitstatus != 0 @stderr.puts @stderr.puts "* ERROR: unable to compile web helper." @stderr.puts backlog exit 1 end end def run_command_yield_activity(command) backlog = "" IO.popen("#{command} 2>&1", "rb") do \|io\| while !io.eof? backlog << io.readline yield end end if $?.exitstatus != 0 @stderr.puts @stderr.puts backlog @stderr.puts "* ERROR: command failed: #{command}" exit 1 end end end end # module Standalone end # module PhusionPassenger	14.77 KB	2025-11-20 11:36
📄 reopen_logs_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'net/http' require 'socket' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'admin_tools/instance_registry' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/utils' PhusionPassenger.require_passenger_lib 'utils/json' module PhusionPassenger module Config class ReopenLogsCommand < Command include PhusionPassenger::Config::Utils def run parse_options select_passenger_instance perform_reopen_logs end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config reopen-logs [OPTIONS]\n" opts.separator "" opts.separator " Instruct #{PROGRAM_NAME} agent processes to reopen their log files. This" opts.separator " should be invoked after you've rotated log files. This command returns after" opts.separator " the log files have been reopened." opts.separator "" opts.separator "Options:" opts.on("--ignore-logs-not-available", "Exit successfully if #{PROGRAM_NAME}#{nl}" + "was not configured with a log file") do options[:ignore_logs_not_available] = true end opts.on("--instance NAME", String, "The #{PROGRAM_NAME} instance to select") do \|value\| options[:instance] = value end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def perform_reopen_logs perform_reopen_logs_on("watchdog", "watchdog_api") perform_reinherit_logs_on("core", "core_api") if using_standalone_nginx_engine? perform_reopen_logs_on_nginx end puts "All done" end def perform_reopen_logs_on(name, socket_name) puts "Reopening logs for #{PROGRAM_NAME} #{name}" request = Net::HTTP::Post.new("/reopen_logs.json") try_performing_full_admin_basic_auth(request, @instance) request.content_type = "application/json" response = @instance.http_request("agents.s/#{socket_name}", request) if response.code.to_i == 401 print_full_admin_command_permission_error abort elsif response["content-type"] == "application/json" if response.code.to_i / 100 != 2 handle_error(name, response) end else STDERR.puts "* An error occured while communicating with the #{PROGRAM_NAME} #{name} (code #{response.code}):" STDERR.puts response.body abort end end def perform_reinherit_logs_on(name, socket_name) puts "Reopening logs for #{PROGRAM_NAME} #{name} (through reinheritance)" request = Net::HTTP::Post.new("/reinherit_logs.json") try_performing_full_admin_basic_auth(request, @instance) request.content_type = "application/json" response = @instance.http_request("agents.s/#{socket_name}", request) if response.code.to_i == 401 print_full_admin_command_permission_error abort elsif response["content-type"] == "application/json" if response.code.to_i / 100 != 2 handle_error(name, response) end else STDERR.puts "* An error occured while communicating with the #{PROGRAM_NAME} #{name} (code #{response.code}):" STDERR.puts response.body abort end end def using_standalone_nginx_engine? @instance.properties["integration_mode"] == "standalone" && @instance.properties["standalone_engine"] == "nginx" end def perform_reopen_logs_on_nginx puts "Reopening logs for Nginx engine" Process.kill('USR1', @instance.web_server_control_process_pid) end def handle_error(name, response) json = PhusionPassenger::Utils::JSON.parse(response.body) if !should_ignore_error?(json) STDERR.puts "*** An error occured while communicating with the #{PROGRAM_NAME} #{name} (code #{response.code}):" STDERR.puts json['message'] abort end end def should_ignore_error?(json) return @options[:ignore_logs_not_available] && json["code"] == "NO_LOG_FILE" end end end # module Config end # module PhusionPassenger	5.64 KB	2025-11-20 11:36
📄 restart_app_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2013-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'net/http' require 'socket' require 'json' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'admin_tools/instance_registry' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/utils' PhusionPassenger.require_passenger_lib 'utils/json' PhusionPassenger.require_passenger_lib 'utils/ansi_colors' PhusionPassenger.require_passenger_lib 'utils/terminal_choice_menu' module PhusionPassenger module Config class RestartAppCommand < Command include PhusionPassenger::Config::Utils def run parse_options select_passenger_instance select_app_group_name perform_restart end private def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage 1: passenger-config restart-app <APP PATH PREFIX> [OPTIONS]\n" + "Usage 2: passenger-config restart-app . [OPTIONS]\n" + "Usage 3: passenger-config restart-app --name <APP GROUP NAME> [OPTIONS]" opts.separator "" opts.separator " Restart an application. The syntax determines how the application that is to" opts.separator " be restarted, will be selected." opts.separator "" opts.separator " 1. Selects all applications whose paths begin with the given prefix." opts.separator "" opts.separator " Example: passenger-config restart-app /webapps" opts.separator " Restarts all apps whose path begin with /webapps, such as /webapps/foo," opts.separator " /webapps/bar and /webapps123." opts.separator "" opts.separator " 2. Selects all application whose paths fall under the current working" opts.separator " directory." opts.separator " Example: passenger-config restart-app ." opts.separator " If the current working directory is /webapps, restarts all apps whose path" opts.separator " begin with /webapps, such as /webapps/foo, /webapps/bar and /webapps123." opts.separator "" opts.separator " 3. Selects a specific application based on an exact match of its app group" opts.separator " name." opts.separator "" opts.separator " Example: passenger-config restart-app --name /webapps/foo" opts.separator " Restarts only /webapps/foo, but not for example /webapps/foo/bar or" opts.separator " /webapps/foo123." opts.separator "" opts.separator "Options:" opts.on("--name APP_GROUP_NAME", String, "The app group name to select") do \|value\| options[:app_group_name] = value end opts.on("--rolling-restart", "Perform a rolling restart instead of a#{nl}" + "regular restart (Enterprise only). The#{nl}" + "default is a blocking restart") do \|value\| if Config::Utils.is_enterprise? options[:rolling_restart] = true else abort "--rolling-restart is only available in #{PROGRAM_NAME} Enterprise: #{ENTERPRISE_URL}" end end opts.on("--ignore-app-not-running", "Exit successfully if the specified#{nl}" + "application is not currently running. The#{nl}" + "default is to exit with an error") do options[:ignore_app_not_running] = true end opts.on("--ignore-passenger-not-running", "Exit successfully if #{PROGRAM_NAME}#{nl}" + "is not currently running. The default is to#{nl}" + "exit with an error") do options[:ignore_passenger_not_running] = true end opts.on("--instance NAME", String, "The #{PROGRAM_NAME} instance to select") do \|value\| options[:instance] = value end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def parse_options super case @argv.size when 0 if !@options[:app_group_name] && !STDIN.tty? abort "Please pass either an app path prefix or an app group name. " + "See --help for more information." end when 1 if @options[:app_group_name] abort "You've passed an app path prefix, but you cannot also pass an " + "app group name. Please use only either one of them. See --help " + "for more information." end else help abort end end def select_app_group_name @groups = [] if app_group_name = @options[:app_group_name] select_app_group_name_exact(app_group_name) elsif @argv.empty? # STDIN is guaranteed to be a TTY thanks to the check in #parse_options. select_app_group_name_interactively else select_app_group_name_by_app_root_regex(@argv.first) end end def select_app_group_name_exact(name) query_pool_json.each do \|group\| if group[:name] == name @groups << group end end if @groups.empty? abort_app_not_found "There is no #{PROGRAM_NAME}-served application running " + "with the app group name '#{name}'." end end def query_group_names result = [] query_pool_json.each do \|group\| result << group[:name] end result << "Cancel" result end def select_app_group_name_interactively colors = PhusionPassenger::Utils::AnsiColors.new choices = query_group_names if choices.size == 1 # No running apps abort_app_not_found "#{PROGRAM_NAME} is currently not serving any applications." end puts "Please select the application to restart." puts colors.ansi_colorize("<gray>Tip: re-run this command with --help to learn how to automate it.</gray>") puts colors.ansi_colorize("<dgray>If the menu doesn't display correctly, press '!'</dgray>") puts menu = PhusionPassenger::Utils::TerminalChoiceMenu.new(choices, :single_choice) begin index, name = menu.query rescue Interrupt abort ensure STDOUT.write(colors.reset) STDOUT.flush end if index == choices.size - 1 abort else puts select_app_group_name_exact(name) end end def select_app_group_name_by_app_root_regex(app_root) if app_root == "." app_root = Dir.pwd end regex = /^#{Regexp.escape(app_root)}/ query_pool_json.each do \|group\| if group[:app_root] =~ regex @groups << group end end if @groups.empty? abort_app_not_found "There are no #{PROGRAM_NAME}-served applications running " + "whose paths begin with '#{app_root}'." end end def perform_restart restart_method = @options[:rolling_restart] ? "rolling" : "blocking" @groups.each do \|group\| group_name = group[:name] puts "Restarting #{group_name}" request = Net::HTTP::Post.new("/pool/restart_app_group.json") try_performing_full_admin_basic_auth(request, @instance) request.content_type = "application/json" request.body = PhusionPassenger::Utils::JSON.generate( :name => group_name, :restart_method => restart_method) response = @instance.http_request("agents.s/core_api", request) if response.code.to_i / 100 == 2 response.body elsif response.code.to_i == 401 print_full_admin_command_permission_error abort else STDERR.puts "* An error occured while communicating with the #{PROGRAM_NAME} server:" STDERR.puts response.body abort end end end def abort_app_not_found(message) if @options[:ignore_app_not_running] STDERR.puts(message) exit else abort(message) end end def query_pool_json request = Net::HTTP::Get.new("/pool.json") try_performing_ro_admin_basic_auth(request, @instance) response = @instance.http_request("agents.s/core_api", request) if response.code.to_i / 100 == 2 if RUBY_VERSION >= '2.3' JSON.parse(response.body, symbolize_names: true).to_a.map{\|(key,value)\| {name: key.to_s, app_root: value.dig(:app_root,0,:value)}} else JSON.parse(response.body, symbolize_names: true).to_a.map{\|(key,value)\| {name: key.to_s, app_root: value[:app_root][0][:value]}} end elsif response.code.to_i == 401 if response["pool-empty"] == "true" [] elsif @options[:ignore_app_not_running] print_instance_querying_permission_error exit else print_instance_querying_permission_error abort end else STDERR.puts "* An error occured while querying the #{PROGRAM_NAME} server:" STDERR.puts response.body abort end end end end # module Config end # module PhusionPassenger	10.62 KB	2025-11-20 11:36
📄 system_metrics_command.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' module PhusionPassenger module Config class SystemMetricsCommand < Command def run agent_exe = PhusionPassenger.find_support_binary(AGENT_EXE) if agent_exe exec(agent_exe, "system-metrics", *@argv) else abort "This command requires the #{PROGRAM_NAME} agent to be installed. " + "Please install it by running `passenger-config install-agent`." end end end end # module Config end # module PhusionPassenger	1.84 KB	2025-11-20 11:36
📄 system_properties_command.rb # frozen_string_literal: true # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2017-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'socket' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'utils/json' PhusionPassenger.require_passenger_lib 'platform_info/operating_system' PhusionPassenger.require_passenger_lib 'platform_info/networking' PhusionPassenger.require_passenger_lib 'platform_info/linux' module PhusionPassenger module Config class SystemPropertiesCommand < Command def run # Output format must be compatible with Appminton # "get server_properties" protocol command. network_interfaces = PlatformInfo.network_interfaces default_network_interfaces = PlatformInfo.default_network_interfaces puts PhusionPassenger::Utils::JSON.generate( :ipv4_addresses => ip_addresses(network_interfaces, :ipv4, default_network_interfaces), :ipv6_addresses => ip_addresses(network_interfaces, :ipv6, default_network_interfaces), :default_ipv4 => default_ip(network_interfaces, :ipv4, default_network_interfaces), :default_ipv6 => default_ip(network_interfaces, :ipv6, default_network_interfaces), :network_interfaces => network_interfaces, :hostname => Socket.gethostname, :fqdn => fqdn, :os => os ) end private def ip_addresses(network_interfaces, type, default_network_interfaces) result = network_interfaces.map { \|iface\| iface[type] }.flatten device = default_network_interfaces[type] if device && device != :unknown default_iface = network_interfaces.find do \|iface\| iface[:device] == device end result << default_iface[type].first end result.uniq! result end def default_ip(network_interfaces, type, default_network_interfaces) device = default_network_interfaces[type] if device == :unknown '<UNKNOWN>' elsif device result = network_interfaces.find do \|iface\| iface[:device] == device end result[type].first else nil end end def fqdn hostname = PlatformInfo.find_command('hostname') if hostname `#{Shellwords.escape hostname} -f`.strip else nil end end def os { :simple_name => PlatformInfo.os_name_simple, :full_name => PlatformInfo.os_name_full, :version => PlatformInfo.os_version, :linux_distro => PlatformInfo.linux_distro, :linux_distro_tags => PlatformInfo.linux_distro_tags } end end end # module Config end # module PhusionPassenger	3.96 KB	2025-11-20 11:36
📄 utils.rb # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2010-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. PhusionPassenger.require_passenger_lib 'constants' module PhusionPassenger module Config module Utils extend self # Make methods available as class methods. def self.included(klass) # When included into another class, make sure that Utils # methods are made private. public_instance_methods(false).each do \|method_name\| klass.send(:private, method_name) end end def select_passenger_instance if name = @options[:instance] @instance = AdminTools::InstanceRegistry.new.find_by_name_prefix(name) if !@instance if @options[:ignore_passenger_not_running] message_type = "WARNING" else message_type = "ERROR" end STDERR.puts "* #{message_type}: there doesn't seem to be a #{PROGRAM_NAME} instance running with the name '#{name}'." list_all_passenger_instances(AdminTools::InstanceRegistry.new.list) STDERR.puts STDERR.puts "Please pass `--instance <NAME>` to select a specific #{PROGRAM_NAME} instance." if @options[:ignore_passenger_not_running] exit else abort end elsif @instance == :ambigious abort "* ERROR: there are multiple instances whose name start with '#{name}'. Please specify the full name." end else instances = AdminTools::InstanceRegistry.new.list if instances.empty? if @options[:ignore_passenger_not_running] message_type = "WARNING" else message_type = "ERROR" end STDERR.puts "* #{message_type}: #{PROGRAM_NAME} doesn't seem to be running. If you are sure that it" STDERR.puts "is running, then the causes of this problem could be one of:" STDERR.puts STDERR.puts " 1. You customized the instance registry directory using Apache's" STDERR.puts " PassengerInstanceRegistryDir option, Nginx's" STDERR.puts " passenger_instance_registry_dir option, or #{PROGRAM_NAME} Standalone's" STDERR.puts " --instance-registry-dir command line argument. If so, please set the" STDERR.puts " environment variable PASSENGER_INSTANCE_REGISTRY_DIR to that directory" STDERR.puts " and run this command again." STDERR.puts " 2. The instance directory has been removed by an operating system background" STDERR.puts " service. Please set a different instance registry directory using Apache's" STDERR.puts " PassengerInstanceRegistryDir option, Nginx's passenger_instance_registry_dir" STDERR.puts " option, or #{PROGRAM_NAME} Standalone's --instance-registry-dir command" STDERR.puts " line argument." if @options[:ignore_passenger_not_running] exit else abort end elsif instances.size == 1 @instance = instances.first else complain_that_multiple_passenger_instances_are_running(instances) abort end end end def complain_that_multiple_passenger_instances_are_running(instances) puts "It appears that multiple #{PROGRAM_NAME} instances are running. Please select" puts "a specific one by passing:" puts puts " --instance <NAME>" puts list_all_passenger_instances(instances) abort end def list_all_passenger_instances(instances, print_preamble = true) if print_preamble puts "The following #{PROGRAM_NAME} instances are running:" puts end printf "%-25s %-7s %s\n", "Name", "PID", "Description" puts "--------------------------------------------------------------------------" if instances.empty? printf "%-25s %-7s %s\n", "(list empty)", "-", "-" else instances.each do \|instance\| printf "%-25s %-7s %s\n", instance.name, instance.watchdog_pid, instance.server_software end end end def try_performing_ro_admin_basic_auth(request, instance) begin password = instance.read_only_admin_password rescue Errno::EACCES return end request.basic_auth("ro_admin", password) end def try_performing_full_admin_basic_auth(request, instance) begin password = instance.full_admin_password rescue Errno::EACCES return end request.basic_auth("admin", password) end def print_instance_querying_permission_error PhusionPassenger.require_passenger_lib 'platform_info/ruby' STDERR.puts "* ERROR: You are not authorized to query the status for this " + "#{PROGRAM_NAME} instance. Please try again with " + "'#{PhusionPassenger::PlatformInfo.ruby_sudo_command}'." end def print_full_admin_command_permission_error PhusionPassenger.require_passenger_lib 'platform_info/ruby' STDERR.puts "*** ERROR: You are not authorized to perform this particular " + "administration command on this #{PROGRAM_NAME} instance. Please try again with " + "'#{PhusionPassenger::PlatformInfo.ruby_sudo_command}'." end def is_enterprise? return defined?(PhusionPassenger::PASSENGER_IS_ENTERPRISE) && PhusionPassenger::PASSENGER_IS_ENTERPRISE end end end # module Config end # module PhusionPassenger	6.79 KB	2025-11-20 11:36
📄 validate_install_command.rb # encoding: utf-8 # Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014-2025 Asynchronous B.V. # # "Passenger", "Phusion Passenger" and "Union Station" are registered # trademarks of Asynchronous B.V. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'config/command' module PhusionPassenger module Config class ValidateInstallCommand < Command # Signifies that there is at least 1 error. FAIL_EXIT_CODE = 1 # Signifies that there are no error, but at least 1 warning. WARN_EXIT_CODE = 2 # Internal error occurred. INTERNAL_ERROR_CODE = 9 def run @orig_argv = @argv.dup parse_options prepare begin if !@options[:auto] && !@options[:invoked_from_installer] ask_what_to_validate end if @options[:validate_apache2] initialize_apache_envvars if !@options[:auto] && !@options[:invoked_from_installer] check_whether_there_are_multiple_apache_installs end end if @options[:validate_passenger] check_tools_in_path check_no_other_installs_in_path end if @options[:validate_apache2] if check_apache2_installed check_apache2_load_module_config end end if @options[:summary] summarize end exit(FAIL_EXIT_CODE) if @error_count > 0 exit(WARN_EXIT_CODE) if @warning_count > 0 ensure reset_terminal end end private def self.create_default_options return { :auto => !STDIN.tty?, :validate_passenger => true, :colors => STDOUT.tty?, :summary => true } end def self.create_option_parser(options) OptionParser.new do \|opts\| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config validate-install [OPTIONS]\n" opts.separator "" opts.separator " Validate this #{SHORT_PROGRAM_NAME} installation and/or its integration with web servers." opts.separator " If you run this command in a terminal, it will run interactively and ask you questions." opts.separator " You can run this command non-interactively either by running it without a terminal, " opts.separator " or by passing --auto." opts.separator "" opts.separator " When running non-interactively, the default is to validate the #{SHORT_PROGRAM_NAME}" opts.separator " installation only (so e.g. Apache is not validated). You can customize this" opts.separator " using the appropriate command line options." opts.separator "" opts.separator " The exit codes are as follows:" opts.separator " 0 - All checks passed. No errors, no warnings." opts.separator " #{FAIL_EXIT_CODE} - Some checks failed with an error." opts.separator " #{WARN_EXIT_CODE} - No checks failed with an error, but some produced warnings." opts.separator " #{INTERNAL_ERROR_CODE} - Some internal error occurred." opts.separator "" opts.separator "Options:" opts.on("--auto", "Run non-interactively") do options[:auto] = true end opts.on("--no-validate-passenger", "Do not validate the #{SHORT_PROGRAM_NAME} installation#{nl}" + "itself") do options[:validate_passenger] = false end opts.on("--validate-apache2", "Validate Apache 2 integration") do options[:validate_apache2] = true end opts.on("--apxs2-path=PATH", String, "Apache installation to validate") do \|val\| ENV['APXS2'] = val end opts.separator "" opts.on("--no-colors", "Never output colors") do options[:colors] = false end opts.on("--no-summary", "Do not display a summary") do options[:summary] = false end opts.separator "" opts.on("-h", "--help", "Show this help") do options[:help] = true end opts.separator "" opts.separator "Internal options:" opts.on("--invoked-from-installer", "Indicate that this program is invoked from#{nl}" + "passenger-install-apache2-module") do options[:invoked_from_installer] = true end end end def prepare begin require 'rubygems' rescue LoadError end PhusionPassenger.require_passenger_lib 'utils/ansi_colors' PhusionPassenger.require_passenger_lib 'utils/terminal_choice_menu' PhusionPassenger.require_passenger_lib 'platform_info' PhusionPassenger.require_passenger_lib 'platform_info/ruby' PhusionPassenger.require_passenger_lib 'platform_info/apache' PhusionPassenger.require_passenger_lib 'platform_info/apache_detector' PhusionPassenger.require_passenger_lib 'platform_info/depcheck' require 'stringio' require 'pathname' @error_count = 0 @warning_count = 0 @colors = Utils::AnsiColors.new(@options[:colors]) prepare_terminal end def prepare_terminal STDOUT.write(@colors.default_terminal_color) STDOUT.flush end def reset_terminal STDOUT.write(@colors.reset) STDOUT.flush end def ask_what_to_validate log "<banner>What would you like to validate?</banner>" log "Use <space> to select." log "<dgray>If the menu doesn't display correctly, press '!'</dgray>" puts menu = Utils::TerminalChoiceMenu.new([ "#{SHORT_PROGRAM_NAME} itself", "Apache" ]) menu["#{SHORT_PROGRAM_NAME} itself"].checked = @options[:validate_passenger] menu["Apache"].checked = @options[:validate_apache2] begin menu.query rescue Interrupt exit(INTERNAL_ERROR_CODE) end display_separator @options[:validate_passenger] = menu.selected_choices.include?("#{SHORT_PROGRAM_NAME} itself") @options[:validate_apache2] = menu.selected_choices.include?("Apache") end def initialize_apache_envvars # The Apache executable may be located in an 'sbin' folder. We add # the 'sbin' folders to $PATH just in case. On some systems # 'sbin' isn't in $PATH unless the user is logged in as root from # the start (i.e. not via 'su' or 'sudo'). ENV["PATH"] += ":/usr/sbin:/sbin:/usr/local/sbin" end def check_tools_in_path checking "whether this #{SHORT_PROGRAM_NAME} install is in PATH" paths = ENV['PATH'].to_s.split(':') if paths.include?(gem_bindir) \|\| paths.include?(homebrew_bindir) \|\| paths.include?(PhusionPassenger.bin_dir) check_ok else check_warning suggest %Q{ Please add #{PhusionPassenger.bin_dir} to PATH. Otherwise you will get "command not found" errors upon running any Passenger commands. Learn more at about PATH at: https://www.phusionpassenger.com/library/indepth/environment_variables.html#the-path-environment-variable } end end def check_no_other_installs_in_path checking "whether there are no other #{SHORT_PROGRAM_NAME} installations" paths = ENV['PATH'].to_s.split(':') if Process.uid == 0 && (sudo_user = ENV['SUDO_USER']) && (bash = PlatformInfo.find_command("bash")) && PlatformInfo.find_command("sudo") # If we were invoked through sudo then we need to check the original user's PATH too. output = `sudo -u #{sudo_user} #{bash} -lc 'echo; echo PATH FOLLOWS; echo "$PATH"' 2>&1` output.sub!(/.\nPATH FOLLOWS\n/m, '') output.strip! paths.concat(output.split(':')) end # These may not be in PATH if the user did not run this command through sudo. paths << "/usr/bin" paths << "/usr/sbin" # Some of the paths may be symlinks, so we take the realpaths when # possible and remove duplicates. This is especially important on # Red Hat 7, where /bin is a symlink to /usr/bin. paths.map! do \|path\| try_realpath(path) end paths.delete(try_realpath(gem_bindir)) paths.delete(try_realpath(homebrew_bindir)) paths.delete(try_realpath(rbenv_shims_dir)) paths.delete(try_realpath(PhusionPassenger.bin_dir)) paths.uniq! other_installs = [] paths.each do \|path\| filename = "#{path}/passenger" if File.exist?(filename) other_installs << filename end end if other_installs.empty? check_ok else check_warning suggest %Q{ You are currently validating against #{PROGRAM_NAME} #{VERSION_STRING}, located in: #{PhusionPassenger.bin_dir}/passenger Besides this #{SHORT_PROGRAM_NAME} installation, the following other #{SHORT_PROGRAM_NAME} installations have also been detected: #{other_installs.join("\n ")} Please uninstall these other #{SHORT_PROGRAM_NAME} installations to avoid confusion or conflicts. } end end def check_whether_there_are_multiple_apache_installs if PlatformInfo.httpd.nil? \|\| PlatformInfo.apxs2.nil? # check_apache2_installed will handle this. return end log '<banner>Checking whether there are multiple Apache installations...</banner>' output = StringIO.new detector = PlatformInfo::ApacheDetector.new(output) begin detector.detect_all detector.report apache2 = detector.result_for(PlatformInfo.apxs2) if apache2.nil? # Print an extra newline because the autodetection routines # may have run some commands which printed stuff to stderr. puts if Process.uid == 0 # More information will be displayed in #check_no_duplicate_apache2_load_module_config, # which should also fail. log "<red>Your Apache installation appears to be broken. More information will be displayed later.</red>" else whoami = `whoami`.strip sudo = PhusionPassenger::PlatformInfo.ruby_sudo_command selfcommand = "#{PhusionPassenger.bin_dir}/passenger-config validate-install #{@orig_argv.join(' ')}" log "<red>Permission problems</red>" log "This program must be able to analyze your Apache installation. But it can't" log "do that, because you're running the installer as <b>#{whoami}</b>." log "Please give this program root privileges, by re-running it with <yellow>#{sudo}</yellow>:" log "" log " <b>export ORIG_PATH=\"$PATH\"</b>" log " <b>#{sudo_s_e}</b>" log " <b>export PATH=\"$ORIG_PATH\"</b>" log " <b>#{ruby_command} #{selfcommand}</b>" exit(INTERNAL_ERROR_CODE) end elsif detector.results.size > 1 other_installs = detector.results - [apache2] log "<yellow>Multiple Apache installations detected!</yellow>" log "" log "You are about to validate #{SHORT_PROGRAM_NAME} against the following" log "Apache installation:" log "" log " <b>Apache #{apache2.version}</b>" log " <b>apxs2 : #{apache2.apxs2}</b>" log " <b>Executable: #{apache2.httpd}</b>" log "" log "However, #{other_installs.size} other Apache installation(s) have been found on your system:" log "" other_installs.each do \|result\| log " <b>Apache #{result.version}</b>" log " <b>apxs2 : #{result.apxs2}</b>" log " <b>Executable: #{result.httpd}</b>" log "" end result = prompt_confirmation "Are you sure you want to validate " + "against Apache #{apache2.version} (#{apache2.apxs2})?" if !result puts display_separator other_installs.each do \|result\| log " To validate against <yellow>Apache #{result.version} (#{result.apxs2})</yellow>:" log " Re-run this program with: <b>--apxs2-path '#{result.apxs2}'</b>" end log "" log "You may also want to read the \"Installation\" section of Passenger Library" log "installation troubleshooting:" log "" log " https://www.phusionpassenger.com/library/install/apache/" log "" log "If you keep having problems installing, please visit the following website for" log "support:" log "" log " #{SUPPORT_URL}" exit(INTERNAL_ERROR_CODE) end else log '<green>Only a single installation detected. This is good.</green>' end display_separator ensure detector.finish end end def check_apache2_installed checking "whether Apache is installed" if PlatformInfo.httpd # macOS >= 10.13 High Sierra no longer includes apxs2, but that's # okay because we know Apache is installed if PlatformInfo.apxs2 \|\| (PlatformInfo.os_name_simple == 'macosx' && PlatformInfo.os_version >= '10.13' && PlatformInfo.httpd == '/usr/sbin/httpd') check_ok true else check_error PlatformInfo::Depcheck.load("depcheck_specs/apache2") dep = PlatformInfo::Depcheck.find("apache2-dev") install_instructions = dep.install_instructions.split("\n").join("\n ") if !@options[:invoked_from_installer] next_step = "When done, please re-run this program." end suggest %Q{ Unable to validate your Apache installation: more software required This program requires the <b>apxs2</b> tool in order to be able to validate your Apache installation. This tool is currently not installed. You can solve this as follows: #{install_instructions} #{next_step} } false end else check_error PlatformInfo::Depcheck.load("depcheck_specs/apache2") dep = PlatformInfo::Depcheck.find("apache2") install_instructions = dep.install_instructions.split("\n").join("\n ") suggest %Q{ Apache is not installed. You can solve this as follows: #{install_instructions} } false end end def check_apache2_load_module_config checking "whether the Passenger module is correctly configured in Apache" if PlatformInfo.httpd_default_config_file.nil? check_error passenger_config = "#{PhusionPassenger.bin_dir}/passenger-config" suggest %Q{ Your Apache installation might be broken You are about to validate #{PROGRAM_NAME} against the following Apache installation: apxs2 : #{PlatformInfo.apxs2 \|\| 'OS-provided installation'} Executable: #{PlatformInfo.httpd \|\| 'unknown'} Version : #{PlatformInfo.httpd_version \|\| 'unknown'} However, this Apache installation appears to be broken, so this program cannot continue. To find out why this program thinks the above Apache installation is broken, run: export ORIG_PATH="$PATH" #{sudo_s_e} export PATH="$ORIG_PATH" #{ruby_command} #{passenger_config} --detect-apache2 } return end result = PlatformInfo.httpd_included_config_files( PlatformInfo.httpd_default_config_file) if !result[:unreadable_files].empty? check_error if Process.uid == 0 suggest %Q{ Permission problems This program must be able to analyze your Apache installation. But it can't do that despite running with root privileges. In particular, it failed to read the following files: #{result[:unreadable_files].join("\n ")} This program doesn't know why this error occurred. Your system is probably secured using some mechanism that this program is not familiar with. Please consult your operating system's manual to learn which security mechanisms may be preventing this program from accessing the above files. On Linux systems, SELinux and AppArmor might be responsible. When you've solved the problem, please re-run this program. } else whoami = `whoami`.strip sudo = PhusionPassenger::PlatformInfo.ruby_sudo_command selfcommand = "#{PhusionPassenger.bin_dir}/passenger-config validate-install #{@orig_argv.join(' ')}" suggest %Q{ Permission problems This program must be able to analyze your Apache installation. But it can't do that, because you're running the installer as '#{whoami}'. In particular, it failed to read the following files: #{result[:unreadable_files].join("\n ")} Please give this program root privileges, by re-running it with '#{sudo}': export ORIG_PATH=\"$PATH\" #{sudo_s_e} export PATH=\"$ORIG_PATH\" #{ruby_command} #{selfcommand} } end return end occurrences = 0 occurrence_files = [] module_path = nil result[:files].each do \|path\| lines = File.open(path, "rb") do \|f\| f.read.split("\n") end lines.each do \|line\| # Get rid of trailing CR line = line.strip if line !~ /^[\s\t]#/ && line =~ /LoadModule[\s\t]+passenger_module[\s\t]+(.)/ module_path = $1 occurrences += 1 occurrence_files << path end end end if occurrences == 1 if module_path !~ /^\// # Non-absolute path. Absolutize using ServerRoot. module_path = "#{PlatformInfo.httpd_default_root}/#{module_path}" end # Resolve symlinks. module_path = try_realpath(module_path) expected_module_path = try_realpath(PhusionPassenger.apache2_module_path) if module_path == expected_module_path check_ok else check_error suggest %Q{ Incorrect #{SHORT_PROGRAM_NAME} module path detected #{PROGRAM_NAME} for Apache requires a 'LoadModule passenger_module' directive inside an Apache configuration file. This directive has been detected in the following config file: #{occurrence_files[0]} However, the directive refers to the following Apache module, which is wrong: #{module_path} Please edit the config file and change the directive to this instead: LoadModule passenger_module #{PhusionPassenger.apache2_module_path} } end elsif occurrences == 0 if @options[:invoked_from_installer] check_warning suggest %Q{ You did not specify 'LoadModule passenger_module' in any of your Apache configuration files. Please paste the configuration snippet that this installer printed earlier, into one of your Apache configuration files, such as #{PlatformInfo.httpd_default_config_file}. } else check_error installer_command = "#{PhusionPassenger.bin_dir}/passenger-install-apache2-module" suggest %Q{ You did not specify 'LoadModule passenger_module' in any of your Apache configuration files. This means that #{PROGRAM_NAME} for Apache is not installed or not active. Please run the #{PROGRAM_NAME} Apache module installer: #{ruby_command} #{installer_command} --apxs2=#{PlatformInfo.apxs2 \|\| 'none'} } end else check_error suggest %Q{ You have #{occurrences} 'LoadModule passenger_module' directives in your Apache configuration files. However, you are only supposed to have one such directive. Please fix this by removing all 'LoadModule passenger_module' directives besides the one for #{SHORT_PROGRAM_NAME} version #{VERSION_STRING}. The directives were found in these files: #{occurrence_files.uniq.join("\n ")} Note: 'LoadModule passenger_module' may be placed inside the global context only (so not within a VirtualHost). } end end def summarize puts if @error_count == 0 && @warning_count == 0 log "<green>Everything looks good. :-)</green>" elsif @error_count == 0 log "<yellow>Detected 0 error(s), #{@warning_count} warning(s).</yellow>" else log "<red>Detected #{@error_count} error(s), #{@warning_count} warning(s).</red>" end end # Returns the RubyGems bin dir, if Phusion Passenger is installed through RubyGems. def gem_bindir if defined?(Gem) && PhusionPassenger.originally_packaged? && PhusionPassenger.build_system_dir =~ /^#{Regexp.escape Gem.dir}\// && File.exist?("#{Gem.bindir}/passenger-config") return Gem.bindir else return nil end end # Returns the Homebrew bin dir, if Phusion Passenger is installed through Homebrew. def homebrew_bindir if PhusionPassenger.packaging_method == "homebrew" return "/usr/local/bin" else return nil end end # Returns the ~/.rbenv/shims directory if it exists. def rbenv_shims_dir home = PhusionPassenger.home_dir "#{home}/.rbenv/shims" end def logn(message) STDOUT.write(@colors.ansi_colorize(message)) STDOUT.flush end def log(message) STDOUT.puts(@colors.ansi_colorize(message)) end def display_separator puts puts "-------------------------------------------------------------------------" puts end def checking(message) logn " * Checking #{message}... " end def check_ok(message = "✓") log "<green>#{message}</green>" end def check_error(message = "✗") log "<red>#{message}</red>" @error_count += 1 end def check_warning(message = "(!)") log "<yellow>#{message}</yellow>" @warning_count += 1 end def suggest(message) puts log reindent(unindent(message), 3) puts end def prompt_confirmation(message) result = prompt("#{message} [y/n]") do \|value\| if value.downcase == 'y' \|\| value.downcase == 'n' true else log "<red>Invalid input '#{value}'; please enter either 'y' or 'n'.</red>" false end end result.downcase == 'y' rescue Interrupt exit(INTERNAL_ERROR_CODE) end def prompt(message, default_value = nil) done = false while !done logn "#{message}: " if default_value puts default_value return default_value end begin result = STDIN.readline rescue EOFError exit(INTERNAL_ERROR_CODE) end result.strip! if result.empty? if default_value result = default_value done = true else done = !block_given? \|\| yield(result) end else done = !block_given? \|\| yield(result) end end result rescue Interrupt exit(INTERNAL_ERROR_CODE) end def unindent(text) return PlatformInfo.send(:unindent, text) end def reindent(text, level) return PlatformInfo.send(:reindent, text, level) end def sudo_s_e PlatformInfo.ruby_sudo_shell_command("-E") end def ruby_command PlatformInfo.ruby_command end def try_realpath(path) if path begin Pathname.new(path).realpath.to_s rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR path end else nil end end end end # module Config end # module PhusionPassenger	26.3 KB	2025-11-20 11:36

Edit File:

Terminal