[qpid-dispatch] branch master updated: DISPATCH-1300 Update documentation and schema for removing 'stand-alone' directory from console install path

[ea...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

eallen pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/qpid-dispatch.git


The following commit(s) were added to refs/heads/master by this push:
     new e6374ea  DISPATCH-1300 Update documentation and schema for removing 'stand-alone' directory from console install path
e6374ea is described below

commit e6374ea6c2247c3c8ee36ffff0e8c9883cfe7552
Author: Ernest Allen <ea...@redhat.com>
AuthorDate: Fri Mar 22 12:55:31 2019 -0400

    DISPATCH-1300 Update documentation and schema for removing 'stand-alone' directory from console install path
---
 console/stand-alone/README.md                 | 27 +++++++++++++++++----------
 python/qpid_dispatch/management/qdrouter.json |  2 +-
 2 files changed, 18 insertions(+), 11 deletions(-)

diff --git a/console/stand-alone/README.md b/console/stand-alone/README.md
index 8d6612c..bbd3659 100644
--- a/console/stand-alone/README.md
+++ b/console/stand-alone/README.md
@@ -21,17 +21,11 @@ The stand-alone qpid dispatch console is an html web site that monitors and cont
 
 ## To install the console:
 
-  After a dispatch build the 3rd party libraries need to be installed.
-
-  ### To manually install the 3rd party libraries:
-    - cd /usr/share/qpid-dispatch/console/stand-alone
-    - npm install
-
-Note: An internet connection is required during the npm install to retrieve the 3rd party javascript / css files.
+  The console files are installed during a dispatch `make install`. By default, the console files are installed in /usr/share/qpid-dispatch/console
 
 ## To run the web console:
-- Ensure one of the routers in your network is configured with a normal listener with `http: true` and that
-the `httpRootDir` is set to the directory containing installed stand-alone console files
+- Ensure one of the routers in your network is configured with a normal listener with `http: true`
+
 ```
 listener {
     role: normal
@@ -39,7 +33,6 @@ listener {
     port: 5673
     http: true
     saslMechanisms: ANONYMOUS
-    httpRootDir: /usr/share/qpid-dispatch/console/stand-alone
 }
 ```
 - start the router
@@ -48,5 +41,19 @@ listener {
 The router will serve the console's html/js/css from the install directory.
 The console will automatically connect to the router at localhost:5673
 
+## To disable the console and still allow the router to respond to other http traffic
+
+- in the listener portion of the config file, add an httpRoot: None
+
+```
+listener {
+    role: normal
+    host: 0.0.0.0
+    port: 5673
+    http: true
+    httpRoot: None
+    saslMechanisms: ANONYMOUS
+}
+```
 
 
diff --git a/python/qpid_dispatch/management/qdrouter.json b/python/qpid_dispatch/management/qdrouter.json
index 1bcf483..cbf154f 100644
--- a/python/qpid_dispatch/management/qdrouter.json
+++ b/python/qpid_dispatch/management/qdrouter.json
@@ -864,7 +864,7 @@
                 },
                 "httpRootDir": {
                     "type": "path",
-                    "description": "Absolute path to a directory from which to serve static HTML files. For example, /usr/share/qpid-dispatch/console/stand-alone.",
+                    "description": "Absolute path to a directory from which to serve static HTML files. For example, /usr/share/qpid-dispatch/console.",
                     "deprecationName": "httpRoot",
                     "create": true
                 },


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org