passenger 5.1.10 → 5.1.11

data/doc/users_guide_snippets/rackup_specifications.txt

@@ -1 +0,0 @@
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/config_ru.html

data/doc/users_guide_snippets/rvm_helper_tool.txt

@@ -1,44 +0,0 @@
-.RVM helper tool
-
-Phusion Passenger provides the `passenger-config --ruby-command` tool for figuring out the correct command for invoking a specific Ruby interpreter. This is especially useful for RVM users. Suppose that you have both Ruby 1.8.7 and Ruby 1.9.3 installed through RVM, and you want to know the correct commands for each Ruby interpreter.
-
-For this purpose we'll want to invoke `passenger-config` using its full path, because each time you `rvm use` a different Ruby interpreter, RVM changes `$PATH`. If you did not install Phusion Passenger through the generic tarball installation method, then here's how you can figure out where `passenger-config` is:
-
-------------------------------
-$ which passenger-config
-/opt/passenger/bin/passenger-config
-------------------------------
-
-Now, switch to all the RVM Ruby interpreters you want to use. In each interpreter, invoke `passenger-config --ruby-command`. For Ruby 1.8.7:
-
-------------------------------
-$ rvm use 1.8.7
-$ /opt/passenger/bin/passenger-config --ruby-command
-passenger-config was invoked through the following Ruby interpreter:
-  Command: /usr/local/rvm/wrappers/ruby-1.8.7-p358/ruby
-  Version: ruby 1.8.7 (2012-02-08 patchlevel 358) [universal-darwin12.0]
-  To use in Apache: PassengerRuby /usr/local/rvm/wrappers/ruby-1.8.7-p358/ruby
-  To use in Nginx : passenger_ruby /usr/local/rvm/wrappers/ruby-1.8.7-p358/ruby
-  To use with Standalone: /usr/local/rvm/wrappers/ruby-1.8.7-p358/ruby /opt/passenger/bin/passenger start
-
-
-## Notes for RVM users
-Do you want to know which command to use for a different Ruby interpreter? 'rvm use' that Ruby interpreter, then re-run 'passenger-config --ruby-command'.
-------------------------------
-
-Then, for Ruby 1.9.3:
-
-------------------------------
-$ rvm use 1.9.3
-$ /opt/passenger/bin/passenger-config --ruby-command
-passenger-config was invoked through the following Ruby interpreter:
-  Command: /usr/local/rvm/wrappers/ruby-1.9.3-p392/ruby
-  Version: ruby 1.9.3p392 (2013-02-22 revision 39386) [x86_64-darwin12.2.1]
-  To use in Apache: PassengerRuby /usr/local/rvm/wrappers/ruby-1.9.3-p392/ruby
-  To use in Nginx : passenger_ruby /usr/local/rvm/wrappers/ruby-1.9.3-p392/ruby
-  To use with Standalone: /usr/local/rvm/wrappers/ruby-1.9.3-p392/ruby /opt/passenger/bin/passenger start
-
-
-## Notes for RVM users
-Do you want to know which command to use for a different Ruby interpreter? 'rvm use' that Ruby interpreter, then re-run 'passenger-config --ruby-command'.
-------------------------------

data/doc/users_guide_snippets/since_version.txt

@@ -1 +0,0 @@
-**Introduced in version {version}.**

data/doc/users_guide_snippets/support_information.txt

@@ -1,8 +0,0 @@
-=== Supported operating systems and languages ===
-
-This documentation has moved. https://www.phusionpassenger.com/library/install/supported_operating_systems_and_languages.html
-
-[[where_to_get_support]]
-=== Where to get support ===
-
-include::where_to_get_support.txt[]

data/doc/users_guide_snippets/tips.txt

