passenger 2.1.3 → 2.2.0

data/bin/passenger-config

@@ -1,23 +1,30 @@
 #!/usr/bin/env ruby
 #  Phusion Passenger - http://www.modrails.com/
-#  Copyright (C) 2008  Phusion
+#  Copyright (c) 2008, 2009 Phusion
 #
-#  Phusion Passenger is a trademark of Hongli Lai & Ninh Bui.
+#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
 #
-#  This program is free software; you can redistribute it and/or modify
-#  it under the terms of the GNU General Public License as published by
-#  the Free Software Foundation; version 2 of the License.
+#  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:
 #
-#  This program is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU General Public License for more details.
+#  The above copyright notice and this permission notice shall be included in
+#  all copies or substantial portions of the Software.
 #
-#  You should have received a copy of the GNU General Public License along
-#  with this program; if not, write to the Free Software Foundation, Inc.,
-#  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#  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.
 
 PASSENGER_ROOT = File.expand_path(File.dirname(__FILE__) << "/..")
+$LOAD_PATH.unshift("#{PASSENGER_ROOT}/lib")
+require 'phusion_passenger/constants'
 
 def help
 	puts "Tool for showing Passenger configuration information."
@@ -32,8 +39,7 @@ case ARGV[0]
 when "--root"
 	puts PASSENGER_ROOT
 when "--version"
-	File.read("#{PASSENGER_ROOT}/Rakefile") =~ /^PACKAGE_VERSION = "(.*)"/
-	puts $1
+	puts PhusionPassenger::VERSION_STRING
 else
 	help
 	exit 1

data/bin/passenger-install-apache2-module

@@ -1,21 +1,26 @@
 #!/usr/bin/env ruby
 #  Phusion Passenger - http://www.modrails.com/
-#  Copyright (C) 2008  Phusion
+#  Copyright (c) 2008, 2009 Phusion
 #
-#  Phusion Passenger is a trademark of Hongli Lai & Ninh Bui.
+#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
 #
-#  This program is free software; you can redistribute it and/or modify
-#  it under the terms of the GNU General Public License as published by
-#  the Free Software Foundation; version 2 of the License.
+#  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:
 #
-#  This program is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU General Public License for more details.
+#  The above copyright notice and this permission notice shall be included in
+#  all copies or substantial portions of the Software.
 #
-#  You should have received a copy of the GNU General Public License along
-#  with this program; if not, write to the Free Software Foundation, Inc.,
-#  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#  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.
 
 PASSENGER_ROOT = File.expand_path(File.dirname(__FILE__) << "/..")
 $LOAD_PATH.unshift("#{PASSENGER_ROOT}/lib")
@@ -30,42 +35,46 @@ ENV["PATH"] += ":/usr/sbin:/sbin:/usr/local/sbin"
 require 'optparse'
 require 'phusion_passenger/platform_info'
 require 'phusion_passenger/dependencies'
-require 'phusion_passenger/console_text_template'
+require 'phusion_passenger/abstract_installer'
 include PlatformInfo
 
-class Installer
+class Installer < PhusionPassenger::AbstractInstaller
 	include PhusionPassenger
 	
-	PASSENGER_WEBSITE = "http://www.modrails.com/"
-	PHUSION_WEBSITE = "www.phusion.nl"
-	
-	REQUIRED_DEPENDENCIES = [
-		Dependencies::GCC,
-		Dependencies::Ruby_DevHeaders,
-		Dependencies::Ruby_OpenSSL,
-		Dependencies::RubyGems,
-		Dependencies::Rake,
-		Dependencies::Apache2,
-		Dependencies::Apache2_DevHeaders
-	]
-	if Dependencies.fastthread_required?
-		REQUIRED_DEPENDENCIES << Dependencies::FastThread
+	def dependencies
+		result = [
+			Dependencies::GCC,
+			Dependencies::Ruby_DevHeaders,
+			Dependencies::Ruby_OpenSSL,
+			Dependencies::RubyGems,
+			Dependencies::Rake,
+			Dependencies::Apache2,
+			Dependencies::Apache2_DevHeaders,
+			Dependencies::FastThread
+		]
+		if Dependencies.fastthread_required?
+			result << Dependencies::FastThread
+		end
+		# Some broken servers don't have apr-config or apu-config installed.
+		# Nevertheless, it is possible to compile Apache modules if Apache
+		# was configured with --included-apr. So here we check whether
+		# apr-config and apu-config are available. If they're not available,
+		# then we only register them as required dependency if no Apache
+		# module can be compiled without their presence.
+		if (PlatformInfo.apr_config && PlatformInfo.apu_config) ||
+		   PlatformInfo.apr_config_needed_for_building_apache_modules?
+			result << Dependencies::APR_DevHeaders
+			result << Dependencies::APU_DevHeaders
+		end
+		return result
 	end
