Class: PhusionPassenger::Standalone::RuntimeInstaller

Inherits:
AbstractInstaller show all
Includes:
Utils
Defined in:
lib/phusion_passenger/standalone/runtime_installer.rb

Overview

Installs the Phusion Passenger Standalone runtime by downloading and compiling Nginx, compiling the Phusion Passenger support binaries, and storing the results in the designated directories. This installer is entirely non-interactive.

The following option must be given:

  • source_root: Path to the Phusion Passenger source root.

If you want RuntimeInstaller to compile and install Nginx, then you must specify these options:

  • nginx_dir: Nginx will be installed into this directory.

  • support_dir: See below.

  • version (optional): The Nginx version to download. If not given then a hardcoded version number will be used.

  • tarball (optional): The location to the Nginx tarball. This tarball must contain the Nginx version as specified by version. If tarball is given then Nginx will not be downloaded; it will be extracted from this tarball instead.

If you want RuntimeInstaller to compile and install the Phusion Passenger support files, then you must specify these:

  • support_dir: The support files will be installed here. Should not equal source_root, or funny things might happen.

Other optional options:

  • download_binaries: If true then RuntimeInstaller will attempt to download precompiled Nginx binaries and precompiled Phusion Passenger support files from the network, if they exist for the current platform. The default is false.

  • binaries_url_root: The URL on which to look for the aforementioned binaries. The default points to the Phusion website.

Please note that RuntimeInstaller will try to avoid compiling/installing things that don’t need to be compiled/installed. This is done by checking whether some key files exist, and concluding that something doesn’t need to be compiled/installed if they do. This quick check is of course not perfect; if you want to force a recompilation/reinstall then you should remove nginx_dir and support_dir before starting this installer.

Constant Summary

Constants inherited from AbstractInstaller

AbstractInstaller::PASSENGER_WEBSITE, AbstractInstaller::PHUSION_WEBSITE

Method Summary

Methods inherited from AbstractInstaller

#initialize, #start

Constructor Details

This class inherits a constructor from PhusionPassenger::AbstractInstaller