passenger 5.0.7 → 5.0.8

data/doc/Users guide Nginx.idmap.txt

@@ -32,7 +32,11 @@
 
 2.3.3. Inserting passenger_root into nginx.conf	=>	inserting-passenger-root-into-nginx-conf--1pmj19o
 
-2.4. Installing or upgrading on Red Hat, Fedora, CentOS or ScientificLinux	=>	installing-or-upgrading-on-red-hat-fedora-centos-or-scientificlinux-1uus5a1
+2.4. Installing or upgrading on Red Hat or CentOS	=>	installing-or-upgrading-on-red-hat-fedora-centos-or-scientificlinux-1uus5a1
+
+2.4.1. Adding our YUM repository	=>	adding-our-yum-repository-2i9z9o
+
+2.4.2. Installing packages	=>	installing-packages-1actlet
 
 2.5. Installing or upgrading on Heroku	=>	installing-or-upgrading-on-heroku-jh07kr
 
@@ -242,7 +246,7 @@
 
 7.6.15. passenger_buffers	=>	passenger-busy-buffers
 
-7.6.16. passenger_busy_buffer_size	=>	passenger-busy-buffer-size-124sj61
+7.6.16. passenger_busy_buffers_size	=>	passenger-busy-buffer-size-124sj61
 
 7.7. Logging and debugging options	=>	logging-and-debugging-options-14e91ni
 
@@ -310,7 +314,9 @@
 
 10.1.3. Caveats & troubleshooting	=>	caveats-troubleshooting-mbw582
 
-10.1.4. Finding out what user an application is running as	=>	finding-out-what-user-an-application-is-running-as-1ni7zk6
+10.1.4. Red Hat and CentOS caveats	=>	red-hat-and-centos-caveats-ilqxyl
+
+10.1.5. Finding out what user an application is running as	=>	finding-out-what-user-an-application-is-running-as-1ni7zk6
 
 10.2. Copy-on-write memory support (reducing memory consumption of Ruby applications)	=>	reducing-memory-consumption-of-ruby-on-rails-applications-by-33--1o3z66q
 

data/doc/Users guide Nginx.txt

@@ -977,6 +977,8 @@ The default value is 'on'.
 
 NOTE: This option has no effect when you are using <<flying_passenger,Flying Passenger>>. You can disable user switching for Flying Passenger by starting the Flying Passenger daemon as a non-root user.
 
+WARNING: If you're on Red Hat or CentOS, be sure to read <<user_switching_rpm_caveats,the Red Hat and CentOS user switching caveats>>.
+
 [[PassengerUser]]
 ==== passenger_user <username> ====
 If <<user_switching,user switching support>> is enabled, then Phusion Passenger will
@@ -1974,7 +1976,7 @@ This option may only occur once, in the 'http' configuration block. The default
 
 ==== passenger_buffer_size ====
 ==== passenger_buffers ====
-==== passenger_busy_buffer_size ====
+==== passenger_busy_buffers_size ====
 These options have the same effect as ngx_http_proxy_module's similarly named options.
 They can be used to modify the maximum allowed HTTP header size.
 
@@ -2074,7 +2076,10 @@ This option is also useful if the partition that the temporary directory lives o
 
 The instance directory is automatically removed when Nginx shuts down.
 
-This option may be specified once, in the `http` configuration block. The default value is the value of the `$TMPDIR` environment variable. Or, if `$TMPDIR` is not set, `/tmp`.
+This option may be specified once, in the `http` configuration block. The default value is as follows:
+
+ * If you are on Red Hat and CentOS, and installed Passenger through the RPMs provided by Phusion, then the default value is `/var/run/passenger-instreg`.
+ * Otherwise, the default value is the value of the `$TMPDIR` environment variable. Or, if `$TMPDIR` is not set, `/tmp`.
 
 :option: `--instance-registry-dir`
 include::users_guide_snippets/alternative_for_flying_passenger.txt[]

data/doc/Users guide Standalone.html