-	# Some broken servers don't have apr-config or apu-config installed.
-	# Nevertheless, it is possible to compile Apache modules if Apache
-	# was configured with --included-apr. So here we check whether
-	# apr-config and apu-config are available. If they're not available,
-	# then we only register them as required dependency if no Apache
-	# module can be compiled without their presence.
-	if (PlatformInfo.apr_config && PlatformInfo.apu_config) ||
-	   PlatformInfo.apr_config_needed_for_building_apache_modules?
-		REQUIRED_DEPENDENCIES << Dependencies::APR_DevHeaders
-		REQUIRED_DEPENDENCIES << Dependencies::APU_DevHeaders
+	
+	def users_guide
+		return "#{DOCDIR}/Users guide Apache.html"
 	end
 	
-	def start(automatic = false)
-		@auto = automatic
-		if natively_packaged?
+	def install!
+		if PhusionPassenger.natively_packaged?
 			check_dependencies || exit(1)
 			show_apache2_config_snippets
 			show_deployment_example
@@ -84,75 +93,15 @@ class Installer
 			show_possible_solutions_for_compilation_and_installation_problems
 			exit(1)
 		end
-	ensure
-		reset_terminal_colors
 	end
 
 private
-	def init_terminal_colors
-		STDOUT.write("\e[0m\e[37m\e[40m")
-		STDOUT.flush
-	end
-	
-	def reset_terminal_colors
-		STDOUT.write("\e[0m")
-		STDOUT.flush
-	end
-	
 	def show_welcome_screen
-		render_template 'welcome', :version => PASSENGER_VERSION
+		render_template 'apache2/welcome', :version => VERSION_STRING
 		wait
 	end
-
-	def check_dependencies
-		missing_dependencies = []
-		color_puts "<banner>Checking for required software...</banner>"
-		puts
-		REQUIRED_DEPENDENCIES.each do |dep|
-			color_print " * #{dep.name}... "
-			result = dep.check
-			if result.found?
-				if result.found_at
-					color_puts "<green>found at #{result.found_at}</green>"
-				else
-					color_puts "<green>found</green>"
-				end
-			else
-				color_puts "<red>not found</red>"
-				missing_dependencies << dep
-			end
-		end
-		
-		if missing_dependencies.empty?
-			return true
-		else
-			puts
-			color_puts "<red>Some required software is not installed.</red>"
-			color_puts "But don't worry, this installer will tell you how to install them.\n"
-			color_puts "<b>Press Enter to continue, or Ctrl-C to abort.</b>"
-			if natively_packaged?
-				wait(10)
-			else
-				wait
-			end
-			
-			line
-			color_puts "<banner>Installation instructions for required software</banner>"
-			puts
-			missing_dependencies.each do |dep|
-				print_dependency_installation_instructions(dep)
-				puts
-			end
-			color_puts "If the aforementioned instructions didn't solve your problem, then please take"
-			color_puts "a look at the Users Guide:"
-			puts
-			color_puts "  <yellow>#{USERS_GUIDE}</yellow>"
-			return false
-		end
-	end
 	
 	def check_whether_apache_uses_compatible_mpm
-		line
 		# 'httpd -V' output is in the form of:
 		#
 		# Server MPM:      Prefork     # <--- this line is not always available!
@@ -172,7 +121,8 @@ private
 			end
 		end
 		if mpm != "prefork" && mpm != "worker"
-			render_template 'apache_must_be_compiled_with_compatible_mpm',
+			new_screen
+			render_template 'apache2/apache_must_be_compiled_with_compatible_mpm',
 				:current_mpm => mpm
 			wait
 		end
