Panel | |
---|---|
|
NGINX Server for Linux
Note |
---|
The following steps require root privilege, be sure that you have the correct access before continuing. |
Note | ||
---|---|---|
| ||
See also the SELinux configuration section. |
Installing with Linux software packages
- Install an NGINX Server (Linux packages).
Install the UDMG packages (RPM or DEB), see Installing with Linux software packages. In particular, the
udmg-admin-ui-nginx
package will add the standard NGINX server configuration files (/opt/udmg/etc/udmg/nginx/udmg.conf
and/etc/nginx/conf.d/udmg.conf
) to load the UDMG Admin UI assets.
Performing a manual installation
- Install an NGINX Server (Linux packages).
Run the following command to check the main NGINX configuration file:
Panel |
---|
|
If the NGINX configuration file supports include directives, there will be a line like this:
Panel |
---|
|
- Create a configuration file
udmg.conf
under this directory (normally/etc/nginx/conf.d
). This will create 2 locations: ‘/' for the UDMG Admin UI and'/service'
for the internal authentication mechanism.
Panel |
---|
|
- Remove any
/etc/nginx/conf.d/default.conf
file, to disable the NGINX default landing page on port 80. - Validate that the configuration is correct with the following command:
Panel |
---|
|
- Create the Root directory:
Panel |
---|
|
- Enable and start the NGINX service using the Init system.
Panel |
---|
|
- Check that the HTTP server was started and is running, for example with the
curl
command:
Panel |
---|
|
This error (403) is expected, since we don't have any asset deployed.
Note |
---|
For configuring HTTPS and HTTP redirection, please refer to the web server documentation. |
NGINX Server for Windows
Note |
---|
The following steps require Administrator privileges, be sure that you have the correct access before to continue. |
- Install NGINX (see nginx for Windows), for example under
C:\UDMG\nginx
.
Run the following command to check the main NGINX configuration file:
Panel |
---|
|
- Create a directory under the configuration folder called "enabled"
Create a configuration file
udmg.conf
under this directory,C:\UDMG\nginx\conf\enabled
:Panel upstream udmg_auth_proxy {
#
UDMG
Auth Proxy Configurationserver localhost:5000;
}
server {
listen 80;
# listen 443 ssl;
# ssl_certificate /etc/udmg
/certs/udmg.pem;# ssl_certificate_key /etc/udmg/certs/udmg.key;
# ssl_session_timeout 5m;
# ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
# ssl_protocols TLSv1.2;
# ssl_prefer_server_ciphers on;
server_name localhost;
access_log logs//udmg.access.log;
location /service/ {
proxy_pass http://udmg_auth_proxy/;
}
location / {
try_files $uri $uri/ /index.html;
root udmg;
}
}
- Edit the default the http section of NGINX the main configuration file
C:\UDMG\nginx\conf\nginx.conf
Remove the standard server section with the default port 80
- Add an include directive to load the udmg.conf file inside . For example, the default file is like this
Panel |
---|
|
and must be edit to look like this:
Panel |
---|
|
- Remove any
/etc/nginx/conf.d/default.conf
file, to disable the NGINX default landing page on port 80.
- Validate that the configuration is correct with the following command:
Panel |
---|
|
- Create the Root directory under the NGINX main directory called udmg:
Panel |
---|
|
- Start NGINX
Panel |
---|
|
- Check that the HTTP server was started and is running, for example with the
curl
command:
Panel |
---|
|
This error (403) is expected, since we don't have any asset deployed.
Notes:
- For configuring HTTPS and HTTP redirection, please refer to the web server documentation (Configuring HTTPS servers).
- The paths in any NGINX configuration file must be specified in UNIX-style, using forward slashes '/'.
- For running NGINX as a service please refer to the service section in UDMG for Windows Installation