[cloudstack-documentation] 03/03: ui - Multiple server management documentation (#232)

[ro...@apache.org]

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

rohit pushed a commit to branch 4.15
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git

commit e7588b7767ca5f13986420d47d8c6ac24c6d5891
Author: Hoang Nguyen <ho...@unitech.vn>
AuthorDate: Wed Aug 11 18:22:56 2021 +0700

    ui - Multiple server management documentation (#232)
    
    * multiple server management documentation
    
    * modify the server name in the Nginx example
    
    (cherry picked from commit 17a6ff447b422f8b2128d48a61ad6f33ba20ca11)
    Signed-off-by: Rohit Yadav <ro...@shapeblue.com>
---
 .../images/ui-multiple-server-management.png       | Bin 0 -> 30709 bytes
 source/adminguide/ui.rst                           |  63 +++++++++++++++++++++
 2 files changed, 63 insertions(+)

diff --git a/source/_static/images/ui-multiple-server-management.png b/source/_static/images/ui-multiple-server-management.png
new file mode 100644
index 0000000..32f9645
Binary files /dev/null and b/source/_static/images/ui-multiple-server-management.png differ
diff --git a/source/adminguide/ui.rst b/source/adminguide/ui.rst
index 5f8594b..b9fa334 100644
--- a/source/adminguide/ui.rst
+++ b/source/adminguide/ui.rst
@@ -472,6 +472,66 @@ Useful documentations:
 - `JavaScript ES6 Reference <https://www.tutorialspoint.com/es6/>`_
 - `Introduction to ES6 <https://scrimba.com/g/gintrotoes6>`_
 
+Multiple Management Support
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+User can use file `/etc/cloudstack/management/config.json` to configure the settings which allow Cloudstack to support multiple servers.
+
+To Cloudstack support use multiple servers, the following details can be edited in config.json:
+
+============================= ================================================================
+Property                      Description
+============================= ================================================================
+multipleServer                Configure to allow Cloudstack to support multiple servers.
+servers                       List of servers to which Cloudstack can connect.
+============================= ================================================================
+
+.. parsed-literal::
+
+   {
+      ...
+      "servers" [
+         {
+            "name": "server-1",
+            "apiHost": "/server-1",
+            "apiBase": "/client/api",
+         },
+         {
+            "name": "server-2",
+            "apiHost": "",
+            "apiBase": "/client/api",
+         }
+      ]
+      ...
+      "multipleServer": true
+   }
+
+For the UI to work with different servers, it is necessary to configure the Nginx config proxy to allow connections to the respective servers without Cross-Origin (to be put into /etc/nginx/conf.d/default/conf or similar).
+
+.. parsed-literal::
+
+   server {
+       listen          80;
+       server_name     localhost;
+       location / {
+           # /src/ui/dist contains the built UI webpack
+           root        /src/ui/dist;
+           index       index.html;
+       }
+       # for apiHost of server-1 located in config.json
+       location /server-1/client/ {
+           rewrite ^/server-1/(.*)$ /$1 break;
+           # server's actual URI
+           proxy_pass   https://server-1.your.domain;
+       }
+       # for apiHost of server-2 located in config.json
+       location /client/ {
+           # server's actual URI
+           proxy_pass   https://server-2.your.domain;
+       }
+   }
+
+|ui-multiple-server-management.png|
 
 Known Limitations
 ~~~~~~~~~~~~~~~~~
@@ -488,3 +548,6 @@ The following features are no longer supported or available in the UI but are st
 
 .. |ui-custom-plugin.png| image:: /_static/images/ui-custom-plugin.png
    :alt: Custom plugin shown in UI with navigation
+
+.. |ui-multiple-server-management.png| image:: /_static/images/ui-multiple-server-management.png
+   :alt: Custom plugin shown in UI with navigation