src/docs/user/cluster/cluster_webservers.diviner

   1 @title Cluster: Web Servers
   2 @group cluster
   3
   4 Configuring Phabricator to use multiple web servers.
   5
   6 Overview
   7 ========
   8
   9 You can run Phabricator on multiple web servers. The advantages of doing this
  10 are:
  11
  12   - you can completely survive the loss of multiple web hosts; and
  13   - performance and capacity may improve.
  14
  15 This configuration is simple, but you must configure repositories first. For
  16 details, see @{article:Cluster: Repositories}.
  17
  18
  19 Adding Web Hosts
  20 ================
  21
  22 After configuring repositories in cluster mode, you can add more web hosts
  23 at any time.
  24
  25 First, deploy the Phabricator software and configuration to a host, then
  26 register the host as a cluster device if it is not already registered (for
  27 help, see @{article:Cluster: Devices}.)
  28
  29 Once the host is registered, start the web server, and then add the host to the
  30 load balancer pool.
  31
  32 Phabricator web servers are stateless, so you can pull them in and out of
  33 production freely.
  34
  35 You may also want to run SSH services on these hosts, since the service is very
  36 similar to HTTP, also stateless, and it may be simpler to load balance the
  37 services together. For details, see @{article:Cluster: SSH Servers}.
  38
  39
  40 Next Steps
  41 ==========
  42
  43 Continue by:
  44
  45   - returning to @{article:Clustering Introduction}.