Differences

This shows you the differences between two versions of the page.

--- dev:websockets:gateway:websocketd [2018/06/14 15:56] – [Optional Systemd Setup] erickson
+++ dev:websockets:gateway:websocketd [2022/02/10 13:34] (current) – external edit 127.0.0.1
@@ Line 46: / Line 46: @@
 </code>
-==== Run Websocketd on port 7684 ====
+==== Run Websocketd on port 7682 ====
 <code>
+# Stop apache-websockets first since we're reusing the port.
+sudo systemctl stop apache2-websockets # or similar
 # AS USER opensrf
-/usr/local/bin/websocketd --loglevel info --maxforks 250 --port 7684 /openils/bin/osrf-websocket-stdio
+/usr/local/bin/websocketd --loglevel info --maxforks 250 --port 7682 /openils/bin/osrf-websocket-stdio
 # Or optionally override the config file path
-/usr/local/bin/websocketd --loglevel info --maxforks 250 --port 7684 /openils/bin/osrf-websocket-stdio /path/to/opensrf_core.xml
+/usr/local/bin/websocketd --loglevel info --maxforks 250 --port 7682 /openils/bin/osrf-websocket-stdio /path/to/opensrf_core.xml
 # Optionally background the process with a trailing '&'
 </code>
+Full set of command line args at https://github.com/joewalnes/websocketd/blob/master/help.go
 ==== Modify NGINX to proxy websocketd ====
@@ Line 64: / Line 68: @@
 <code>
-# comment out the apache-websocket proxy.
+# Websocketd supports SSL, but I run it in non-SSL mode since it's on the same machine as NGINX.
-# proxy_pass https://localhost:7682;
+# Replace https:// with http://
+proxy_pass http://localhost:7682;
-# I run websocketd in non-SSL (http://) mode behind the proxy
+# Update timeout values within the /osrf-websocket-translator section
-proxy_pass http://localhost:7684;
+# to disconnect idle clients.
-# Update timeout values to disconnect idle clients.
 # The osrf-websocket-stdio handler has no idle timeout threads.
 # Change to suit
@@ Line 124: / Line 127: @@
 Environment=PATH=/openils/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
 Environment=LD_LIBRARY_PATH=/openils/lib:/usr/local/lib:/usr/local/lib/dbd:$LD_LIBRARY_PATH
-ExecStart=/usr/local/bin/websocketd --loglevel error --maxforks 250 --port 7684 /openils/bin/osrf-websocket-stdio
+ExecStart=/usr/local/bin/websocketd --loglevel error --maxforks 250 --port 7682 /openils/bin/osrf-websocket-stdio
-# --sameorigin and --origin=domain1,domain2 flags are also supported.
+# modify websocketd command line options to taste
+# --sameorigin and --origin=domain1,domain2 flags are also supported for security.
+# On Ubuntu 18.04, you may also need to include something like this:
 [Install]
 WantedBy=multi-user.target
@@ Line 135: / Line 140: @@
 <code>
-$ sudo systemctl daemon-reload
+# disable apache2-websockets to avoid unintended starts & port conflicts
-$ sudo systemctl enable websocketd-osrf
+sudo systemctl disable apache2-websockets
-$ sudo systemctl start websocketd-osrf
+# enable and start websocketd-osrf
+sudo systemctl daemon-reload
+sudo systemctl enable websocketd-osrf
+sudo systemctl start websocketd-osrf
 </code>