@@ -1105,7 +1105,9 @@ pre {
 <div class="foo toclevel3"><a href="#install_on_debian_ubuntu">2.3. Installing or upgrading on Debian or Ubuntu</a></div>
 <div class="foo toclevel4"><a href="#install_add_apt_repo">2.3.1. Adding our APT repository</a></div>
 <div class="foo toclevel4"><a href="#_installing_packages">2.3.2. Installing packages</a></div>
-<div class="foo toclevel3"><a href="#_installing_or_upgrading_on_red_hat_fedora_centos_or_scientificlinux">2.4. Installing or upgrading on Red Hat, Fedora, CentOS or ScientificLinux</a></div>
+<div class="foo toclevel3"><a href="#installing_or_upgrading_on_red_hat">2.4. Installing or upgrading on Red Hat or CentOS</a></div>
+<div class="foo toclevel4"><a href="#install_add_yum_repo">2.4.1. Adding our YUM repository</a></div>
+<div class="foo toclevel4"><a href="#_installing_packages_2">2.4.2. Installing packages</a></div>
 <div class="foo toclevel3"><a href="#_installing_or_upgrading_on_heroku">2.5. Installing or upgrading on Heroku</a></div>
 <div class="foo toclevel3"><a href="#rubygems_generic_install">2.6. Generic installation, upgrade and downgrade method: via RubyGems</a></div>
 <div class="foo toclevel3"><a href="#tarball_generic_install">2.7. Generic installation, upgrade and downgrade method: via tarball</a></div>
@@ -1419,12 +1421,14 @@ by Lorenzo Bettini
 http://www.lorenzobettini.it
 http://www.gnu.org/software/src-highlite -->
 <pre><tt><span style="font-style: italic"><span style="color: #9A1900">##### !!!! Only add ONE of these lines, not all of them !!!! #####</span></span>
+<span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 15.04</span></span>
+deb https<span style="color: #990000">:</span>//oss-binaries<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/apt/passenger vivid main
 <span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 14.04</span></span>
 deb https<span style="color: #990000">:</span>//oss-binaries<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/apt/passenger trusty main
 <span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 12.04</span></span>
 deb https<span style="color: #990000">:</span>//oss-binaries<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/apt/passenger precise main
-<span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 10.04</span></span>
-deb https<span style="color: #990000">:</span>//oss-binaries<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/apt/passenger lucid main
+<span style="font-style: italic"><span style="color: #9A1900"># Debian 8</span></span>
+deb https<span style="color: #990000">:</span>//oss-binaries<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/apt/passenger jessie main
 <span style="font-style: italic"><span style="color: #9A1900"># Debian 7</span></span>
 deb https<span style="color: #990000">:</span>//oss-binaries<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/apt/passenger wheezy main
 <span style="font-style: italic"><span style="color: #9A1900"># Debian 6</span></span>
@@ -1443,12 +1447,14 @@ by Lorenzo Bettini
 http://www.lorenzobettini.it
 http://www.gnu.org/software/src-highlite -->
 <pre><tt><span style="font-style: italic"><span style="color: #9A1900">##### !!!! Only add ONE of these lines, not all of them !!!! #####</span></span>
+<span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 15.04</span></span>
+deb https<span style="color: #990000">:</span>//download<span style="color: #990000">:</span>YOUR_DOWNLOAD_TOKEN@www<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/enterprise_apt vivid main
 <span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 14.04</span></span>
 deb https<span style="color: #990000">:</span>//download<span style="color: #990000">:</span>YOUR_DOWNLOAD_TOKEN@www<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/enterprise_apt trusty main
 <span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 12.04</span></span>
 deb https<span style="color: #990000">:</span>//download<span style="color: #990000">:</span>YOUR_DOWNLOAD_TOKEN@www<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/enterprise_apt precise main
-<span style="font-style: italic"><span style="color: #9A1900"># Ubuntu 10.04</span></span>
-deb https<span style="color: #990000">:</span>//download<span style="color: #990000">:</span>YOUR_DOWNLOAD_TOKEN@www<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/enterprise_apt lucid main
+<span style="font-style: italic"><span style="color: #9A1900"># Debian 8</span></span>
+deb https<span style="color: #990000">:</span>//download<span style="color: #990000">:</span>YOUR_DOWNLOAD_TOKEN@www<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/enterprise_apt jessie main
 <span style="font-style: italic"><span style="color: #9A1900"># Debian 7</span></span>
 deb https<span style="color: #990000">:</span>//download<span style="color: #990000">:</span>YOUR_DOWNLOAD_TOKEN@www<span style="color: #990000">.</span>phusionpassenger<span style="color: #990000">.</span>com/enterprise_apt wheezy main
 <span style="font-style: italic"><span style="color: #9A1900"># Debian 6</span></span>
@@ -1549,83 +1555,135 @@ Install the packages:
 </div>
 </div>
 <div class="sect2">
-<a href="javascript:void(0)" class="comments empty" title="Add a comment"><span class="count"></span></a><span class="anchor_helper" id="_installing_or_upgrading_on_red_hat_fedora_centos_or_scientificlinux"></span><h3 data-comment-topic="installing-or-upgrading-on-red-hat-fedora-centos-or-scientificlinux-16cek45" data-anchor="_installing_or_upgrading_on_red_hat_fedora_centos_or_scientificlinux">2.4. Installing or upgrading on Red Hat, Fedora, CentOS or ScientificLinux</h3>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<img src="./images/icons/warning.png" alt="Warning">
-</td>
-<td class="content">The RPMs are currently unmaintained. As such, the repository only contains Phusion Passenger 3.x (the latest version is 4.x), which did not support Node.js, Meteor, multiple Rubies, etc. For more recent versions of Phusion Passenger, you are suggested to install from gem or tarball instead.</td>
-</tr></table>
-</div>
-<div class="paragraph"><p>YUM repositories with RPMs are maintained by <a href="https://github.com/erikogan/passenger">Erik Ogan</a> and <a href="http://stealthymonkeys.com/">Stealthy Monkeys Consulting</a>. Only packages for the open source version of Phusion Passenger are provided. <a href="https://www.phusionpassenger.com/enterprise">Phusion Passenger Enterprise</a> customers should use the <a href="#rubygems_generic_install">generic RubyGems installation method</a> or <a href="#tarball_generic_install">the generic tarball installation method</a> instead.</p></div>
-<div class="paragraph"><p>If you use YUM to install Phusion Passenger then you do not need to run <span class="monospaced">passenger-install-apache2-module</span> or <span class="monospaced">passenger-install-nginx-module</span>. The YUM packages contain all the binaries that you need. You also don’t need to modify any Apache or Nginx configuration to get them to load Phusion Passenger, the packages provide configuration snippets for you as well.</p></div>
-<span class="anchor_helper" id="_step_1_import_the_stealthy_monkeys_consulting_8217_s_gpg_key"></span><h4 class="float" data-anchor="_step_1_import_the_stealthy_monkeys_consulting_8217_s_gpg_key">Step 1: Import the Stealthy Monkeys Consulting’s GPG key</h4>
-<div class="listingblock">
-<div class="content monospaced">
-<pre>rpm --import http://passenger.stealthymonkeys.com/RPM-GPG-KEY-stealthymonkeys.asc</pre>
-</div>
-</div>
-<span class="anchor_helper" id="_step_2_install_the_release_package"></span><h4 class="float" data-anchor="_step_2_install_the_release_package">Step 2: Install the release package</h4>
-<div class="paragraph"><p>Install the passenger-release package from the <a href="http://passenger.stealthymonkeys.com/">main repository</a>.</p></div>
-<div class="paragraph"><p>Fedora Core 17:</p></div>
+<a href="javascript:void(0)" class="comments empty" title="Add a comment"><span class="count"></span></a><span class="anchor_helper" id="installing_or_upgrading_on_red_hat"></span><h3 data-comment-topic="installing-or-upgrading-on-red-hat-fedora-centos-or-scientificlinux-16cek45" data-anchor="installing_or_upgrading_on_red_hat">2.4. Installing or upgrading on Red Hat or CentOS</h3>
+<div class="paragraph"><p>We provide an official Phusion Passenger YUM repository with packages for Red Hat Enterprise Linux and CentOS. These packages are automatically built by our build server after we push out a source release, and thus are always up to date with the official source releases.</p></div>
+<div class="paragraph"><p>If you use these packages to install Phusion Passenger then you do not need to run <span class="monospaced">passenger-install-apache2-module</span> or <span class="monospaced">passenger-install-nginx-module</span>. These packages contain all the binaries that you need. These packages also come with SELinux policy modules so that Passenger works nicely with SELinux.</p></div>
+<div class="paragraph"><p>Packages are available for the x86 and x86_64 architectures. Our policy is to support all Red Hat and CentOS releases that still receive full updates by their vendors. The earliest Red Hat and CentOS version we support is version 5.</p></div>
+<div class="sect3">
+<a href="javascript:void(0)" class="comments empty" title="Add a comment"><span class="count"></span></a><span class="anchor_helper" id="install_add_yum_repo"></span><h4 data-comment-topic="adding-our-yum-repository-7c3y3z" data-anchor="install_add_yum_repo">2.4.1. Adding our YUM repository</h4>
+<div class="olist arabic"><ol class="arabic">
+<li>
+<p>
+Install <a href="https://fedoraproject.org/wiki/EPEL">EPEL</a> and a few other prerequisites.
+</p>
 <div class="listingblock">
 <div class="content monospaced">
-<pre>yum install http://passenger.stealthymonkeys.com/fedora/17/passenger-release.noarch.rpm</pre>
+<pre>sudo yum install epel-release pygpgme curl</pre>
 </div>
 </div>
-<div class="paragraph"><p>Fedora Core 16:</p></div>
+</li>
+<li>
+<p>
+Download the Passenger YUM repository definition.
+</p>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+<strong>Open source</strong>
+</dt>
+<dd>
 <div class="listingblock">
 <div class="content monospaced">
-<pre>yum install http://passenger.stealthymonkeys.com/fedora/16/passenger-release.noarch.rpm</pre>
+<pre>sudo curl --fail -sSLo /etc/yum.repos.d/passenger.repo https://oss-binaries.phusionpassenger.com/yum/definitions/el-passenger.repo</pre>
 </div>
 </div>
-<div class="paragraph"><p>Fedora Core 15:</p></div>
+</dd>
+<dt class="hdlist1">
+<strong>Enterprise</strong>
+</dt>
+<dd>
 <div class="listingblock">
 <div class="content monospaced">
-<pre>yum install http://passenger.stealthymonkeys.com/fedora/15/passenger-release.noarch.rpm</pre>
+<pre>unset HISTFILE
+sudo curl --fail -sSLo -u download:YOUR_DOWNLOAD_TOKEN /etc/yum.repos.d/passenger.repo https://www.phusionpassenger.com/enterprise_yum/el-passenger-enterprise.repo</pre>
 </div>
 </div>
-<div class="paragraph"><p>Fedora Core 14:</p></div>
+<div class="paragraph"><p>The <span class="monospaced">unset HISTFILE</span> command ensures that your download token isn’t saved to the Bash history file.</p></div>
+<div class="paragraph"><p>You can find the correct value for <em>YOUR_DOWNLOAD_TOKEN</em> in the <a href="https://www.phusionpassenger.com/orders">Customer Area</a>.</p></div>
+</dd>
+</dl></div>
+</li>
+<li>
+<p>
+Secure <span class="monospaced">passenger.repo</span>:
+</p>
 <div class="listingblock">
 <div class="content monospaced">
-<pre>yum install http://passenger.stealthymonkeys.com/fedora/14/passenger-release.noarch.rpm</pre>
+<pre>sudo chown root: /etc/yum.repos.d/passenger.repo
+sudo chmod 600 /etc/yum.repos.d/passenger.repo</pre>
 </div>
 </div>
-<div class="paragraph"><p>RHEL 6 / CentOS 6 / ScientificLinux 6: (Note: these packages depend on <a href="http://fedoraproject.org/wiki/EPEL">EPEL</a>.)</p></div>
-<div class="listingblock">
-<div class="content monospaced">
-<pre>yum install http://passenger.stealthymonkeys.com/rhel/6/passenger-release.noarch.rpm</pre>
-</div>
+</li>
+</ol></div>
 </div>
-<div class="paragraph"><p>RHEL 5 / CentOS 5 / ScientificLinux 5: (Note: these packages depend on <a href="http://fedoraproject.org/wiki/EPEL">EPEL</a>.)</p></div>
-<div class="listingblock">
-<div class="content monospaced">
-<pre>rpm -Uvh http://passenger.stealthymonkeys.com/rhel/5/passenger-release.noarch.rpm</pre>
-</div>
+<div class="sect3">
+<a href="javascript:void(0)" class="comments empty" title="Add a comment"><span class="count"></span></a><span class="anchor_helper" id="_installing_packages_2"></span><h4 data-comment-topic="installing-packages-1i5z60y" data-anchor="_installing_packages_2">2.4.2. Installing packages</h4>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<img src="./images/icons/note.png" alt="Note">
+</td>
+<td class="content">
+<div class="title">Notes about SELinux on Red Hat 6 and CentOS 6</div>
+<div class="paragraph"><p>If you are on Red Hat 6 or CentOS 6, and you are also using SELinux in enforcing mode, then Passenger requires kernel &gt;= 2.6.39.</p></div>
+<div class="paragraph"><p>If you want to install Passenger on Red Hat 6 or CentOS 6, without upgrading your kernel, then you must <strong>disable</strong> SELinux completely. Edit <span class="monospaced">/etc/selinux/config</span>, set <span class="monospaced">SELINUX=disabled</span> and reboot. Note that merely setting SELinux to permissive mode is not enough.</p></div>
+<div class="paragraph"><p>This issue does not apply to Red Hat &gt;= 7 and CentOS &gt;= 7, because these OS versions supply recent enough kernel versions.</p></div>
+</td>
+</tr></table>
 </div>
-<span class="anchor_helper" id="_step_3_install_the_right_phusion_passenger_package"></span><h4 class="float" data-anchor="_step_3_install_the_right_phusion_passenger_package">Step 3: Install the right Phusion Passenger package</h4>
-<div class="paragraph"><p>From there you can use <a href="http://prefetch.net/articles/yum.html">YUM</a> to install packages. For example, try one of these:</p></div>
-<div class="paragraph"><p>Phusion Passenger for Apache:</p></div>
+<div class="paragraph"><p>You can install the Passenger packages as follows.</p></div>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+<strong>Open source</strong>
+</dt>
+<dd>
+<div class="olist arabic"><ol class="arabic">
+<li>
+<p>
+<a href="#install_add_yum_repo">Add our YUM repository.</a>
+</p>
+</li>
+<li>
+<p>
+Install the package:
+</p>
 <div class="listingblock">
 <div class="content monospaced">
-<pre>yum install mod_passenger</pre>
+<pre>sudo yum install passenger</pre>
 </div>
 </div>
-<div class="paragraph"><p>Phusion Passenger for Nginx:</p></div>
+</li>
+</ol></div>
+</dd>
+<dt class="hdlist1">
+<strong>Enterprise</strong>
+</dt>
+<dd>
+<div class="olist arabic"><ol class="arabic">
+<li>
+<p>
+Download your license key from the <a href="https://www.phusionpassenger.com/orders">Customer Area</a> and save it as <span class="monospaced">/etc/passenger-enterprise-license</span>.
+</p>
+</li>
+<li>
+<p>
+<a href="#install_add_yum_repo">Add our YUM repository.</a>
+</p>
+</li>
+<li>
+<p>
+Install the packages:
+</p>
 <div class="listingblock">
 <div class="content monospaced">
-<pre>yum install nginx-passenger</pre>
+<pre>sudo yum install passenger-enterprise</pre>
 </div>
 </div>
-<div class="paragraph"><p>Phusion Passenger Standalone:</p></div>
-<div class="listingblock">
-<div class="content monospaced">
-<pre>yum install passenger-standalone</pre>
-</div>
+</li>
+</ol></div>
+</dd>
+</dl></div>
+<div class="paragraph"><p>You can now proceed with a chapter for Deploying your (specific type of) application.</p></div>
 </div>
-<span class="anchor_helper" id="_building_your_own_packages"></span><h4 class="float" data-anchor="_building_your_own_packages">Building your own packages</h4>
-<div class="paragraph"><p>There are instructions for building your own packages and Yum repositories in the <a href="https://github.com/phusion/passenger/tree/master/rpm#readme">rpm directory ReadMe</a> within the <a href="https://github.com/phusion/passenger">GitHub repository</a>.</p></div>
 </div>
 <div class="sect2">
 <a href="javascript:void(0)" class="comments empty" title="Add a comment"><span class="count"></span></a><span class="anchor_helper" id="_installing_or_upgrading_on_heroku"></span><h3 data-comment-topic="installing-or-upgrading-on-heroku-rspclc" data-anchor="_installing_or_upgrading_on_heroku">2.5. Installing or upgrading on Heroku</h3>

data/doc/Users guide Standalone.idmap.txt

@@ -30,7 +30,11 @@
 
 2.3.2. Installing packages	=>	installing-packages-k1zxbg
 
-2.4. Installing or upgrading on Red Hat, Fedora, CentOS or ScientificLinux	=>	installing-or-upgrading-on-red-hat-fedora-centos-or-scientificlinux-16cek45
+2.4. Installing or upgrading on Red Hat or CentOS	=>	installing-or-upgrading-on-red-hat-fedora-centos-or-scientificlinux-16cek45
+
+2.4.1. Adding our YUM repository	=>	adding-our-yum-repository-7c3y3z
+
+2.4.2. Installing packages	=>	installing-packages-1i5z60y
 
 2.5. Installing or upgrading on Heroku	=>	installing-or-upgrading-on-heroku-rspclc
 

data/doc/users_guide_snippets/installation.txt

@@ -85,12 +85,14 @@ sudo apt-get install apt-transport-https ca-certificates
 [source,sh]
 --------------------------------------------------------------
 ##### !!!! Only add ONE of these lines, not all of them !!!! #####
+# Ubuntu 15.04
+deb https://oss-binaries.phusionpassenger.com/apt/passenger vivid main
 # Ubuntu 14.04
 deb https://oss-binaries.phusionpassenger.com/apt/passenger trusty main
 # Ubuntu 12.04
 deb https://oss-binaries.phusionpassenger.com/apt/passenger precise main
-# Ubuntu 10.04
-deb https://oss-binaries.phusionpassenger.com/apt/passenger lucid main
+# Debian 8
+deb https://oss-binaries.phusionpassenger.com/apt/passenger jessie main
 # Debian 7
 deb https://oss-binaries.phusionpassenger.com/apt/passenger wheezy main
 # Debian 6
@@ -102,12 +104,14 @@ deb https://oss-binaries.phusionpassenger.com/apt/passenger squeeze main
 [source,sh]
 --------------------------------------------------------------
 ##### !!!! Only add ONE of these lines, not all of them !!!! #####
+# Ubuntu 15.04
+deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt vivid main
 # Ubuntu 14.04
 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt trusty main
 # Ubuntu 12.04
 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt precise main
-# Ubuntu 10.04
-deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt lucid main
+# Debian 8
+deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt jessie main
 # Debian 7
 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt wheezy main
 # Debian 6
@@ -256,83 +260,143 @@ http {
 endif::nginx[]
 
 
-=== Installing or upgrading on Red Hat, Fedora, CentOS or ScientificLinux
+[[installing_or_upgrading_on_red_hat]]
+=== Installing or upgrading on Red Hat or CentOS
 
-WARNING: The RPMs are currently unmaintained. As such, the repository only contains Phusion Passenger 3.x (the latest version is 4.x), which did not support Node.js, Meteor, multiple Rubies, etc. For more recent versions of Phusion Passenger, you are suggested to install from gem or tarball instead.
+We provide an official Phusion Passenger YUM repository with packages for Red Hat Enterprise Linux and CentOS. These packages are automatically built by our build server after we push out a source release, and thus are always up to date with the official source releases.
 
-YUM repositories with RPMs are maintained by link:https://github.com/erikogan/passenger[Erik Ogan] and link:http://stealthymonkeys.com/[Stealthy Monkeys Consulting]. Only packages for the open source version of Phusion Passenger are provided. link:https://www.phusionpassenger.com/enterprise[Phusion Passenger Enterprise] customers should use the <<rubygems_generic_install,generic RubyGems installation method>> or <<tarball_generic_install,the generic tarball installation method>> instead.
+If you use these packages to install Phusion Passenger then you do not need to run `passenger-install-apache2-module` or `passenger-install-nginx-module`. These packages contain all the binaries that you need. These packages also come with SELinux policy modules so that Passenger works nicely with SELinux.
 
-If you use YUM to install Phusion Passenger then you do not need to run `passenger-install-apache2-module` or `passenger-install-nginx-module`. The YUM packages contain all the binaries that you need. You also don't need to modify any Apache or Nginx configuration to get them to load Phusion Passenger, the packages provide configuration snippets for you as well.
+Packages are available for the x86 and x86_64 architectures. Our policy is to support all Red Hat and CentOS releases that still receive full updates by their vendors. The earliest Red Hat and CentOS version we support is version 5.
 
-[float]
-==== Step 1: Import the Stealthy Monkeys Consulting's GPG key
-
----------------------------------------------
-rpm --import http://passenger.stealthymonkeys.com/RPM-GPG-KEY-stealthymonkeys.asc
----------------------------------------------
+[[install_add_yum_repo]]
+==== Adding our YUM repository
 
-[float]
-==== Step 2: Install the release package
-
-Install the passenger-release package from the link:http://passenger.stealthymonkeys.com/[main repository].
-
-Fedora Core 17:
----------------------------------------------
-yum install http://passenger.stealthymonkeys.com/fedora/17/passenger-release.noarch.rpm
----------------------------------------------
-
-Fedora Core 16:
----------------------------------------------
-yum install http://passenger.stealthymonkeys.com/fedora/16/passenger-release.noarch.rpm
----------------------------------------------
-
-Fedora Core 15:
----------------------------------------------
-yum install http://passenger.stealthymonkeys.com/fedora/15/passenger-release.noarch.rpm
----------------------------------------------
-
-Fedora Core 14:
----------------------------------------------
-yum install http://passenger.stealthymonkeys.com/fedora/14/passenger-release.noarch.rpm
----------------------------------------------
-
-RHEL 6 / CentOS 6 / ScientificLinux 6: (Note: these packages depend on link:http://fedoraproject.org/wiki/EPEL[EPEL].)
----------------------------------------------
-yum install http://passenger.stealthymonkeys.com/rhel/6/passenger-release.noarch.rpm
----------------------------------------------
-
-RHEL 5 / CentOS 5 / ScientificLinux 5: (Note: these packages depend on link:http://fedoraproject.org/wiki/EPEL[EPEL].)
----------------------------------------------
-rpm -Uvh http://passenger.stealthymonkeys.com/rhel/5/passenger-release.noarch.rpm
----------------------------------------------
+1. Install link:https://fedoraproject.org/wiki/EPEL[EPEL] and a few other prerequisites.
++
+--------------------------------------------------------------
+sudo yum install epel-release pygpgme curl
+--------------------------------------------------------------
 
-[float]
-==== Step 3: Install the right Phusion Passenger package
+2. Download the Passenger YUM repository definition.
++
+**Open source**::
++
+--------------------------------------------------------------
+sudo curl --fail -sSLo /etc/yum.repos.d/passenger.repo https://oss-binaries.phusionpassenger.com/yum/definitions/el-passenger.repo
+--------------------------------------------------------------
++
+**Enterprise**::
++
+--------------------------------------------------------------
+unset HISTFILE
+sudo curl --fail -sSLo -u download:YOUR_DOWNLOAD_TOKEN /etc/yum.repos.d/passenger.repo https://www.phusionpassenger.com/enterprise_yum/el-passenger-enterprise.repo
+--------------------------------------------------------------
++
+The `unset HISTFILE` command ensures that your download token isn't saved to the Bash history file.
++
+You can find the correct value for 'YOUR_DOWNLOAD_TOKEN' in the link:https://www.phusionpassenger.com/orders[Customer Area].
 
-From there you can use link:http://prefetch.net/articles/yum.html[YUM] to install packages. For example, try one of these:
+3. Secure `passenger.repo`:
++
+--------------------------------------------------------------
+sudo chown root: /etc/yum.repos.d/passenger.repo
+sudo chmod 600 /etc/yum.repos.d/passenger.repo
+--------------------------------------------------------------
 
-Phusion Passenger for Apache:
+==== Installing packages
 
----------------------------------------------
-yum install mod_passenger
----------------------------------------------
+.Notes about SELinux on Red Hat 6 and CentOS 6
+[NOTE]
+====================================================
+If you are on Red Hat 6 or CentOS 6, and you are also using SELinux in enforcing mode, then Passenger requires kernel >= 2.6.39.
 
-Phusion Passenger for Nginx:
+If you want to install Passenger on Red Hat 6 or CentOS 6, without upgrading your kernel, then you must *disable* SELinux completely. Edit `/etc/selinux/config`, set `SELINUX=disabled` and reboot. Note that merely setting SELinux to permissive mode is not enough.
 
----------------------------------------------
-yum install nginx-passenger
----------------------------------------------
+This issue does not apply to Red Hat >= 7 and CentOS >= 7, because these OS versions supply recent enough kernel versions.
+====================================================
 
-Phusion Passenger Standalone:
+You can install the Passenger packages as follows.
 
----------------------------------------------
-yum install passenger-standalone
----------------------------------------------
+**Open source**::
++
+1. <<install_add_yum_repo,Add our YUM repository.>>
+ifdef::nginx[]
+2. Install the packages:
++
+--------------------------------------------------------------
+sudo yum install nginx passenger
+--------------------------------------------------------------
++
+3. Edit `/etc/nginx/conf.d/passenger.conf` and uncomment `passenger_root`, `passenger_ruby` and `passenger_instance_registry_dir`.
++
+Especially <<PassengerRoot,passenger_root>> is important: Phusion Passenger won't work without it!
++
+4. Restart Nginx:
++
+--------------------------------------------------------------
+sudo service nginx restart
+--------------------------------------------------------------
+endif::[]
+ifdef::apache[]
+2. Install the package:
++
+--------------------------------------------------------------
+sudo yum install mod_passenger
+--------------------------------------------------------------
++
+3. Stop/start Apache (reload or restart is not enough when upgrading):
++
+--------------------------------------------------------------
+sudo service httpd stop; sudo service httpd start
+--------------------------------------------------------------
+endif::[]
+ifdef::standalone[]
+2. Install the package:
++
+--------------------------------------------------------------
+sudo yum install passenger
+--------------------------------------------------------------
+endif::[]
 
-[float]
-==== Building your own packages
+**Enterprise**::
++
+1. Download your license key from the link:https://www.phusionpassenger.com/orders[Customer Area] and save it as `/etc/passenger-enterprise-license`.
+2. <<install_add_yum_repo,Add our YUM repository.>>
+3. Install the packages:
++
+ifdef::nginx[]
+--------------------------------------------------------------
+sudo yum install nginx passenger-enterprise
+--------------------------------------------------------------
+4. Edit `/etc/nginx/conf.d/passenger.conf` and uncomment `passenger_root`, `passenger_ruby` and `passenger_instance_registry_dir`.
++
+Especially <<PassengerRoot,passenger_root>> is important: Phusion Passenger won't work without it!
++
+5. Restart Nginx:
++
+--------------------------------------------------------------
+sudo service nginx restart
+--------------------------------------------------------------
+endif::[]
+ifdef::apache[]
+--------------------------------------------------------------
+sudo yum install mod_passenger_enterprise
+--------------------------------------------------------------
++
+4. Stop/start Apache (reload or restart is not enough when upgrading):
++
+--------------------------------------------------------------
+sudo service httpd stop; sudo service httpd start
+--------------------------------------------------------------
+endif::[]
+ifdef::standalone[]
+--------------------------------------------------------------
+sudo yum install passenger-enterprise
+--------------------------------------------------------------
+endif::[]
 
-There are instructions for building your own packages and Yum repositories in the link:https://github.com/phusion/passenger/tree/master/rpm#readme[rpm directory ReadMe] within the link:https://github.com/phusion/passenger[GitHub repository].
+You can now proceed with a chapter for Deploying your (specific type of) application. 
 
 
 === Installing or upgrading on Heroku