@@ -1,302 +0,0 @@
-[[user_switching]]
-=== User Switching (security feature) ===
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/user_sandboxing.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/user_sandboxing.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/standalone/user_sandboxing.html
-endif::[]
-
-==== Requirements
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/user_sandboxing.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/user_sandboxing.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/standalone/user_sandboxing.html
-endif::[]
-
-==== Effects
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/user_sandboxing.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/user_sandboxing.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/standalone/user_sandboxing.html
-endif::[]
-
-==== Caveats & troubleshooting
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/user_sandboxing.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/user_sandboxing.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/standalone/user_sandboxing.html
-endif::[]
-
-[[user_switching_rpm_caveats]]
-==== Red Hat and CentOS caveats
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/user_sandboxing.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/user_sandboxing.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/standalone/user_sandboxing.html
-endif::[]
-
-[[finding_out_app_user]]
-==== Finding out what user an application is running as
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/user_sandboxing.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/user_sandboxing.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/standalone/user_sandboxing.html
-endif::[]
-
-
-[[reducing_memory_usage]]
-=== Copy-on-write memory support (reducing memory consumption of Ruby applications) ===
-
-Phusion Passenger automatically leverages operating system virtual memory copy-on-write features in order to reduce the memory usage of Ruby applications. Experience has shown that this reduces memory usage by 33% on average. For this mechanism to work, a Ruby interpreter with a copy-on-write friendly garbage collector is required. The following Ruby interpreters have copy-on-write friendly garbage collectors:
-
-- MRI Ruby >= 2.0. Versions prior to 2.0 did not have a copy-on-write friendly garbage collector.
-- http://www.rubyenterpriseedition.com/[Ruby Enterprise Edition], which was Phusion's branch of MRI Ruby 1.8 with a copy-on-write friendly garbage collector and other enhancement. It has reached End-Of-Life as of 2012, but remains available for legacy systems.
-
-[[tuning_sse_websockets]]
-=== Tuning for Server Sent Events and WebSockets ===
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/config/apache/tuning_sse_and_websockets.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/config/nginx/tuning_sse_and_websockets.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/config/standalone/tuning_sse_and_websockets.html
-endif::[]
-
-[[bundler_support]]
-=== Bundler support ===
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/ruby/bundler.html
-
-[[add_passenger_to_gemfile]]
-==== Does Phusion Passenger itself need to be added to the Gemfile?
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/ruby/bundler.html#does-passenger-itself-need-to-be-added-to-the-gemfile
-
-=== Installing multiple Ruby on Rails versions ===
-
-Each Ruby on Rails applications that are going to be deployed may require a
-specific Ruby on Rails version. You can install a specific version with
-this command:
------------------------------
-gem install rails -v X.X.X
------------------------------
-where 'X.X.X' is the version number of Ruby on Rails.
-
-All of these versions will exist in parallel, and will not conflict with each
-other. Phusion Passenger will automatically make use of the correct version.
-
-=== Making the application restart after each request ===
-
-In some situations it might be desirable to restart the web application after
-each request, for example when developing a non-Rails application that doesn't
-support code reloading, or when developing a web framework.
-
-To achieve this, simply create the file 'tmp/always_restart.txt' in your
-application's root folder. Unlike 'restart.txt', Phusion Passenger does not
-check for this file's timestamp: Phusion Passenger will always restart the
-application, as long as 'always_restart.txt' exists.
-
-NOTE: If you're just developing a Rails application then you probably don't need
-this feature. If you set
-ifdef::apache['RailsEnv development']
-ifdef::nginx['rails_env development']
-in your web server configuration,
-then Rails will automatically reload your application code after each request.
-'always_restart.txt' is mostly useful when you're using a web framework that
-doesn't support code reloading by itself, of when you're working on a web framework
-yourself.
-
-[[sub_uri_deployment_uri_fix]]
-=== How to fix broken images/CSS/JavaScript URIs in sub-URI deployments
-
-Some people experience broken images and other broken static assets when they
-deploy their application to a sub-URI (i.e. 'http://mysite.com/railsapp/').
-The reason for this usually is that you used a
-static URI for your image in the views. This means your 'img' source probably refers
-to something like '/images/foo.jpg'. The leading slash means that it's an absolute URI:
-you're telling the browser to always load 'http://mysite.com/images/foo.jpg' no
-matter what. The problem is that the image is actually at
-'http://mysite.com/railsapp/images/foo.jpg'. There are two ways to fix this.
-
-The first way (not recommended) is to change your view templates to refer to
-'images/foo.jpg'. This is a relative URI: note the lack of a leading slash). What
-this does is making the path relative to the current URI. The problem is that if you
-use restful URIs, then your images will probably break again when you add a level to
-the URI.
-For example, when you're at 'http://mysite.com/railsapp' the browser will look for
-'http://mysite.com/railsapp/images/foo.jpg'. But when you're at
-'http://mysite.com/railsapp/controller'. the browser will look for
-'http://mysite.com/railsapp/controller/images/foo.jpg'.
-So relative URIs usually don't work well with layout templates.
-
-The second and highly recommended way is to always use Rails helper methods to
-output tags for static assets. These helper methods automatically take care
-of prepending the base URI that you've deployed the application to. For images
-there is `image_tag`, for JavaScript there is `javascript_include_tag` and for
-CSS there is `stylesheet_link_tag`. In the above example you would simply remove
-the '<img>' HTML tag and replace it with inline Ruby like this:
-
----------------------------------------
-<%= image_tag("foo.jpg") %>
----------------------------------------
-
-This will generate the proper image tag to `$RAILS_ROOT/public/images/foo.jpg`
-so that your images will always work no matter what sub-URI you've deployed to.
-
-These helper methods are more valuable than you may think. For example they also
-append a timestamp to the URI to better facilitate HTTP caching. For more information,
-please refer to
-link:http://api.rubyonrails.org/classes/ActionView/Helpers/AssetTagHelper.html[the Rails API docs].
-
-=== Out-of-Band Work and Out-of-Band Garbage Collection
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/ruby/out_of_band_work.html
-
-=== Hooks
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/hooks.html
-
-==== Example
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/hooks.html#example
-
-==== Environment
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/hooks.html#environment
-
-==== Blocking and concurrency
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/hooks.html#blocking-and-concurrency
-
-==== Error handling
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/hooks.html#error-handling
-
-==== Compatibility
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/hooks.html#compatibility
-
-==== Available hooks
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/indepth/hooks.html#available-hooks
-
-[[flying_passenger]]
-=== Flying Passenger
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/flying_passenger.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-
-==== Requirements
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/flying_passenger.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-
-==== Basic usage
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/flying_passenger.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-
-[[configuring_flying_passenger]]
-==== Configuring Flying Passenger
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/flying_passenger.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-
-==== Managing the Flying Passenger daemon
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/flying_passenger.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-
-[[using_flying_passenger_with_mri_18_or_jruby]]
-==== Using Flying Passenger with MRI 1.8 or JRuby
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/flying_passenger.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-
-[[flying_passenger_caveats]]
-==== Caveats and limitations
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/apache/flying_passenger.html
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/deploy/nginx/flying_passenger.html
-endif::[]

