Merge branch '10401-run-upload-dir' refs #10401

[arvados.git] / doc / install / install-ws.html.textile.liquid

diff --git a/doc/install/install-ws.html.textile.liquid b/doc/install/install-ws.html.textile.liquid
index ffbaf5e81b1851d071a4a22ab777042ec4cc7a37..9887f462c6559d76d8238ba5231bec3e2d0cb86a 100644 (file)
--- a/doc/install/install-ws.html.textile.liquid
+++ b/doc/install/install-ws.html.textile.liquid
@@ -4,13 +4,7 @@ navsection: installguide
 title: Install the websocket server
 ...
 
-{% include 'notebox_begin_warning' %}
-
-This websocket server is an alternative to the puma server that comes with the API server. It is available as an *experimental pre-release* and is not recommended for production sites.
-
-{% include 'notebox_end' %}
-
-The arvados-ws server provides event notifications to websocket clients. It can be installed anywhere with access to Postgres database and the Arvados API server, typically behind a web proxy that provides SSL support. See the "godoc page":http://godoc.org/github.com/curoverse/arvados/services/keep-web for additional information.
+The arvados-ws server provides event notifications to websocket clients. It can be installed anywhere with access to Postgres database and the Arvados API server, typically behind a web proxy that provides SSL support. See the "godoc page":http://godoc.org/github.com/curoverse/arvados/services/ws for additional information.
 
 By convention, we use the following hostname for the websocket service.
 
@@ -55,8 +49,7 @@ h3. Create a configuration file
 Create @/etc/arvados/ws/ws.yml@ using the following template. Replace @xxxxxxxx@ with the "password you generated during database setup":install-postgresql.html#api.
 
 <notextile>
-<pre><code>~$ <span class="userinput">arvados-ws -h</span>
-Client:
+<pre><code>Client:
   APIHost: <span class="userinput">uuid_prefix.your.domain</span>:443
 Listen: ":<span class="userinput">9003</span>"
 Postgres:
@@ -76,7 +69,7 @@ If your system uses systemd, the arvados-ws service should already be set up. St
 <notextile>
 <pre><code>~$ <span class="userinput">sudo systemctl restart arvados-ws</span>
 ~$ <span class="userinput">sudo systemctl status arvados-ws</span>
-● arvados-ws.service - Arvados websocket server
+&#x25cf; arvados-ws.service - Arvados websocket server
    Loaded: loaded (/lib/systemd/system/arvados-ws.service; enabled)
    Active: active (running) since Tue 2016-12-06 11:20:48 EST; 10s ago
      Docs: https://doc.arvados.org/
@@ -176,7 +169,9 @@ server {
 }
 </pre></notextile>
 
-If Nginx is already configured to proxy @ws@ requests to puma, move that configuration out of the way or change its @server_name@ so it doesn't conflict.
+{% include 'notebox_begin' %}
+If you are upgrading a cluster where Nginx is configured to proxy @ws@ requests to puma, change the @server_name@ value in the old configuration block so it doesn't conflict. When the new configuration is working, delete the old Nginx configuration sections (i.e., the "upstream websockets" block, and the "server" block that references @http://websockets@), and disable/remove the runit or systemd files for the puma server.
+{% include 'notebox_end' %}
 
 h3. Update API server configuration
 
@@ -187,7 +182,7 @@ Ensure the websocket server address is correct in the API server configuration f
 </code></pre>
 </notextile>
 
-Restart the Nginx to reload the API server configuration.
+Restart Nginx to reload the API server configuration.
 
 <notextile>
 <pre><code>$ sudo nginx -s reload</span>