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 <[email protected]> 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 <[email protected]> --- .../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