data/doc/users_guide_snippets/troubleshooting/default.txt

@@ -1,48 +0,0 @@
-=== Generic troubleshooting tips
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/apache/troubleshooting/
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/nginx/troubleshooting/
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/standalone/troubleshooting/
-endif::[]
-
-
-ifndef::standalone[]
-=== Why does the first request take a long time?
-
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/nginx/troubleshooting/?a=why-does-the-first-request-take-a-long-time
-endif::[]
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/apache/troubleshooting/?a=why-does-the-first-request-take-a-long-time
-endif::[]
-
-
-ifdef::nginx[]
-=== Upon accessing the web app, Nginx reports a "Permission denied" error
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/nginx/troubleshooting/?a=upon-accessing-the-web-app-nginx-reports-a-permission-denied-error
-endif::[]
-
-
-ifdef::standalone[]
-=== Upon uploading a file, Phusion Passenger reports "client_body_temp/00000000xx failed (2: No such file or directory)"
-
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/standalone/troubleshooting/?a=upon-uploading-a-file-passenger-reports-client_body_temp-00000000xx-failed-2-no-such-file-or-directory
-endif::[]
-
-=== I get "command not found" when running a Phusion Passenger command through sudo
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/apache/troubleshooting/?a=i-get-command-not-found-when-running-a-passenger-command-through-sudo
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/nginx/troubleshooting/?a=i-get-command-not-found-when-running-a-passenger-command-through-sudo
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/standalone/troubleshooting/?a=i-get-command-not-found-when-running-a-passenger-command-through-sudo
-endif::[]

data/doc/users_guide_snippets/troubleshooting/rails.txt

@@ -1,59 +0,0 @@
-=== Ruby on Rails-specific troubleshooting
-
-==== The "About your application's environment" link does not work
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/apache/troubleshooting/ruby/#the-about-your-application-s-environment-link-does-not-work
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/nginx/troubleshooting/ruby/#the-about-your-application-s-environment-link-does-not-work
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/standalone/troubleshooting/ruby/#the-about-your-application-s-environment-link-does-not-work
-endif::[]
-
-
-
-==== The Rails application reports that it's unable to start because of a permission error
-
-ifdef::apache[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/apache/troubleshooting/ruby/#the-rails-application-reports-that-it-s-unable-to-start-because-of-a-permission-error
-endif::[]
-ifdef::nginx[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/nginx/troubleshooting/ruby/#the-rails-application-reports-that-it-s-unable-to-start-because-of-a-permission-error
-endif::[]
-ifdef::standalone[]
-This documentation has moved. Please visit https://www.phusionpassenger.com/library/admin/standalone/troubleshooting/ruby/#the-rails-application-reports-that-it-s-unable-to-start-because-of-a-permission-error
-endif::[]
-
-
-==== The Rails application's log file is not being written to
-
-There are a couple things that you should be aware of:
-
-- By default, Phusion Passenger runs Rails applications in 'production' mode,
-  so please be sure to check `production.log` instead of `development.log`.
-+
-See
-ifdef::apache[]
-<<RailsEnv,RailsEnv>>
-endif::[]
-ifdef::nginx[]
-<<RailsEnv,rails_env>>
-endif::[]
-for configuration.
-- By default, Phusion Passenger runs Rails applications as the owner of `config.ru`.
-  So the log file can only be written to if that user has write permission to the
-  log file. Please `chmod` or `chown` your log file accordingly.
-+
-See <<User_switching,User switching (security)>> for details.
-
-If you're using a RedHat-derived Linux distribution (such as Fedora or CentOS)
-then it is link:http://code.google.com/p/phusion-passenger/issues/detail?id=4[possible
-that SELinux is interfering]. RedHat's SELinux policy only allows Apache to read/write
-directories that have the 'httpd_sys_content_t' security context. Please run the
-following command to give your Rails application folder that context:
-
------------------------------------------------------------
-chcon -R -h -t httpd_sys_content_t /path/to/your/rails/app
------------------------------------------------------------