Skip to content

Commit 17a6ff4

Browse files
author
Hoang Nguyen
authored
ui - Multiple server management documentation (#232)
* multiple server management documentation * modify the server name in the Nginx example
1 parent 8966e71 commit 17a6ff4

File tree

2 files changed

+63
-0
lines changed

2 files changed

+63
-0
lines changed
30 KB
Loading

source/adminguide/ui.rst

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -472,6 +472,66 @@ Useful documentations:
472472
- `JavaScript ES6 Reference <https://www.tutorialspoint.com/es6/>`_
473473
- `Introduction to ES6 <https://scrimba.com/g/gintrotoes6>`_
474474

475+
Multiple Management Support
476+
~~~~~~~~~~~~~~~~~~~~~~~~~~~
477+
478+
User can use file `/etc/cloudstack/management/config.json` to configure the settings which allow Cloudstack to support multiple servers.
479+
480+
To Cloudstack support use multiple servers, the following details can be edited in config.json:
481+
482+
============================= ================================================================
483+
Property Description
484+
============================= ================================================================
485+
multipleServer Configure to allow Cloudstack to support multiple servers.
486+
servers List of servers to which Cloudstack can connect.
487+
============================= ================================================================
488+
489+
.. parsed-literal::
490+
491+
{
492+
...
493+
"servers" [
494+
{
495+
"name": "server-1",
496+
"apiHost": "/server-1",
497+
"apiBase": "/client/api",
498+
},
499+
{
500+
"name": "server-2",
501+
"apiHost": "",
502+
"apiBase": "/client/api",
503+
}
504+
]
505+
...
506+
"multipleServer": true
507+
}
508+
509+
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).
510+
511+
.. parsed-literal::
512+
513+
server {
514+
listen 80;
515+
server_name localhost;
516+
location / {
517+
# /src/ui/dist contains the built UI webpack
518+
root /src/ui/dist;
519+
index index.html;
520+
}
521+
# for apiHost of server-1 located in config.json
522+
location /server-1/client/ {
523+
rewrite ^/server-1/(.*)$ /$1 break;
524+
# server's actual URI
525+
proxy_pass https://server-1.your.domain;
526+
}
527+
# for apiHost of server-2 located in config.json
528+
location /client/ {
529+
# server's actual URI
530+
proxy_pass https://server-2.your.domain;
531+
}
532+
}
533+
534+
|ui-multiple-server-management.png|
475535

476536
Known Limitations
477537
~~~~~~~~~~~~~~~~~
@@ -488,3 +548,6 @@ The following features are no longer supported or available in the UI but are st
488548

489549
.. |ui-custom-plugin.png| image:: /_static/images/ui-custom-plugin.png
490550
:alt: Custom plugin shown in UI with navigation
551+
552+
.. |ui-multiple-server-management.png| image:: /_static/images/ui-multiple-server-management.png
553+
:alt: Custom plugin shown in UI with navigation

0 commit comments

Comments
 (0)