X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/cfcfa1c48d95a07bb961baeef8d7658ddecce41e..f7e00eb55fbcc41b8cd1f416344ad4abdb020bc0:/doc/install/install-workbench-app.html.textile.liquid diff --git a/doc/install/install-workbench-app.html.textile.liquid b/doc/install/install-workbench-app.html.textile.liquid index 1a65f2de38..5fc41114a6 100644 --- a/doc/install/install-workbench-app.html.textile.liquid +++ b/doc/install/install-workbench-app.html.textile.liquid @@ -6,38 +6,30 @@ title: Install Workbench h2. Install prerequisites -The Arvados package repository includes Workbench server package that can help automate much of the deployment. It requires: +The Arvados package repository includes Workbench server package that can help automate much of the deployment. -* "Ruby 2.1 and bundler":install-manual-prerequisites-ruby.html -* The Arvados Python SDK -* Graphviz -* Build tools to build gem dependencies -* Nginx +h3(#install_ruby_and_bundler). Install Ruby and Bundler -Workbench doesn't need its own database, so it does not need to have PostgreSQL installed. +{% include 'install_ruby_and_bundler' %} + +h2(#install_workbench). Install Workbench and dependencies -On older distributions, you may need to use a backports repository to satisfy these requirements. For example, on older Red Hat-based systems, consider using the "nginx16":https://www.softwarecollections.org/en/scls/rhscl/nginx16/ Software Collection. +Workbench doesn't need its own database, so it does not need to have PostgreSQL installed. On a Debian-based system, install the following packages: -
~$ sudo apt-get install bison build-essential graphviz git nginx python-arvados-python-client arvados-workbench
+
~$ sudo apt-get install bison build-essential graphviz git python-arvados-python-client arvados-workbench
 
On a Red Hat-based system, install the following packages: -
~$ sudo yum install bison make automake gcc gcc-c++ graphviz git nginx python27-python-arvados-python-client arvados-workbench
+
~$ sudo yum install bison make automake gcc gcc-c++ graphviz git python27-python-arvados-python-client arvados-workbench
 
-{% include 'notebox_begin' %} - -If you intend to use specific versions of these packages from Software Collections, you may have to adapt some of the package names to match; e.g., @nginx16@. - -{% include 'notebox_end' %} - {% include 'note_python27_sc' %} h2. Set up configuration files @@ -120,9 +112,7 @@ For best performance, we recommend you use Nginx as your Web server front-end, w
    -
  1. Install Nginx via your distribution or a backports repository.
  2. - -
  3. Install Phusion Passenger for Nginx.
  4. +
  5. Install Nginx and Phusion Passenger.
  6. Edit the http section of your Nginx configuration to run the Passenger server, and act as a front-end for it. You might add a block like the following, adding SSL and logging parameters to taste:

    @@ -149,16 +139,19 @@ server { server_name workbench.uuid-prefix.your.domain; ssl on; + ssl_certificate /YOUR/PATH/TO/cert.pem; + ssl_certificate_key /YOUR/PATH/TO/cert.key; index index.html index.htm index.php; location / { proxy_pass http://workbench; proxy_redirect off; + proxy_connect_timeout 90s; + proxy_read_timeout 300s; proxy_set_header X-Forwarded-Proto https; proxy_set_header Host $http_host; - proxy_set_header X-External-Client $external_client; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }