X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/2a62b82e96a6f56357e913117e04c36b1ccf7585..608a1591840dfbeac3d5580c505b50bfface5929:/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 ffbaf5e81b..f6a4bb5faf 100644 --- a/doc/install/install-ws.html.textile.liquid +++ b/doc/install/install-ws.html.textile.liquid @@ -3,14 +3,13 @@ layout: default navsection: installguide title: Install the websocket server ... +{% comment %} +Copyright (C) The Arvados Authors. All rights reserved. -{% include 'notebox_begin_warning' %} +SPDX-License-Identifier: CC-BY-SA-3.0 +{% endcomment %} -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. @@ -44,27 +43,25 @@ Verify that @arvados-ws@ is functional:
~$ arvados-ws -h
Usage of arvados-ws:
-config path
- path to config file (default "/etc/arvados/ws/ws.yml")
+ path to config file (default "/etc/arvados/config.yml")
-dump-config
show current configuration and exit
-h3. Create a configuration file
+h3. Update cluster config
-Create @/etc/arvados/ws/ws.yml@ using the following template. Replace @xxxxxxxx@ with the "password you generated during database setup":install-postgresql.html#api.
+Edit the cluster config at @/etc/arvados/config.yml@ and set @Services.Websocket.ExternalURL@ and @Services.Websocket.InternalURLs@. Replace @zzzzz@ with your cluster id.
~$ arvados-ws -h
-Client:
- APIHost: uuid_prefix.your.domain:443
-Listen: ":9003"
-Postgres:
- dbname: arvados_production
- host: localhost
- password: xxxxxxxx
- user: arvados
-
+Clusters:
+ zzzzz:
+ Services:
+ Websocket:
+ ExternalURL: wss://ws.uuid_prefix.your.domain/websocket
+ InternalURLs:
+ "http://localhost:9003": {}
+
~$ sudo systemctl restart arvados-ws
~$ sudo systemctl status arvados-ws
-â arvados-ws.service - Arvados websocket server
+● 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,18 +173,13 @@ server {
}
websocket_address: wss://ws.uuid_prefix.your.domain/websocket
-
-$ sudo nginx -s reload
@@ -196,10 +188,10 @@ Restart the Nginx to reload the API server configuration.
h3. Verify DNS and proxy setup
-Use a host elsewhere on the Internet to confirm that your DNS, proxy, and SSL are configured correctly.
+Use a host elsewhere on the Internet to confirm that your DNS, proxy, and SSL are configured correctly. For @Authorization: Bearer xxxx@ replace @xxxx@ with the value from @ManagementToken@ in @config.yml@.
-$ curl https://ws.uuid_prefix.your.domain/status.json
-{"Clients":1}
+$ curl -H "Authorization: Bearer xxxx" https://ws.uuid_prefix.your.domain/_health/ping
+{"health":"OK"}