@@ -181,13 +131,13 @@ private
 	def check_write_permission_to_passenger_root
 		File.new("__test__.txt", "w").close
 		return true
-	rescue
+	rescue SystemCallError
 		puts
 		line
 		if Process.uid == 0
-			render_template 'no_write_permission_to_passenger_root'
+			render_template 'apache2/no_write_permission_to_passenger_root'
 		else
-			render_template 'run_installer_as_root'
+			render_template 'apache2/run_installer_as_root'
 		end
 		return false
 	ensure
@@ -201,26 +151,26 @@ private
 		puts "cd #{PASSENGER_ROOT}"
 		if ENV['TRACE']
 			puts "#{RUBY} -S #{PlatformInfo.rake} --trace clean apache2"
-			return system(RUBY, "-S", PlatformInfo.rake, "--trace", "clean", "apache2")
+			return sh(RUBY, "-S", PlatformInfo.rake, "--trace", "clean", "apache2")
 		else
 			puts "#{RUBY} -S #{PlatformInfo.rake} clean apache2"
-			return system(RUBY, "-S", PlatformInfo.rake, "clean", "apache2")
+			return sh(RUBY, "-S", PlatformInfo.rake, "clean", "apache2")
 		end
 	end
 	
 	def show_apache2_config_snippets
 		puts
 		line
-		if natively_packaged?
+		if PhusionPassenger.natively_packaged?
 			module_location = "#{PASSENGER_ROOT}/lib/phusion_passenger/mod_passenger.so"
 		else
 			module_location = "#{PASSENGER_ROOT}/ext/apache2/mod_passenger.so"
 		end
-		render_template 'apache2_config_snippets',
+		render_template 'apache2/config_snippets',
 			:module_location => module_location,
 			:passenger_root => PASSENGER_ROOT,
 			:ruby => RUBY
-		if natively_packaged?
+		if PhusionPassenger.natively_packaged?
 			wait(10)
 		else
 			wait
@@ -230,102 +180,18 @@ private
 	def show_deployment_example
 		puts
 		line
-		render_template 'deployment_example',
-			:users_guide => USERS_GUIDE,
+		render_template 'apache2/deployment_example',
+			:users_guide => users_guide,
 			:phusion_website => PHUSION_WEBSITE,
 			:passenger_website => PASSENGER_WEBSITE
 	end
 	
 	def show_possible_solutions_for_compilation_and_installation_problems
-		puts
-		line
-		render_template 'possible_solutions_for_compilation_and_installation_problems',
-			:users_guide => USERS_GUIDE,
+		new_screen
+		render_template 'apache2/possible_solutions_for_compilation_and_installation_problems',
+			:users_guide => users_guide,
 			:passenger_website => PASSENGER_WEBSITE
 	end
-
-private
-	def color_print(text)
-		STDOUT.write(ConsoleTextTemplate.new(:text => text).result)
-		STDOUT.flush
-	end
-	
-	def color_puts(text)
-		color_print("#{text}\n")
-	end
-	
-	def render_template(name, options = {})
-		puts ConsoleTextTemplate.new({ :file => name }, options).result
-	end
-	
-	def line
-		puts "--------------------------------------------"
-	end
-	
-	def wait(timeout = nil)
-		return if @auto
-		begin
-			if timeout
-				require 'timeout' unless defined?(Timeout)
-				begin
-					Timeout.timeout(timeout) do
-						STDIN.readline
-					end
-				rescue Timeout::Error
-					# Do nothing.
-				end
-			else
-				STDIN.readline
-			end
-		rescue Interrupt
-			exit 2
-		end
-	end
-	
-	def print_dependency_installation_instructions(dep)
-		color_puts " * To install <yellow>#{dep.name}</yellow>:"
-		if !dep.install_command.nil?
-			color_puts "   Please run <b>#{dep.install_command}</b> as root."
-		elsif !dep.install_instructions.nil?
-			color_puts "   " << dep.install_instructions
-		elsif !dep.website.nil?
-			color_puts "   Please download it from <b>#{dep.website}</b>"
-			if !dep.website_comments.nil?
-				color_puts "   (#{dep.website_comments})"
-			end
-		else
-			color_puts "   Search Google."
-		end
-	end
-	
-	def natively_packaged?
-		return self.class.natively_packaged?
-	end
-	
-	def self.natively_packaged?
-		return File.expand_path(File.dirname(__FILE__)) == "/usr/bin"
-	end
-	
-	def self.determine_version
-		if natively_packaged?
-			require 'rbconfig'
-			return File.read("/etc/passenger_version.txt")
-		else
-			File.read("#{PASSENGER_ROOT}/Rakefile") =~ /^PACKAGE_VERSION = "(.*)"$/
-			return $1
-		end
-	end
-	
-	def self.determine_users_guide
-		if natively_packaged?
-			return "/usr/share/doc/phusion_passenger/Users guide.html"
-		else
-			return "#{PASSENGER_ROOT}/doc/Users guide.html"
-		end
-	end
-	
-	PASSENGER_VERSION = determine_version
-	USERS_GUIDE = determine_users_guide
 end
 
 options = {}
@@ -349,4 +215,4 @@ rescue OptionParser::ParseError => e
 	exit 1
 end
 
-Installer.new.start(options[:auto])
+Installer.new(options).start

data/bin/passenger-install-nginx-module

@@ -0,0 +1,477 @@
+#!/usr/bin/env ruby
+#  Phusion Passenger - http://www.modrails.com/
+#  Copyright (c) 2009 Phusion
+#
+#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+#
+#  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.
+
+PASSENGER_ROOT = File.expand_path(File.dirname(__FILE__) << "/..")
+$LOAD_PATH.unshift("#{PASSENGER_ROOT}/lib")
+$LOAD_PATH.unshift("#{PASSENGER_ROOT}/ext")
+
+require 'optparse'
+require 'fileutils'
+require 'phusion_passenger/platform_info'
+require 'phusion_passenger/dependencies'
+require 'phusion_passenger/abstract_installer'
+include PlatformInfo
+
+class Installer < PhusionPassenger::AbstractInstaller
+	include PhusionPassenger
+	
+	NGINX_VERSION = "0.6.36"
+	
+	def dependencies
+		return [
+			Dependencies::GCC,
+			Dependencies::Ruby_DevHeaders,
+			Dependencies::Ruby_OpenSSL,
+			Dependencies::RubyGems,
+			Dependencies::Rake,
+			Dependencies::FastThread,
+			Dependencies::Zlib_Dev
+		]
+	end
+	
+	def users_guide
+		return "#{DOCDIR}/Users guide Nginx.html"
+	end
+	
+	def install!
+		Dir.chdir(PASSENGER_ROOT)
+		show_welcome_screen
+		check_dependencies || exit(1)
+		
+		check_write_permission_to_passenger_root || exit(1)
+		
+		download_and_install = should_we_download_and_install_nginx_automatically?
+		if pcre_is_installed?
+			@pcre_source_dir = nil
+		else
+			@pcre_source_dir = download_and_extract_pcre
+		end
+		if download_and_install
+			nginx_source_dir = download_and_extract_nginx
+			if nginx_source_dir.nil?
+				show_possible_solutions_for_download_and_extraction_problems
+				exit(1)
+			end
+			nginx_prefix = ask_for_nginx_install_prefix
+			extra_nginx_configure_flags = nil
+		else
+			nginx_source_dir = ask_for_nginx_source_dir
+			nginx_prefix = ask_for_nginx_install_prefix
+			extra_nginx_configure_flags = ask_for_extra_nginx_configure_flags(nginx_prefix)
+		end
+		check_whether_we_can_write_to(nginx_prefix) || exit(1)
+		nginx_config_already_exists_before_installing = nginx_config_exists?(nginx_prefix)
+		compile_passenger_support_files || exit(1)
+		if install_nginx(nginx_source_dir, nginx_prefix, extra_nginx_configure_flags)
+			if nginx_config_already_exists_before_installing
+				show_passenger_config_snippets(nginx_prefix)
+			else
+				insert_passenger_config_snippets(nginx_prefix)
+			end
+			show_deployment_example
+		else
+			show_possible_solutions_for_compilation_and_installation_problems
+			exit(1)
+		end
+	end
+
+private
+	def show_welcome_screen
+		render_template 'nginx/welcome', :version => VERSION_STRING
+		wait
+	end
+	
+	def check_write_permission_to_passenger_root
+		File.new("__test__.txt", "w").close
+		return true
+	rescue
+		new_screen
+		if Process.uid == 0
+			render_template 'no_write_permission_to_passenger_root'
+		else
+			render_template 'run_installer_as_root'
+		end
+		return false
+	ensure
+		File.unlink("__test__.txt") rescue nil
+	end
+	
+	def compile_passenger_support_files
+		new_screen
+		color_puts "<banner>Compiling Passenger support files...</banner>"
+		return sh(RUBY, "-S", PlatformInfo.rake, "clean", "nginx")
+	end
+	
+	def should_we_download_and_install_nginx_automatically?
+		new_screen
+		render_template 'nginx/query_download_and_install',
+			:nginx_version => NGINX_VERSION
+		puts
+		
+		if @auto_download
+			color_puts "<b>=> Proceeding with choice 1.</b>"
+			return true
+		elsif @nginx_source_dir
+			color_puts "<b>=> Proceeding with choice 2.</b>"
+			return false
+		else
+			choice = prompt("Enter your choice (1 or 2) or press Ctrl-C to abort") do |input|
+				if input == "1" || input == "2"
+					true
+				elsif input.empty?
+					color_puts "<red>No choice has been given.</red>"
+					false
+				else
+					color_puts "<red>'#{input}' is not a valid choice.</red>"
+					false
+				end
+			end
+			return choice == "1"
+		end
+	end
+	
+	def download_and_extract_pcre
+		new_screen
+		color_puts "<banner>PCRE (required by Nginx) not installed, downloading it...</banner>"
+		
+		basename = "pcre-7.8.tar.gz"
+		dirname = "pcre-7.8"
+		url = "ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/#{basename}"
+		File.unlink("/tmp/#{basename}") rescue nil
+		FileUtils.rm_rf("/tmp/#{dirname}")
+		
+		if download(url, "/tmp/#{basename}")
+			Dir.chdir("/tmp") do
+				color_puts "<banner>Extracting PCRE source tarball...</banner>"
+				if sh("tar", "xzvf", basename)
+					return "/tmp/#{dirname}"
+				else
+					new_screen
+					render_template "nginx/pcre_could_not_be_extracted"
+					wait
+					return nil
+				end
+			end
+		else
+			new_screen
+			render_template "nginx/pcre_could_not_be_downloaded"
+			wait
+			return nil
+		end
+	rescue Interrupt
+		exit 2
+	end
+	
+	def download_and_extract_nginx
+		new_screen
+		color_puts "<banner>Downloading Nginx...</banner>"
+		
+		basename = "nginx-#{NGINX_VERSION}.tar.gz"
+		url = "http://sysoev.ru/nginx/#{basename}"
+		File.unlink("/tmp/#{basename}") rescue nil
+		FileUtils.rm_rf("/tmp/nginx-#{NGINX_VERSION}")
+		
+		if download(url, "/tmp/#{basename}")
+			Dir.chdir("/tmp") do
+				color_puts "<banner>Extracting Nginx source tarball...</banner>"
+				if sh("tar", "xzvf", basename)
+					return "/tmp/nginx-#{NGINX_VERSION}"
+				else
+					return nil
+				end
+			end
+		else
+			return nil
+		end
+	rescue Interrupt
+		exit 2
+	end
+	
+	def show_possible_solutions_for_download_and_extraction_problems
+		new_screen
+		render_template "nginx/possible_solutions_for_download_and_extraction_problems"
+		puts
+	end
+	
+	def ask_for_nginx_install_prefix
+		new_screen
+		color_puts "<banner>Where do you want to install Nginx to?</banner>"
+		puts
+		if @prefix
+			color_puts "<b>=> #{@prefix}</b>"
+			return @prefix
+		else
+			prefix = prompt("Please specify a prefix directory [/opt/nginx]") do |input|
+				if input.empty? || input =~ %r(/)
+					true
+				else
+					color_puts "<red>Please specify an absolute path.</red>"
+					false
+				end
+			end
+			if prefix.empty?
+				prefix = "/opt/nginx"
+			end
+			return prefix
+		end
+	end
+	
+	def ask_for_nginx_source_dir
+		new_screen
+		color_puts "<banner>Where is your Nginx source code located?</banner>"
+		puts
+		if @nginx_source_dir
+			color_puts "<b>=> #{@nginx_source_dir}</b>"
+			return @nginx_source_dir
+		else
+			return prompt("Please specify the directory") do |input|
+				if input =~ %r(/)
+					if File.exist?("#{input}/src/core/nginx.c")
+						true
+					else
+						color_puts "<red>'#{input}' does not look like an Nginx source directory.</red>"
+						false
+					end
+				else
+					color_puts "<red>Please specify an absolute path.</red>"
+					false
+				end
+			end
+		end
+	end
+	
+	def ask_for_extra_nginx_configure_flags(prefix)
+		done = false
+		while !done
+			new_screen
+			render_template 'nginx/ask_for_extra_configure_flags',
+				:command => build_nginx_configure_command(prefix)
+			puts
+			if @extra_configure_flags
+				if @extra_configure_flags == "none"
+					extra_args = ""
+					color_puts "<b>=> No extra configure flags.</b>"
+				else
+					extra_args = @extra_configure_flags
+					color_puts "<b>=> #{extra_args}</b>"
+				end
+				return extra_args
+			else
+				extra_args = prompt "Extra arguments to pass to configure script"
+			
+				new_screen
+				render_template 'nginx/confirm_extra_configure_flags',
+					:command => build_nginx_configure_command(prefix, extra_args)
+				puts
+				answer = prompt("Is this what you want? (yes/no) [default=yes]") do |input|
+					if input.empty? || input == "yes" || input == "no"
+						true
+					else
+						color_puts "<red>Please enter 'yes' or 'no'.</red>"
+						false
+					end
+				end
+				done = answer.empty? || answer == "yes"
+			end
+		end
+		return extra_args
+	end
+	
+	def check_whether_we_can_write_to(dir)
+		FileUtils.mkdir_p(dir)
+		File.new("#{dir}/__test__.txt", "w").close
+		return true
+	rescue
+		new_screen
+		if Process.uid == 0
+			render_template 'nginx/cannot_write_to_dir', :dir => dir
+		else
+			render_template 'nginx/run_installer_as_root', :dir => dir
+		end
+		return false
+	ensure
+		File.unlink("#{dir}/__test__.txt") rescue nil
+	end
+	
+	def nginx_config_exists?(prefix)
+		return !!locate_nginx_config_file(prefix)
+	end
+	
+	def install_nginx(source_dir, prefix, extra_configure_flags)
+		Dir.chdir(source_dir) do
+			new_screen
+			color_puts "<banner>Compiling and installing Nginx...</banner>"
+			if !sh(build_nginx_configure_command(prefix, extra_configure_flags)) ||
+			   !sh("make") ||
+			   !sh("make install")
+				return false
+			end
+		end
+		return true
+	end
+	
+	def show_passenger_config_snippets(prefix)
+		new_screen
+		render_template 'nginx/config_snippets',
+			:config_file => locate_nginx_config_file(prefix),
+			:passenger_root => PASSENGER_ROOT,
+			:ruby => RUBY
+		wait
+	end
+	
+	def show_deployment_example
+		line
+		puts
+		render_template 'nginx/deployment_example',
+			:users_guide => users_guide,
+			:phusion_website => PHUSION_WEBSITE,
+			:passenger_website => PASSENGER_WEBSITE
+	end
+	
+	def show_possible_solutions_for_compilation_and_installation_problems
+		line
+		puts
+		render_template 'nginx/possible_solutions_for_compilation_and_installation_problems',
+			:users_guide => users_guide,
+			:passenger_website => PASSENGER_WEBSITE
+	end
+	
+	def locate_nginx_config_file(prefix)
+		["#{prefix}/conf/nginx.conf", "#{prefix}/etc/nginx.conf"].each do |filename|
+			if File.exist?(filename)
+				return filename
+			end
+		end
+		return nil
+	end
+	
+	def insert_passenger_config_snippets(prefix)
+		config_file = locate_nginx_config_file(prefix)
+		contents = File.read(config_file)
+		contents.sub!(/^http \{/,
+			"http {\n" <<
+			"    passenger_root #{PASSENGER_ROOT};\n" <<
+			"    passenger_ruby #{RUBY};\n")
+		File.open(config_file, 'w') do |f|
+			f.write(contents)
+		end
+		
+		new_screen
+		render_template 'nginx/config_snippets_inserted',
+			:config_file => config_file,
+			:passenger_root => PASSENGER_ROOT,
+			:ruby => RUBY
+		wait
+	end
+	
+	def build_nginx_configure_command(prefix, extra_configure_flags = nil)
+		command = "./configure --prefix='#{prefix}' "
+		if @pcre_source_dir
+			command << "--with-pcre='#{@pcre_source_dir}' "
+		else
+			command << "--without-http_rewrite_module "
+		end
+		command << "--add-module='#{PASSENGER_ROOT}/ext/nginx' #{extra_configure_flags}"
+		command.strip!
+		return command
+	end
+	
+	def pcre_is_installed?
+		if @pcre_is_installed.nil?
+			@pcre_is_installed = begin
+				File.open('/tmp/passenger-check.c', 'w') do |f|
+					f.puts("#include <pcre.h>")
+				end
+				Dir.chdir('/tmp') do
+					system("(gcc -c passenger-check.c) >/dev/null 2>/dev/null")
+				end
+			ensure
+				File.unlink('/tmp/passenger-check.c') rescue nil
+				File.unlink('/tmp/passenger-check.o') rescue nil
+			end
+		end
+		return @pcre_is_installed
+	end
+	
+	def download(url, output)
+		if PlatformInfo.find_command("wget")
+			return sh("wget", "-O", output, url)
+		else
+			return sh("curl", url, "-o", output)
+		end
+	end
+end
+
+options = {}
+parser = OptionParser.new do |opts|
+	opts.banner = "Usage: passenger-install-nginx-module [options]"
+	opts.separator ""
+	
+	opts.separator "Options:"
+	opts.on("--auto", "Automatically confirm 'Press ENTER to\n" <<
+	        "#{' ' * 37}continue' prompts.") do
+		options[:auto] = true
+	end
+	opts.on("--prefix=DIR", String, "Use the given Nginx install prefix instead\n" <<
+	        "#{' ' * 37}of asking for it interactively.") do |dir|
+		options[:prefix] = dir
+	end
+	opts.on("--auto-download", "Download and install Nginx automatically,\n" <<
+	        "#{' ' * 37}instead of asking interactively whether to\n" <<
+	        "#{' ' * 37}download+install or to use an existing\n" <<
+	        "#{' ' * 37}Nginx source directory.") do
+		options[:auto_download] = true
+	end
+	opts.on("--nginx-source-dir=DIR", String, "Compile and install Nginx using the given\n" <<
+	        "#{' ' * 37}Nginx source directory, instead of\n" <<
+	        "#{' ' * 37}interactively asking to download+install\n" <<
+	        "#{' ' * 37}or to use an existing Nginx source\n" <<
+	        "#{' ' * 37}directory. Conflicts with --auto-download.") do |dir|
+		options[:nginx_source_dir] = dir
+	end
+	opts.on("--extra-configure-flags=STRING", String, "Pass these extra flags to Nginx's\n" <<
+	        "#{' ' * 37}'configure' script, instead of asking for\n" <<
+	        "#{' ' * 37}it interactively. Only applicable if\n" <<
+	        "#{' ' * 37}--nginx-source-dir is given. Specify\n" <<
+	        "#{' ' * 37}'none' if you do not want to pass\n" <<
+	        "#{' ' * 37}additional flags but do not want this\n" <<
+	        "#{' ' * 37}installer to ask interactively either.") do |flags|
+		options[:extra_configure_flags] = flags
+	end
+end
+begin
+	parser.parse!
+rescue OptionParser::ParseError => e
+	puts e
+	puts
+	puts "Please see '--help' for valid options."
+	exit 1
+end
+
+if options[:auto_download] && options[:nginx_source_dir]
+	STDERR.puts "You cannot specify both --auto-download and --nginx-source-dir."
+	exit 1
+end
+
+Installer.new(options).start