From ef71d02ea4d3bd1310216a04109b9a1b860512aa Mon Sep 17 00:00:00 2001 From: Yaroslav Zhuravlev Date: Wed, 2 Apr 2025 10:37:49 +0100 Subject: [PATCH] Updated some links from "relref" and "a href" to "ref". --- .../basic-functionality/runtime-control.md | 2 +- .../admin-guide/dynamic-modules/brotli.md | 4 ++-- .../dynamic-modules/cookie-flag.md | 4 ++-- .../dynamic-modules/dynamic-modules.md | 24 +++++++++---------- .../dynamic-modules/encrypted-session.md | 4 ++-- .../nginx/admin-guide/dynamic-modules/fips.md | 4 ++-- .../admin-guide/dynamic-modules/geoip.md | 10 ++++---- .../admin-guide/dynamic-modules/geoip2.md | 6 ++--- .../dynamic-modules/headers-more.md | 4 ++-- .../http-substitutions-filter.md | 4 ++-- .../dynamic-modules/image-filter.md | 4 ++-- .../nginx/admin-guide/dynamic-modules/lua.md | 4 ++-- .../nginx/admin-guide/dynamic-modules/ndk.md | 6 ++--- .../admin-guide/dynamic-modules/nginscript.md | 4 ++-- .../admin-guide/dynamic-modules/nginx-waf.md | 4 ++-- .../dynamic-modules/opentelemetry.md | 6 ++--- .../dynamic-modules/passenger-open-source.md | 4 ++-- .../nginx/admin-guide/dynamic-modules/perl.md | 4 ++-- .../dynamic-modules/prometheus-njs.md | 2 +- .../nginx/admin-guide/dynamic-modules/rtmp.md | 4 ++-- .../admin-guide/dynamic-modules/set-misc.md | 4 ++-- .../admin-guide/dynamic-modules/spnego.md | 4 ++-- .../admin-guide/dynamic-modules/uninstall.md | 2 +- .../nginx/admin-guide/dynamic-modules/xslt.md | 4 ++-- .../configuration-sharing.md | 2 +- .../high-availability/ha-keepalived-nodes.md | 2 +- .../high-availability/ha-keepalived.md | 2 +- .../high-availability/zone_sync.md | 4 ++-- .../high-availability/zone_sync_details.md | 6 ++--- .../installing-nginx-docker.md | 2 +- .../installing-nginx-open-source.md | 4 ++-- .../dynamic-configuration-api.md | 4 ++-- .../load-balancer/http-health-check.md | 2 +- .../load-balancer/http-load-balancer.md | 4 ++-- .../load-balancer/tcp-udp-load-balancer.md | 8 +++---- .../load-balancer/udp-health-check.md | 2 +- .../load-balancer/using-proxy-protocol.md | 12 +++++----- .../nginx/admin-guide/monitoring/debugging.md | 4 ++-- .../monitoring/live-activity-monitoring.md | 22 ++++++++--------- .../nginx/admin-guide/monitoring/logging.md | 2 +- .../configuring-jwt-authentication.md | 12 +++++----- .../controlling-access-by-geoip.md | 6 ++--- .../controlling-access-proxied-http.md | 2 +- .../denylisting-ip-addresses.md | 6 ++--- .../securing-http-traffic-upstream.md | 2 +- .../securing-tcp-traffic-upstream.md | 4 ++-- .../security-controls/terminating-ssl-tcp.md | 4 ++-- .../web-server/app-gateway-uwsgi-django.md | 2 +- .../high-availability-keepalived.md | 4 ++-- ...high-availability-network-load-balancer.md | 4 ++-- .../route-53-global-server-load-balancing.md | 4 ++-- .../ns1-global-server-load-balancing.md | 4 ++-- .../high-availability-all-active.md | 4 ++-- .../load-balance-third-party/apache-tomcat.md | 14 +++++------ .../microsoft-exchange.md | 14 +++++------ .../load-balance-third-party/node-js.md | 16 ++++++------- .../oracle-e-business-suite.md | 20 ++++++++-------- .../oracle-weblogic-server.md | 18 +++++++------- .../load-balance-third-party/wildfly.md | 16 ++++++------- ...igh-availability-standard-load-balancer.md | 6 ++--- .../virtual-machines-for-nginx.md | 4 ++-- .../citrix-adc-configuration.md | 16 ++++++------- .../f5-big-ip-configuration.md | 16 ++++++------- .../nginx-plus-high-availability-chef.md | 2 +- .../setting-up-nginx-demo-environment.md | 4 ++-- 65 files changed, 204 insertions(+), 204 deletions(-) diff --git a/content/nginx/admin-guide/basic-functionality/runtime-control.md b/content/nginx/admin-guide/basic-functionality/runtime-control.md index ca301ea1a..7f61904a0 100644 --- a/content/nginx/admin-guide/basic-functionality/runtime-control.md +++ b/content/nginx/admin-guide/basic-functionality/runtime-control.md @@ -13,7 +13,7 @@ This section describes the processes that NGINX starts at run time and how to co ## Master and Worker Processes -NGINX has one master process and one or more worker processes. If [caching]({{< relref "../content-cache/content-caching.md" >}}) is enabled, the cache loader and cache manager processes also run at startup. +NGINX has one master process and one or more worker processes. If [caching]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) is enabled, the cache loader and cache manager processes also run at startup. The main purpose of the master process is to read and evaluate configuration files, as well as maintain the worker processes. diff --git a/content/nginx/admin-guide/dynamic-modules/brotli.md b/content/nginx/admin-guide/dynamic-modules/brotli.md index 29b9171b8..52e1389f2 100644 --- a/content/nginx/admin-guide/dynamic-modules/brotli.md +++ b/content/nginx/admin-guide/dynamic-modules/brotli.md @@ -21,7 +21,7 @@ The [ngx_brotli](https://github.com/google/ngx_brotli) module enables Brotli com ## Prerequisites -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. If required, install the **epel-release** dependency @@ -116,4 +116,4 @@ After installation you will need to enable and configure Brotli modules in NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/cookie-flag.md b/content/nginx/admin-guide/dynamic-modules/cookie-flag.md index 26d1f3636..b6744c690 100644 --- a/content/nginx/admin-guide/dynamic-modules/cookie-flag.md +++ b/content/nginx/admin-guide/dynamic-modules/cookie-flag.md @@ -10,7 +10,7 @@ type: - how-to --- -> **Note**: The module was deprecated in Release 23 and removed in Release 26. The [`proxy_cookie_flags`](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cookie_flags) directive implements native support for setting cookie flags and replaces the module. See [Native Method for Setting Cookie Flags](https://www.nginx.com/blog/nginx-plus-r23-released#cookie-flags) for details. +> **Note**: The module was deprecated in [Release 23]({{< ref "nginx/releases.md#r23" >}}) and removed in [Release 26]({{< ref "nginx/releases.md#r26" >}}). The [`proxy_cookie_flags`](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cookie_flags) directive implements native support for setting cookie flags and replaces the module. See [Native Method for Setting Cookie Flags](https://www.nginx.com/blog/nginx-plus-r23-released#cookie-flags) for details. @@ -64,4 +64,4 @@ type: - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md b/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md index 6a3a06414..00ce6fe5d 100644 --- a/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md +++ b/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md @@ -12,7 +12,7 @@ type: ## Overview -F5 NGINX Plus uses a modular architecture. New features and functionality can be added with software modules, which can be plugged into a running NGINX Plus instance on demand. Dynamic modules add functionality to NGINX Plus such as [geolocating users by IP address]({{< relref "./geoip2.md" >}}), [resizing images]({{< ref "image-filter.md" >}}), and embedding [NGINX JavaScript njs]({{< ref "nginscript.md" >}}) or [Lua]({{< relref "./lua.md" >}}) scripts into the NGINX Plus event‑processing model. Modules are created both by NGINX and third‑party developers. +F5 NGINX Plus uses a modular architecture. New features and functionality can be added with software modules, which can be plugged into a running NGINX Plus instance on demand. Dynamic modules add functionality to NGINX Plus such as [geolocating users by IP address]({{< ref "geoip2.md" >}}), [resizing images]({{< ref "image-filter.md" >}}), and embedding [NGINX JavaScript njs]({{< ref "nginscript.md" >}}) or [Lua]({{< ref "nginx/admin-guide/dynamic-modules/lua.md" >}}) scripts into the NGINX Plus event‑processing model. Modules are created both by NGINX and third‑party developers. NGINX Plus allows features to be plugged in on demand @@ -44,15 +44,15 @@ load_module modules/ngx_stream_js_module.so; For module‑specific instructions, see the list of modules in the same section of the NGINX Plus Admin Guide as this article: - [Brotli]({{< ref "brotli.md" >}}) -- [Cookie-Flag]({{< relref "./cookie-flag.md" >}}) +- [Cookie-Flag]({{< ref "cookie-flag.md" >}}) - [Encrypted-Session]({{< ref "encrypted-session.md" >}}) -- [FIPS Status Check]({{< relref "./fips.md" >}}) -- [GeoIP]({{< relref "./geoip.md" >}}) -- [GeoIP2]({{< relref "./geoip2.md" >}}) +- [FIPS Status Check]({{< ref "fips.md" >}}) +- [GeoIP]({{< ref "geoip.md" >}}) +- [GeoIP2]({{< ref "geoip2.md" >}}) - [Headers-More]({{< ref "headers-more.md" >}}) - [HTTP Substitutions Filter]({{< ref "http-substitutions-filter.md" >}}) - [Image-Filter]({{< ref "image-filter.md" >}}) -- [Lua]({{< relref "./lua.md" >}}) +- [Lua]({{< ref "lua.md" >}}) - [njs Scripting Language]({{< ref "nginscript.md" >}}) - [NGINX ModSecurity WAF]({{< ref "nginx-waf.md" >}}) - [NGINX Developer Kit]({{< ref "ndk.md" >}}) @@ -62,15 +62,15 @@ For module‑specific instructions, see the list of modules in the same section - [Perl]({{< ref "perl.md" >}}) - [Prometheus-njs]({{< ref "prometheus-njs.md" >}}) - [RTMP]({{< ref "rtmp.md" >}}) -- [Set-Misc]({{< relref "./set-misc.md" >}}) +- [Set-Misc]({{< ref "nginx/admin-guide/dynamic-modules/set-misc.md" >}}) - [SPNEGO]({{< ref "spnego.md" >}}) -- [XSLT]({{< relref "./xslt.md" >}}) +- [XSLT]({{< ref "xslt.md" >}}) ### Prerequisites -To get started using dynamic modules, first install the latest NGINX Plus release, following the [installation instructions]({{< relref "../installing-nginx/installing-nginx-plus.md" >}}). Dynamic modules are supported in [NGINX Plus Release 9 (R9)]({{< ref "/nginx/releases.md#r9" >}}) and later. +To get started using dynamic modules, first install the latest NGINX Plus release, following the [installation instructions]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}). Dynamic modules are supported in [NGINX Plus Release 9 (R9)]({{< ref "/nginx/releases.md#r9" >}}) and later. @@ -109,7 +109,7 @@ NGINX Plus Certified Modules can be found on the [Dynamic Modules page](https:// ### Caveats -Some modules are not available for certain OS versions because of OS limitations. For details, see the [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}). +Some modules are not available for certain OS versions because of OS limitations. For details, see the [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}). @@ -127,7 +127,7 @@ To uninstall a dynamic module, please follow the [Uninstalling a dynamic module] ## See Also -- [Installing NGINX Plus]({{< relref "../installing-nginx/installing-nginx-plus.md" >}}) +- [Installing NGINX Plus]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/encrypted-session.md b/content/nginx/admin-guide/dynamic-modules/encrypted-session.md index ec7710be9..b85831f13 100644 --- a/content/nginx/admin-guide/dynamic-modules/encrypted-session.md +++ b/content/nginx/admin-guide/dynamic-modules/encrypted-session.md @@ -14,7 +14,7 @@ The Encrypted Session dynamic module provides encryption and decryption support ## Prerequisites -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Prior to installing the module, verify that the [NDK]({{< ref "ndk.md" >}}) module is already installed. @@ -90,4 +90,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/fips.md b/content/nginx/admin-guide/dynamic-modules/fips.md index 55dad8716..7878303e7 100644 --- a/content/nginx/admin-guide/dynamic-modules/fips.md +++ b/content/nginx/admin-guide/dynamic-modules/fips.md @@ -15,7 +15,7 @@ For F5 NGINX Plus, the cryptographic boundary includes all functionality that is ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the FIPS module package `nginx-plus-module-fips-check`. @@ -85,4 +85,4 @@ After installation you will need to enable and configure the module in NGINX Plu - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/geoip.md b/content/nginx/admin-guide/dynamic-modules/geoip.md index 8825674a4..b9129d07c 100644 --- a/content/nginx/admin-guide/dynamic-modules/geoip.md +++ b/content/nginx/admin-guide/dynamic-modules/geoip.md @@ -9,13 +9,13 @@ type: - how-to --- -{{< note >}} MaxMind GeoLite Legacy databases are currently [discontinued](https://blog.maxmind.com/2018/01/discontinuation-of-the-geolite-legacy-databases), MaxMind GeoIP2 or Geolite2 databases and F5 NGINX Plus [GeoIP2 module]({{< relref "./geoip2.md" >}}) should be used instead. {{< /note >}} +{{< note >}} MaxMind GeoLite Legacy databases are currently [discontinued](https://blog.maxmind.com/2018/01/discontinuation-of-the-geolite-legacy-databases), MaxMind GeoIP2 or Geolite2 databases and F5 NGINX Plus [GeoIP2 module]({{< ref "geoip2.md" >}}) should be used instead. {{< /note >}} ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the GeoIP module package `nginx-plus-module-geoip`. @@ -74,9 +74,9 @@ After installation you will need to enable and configure the module in NGINX Plu ## More Info -- [GeoIP2 Dynamic Module Installation Instructions]({{< relref "./geoip2.md" >}}) +- [GeoIP2 Dynamic Module Installation Instructions]({{< ref "geoip2.md" >}}) -- [Restricting Access by Geographical Location]({{< relref "../security-controls/controlling-access-by-geoip.md" >}}) +- [Restricting Access by Geographical Location]({{< ref "nginx/admin-guide/security-controls/controlling-access-by-geoip.md" >}}) - [ngx_http_geoip_module Module Reference](https://nginx.org/en/docs/http/ngx_http_geoip_module.html) @@ -84,4 +84,4 @@ After installation you will need to enable and configure the module in NGINX Plu - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/geoip2.md b/content/nginx/admin-guide/dynamic-modules/geoip2.md index 6aa7e31da..9237fc36b 100644 --- a/content/nginx/admin-guide/dynamic-modules/geoip2.md +++ b/content/nginx/admin-guide/dynamic-modules/geoip2.md @@ -19,7 +19,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the GeoIP2 module package `nginx-plus-module-geoip2`. @@ -83,7 +83,7 @@ After installation you will need to enable and configure the module in NGINX Plu ## More Info -- [Restricting Access by Geographical Location]({{< relref "../security-controls/controlling-access-by-geoip.md" >}}) +- [Restricting Access by Geographical Location]({{< ref "nginx/admin-guide/security-controls/controlling-access-by-geoip.md" >}}) - [MaxMind GeoIP2 Databases](https://www.maxmind.com/en/geoip2-databases) @@ -91,4 +91,4 @@ After installation you will need to enable and configure the module in NGINX Plu - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/headers-more.md b/content/nginx/admin-guide/dynamic-modules/headers-more.md index 51d34ea05..98cbf683d 100644 --- a/content/nginx/admin-guide/dynamic-modules/headers-more.md +++ b/content/nginx/admin-guide/dynamic-modules/headers-more.md @@ -12,7 +12,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the Headers-More module package `nginx-plus-module-headers-more`. @@ -79,4 +79,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/http-substitutions-filter.md b/content/nginx/admin-guide/dynamic-modules/http-substitutions-filter.md index e14d55948..789e8d0c5 100644 --- a/content/nginx/admin-guide/dynamic-modules/http-substitutions-filter.md +++ b/content/nginx/admin-guide/dynamic-modules/http-substitutions-filter.md @@ -12,7 +12,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the HTTP Substitutions Filter module package `nginx-plus-module-subs-filter`. @@ -73,4 +73,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/image-filter.md b/content/nginx/admin-guide/dynamic-modules/image-filter.md index ef058c6c0..3967a3cdf 100644 --- a/content/nginx/admin-guide/dynamic-modules/image-filter.md +++ b/content/nginx/admin-guide/dynamic-modules/image-filter.md @@ -12,7 +12,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the Image-Filter module package `nginx-plus-module-image-filter`. @@ -80,4 +80,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/lua.md b/content/nginx/admin-guide/dynamic-modules/lua.md index 42cc5ab63..61e51899a 100644 --- a/content/nginx/admin-guide/dynamic-modules/lua.md +++ b/content/nginx/admin-guide/dynamic-modules/lua.md @@ -13,7 +13,7 @@ Integrate Lua co-routines into the NGINX event-processing model with the communi ## Prerequisites -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Prior to installing the module, verify that the [NGINX Developer Kit (NDK)]({{< ref "nginx/admin-guide/dynamic-modules/ndk.md" >}}) module is already installed. @@ -96,4 +96,4 @@ After installation, enable and configure the modules in NGINX Plus configuration - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/ndk.md b/content/nginx/admin-guide/dynamic-modules/ndk.md index 5431006fd..d17b9ca98 100644 --- a/content/nginx/admin-guide/dynamic-modules/ndk.md +++ b/content/nginx/admin-guide/dynamic-modules/ndk.md @@ -10,13 +10,13 @@ type: The NGINX Developer Kit (NDK) module makes it easier for module developers to develop NGINX modules. -The NDK module is also a prerequisite for [Encrypted Session]({{< ref "encrypted-session.md" >}}), [Lua]({{< relref "./lua.md" >}}), and [Set-Misc]({{< relref "./set-misc.md" >}}) modules. +The NDK module is also a prerequisite for [Encrypted Session]({{< ref "encrypted-session.md" >}}), [Lua]({{< ref "nginx/admin-guide/dynamic-modules/lua.md" >}}), and [Set-Misc]({{< ref "nginx/admin-guide/dynamic-modules/set-misc.md" >}}) modules. ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the NDK module package `nginx-plus-module-ndk`. @@ -84,4 +84,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/nginscript.md b/content/nginx/admin-guide/dynamic-modules/nginscript.md index 67393f1e3..ae419595c 100644 --- a/content/nginx/admin-guide/dynamic-modules/nginscript.md +++ b/content/nginx/admin-guide/dynamic-modules/nginscript.md @@ -13,7 +13,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the njs module package `nginx-plus-module-njs`. @@ -83,4 +83,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/nginx-waf.md b/content/nginx/admin-guide/dynamic-modules/nginx-waf.md index 59e625696..006eb16d3 100644 --- a/content/nginx/admin-guide/dynamic-modules/nginx-waf.md +++ b/content/nginx/admin-guide/dynamic-modules/nginx-waf.md @@ -11,13 +11,13 @@ type: The F5 NGINX ModSecurity web application firewall (WAF) is built on ModSecurity 3.0. - {{< note >}} The ModSecurity WAF module was deprecated since NGINX Plus Release 29, and is no longer available since NGINX Plus Release 32 {{< /note >}} + {{< note >}} The ModSecurity WAF module was deprecated since NGINX Plus [Release 29]({{< ref "nginx/releases.md#r29" >}}), and is no longer available since NGINX Plus [Release 32]({{< ref "nginx/releases.md#r32" >}}) {{< /note >}} ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the NGINX ModSecurity WAF module package `nginx-plus-module-modsecurity`. diff --git a/content/nginx/admin-guide/dynamic-modules/opentelemetry.md b/content/nginx/admin-guide/dynamic-modules/opentelemetry.md index c53adb9c3..c6a4530ca 100644 --- a/content/nginx/admin-guide/dynamic-modules/opentelemetry.md +++ b/content/nginx/admin-guide/dynamic-modules/opentelemetry.md @@ -14,13 +14,13 @@ type: The module provides [OpenTelemetry](https://opentelemetry.io/) distributed tracing support. The module supports [W3C](https://w3c.github.io/trace-context/) context propagation and OTLP/gRPC export protocol. - {{< note >}} the code of NGINX OpenTelemetry module is open source since [NGINX Open Source](https://nginx.org) 1.25.2 and F5 NGINX Plus Release 30. The source code is available on [GitHub](https://github.com/nginxinc/nginx-otel).{{< /note >}} + {{< note >}} the code of NGINX OpenTelemetry module is open source since [NGINX Open Source](https://nginx.org) 1.25.2 and NGINX Plus [Release 30]({{< ref "nginx/releases.md#r30" >}}). The source code is available on [GitHub](https://github.com/nginxinc/nginx-otel).{{< /note >}} ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the OpenTelemetry module package `nginx-plus-module-otel`. @@ -310,4 +310,4 @@ http { - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/passenger-open-source.md b/content/nginx/admin-guide/dynamic-modules/passenger-open-source.md index a3390e95d..25f2db23d 100644 --- a/content/nginx/admin-guide/dynamic-modules/passenger-open-source.md +++ b/content/nginx/admin-guide/dynamic-modules/passenger-open-source.md @@ -13,7 +13,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the Phusion Passenger Open Source module package `nginx-plus-module-passenger`. @@ -82,4 +82,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/perl.md b/content/nginx/admin-guide/dynamic-modules/perl.md index 2c71de798..79615816c 100644 --- a/content/nginx/admin-guide/dynamic-modules/perl.md +++ b/content/nginx/admin-guide/dynamic-modules/perl.md @@ -13,7 +13,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the Perl module package `nginx-plus-module-perl`. @@ -82,4 +82,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md b/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md index ce3d2a3d3..4ff4627ff 100644 --- a/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md +++ b/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md @@ -372,4 +372,4 @@ stream { - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/rtmp.md b/content/nginx/admin-guide/dynamic-modules/rtmp.md index b54ee5c9b..aa8e7d214 100644 --- a/content/nginx/admin-guide/dynamic-modules/rtmp.md +++ b/content/nginx/admin-guide/dynamic-modules/rtmp.md @@ -12,7 +12,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the RTMP Media Streaming module package `nginx-plus-module-rtmp`. @@ -81,4 +81,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/set-misc.md b/content/nginx/admin-guide/dynamic-modules/set-misc.md index 1ffe56f77..a5b42f47d 100644 --- a/content/nginx/admin-guide/dynamic-modules/set-misc.md +++ b/content/nginx/admin-guide/dynamic-modules/set-misc.md @@ -13,7 +13,7 @@ type: ## Prerequisites -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Prior to installing the module, verify that the [NDK]({{< ref "ndk.md" >}}) module is already installed. @@ -91,4 +91,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/spnego.md b/content/nginx/admin-guide/dynamic-modules/spnego.md index c3bdd4538..d81f059bc 100644 --- a/content/nginx/admin-guide/dynamic-modules/spnego.md +++ b/content/nginx/admin-guide/dynamic-modules/spnego.md @@ -12,7 +12,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the SPNEGO Auth module package `nginx-plus-module-auth-spnego`. @@ -81,5 +81,5 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/uninstall.md b/content/nginx/admin-guide/dynamic-modules/uninstall.md index 761e61ba6..2ee946ac6 100644 --- a/content/nginx/admin-guide/dynamic-modules/uninstall.md +++ b/content/nginx/admin-guide/dynamic-modules/uninstall.md @@ -68,5 +68,5 @@ After uninstalling the package, you will need to disable the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/xslt.md b/content/nginx/admin-guide/dynamic-modules/xslt.md index e6c94511a..1c2d8351f 100644 --- a/content/nginx/admin-guide/dynamic-modules/xslt.md +++ b/content/nginx/admin-guide/dynamic-modules/xslt.md @@ -12,7 +12,7 @@ type: ## Installation -1. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. 2. Install the XSLT module package `nginx-plus-module-xslt`. @@ -81,4 +81,4 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) -- [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) diff --git a/content/nginx/admin-guide/high-availability/configuration-sharing.md b/content/nginx/admin-guide/high-availability/configuration-sharing.md index 2eb06ce2d..1f89b6967 100644 --- a/content/nginx/admin-guide/high-availability/configuration-sharing.md +++ b/content/nginx/admin-guide/high-availability/configuration-sharing.md @@ -46,7 +46,7 @@ To configure this feature: ### Installing nginx-sync on the Primary Machine -Install the NGINX Synchronization module package `nginx-sync` on the Primary machine. Check the [Technical Specifications]({{< relref "../../technical-specs.md" >}}) page to verify that the module is supported by your operating system. +Install the NGINX Synchronization module package `nginx-sync` on the Primary machine. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. - For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: diff --git a/content/nginx/admin-guide/high-availability/ha-keepalived-nodes.md b/content/nginx/admin-guide/high-availability/ha-keepalived-nodes.md index 56ac9fb63..52465ece9 100644 --- a/content/nginx/admin-guide/high-availability/ha-keepalived-nodes.md +++ b/content/nginx/admin-guide/high-availability/ha-keepalived-nodes.md @@ -13,7 +13,7 @@ type: ## Introduction -F5 NGINX Plus utilizes [keepalived](http://www.keepalived.org/) to provide high availability (HA) in a standard active‑passive fashion. This provides failover redundancy in the event of a problem on the primary NGINX Plus node. We can extend this functionality with additional nodes and changes to the `keepalived` configuration, providing additional redundancy and scalability options. This guide assumes that you have already configured NGINX Plus in an active‑passive implementation with [the NGINX HA solution]({{< relref "./ha-keepalived.md" >}}). +F5 NGINX Plus utilizes [keepalived](http://www.keepalived.org/) to provide high availability (HA) in a standard active‑passive fashion. This provides failover redundancy in the event of a problem on the primary NGINX Plus node. We can extend this functionality with additional nodes and changes to the `keepalived` configuration, providing additional redundancy and scalability options. This guide assumes that you have already configured NGINX Plus in an active‑passive implementation with [the NGINX HA solution]({{< ref "nginx/admin-guide/high-availability/ha-keepalived.md" >}}). **NOTE:** In a public cloud deployment we recommend using a Layer 4 or TCP load‑balancing service offered by the cloud provider to distribute traffic to NGINX Plus for active‑active functionality. diff --git a/content/nginx/admin-guide/high-availability/ha-keepalived.md b/content/nginx/admin-guide/high-availability/ha-keepalived.md index af3909706..23aae7e4b 100644 --- a/content/nginx/admin-guide/high-availability/ha-keepalived.md +++ b/content/nginx/admin-guide/high-availability/ha-keepalived.md @@ -16,7 +16,7 @@ This article explains how to configure high availability of NGINX Plus instance ## High Availability Support Based on keepalived -NGINX Plus R6 and later supports a solution for fast and easy configuration of NGINX Plus in an active‑passive high‑availability (HA) setup, based on [keepalived](https://www.keepalived.org/). +NGINX Plus [Release 6]({{< ref "nginx/releases.md#r6" >}}) and later supports a solution for fast and easy configuration of NGINX Plus in an active‑passive high‑availability (HA) setup, based on [keepalived](https://www.keepalived.org/). The [keepalived open source project](http://www.keepalived.org/) includes three components: diff --git a/content/nginx/admin-guide/high-availability/zone_sync.md b/content/nginx/admin-guide/high-availability/zone_sync.md index bd224a616..5baeb4224 100644 --- a/content/nginx/admin-guide/high-availability/zone_sync.md +++ b/content/nginx/admin-guide/high-availability/zone_sync.md @@ -25,8 +25,8 @@ All NGINX Plus instances can exchange state data with all other members in a clu ## Prerequisites -- NGINX Plus R16 for sharing limits of requests processing and key-value data across the cluster -- NGINX Plus R15 for sharing limits of sticky learn data across the cluster +- NGINX Plus [R16]({{< ref "nginx/releases.md#r16" >}}) for sharing limits of requests processing and key-value data across the cluster +- NGINX Plus [R15]({{< ref "nginx/releases.md#r15" >}}) for sharing limits of sticky learn data across the cluster State sharing across a cluster is eventually consistent by nature. It is strongly recommended using data-center grade networks for clustering traffic, as latency, low bandwidth, and packet loss will have a significant negative impact on state consistency. We do not recommend stretching clusters over the Internet, regions, or availability zones. diff --git a/content/nginx/admin-guide/high-availability/zone_sync_details.md b/content/nginx/admin-guide/high-availability/zone_sync_details.md index efb3855b8..8b46c0568 100644 --- a/content/nginx/admin-guide/high-availability/zone_sync_details.md +++ b/content/nginx/admin-guide/high-availability/zone_sync_details.md @@ -214,9 +214,9 @@ With many workers and nodes, this can become a bottleneck. If the number of even ## History -In NGINX Plus R15, the ability to synchronize memory zones between instances was introduced; only sticky sessions with [learn](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#sticky_learn_sync) method were supported at the moment. +In NGINX Plus [R15]({{< ref "nginx/releases.md#r15" >}}), the ability to synchronize memory zones between instances was introduced; only sticky sessions with [learn](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#sticky_learn_sync) method were supported at the moment. -In NGINX Plus R16, shared zones synchronization was extended to support [keyval](https://nginx.org/en/docs/http/ngx_http_keyval_module.html) and [limit_req](https://nginx.org/en/docs/http/ngx_http_limit_req_module.html#limit_req) modules. +In NGINX Plus [R16]({{< ref "nginx/releases.md#r16" >}}), shared zones synchronization was extended to support [keyval](https://nginx.org/en/docs/http/ngx_http_keyval_module.html) and [limit_req](https://nginx.org/en/docs/http/ngx_http_limit_req_module.html#limit_req) modules. -In NGINX Plus R18, a single zone_sync configuration can be applied between all instances in a cluster using wildcards in the [listen](https://nginx.org/en/docs/stream/ngx_stream_core_module.html#listen) directive. +In NGINX Plus [R18]({{< ref "nginx/releases.md#r18" >}}), a single zone_sync configuration can be applied between all instances in a cluster using wildcards in the [listen](https://nginx.org/en/docs/stream/ngx_stream_core_module.html#listen) directive. diff --git a/content/nginx/admin-guide/installing-nginx/installing-nginx-docker.md b/content/nginx/admin-guide/installing-nginx/installing-nginx-docker.md index 3ee7bee2b..58c62d2c8 100644 --- a/content/nginx/admin-guide/installing-nginx/installing-nginx-docker.md +++ b/content/nginx/admin-guide/installing-nginx/installing-nginx-docker.md @@ -26,7 +26,7 @@ type: ## Using official NGINX Plus Docker images -Since NGINX Plus Release 31 you can get an NGINX Plus image from the official NGINX Plus Docker registry and upload it to your private registry. +Since NGINX Plus NGINX Plus [Release 31]({{< ref "nginx/releases.md#r31" >}}) you can get an NGINX Plus image from the official NGINX Plus Docker registry and upload it to your private registry. The NGINX Plus Docker registry is available at `https://private-registry.nginx.com/v2/`. diff --git a/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md b/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md index 57991bd36..889d9c936 100644 --- a/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md +++ b/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md @@ -594,7 +594,7 @@ The package can be installed from the official repo at **nginx.org**. You have t sudo apk add nginx ``` - The `@nginx` tag should also be specified when installing packages with [dynamic modules]({{< relref "../dynamic-modules/dynamic-modules.md" >}}): + The `@nginx` tag should also be specified when installing packages with [dynamic modules]({{< ref "nginx/admin-guide/dynamic-modules/dynamic-modules.md" >}}): ```shell sudo apk add nginx-module-image-filter@nginx nginx-module-njs@nginx @@ -885,7 +885,7 @@ If you do not need a module that is built by default, you can disable it by nami Many NGINX modules are not built by default, and must be listed on the `configure` command line to be built. -The [mail](https://nginx.org/en/docs/mail/ngx_mail_core_module.html), [stream](https://nginx.org/en/docs/stream/ngx_stream_core_module.html), [geoip](https://nginx.org/en/docs/http/ngx_http_geoip_module.html), [image_filter](https://nginx.org/en/docs/http/ngx_http_image_filter_module.html), [perl](https://nginx.org/en/docs/http/ngx_http_perl_module.html) and [xslt](https://nginx.org/en/docs/http/ngx_http_xslt_module.html) modules can be compiled as dynamic. See [Dynamic Modules]({{< relref "../dynamic-modules/dynamic-modules.md" >}}) for details. +The [mail](https://nginx.org/en/docs/mail/ngx_mail_core_module.html), [stream](https://nginx.org/en/docs/stream/ngx_stream_core_module.html), [geoip](https://nginx.org/en/docs/http/ngx_http_geoip_module.html), [image_filter](https://nginx.org/en/docs/http/ngx_http_image_filter_module.html), [perl](https://nginx.org/en/docs/http/ngx_http_perl_module.html) and [xslt](https://nginx.org/en/docs/http/ngx_http_xslt_module.html) modules can be compiled as dynamic. See [Dynamic Modules]({{< ref "nginx/admin-guide/dynamic-modules/dynamic-modules.md" >}}) for details. An example of the `configure` command that includes nondefault modules (should be typed as a single line): diff --git a/content/nginx/admin-guide/load-balancer/dynamic-configuration-api.md b/content/nginx/admin-guide/load-balancer/dynamic-configuration-api.md index ad327a68b..742d40381 100644 --- a/content/nginx/admin-guide/load-balancer/dynamic-configuration-api.md +++ b/content/nginx/admin-guide/load-balancer/dynamic-configuration-api.md @@ -21,7 +21,7 @@ With F5 NGINX Plus, configuration of upstream servers in a server group can be m These changes are made with the NGINX Plus REST API interface with API commands. -> **Note:** In NGINX Plus Release 12 (R12) and earlier, dynamic configuration was performed with the `upstream_conf` handler. That API (and the extended `status` API) are now deprecated in favor of the NGINX Plus API. +> **Note:** In NGINX Plus [Release 12]({{< ref "nginx/releases.md#r12" >}}) and earlier, dynamic configuration was performed with the `upstream_conf` handler. That API (and the extended `status` API) are now deprecated in favor of the NGINX Plus API. @@ -29,7 +29,7 @@ These changes are made with the NGINX Plus REST API interface with API commands. Prior to using the dynamic configuration feature, make sure that you have the following environment: -1. NGINX Plus R13 or later +1. NGINX Plus [R13]({{< ref "nginx/releases.md#r13" >}}) or later 2. You have created upstream groups of application or web servers, as described in [HTTP Load Balancing]({{< ref "http-load-balancer.md" >}}) and [TCP/UDP Load Balancing]({{< ref "tcp-udp-load-balancer.md" >}}) 3. Upstream server groups reside in the shared memory zone, as described in [Sharing Data with Multiple Worker Processes]({{< ref "http-load-balancer.md" >}}) diff --git a/content/nginx/admin-guide/load-balancer/http-health-check.md b/content/nginx/admin-guide/load-balancer/http-health-check.md index 1ff8a0642..49dbb1b4d 100644 --- a/content/nginx/admin-guide/load-balancer/http-health-check.md +++ b/content/nginx/admin-guide/load-balancer/http-health-check.md @@ -19,7 +19,7 @@ NGINX and F5 NGINX Plus can continually test your upstream servers, avoid the se ## Prerequisites - For passive health checks, [NGINX Open Source](https://nginx.org/en/) or [NGINX Plus](https://www.nginx.com/products/nginx) -- For active health checks and the [live activity monitoring dashboard]({{< relref "../monitoring/live-activity-monitoring.md" >}}), NGINX Plus +- For active health checks and the [live activity monitoring dashboard]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}), NGINX Plus - A load‑balanced group of [HTTP upstream servers]({{< ref "http-load-balancer.md" >}}) diff --git a/content/nginx/admin-guide/load-balancer/http-load-balancer.md b/content/nginx/admin-guide/load-balancer/http-load-balancer.md index e3ef4ddb4..a01b69aed 100644 --- a/content/nginx/admin-guide/load-balancer/http-load-balancer.md +++ b/content/nginx/admin-guide/load-balancer/http-load-balancer.md @@ -262,7 +262,7 @@ NGINX Plus supports three session persistence methods. The methods are set with } ``` - See [Runtime State Sharing in a Cluster]({{< relref "../high-availability/zone_sync.md" >}}) for details. + See [Runtime State Sharing in a Cluster]({{< ref "nginx/admin-guide/high-availability/zone_sync.md" >}}) for details. @@ -290,7 +290,7 @@ Note that the `max_conns` limit is ignored if there are idle [`keepalive`](https NGINX can continually test your HTTP upstream servers, avoid the servers that have failed, and gracefully add the recovered servers into the load‑balanced group. -See [HTTP Health Checks]({{< relref "./http-health-check.md" >}}) for instructions how to configure health checks for HTTP. +See [HTTP Health Checks]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}) for instructions how to configure health checks for HTTP. diff --git a/content/nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md b/content/nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md index 258a5cf87..a7a6a7f61 100644 --- a/content/nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md +++ b/content/nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md @@ -14,9 +14,9 @@ type: [Load balancing](https://www.nginx.com/solutions/load-balancing/) refers to efficiently distributing network traffic across multiple backend servers. -In F5 NGINX Plus Release 5 and later, NGINX Plus can proxy and load balance Transmission Control Protocol) (TCP) traffic. TCP is the protocol for many popular applications and services, such as LDAP, MySQL, and RTMP. +In F5 NGINX Plus [R5]({{< ref "nginx/releases.md#r5" >}}) and later, NGINX Plus can proxy and load balance Transmission Control Protocol) (TCP) traffic. TCP is the protocol for many popular applications and services, such as LDAP, MySQL, and RTMP. -In NGINX Plus Release 9 and later, NGINX Plus can proxy and load balance UDP traffic. UDP (User Datagram Protocol) is the protocol for many popular non-transactional applications, such as DNS, syslog, and RADIUS. +In NGINX Plus [R9]({{< ref "nginx/releases.md#r9" >}}) and later, NGINX Plus can proxy and load balance UDP traffic. UDP (User Datagram Protocol) is the protocol for many popular non-transactional applications, such as DNS, syslog, and RADIUS. To load balance HTTP traffic, refer to the [HTTP Load Balancing]({{< ref "http-load-balancer.md" >}}) article. @@ -255,9 +255,9 @@ stream { NGINX can continually test your TCP or UDP upstream servers, avoid the servers that have failed, and gracefully add the recovered servers into the load‑balanced group. -See [TCP Health Checks]({{< relref "./tcp-health-check.md" >}}) for instructions how to configure health checks for TCP. +See [TCP Health Checks]({{< ref "nginx/admin-guide/load-balancer/tcp-health-check.md" >}}) for instructions how to configure health checks for TCP. -See [UDP Health Checks]({{< relref "./udp-health-check.md" >}}) for instructions how to configure health checks for UDP. +See [UDP Health Checks]({{< ref "nginx/admin-guide/load-balancer/udp-health-check.md" >}}) for instructions how to configure health checks for UDP. ## On-the-Fly Configuration diff --git a/content/nginx/admin-guide/load-balancer/udp-health-check.md b/content/nginx/admin-guide/load-balancer/udp-health-check.md index 79a0456ba..bb4818fd4 100644 --- a/content/nginx/admin-guide/load-balancer/udp-health-check.md +++ b/content/nginx/admin-guide/load-balancer/udp-health-check.md @@ -42,7 +42,7 @@ type: } ``` - See [TCP and UDP Load Balancing]({{< relref "../load-balancer/tcp-udp-load-balancer.md" >}}) for details. + See [TCP and UDP Load Balancing]({{< ref "nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md" >}}) for details. ## Passive UDP Health Checks diff --git a/content/nginx/admin-guide/load-balancer/using-proxy-protocol.md b/content/nginx/admin-guide/load-balancer/using-proxy-protocol.md index 6ea9fee95..a1dee5b92 100644 --- a/content/nginx/admin-guide/load-balancer/using-proxy-protocol.md +++ b/content/nginx/admin-guide/load-balancer/using-proxy-protocol.md @@ -28,15 +28,15 @@ Using this data, NGINX can get the originating IP address of the client in sever ## Prerequisites -- To accept the PROXY protocol v2, NGINX Plus R16 and later or NGINX Open Source [1.13.11](https://nginx.org/en/CHANGES) and later +- To accept the PROXY protocol v2, NGINX Plus [R16]({{< ref "nginx/releases.md#r16" >}}) and later or NGINX Open Source [1.13.11](https://nginx.org/en/CHANGES) and later -- To accept the PROXY protocol for HTTP, NGINX Plus R3 and later or NGINX Open Source [1.5.12](https://nginx.org/en/CHANGES) and later +- To accept the PROXY protocol for HTTP, NGINX Plus [R3]({{< ref "nginx/releases.md#r3" >}}) and later or NGINX Open Source [1.5.12](https://nginx.org/en/CHANGES) and later -- For TCP client‑side PROXY protocol support, NGINX Plus R7 and later or NGINX Open Source [1.9.3](https://nginx.org/en/CHANGES) and later +- For TCP client‑side PROXY protocol support, NGINX Plus [R7]({{< ref "nginx/releases.md#r7" >}}) and later or NGINX Open Source [1.9.3](https://nginx.org/en/CHANGES) and later -- To accept the PROXY protocol for TCP, NGINX Plus R11 and later or NGINX Open Source [1.11.4](https://nginx.org/en/CHANGES) and later +- To accept the PROXY protocol for TCP, NGINX Plus [R11]({{< ref "nginx/releases.md#r11" >}}) and later or NGINX Open Source [1.11.4](https://nginx.org/en/CHANGES) and later -- The Real‑IP modules for [HTTP](https://nginx.org/en/docs/http/ngx_http_realip_module.html) and [Stream TCP](https://nginx.org/en/docs/stream/ngx_stream_realip_module.html) are not included in NGINX Open Source by default; see [Installing NGINX Open Source]({{< relref "../installing-nginx/installing-nginx-open-source.md" >}}) for details. No extra steps are required for NGINX Plus. +- The Real‑IP modules for [HTTP](https://nginx.org/en/docs/http/ngx_http_realip_module.html) and [Stream TCP](https://nginx.org/en/docs/stream/ngx_stream_realip_module.html) are not included in NGINX Open Source by default; see [Installing NGINX Open Source]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-open-source.md" >}}) for details. No extra steps are required for NGINX Plus. @@ -81,7 +81,7 @@ To change the IP address from the load balancer's IP address to the client's IP nginx -V 2>&1 | grep -- 'stream_realip_module' ``` - If not, recompile NGINX with these modules. See [Installing NGINX Open Source]({{< relref "../installing-nginx/installing-nginx-open-source.md" >}}) for details. No extra steps are required for NGINX Plus. + If not, recompile NGINX with these modules. See [Installing NGINX Open Source]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-open-source.md" >}}) for details. No extra steps are required for NGINX Plus. 3. In the `set_real_ip_from` directive for [HTTP](https://nginx.org/en/docs/http/ngx_http_realip_module.html#set_real_ip_from), [Stream](https://nginx.org/en/docs/stream/ngx_stream_realip_module.html#set_real_ip_from), or both, specify the IP address or the CIDR range of addresses of the TCP proxy or load balancer: diff --git a/content/nginx/admin-guide/monitoring/debugging.md b/content/nginx/admin-guide/monitoring/debugging.md index 6e0f45bdf..91125e718 100644 --- a/content/nginx/admin-guide/monitoring/debugging.md +++ b/content/nginx/admin-guide/monitoring/debugging.md @@ -22,7 +22,7 @@ First, you will need to enable debugging in NGINX binary. NGINX Plus already pr ### Configuring F5 NGINX Plus Binary -Starting from [Release 8]({{< relref "../../releases.md" >}}), NGINX Plus ships the _nginx-debug_ binary together with the standard binary. To enable debugging in NGINX Plus, you will need to switch from _nginx_ to _nginx-debug_ binary. Open terminal and run the command: +Starting from [Release 8]({{< ref "nginx/releases.md" >}}), NGINX Plus ships the _nginx-debug_ binary together with the standard binary. To enable debugging in NGINX Plus, you will need to switch from _nginx_ to _nginx-debug_ binary. Open terminal and run the command: ```shell service nginx stop && service nginx-debug start @@ -37,7 +37,7 @@ To enable debugging in NGINX Open Source, you will need to recompile it with th To compile NGINX Open Source with the debug support: -1. Download and unpack NGINX source files, go to the directory with the source files. See [Downloading the Sources]({{< relref "../installing-nginx/installing-nginx-open-source.md" >}}). +1. Download and unpack NGINX source files, go to the directory with the source files. See [Downloading the Sources]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-open-source.md" >}}). 2. Get the list of NGINX configure arguments. Run the command: ```shell diff --git a/content/nginx/admin-guide/monitoring/live-activity-monitoring.md b/content/nginx/admin-guide/monitoring/live-activity-monitoring.md index 0715c089a..8e15e9cd2 100644 --- a/content/nginx/admin-guide/monitoring/live-activity-monitoring.md +++ b/content/nginx/admin-guide/monitoring/live-activity-monitoring.md @@ -19,11 +19,11 @@ This article describes how to configure and use runtime monitoring services in N NGINX Plus provides various monitoring tools for your server infrastructure: -- the interactive Dashboard page available since NGINX Plus Release 9 - a real-time live activity monitoring interface that shows key load and performance metrics of your server infrastructure. +- the interactive Dashboard page available since NGINX Plus [Release 9]({{< ref "nginx/releases.md#r9" >}}) - a real-time live activity monitoring interface that shows key load and performance metrics of your server infrastructure. -- NGINX REST API available since NGINX Plus Release 14 - an interface that can obtain extended status information, reset statistics, manage upstream servers on-the-fly, and manage key-value store. With the API you can connect NGINX Plus status information with third-party tools that support the JSON interface, for example, NewRelic or your own dashboard. +- NGINX REST API available since NGINX Plus [Release 14]({{< ref "nginx/releases.md#r14" >}}) - an interface that can obtain extended status information, reset statistics, manage upstream servers on-the-fly, and manage key-value store. With the API you can connect NGINX Plus status information with third-party tools that support the JSON interface, for example, NewRelic or your own dashboard. - > **Note**: Prior to NGINX Plus R14, gathering statistics and management of upstream servers in the Dashboard was performed with the [status](https://nginx.org/en/docs/http/ngx_http_status_module.html#status) and [upstream_conf](https://nginx.org/en/docs/http/ngx_http_upstream_conf_module.html) modules. Now the extended [status](https://nginx.org/en/docs/http/ngx_http_status_module.html#status) and [upstream_conf](https://nginx.org/en/docs/http/ngx_http_upstream_conf_module.html) modules are superseded by the [api](https://nginx.org/en/docs/http/ngx_http_api_module.html) module. Starting from R16, the [status](https://nginx.org/en/docs/http/ngx_http_status_module.html#status) and [upstream_conf](https://nginx.org/en/docs/http/ngx_http_upstream_conf_module.html) modules will be removed and completely superseded with the [api](https://nginx.org/en/docs/http/ngx_http_api_module.html) module. + > **Note**: Prior to NGINX Plus [R14]({{< ref "nginx/releases.md#r14" >}}), gathering statistics and management of upstream servers in the Dashboard was performed with the [status](https://nginx.org/en/docs/http/ngx_http_status_module.html#status) and [upstream_conf](https://nginx.org/en/docs/http/ngx_http_upstream_conf_module.html) modules. Now the extended [status](https://nginx.org/en/docs/http/ngx_http_status_module.html#status) and [upstream_conf](https://nginx.org/en/docs/http/ngx_http_upstream_conf_module.html) modules are superseded by the [api](https://nginx.org/en/docs/http/ngx_http_api_module.html) module. Starting from R16, the [status](https://nginx.org/en/docs/http/ngx_http_status_module.html#status) and [upstream_conf](https://nginx.org/en/docs/http/ngx_http_upstream_conf_module.html) modules will be removed and completely superseded with the [api](https://nginx.org/en/docs/http/ngx_http_api_module.html) module. * * * @@ -34,7 +34,7 @@ NGINX Plus provides various monitoring tools for your server infrastructure: ## Prerequisites -- NGINX Plus R14 and later for NGINX Plus REST API and the Dashboard +- NGINX Plus [R14]({{< ref "nginx/releases.md#r14" >}}) and later for NGINX Plus REST API and the Dashboard - Data for statistics (see [Gathering Data to Appear in Statistics](#status_data)) @@ -42,7 +42,7 @@ NGINX Plus provides various monitoring tools for your server infrastructure: In order to collect data from virtual servers, upstream server groups, or cache zones, you will need to *enable shared memory zones* for the objects you want to collect data for. A shared memory zone stores configuration and runtime state information referenced by NGINX worker processes. -- To make [HTTP]({{< relref "../load-balancer/http-load-balancer.md" >}}) and [TCP]({{< relref "../load-balancer/tcp-udp-load-balancer.md" >}}) server to appear in statistics, specify the [`status_zone`](https://nginx.org/en/docs/http/ngx_http_api_module.html#status_zone) directive. The same zone name can be specified more than once for many [`server`](https://nginx.org/en/docs/http/ngx_http_core_module.html#server) blocks. Since R19, the [status_zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#status_zone) directive can also be specified for [`location`](https://nginx.org/en/docs/http/ngx_http_core_module.html#location) blocks - in this case, the statistics will be aggregated separately for servers and locations in the Dashboard: +- To make [HTTP]({{< ref "nginx/admin-guide/load-balancer/http-load-balancer.md" >}}) and [TCP]({{< ref "nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md" >}}) server to appear in statistics, specify the [`status_zone`](https://nginx.org/en/docs/http/ngx_http_api_module.html#status_zone) directive. The same zone name can be specified more than once for many [`server`](https://nginx.org/en/docs/http/ngx_http_core_module.html#server) blocks. Since [R19]({{< ref "nginx/releases.md#r19" >}}), the [status_zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#status_zone) directive can also be specified for [`location`](https://nginx.org/en/docs/http/ngx_http_core_module.html#location) blocks - in this case, the statistics will be aggregated separately for servers and locations in the Dashboard: ```nginx server { @@ -65,7 +65,7 @@ In order to collect data from virtual servers, upstream server groups, or cache } ``` -- To make cache appear in statistics, make sure that caching is enabled in your configuration. A shared memory zone for caching is specified in the [`proxy_cache_path`](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path), [`fastcgi_cache_path`](https://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_cache_path), [`scgi_cache_path`](https://nginx.org/en/docs/http/ngx_http_scgi_module.html#scgi_cache_path), or [`uwsgi_cache_path`](https://nginx.org/en/docs/http/ngx_http_uwsgi_module.html#uwsgi_cache_path">uwsgi_cache_path) directive in the `keys_zone` parameter. See [NGINX Content Caching]({{< relref "../content-cache/content-caching.md" >}}) for more information: +- To make cache appear in statistics, make sure that caching is enabled in your configuration. A shared memory zone for caching is specified in the [`proxy_cache_path`](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path), [`fastcgi_cache_path`](https://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_cache_path), [`scgi_cache_path`](https://nginx.org/en/docs/http/ngx_http_scgi_module.html#scgi_cache_path), or [`uwsgi_cache_path`](https://nginx.org/en/docs/http/ngx_http_uwsgi_module.html#uwsgi_cache_path">uwsgi_cache_path) directive in the `keys_zone` parameter. See [NGINX Content Caching]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) for more information: ```nginx http { @@ -74,7 +74,7 @@ In order to collect data from virtual servers, upstream server groups, or cache } ``` -- To make health checks appear in statistics, make sure that health checks are enabled with the [`health_check`](https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html) directive and the server group resides in the [shared memory](https://nginx.org/en/docs/http/ngx_http_api_module.html#status_zone). See [HTTP Health Checks]({{< relref "../load-balancer/http-health-check.md" >}}) and [TCP Health Checks]({{< ref "/nginx/admin-guide/load-balancer/tcp-health-check.md" >}}) for more information. +- To make health checks appear in statistics, make sure that health checks are enabled with the [`health_check`](https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html) directive and the server group resides in the [shared memory](https://nginx.org/en/docs/http/ngx_http_api_module.html#status_zone). See [HTTP Health Checks]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}) and [TCP Health Checks]({{< ref "nginx/admin-guide/load-balancer/tcp-health-check.md" >}}) for more information. ```nginx server { @@ -137,7 +137,7 @@ To enable the API: } ``` -- In order to make changes with the API, such as [resetting statistics counters](#json_delete), managing [upstream servers on-the-fly]({{< relref "../load-balancer/dynamic-configuration-api.md" >}}) or [key-value storage]({{< ref "/nginx/admin-guide/security-controls/denylisting-ip-addresses.md" >}}), managing upstream servers from the [Dashboard](#dashboard_upstream), enable the read-write mode for the API by specifying the `write=on` parameter for the [`api`](https://nginx.org/en/docs/http/ngx_http_api_module.html#api) directive: +- In order to make changes with the API, such as [resetting statistics counters](#json_delete), managing [upstream servers on-the-fly]({{< ref "nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) or [key-value storage]({{< ref "/nginx/admin-guide/security-controls/denylisting-ip-addresses.md" >}}), managing upstream servers from the [Dashboard](#dashboard_upstream), enable the read-write mode for the API by specifying the `write=on` parameter for the [`api`](https://nginx.org/en/docs/http/ngx_http_api_module.html#api) directive: ```nginx http { @@ -285,7 +285,7 @@ The **HTTP Upstreams** tab provides information about each upstream group for HT ![The 'Upstreams' tab on the NGINX Plus live activity monitoring dashboard provides information about the servers in each upstream group for HTTP/HTTPS traffic](/nginx/images/dashboard-tab-http-upstreams.png) -The **Caches** tab provides statistics about the caches configured in NGINX Plus. For NGINX Plus to collect information for an upstream group, you must [configure cache]({{< relref "../content-cache/content-caching.md" >}}). +The **Caches** tab provides statistics about the caches configured in NGINX Plus. For NGINX Plus to collect information for an upstream group, you must [configure cache]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}). ![The 'Caches' tab in the NGINX Plus live activity monitoring dashboard provides information about cache readiness, fullness, and hit ratio](/nginx/images/dashboard-tab-caches.png) @@ -345,7 +345,7 @@ You can configure the threshold for Dashboard warnings and alerts by clicking th ## Using the REST API -With NGINX Plus, statistics of your server infrastructure can be managed with the REST API interface. The API is based on standard HTTP requests: statistics can be obtained with `GET` requests and reset with `DELETE` requests. Upstream servers can be added with `POST` requests and modified with `PATCH` requests. See [Managing Upstream Servers with the API]({{< relref "../load-balancer/dynamic-configuration-api.md" >}}) for more information. +With NGINX Plus, statistics of your server infrastructure can be managed with the REST API interface. The API is based on standard HTTP requests: statistics can be obtained with `GET` requests and reset with `DELETE` requests. Upstream servers can be added with `POST` requests and modified with `PATCH` requests. See [Managing Upstream Servers with the API]({{< ref "nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) for more information. The requests are sent in the JSON format that allows you to connect the stats to monitoring tools or dashboards that support JSON. @@ -502,7 +502,7 @@ NGINX Plus allows you to explore the REST API documentation and send API command The main purpose of Swagger UI and the YAML OpenAPI spec is to document and visualize NGINX API commands. For security reasons it is not recommended using it in a production environment. -Prior to [NGINX Plus Release 25](https://docs.nginx.com/nginx/releases/#nginxplusrelease-25-r25), the Swagger UI was shipped together with NGINX Plus packages. Since [NGINX Plus Release 26](https://docs.nginx.com/nginx/releases/#nginxplusrelease-26-r26), the OpenAPI YAML specification and the Swagger UI is published separately, below. +Prior to NGINX Plus [Release 25]({{< ref "nginx/releases.md#r25" >}}), the Swagger UI was shipped together with NGINX Plus packages. Since NGINX Plus [Release 26]({{< ref "nginx/releases.md#r26" >}}), the OpenAPI YAML specification and the Swagger UI is published separately, below. Alternatively, copy the link to the appropriate YAML file, and import into your preferred OpenAPI v2 tool. diff --git a/content/nginx/admin-guide/monitoring/logging.md b/content/nginx/admin-guide/monitoring/logging.md index 80da2d832..cc6c3b258 100644 --- a/content/nginx/admin-guide/monitoring/logging.md +++ b/content/nginx/admin-guide/monitoring/logging.md @@ -205,6 +205,6 @@ The `severity=` parameter sets the severity level of syslog messages for access ## Live Activity Monitoring -NGINX Plus provides a real-time live activity monitoring interface that shows key load and performance metrics of your [HTTP]({{< relref "../load-balancer/http-load-balancer.md" >}}) and [TCP]({{< relref "../load-balancer/tcp-udp-load-balancer.md" >}}) upstream servers. See the [Live Activity Monitoring]({{< ref "live-activity-monitoring.md" >}}) article for more information. +NGINX Plus provides a real-time live activity monitoring interface that shows key load and performance metrics of your [HTTP]({{< ref "nginx/admin-guide/load-balancer/http-load-balancer.md" >}}) and [TCP]({{< ref "nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md" >}}) upstream servers. See the [Live Activity Monitoring]({{< ref "live-activity-monitoring.md" >}}) article for more information. To learn more about NGINX Plus, please visit the [Products](https://www.nginx.com/products/) page. diff --git a/content/nginx/admin-guide/security-controls/configuring-jwt-authentication.md b/content/nginx/admin-guide/security-controls/configuring-jwt-authentication.md index 8ebc39d18..bde080030 100644 --- a/content/nginx/admin-guide/security-controls/configuring-jwt-authentication.md +++ b/content/nginx/admin-guide/security-controls/configuring-jwt-authentication.md @@ -17,12 +17,12 @@ With F5 NGINX Plus it is possible to control access to your resources using JWT ## Prerequisites -- NGINX Plus Release 10 (R10) for native [JWT support](https://www.nginx.com/blog/nginx-plus-r10-released/#r10-jwt) -- NGINX Plus Release 14 (R14) for access to [nested JWT claims and longer signing keys](https://www.nginx.com/blog/nginx-plus-r14-released/#jwt) -- NGINX Plus Release 17 (R17) for [getting JSON Web keys from a remote location](https://www.nginx.com/blog/nginx-plus-r17-released/#r17-openid) -- NGINX Plus Release 24 (R24) for support of encrypted tokens (JWE) -- NGINX Plus Release 25 (R25) for support of Nested JWT, multiple sources of JSON Web keys, condition-based JWT authentication -- NGINX Plus Release 26 (R26) for support of [JWT key caching](https://nginx.org/en/docs/http/ngx_http_auth_jwt_module.html#auth_jwt_key_cache) +- NGINX Plus [Release 10]({{< ref "nginx/releases.md#r10" >}}) (R10) for native [JWT support](https://www.nginx.com/blog/nginx-plus-r10-released/#r10-jwt) +- NGINX Plus [Release 14]({{< ref "nginx/releases.md#r14" >}}) for access to [nested JWT claims and longer signing keys](https://www.nginx.com/blog/nginx-plus-r14-released/#jwt) +- NGINX Plus [Release 17]({{< ref "nginx/releases.md#r17" >}}) for [getting JSON Web keys from a remote location](https://www.nginx.com/blog/nginx-plus-r17-released/#r17-openid) +- NGINX Plus [Release 24]({{< ref "nginx/releases.md#r24" >}}) (R24) for support of encrypted tokens (JWE) +- NGINX Plus [Release 25]({{< ref "nginx/releases.md#r25" >}}) (R25) for support of Nested JWT, multiple sources of JSON Web keys, condition-based JWT authentication +- NGINX Plus [Release 26]({{< ref "nginx/releases.md#r26" >}}) (R26) for support of [JWT key caching](https://nginx.org/en/docs/http/ngx_http_auth_jwt_module.html#auth_jwt_key_cache) - An identity provider (IdP) or service that creates JWT. For manual JWT generation, see "Issuing a JWT to API Clients" section of the [Authenticating API Clients with JWT and NGINX Plus](https://www.nginx.com/blog/authenticating-api-clients-jwt-nginx-plus/) blog post. diff --git a/content/nginx/admin-guide/security-controls/controlling-access-by-geoip.md b/content/nginx/admin-guide/security-controls/controlling-access-by-geoip.md index 1533c497b..5432bbb9e 100644 --- a/content/nginx/admin-guide/security-controls/controlling-access-by-geoip.md +++ b/content/nginx/admin-guide/security-controls/controlling-access-by-geoip.md @@ -16,7 +16,7 @@ F5 NGINX Plus can differentiate users based on their geographical location. For NGINX Plus uses third-party MaxMind databases to match the IP address of the user and its location. As soon as the geoposition is known, it is then possible to use geoip-based variables in the [map](https://nginx.org/en/docs/http/ngx_http_map_module.html) or the [split_clients](https://nginx.org/en/docs/http/ngx_http_split_clients_module.html) module. -> **Note** MaxMind GeoLite Legacy databases are currently [discontinued](https://blog.maxmind.com/2018/01/discontinuation-of-the-geolite-legacy-databases), MaxMind GeoIP2 or GeoLite2 databases and NGINX Plus [GeoIP2 module]({{< relref "../dynamic-modules/geoip2.md" >}}) should be used instead. +> **Note** MaxMind GeoLite Legacy databases are currently [discontinued](https://blog.maxmind.com/2018/01/discontinuation-of-the-geolite-legacy-databases), MaxMind GeoIP2 or GeoLite2 databases and NGINX Plus [GeoIP2 module]({{< ref "nginx/admin-guide/dynamic-modules/geoip2.md" >}}) should be used instead. Restricting by geographical location works both for HTTP and TCP/UDP protocols. @@ -24,7 +24,7 @@ Restricting by geographical location works both for HTTP and TCP/UDP protocols. ## Prerequisites -- NGINX Plus [GeoIP2 dynamic module]({{< relref "../dynamic-modules/geoip2.md" >}}) +- NGINX Plus [GeoIP2 dynamic module]({{< ref "nginx/admin-guide/dynamic-modules/geoip2.md" >}}) - [GeoIP2](https://www.maxmind.com/en/geoip2-databases) or [GeoLite2](https://dev.maxmind.com/geoip/geoip2/geolite2/) databases from MaxMind - (optional) [mmdblookup](http://maxmind.github.io/libmaxminddb/mmdblookup.html) utility that looks up an IP address in a MaxMind Database file @@ -269,7 +269,7 @@ Using the geolocation data from the created variables, a client connection can b This can be achieved by using the continent code from the GeoIP2 database in a variable and the [map](https://nginx.org/en/docs/http/ngx_http_map_module.html) module that will create another variable whose value will be the closest server basing on a continent location. Basing on this value, NGINX will pass the request to the corresponding upstream server group. -1. Make sure you have configured the servers or [upstream server groups]({{< relref "../load-balancer/http-load-balancer.md" >}}) for each continent, for example, `eu` for Europe, `na` for North America, `all` for cases when the IP address cannot be matched against the GeoIP database: +1. Make sure you have configured the servers or [upstream server groups]({{< ref "nginx/admin-guide/load-balancer/http-load-balancer.md" >}}) for each continent, for example, `eu` for Europe, `na` for North America, `all` for cases when the IP address cannot be matched against the GeoIP database: ```nginx upstream all { diff --git a/content/nginx/admin-guide/security-controls/controlling-access-proxied-http.md b/content/nginx/admin-guide/security-controls/controlling-access-proxied-http.md index 706f1e825..a135c60cf 100644 --- a/content/nginx/admin-guide/security-controls/controlling-access-proxied-http.md +++ b/content/nginx/admin-guide/security-controls/controlling-access-proxied-http.md @@ -224,7 +224,7 @@ http { } ``` -See [Runtime State Sharing in a Cluster]({{< relref "../high-availability/zone_sync.md" >}}) for details. +See [Runtime State Sharing in a Cluster]({{< ref "nginx/admin-guide/high-availability/zone_sync.md" >}}) for details. diff --git a/content/nginx/admin-guide/security-controls/denylisting-ip-addresses.md b/content/nginx/admin-guide/security-controls/denylisting-ip-addresses.md index fc4373fa7..d7e68d231 100644 --- a/content/nginx/admin-guide/security-controls/denylisting-ip-addresses.md +++ b/content/nginx/admin-guide/security-controls/denylisting-ip-addresses.md @@ -14,15 +14,15 @@ This section describes how to create a denylist or allowlist of specific client ## Overview -In F5 NGINX Plus Release 13 (R13) and later, you can denylist some IP addresses as well as create and maintain a database of denylisted IP addresses. You can also explicitly allowlist other IP addresses. The IP addresses database is managed with the NGINX Plus API and keyval modules. +In F5 NGINX Plus [Release 13]({{< ref "nginx/releases.md#r13" >}}) (R13) and later, you can denylist some IP addresses as well as create and maintain a database of denylisted IP addresses. You can also explicitly allowlist other IP addresses. The IP addresses database is managed with the NGINX Plus API and keyval modules. -NGINX Plus Release 19 (R19) extends this capability by matching an IP address to any address within a subnet or network range. +NGINX Plus [Release 19]({{< ref "nginx/releases.md#r19" >}}) extends this capability by matching an IP address to any address within a subnet or network range. ## Prerequisites -NGINX Plus Release 13 and later, NGINX Plus Release 19 and later for network ranges support. +NGINX Plus [Release 13]({{< ref "nginx/releases.md#r13" >}}) and later, NGINX Plus [Release 19]({{< ref "nginx/releases.md#r19" >}}) and later for network ranges support. ## Setup diff --git a/content/nginx/admin-guide/security-controls/securing-http-traffic-upstream.md b/content/nginx/admin-guide/security-controls/securing-http-traffic-upstream.md index eadf93b27..93ebefb11 100644 --- a/content/nginx/admin-guide/security-controls/securing-http-traffic-upstream.md +++ b/content/nginx/admin-guide/security-controls/securing-http-traffic-upstream.md @@ -15,7 +15,7 @@ This article explains how to encrypt HTTP traffic between NGINX and a upstream g ## Prerequisites - [NGINX Open Source](https://nginx.org/en/download.html) or [F5 NGINX Plus](https://nginx.com/products/) -- A [proxied server]({{< relref "../web-server/reverse-proxy.md" >}}) or an [upstream group of servers]({{< relref "../load-balancer/http-load-balancer.md" >}}) +- A [proxied server]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) or an [upstream group of servers]({{< ref "nginx/admin-guide/load-balancer/http-load-balancer.md" >}}) - SSL certificates and a private key ## Obtaining SSL Server Certificates diff --git a/content/nginx/admin-guide/security-controls/securing-tcp-traffic-upstream.md b/content/nginx/admin-guide/security-controls/securing-tcp-traffic-upstream.md index 8bcd38a95..69cdb80ff 100644 --- a/content/nginx/admin-guide/security-controls/securing-tcp-traffic-upstream.md +++ b/content/nginx/admin-guide/security-controls/securing-tcp-traffic-upstream.md @@ -13,8 +13,8 @@ This article explains how to secure TCP traffic between NGINX and a TCP upstream ## Prerequisites -- F5 NGINX Plus [R6]({{< relref "../../releases.md" >}}) and later or the latest NGINX Open Source compiled with the `--with-stream` and `with-stream_ssl_module` configuration parameters -- A proxied TCP server or an [upstream group of TCP servers]({{< relref "../load-balancer/tcp-udp-load-balancer.md" >}}) +- F5 NGINX Plus [R6]({{< ref "nginx/releases.md" >}}) and later or the latest NGINX Open Source compiled with the `--with-stream` and `with-stream_ssl_module` configuration parameters +- A proxied TCP server or an [upstream group of TCP servers]({{< ref "nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md" >}}) - SSL certificates and a private key ## Obtaining SSL Server Certificates diff --git a/content/nginx/admin-guide/security-controls/terminating-ssl-tcp.md b/content/nginx/admin-guide/security-controls/terminating-ssl-tcp.md index a6a247b97..bf7ab028f 100644 --- a/content/nginx/admin-guide/security-controls/terminating-ssl-tcp.md +++ b/content/nginx/admin-guide/security-controls/terminating-ssl-tcp.md @@ -18,8 +18,8 @@ SSL termination means that NGINX Plus acts as the server-side SSL endpoint for ## Prerequisites -- [NGINX Plus R6]({{< relref "../../releases.md#r6 " >}}) or later -- A load-balanced [upstream group]({{< relref "../load-balancer/tcp-udp-load-balancer.md" >}}) with several TCP servers +- [NGINX Plus R6]({{< ref "nginx/releases.md#r6 " >}}) or later +- A load-balanced [upstream group]({{< ref "nginx/admin-guide/load-balancer/tcp-udp-load-balancer.md" >}}) with several TCP servers - SSL certificates and a private key (obtained or self-generated) ## Obtaining SSL Certificates diff --git a/content/nginx/admin-guide/web-server/app-gateway-uwsgi-django.md b/content/nginx/admin-guide/web-server/app-gateway-uwsgi-django.md index 3b84b6811..8799291e9 100644 --- a/content/nginx/admin-guide/web-server/app-gateway-uwsgi-django.md +++ b/content/nginx/admin-guide/web-server/app-gateway-uwsgi-django.md @@ -14,7 +14,7 @@ This article explains how to use NGINX or F5 NGINX Plus as an application gatew ## Introduction -NGINX is a high‑performance, scalable, secure, and reliable web server and a reverse proxy. NGINX enables all the main web acceleration techniques for managing HTTP connections and traffic. For many years, NGINX capabilities such as [load balancing]({{< relref "../load-balancer/http-load-balancer.md" >}}), [SSL termination]({{< relref "../security-controls/terminating-ssl-http.md" >}}), connection and request [policing]({{< relref "../security-controls/controlling-access-proxied-http.md" >}}), static [content offload]({{< relref "../web-server/serving-static-content.md" >}}), and [content caching]({{< relref "../content-cache/content-caching.md" >}}) have helped NGINX users to build reliable and fast websites quickly and efficiently. +NGINX is a high‑performance, scalable, secure, and reliable web server and a reverse proxy. NGINX enables all the main web acceleration techniques for managing HTTP connections and traffic. For many years, NGINX capabilities such as [load balancing]({{< ref "nginx/admin-guide/load-balancer/http-load-balancer.md" >}}), [SSL termination]({{< relref "../security-controls/terminating-ssl-http.md" >}}), connection and request [policing]({{< relref "../security-controls/controlling-access-proxied-http.md" >}}), static [content offload]({{< relref "../web-server/serving-static-content.md" >}}), and [content caching]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) have helped NGINX users to build reliable and fast websites quickly and efficiently. NGINX can also act as a secure application gateway, offering a number of specialized built‑in interfaces to pass traffic from users to applications. In this regard, not only can NGINX proxy HTTP and HTTPS traffic to an HTTP‑enabled application container, it can also directly talk to most of the popular lightweight application servers and web frameworks via optimized app‑gateway interfaces implemented in modules like [FastCGI](https://nginx.org/en/docs/http/ngx_http_fastcgi_module.html), [Memcached](https://nginx.org/en/docs/http/ngx_http_memcached_module.html), [scgi](https://nginx.org/en/docs/http/ngx_http_scgi_module.html), and [uwsgi](https://nginx.org/en/docs/http/ngx_http_uwsgi_module.html). diff --git a/content/nginx/deployment-guides/amazon-web-services/high-availability-keepalived.md b/content/nginx/deployment-guides/amazon-web-services/high-availability-keepalived.md index 18bf2d378..d47052c85 100644 --- a/content/nginx/deployment-guides/amazon-web-services/high-availability-keepalived.md +++ b/content/nginx/deployment-guides/amazon-web-services/high-availability-keepalived.md @@ -16,7 +16,7 @@ NGINX also provides a [solution for active‑active HA of NGINX Plus in AWS]({{ ## Overview -The [supported solution for HA deployment]({{< relref "../../admin-guide/high-availability/ha-keepalived.md" >}}) of NGINX Plus that uses `keepalived` is designed for on‑premises deployments. It is typically not viable in cloud environments, such as AWS, because of the networking restrictions they impose. +The [supported solution for HA deployment]({{< ref "nginx/admin-guide/high-availability/ha-keepalived.md" >}}) of NGINX Plus that uses `keepalived` is designed for on‑premises deployments. It is typically not viable in cloud environments, such as AWS, because of the networking restrictions they impose. One method for deploying NGINX Plus in a highly available manner on AWS is to use ELB in front of NGINX Plus instances. However, the method has several disadvantages: @@ -64,7 +64,7 @@ The scripts in the HA solution use the AWS API to associate an Elastic IP addre Alternatively, you can use the `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` environment variables to provide credentials to the HA scripts, as shown in [Step 5](#ha-aws_keepalived-configure). -2. Launch two instances and [install NGINX Plus]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-amazon-web-services.md" >}}) on each. (As noted, we tested the instructions on Ubuntu 16.04 LTS and CentOS 7.) +2. Launch two instances and [install NGINX Plus]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus-amazon-web-services.md" >}}) on each. (As noted, we tested the instructions on Ubuntu 16.04 LTS and CentOS 7.) 3. Attach this IAM role to the instance. diff --git a/content/nginx/deployment-guides/amazon-web-services/high-availability-network-load-balancer.md b/content/nginx/deployment-guides/amazon-web-services/high-availability-network-load-balancer.md index 3e36914ea..079825229 100644 --- a/content/nginx/deployment-guides/amazon-web-services/high-availability-network-load-balancer.md +++ b/content/nginx/deployment-guides/amazon-web-services/high-availability-network-load-balancer.md @@ -33,8 +33,8 @@ NGINX Plus also provides reverse‑proxy and load balancing features, including - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) diff --git a/content/nginx/deployment-guides/amazon-web-services/route-53-global-server-load-balancing.md b/content/nginx/deployment-guides/amazon-web-services/route-53-global-server-load-balancing.md index adcc55cfd..4a449de16 100644 --- a/content/nginx/deployment-guides/amazon-web-services/route-53-global-server-load-balancing.md +++ b/content/nginx/deployment-guides/amazon-web-services/route-53-global-server-load-balancing.md @@ -24,8 +24,8 @@ The [Appendix](#appendix) provides instructions for creating EC2 instances with - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) diff --git a/content/nginx/deployment-guides/global-server-load-balancing/ns1-global-server-load-balancing.md b/content/nginx/deployment-guides/global-server-load-balancing/ns1-global-server-load-balancing.md index 41c282581..d1284e106 100644 --- a/content/nginx/deployment-guides/global-server-load-balancing/ns1-global-server-load-balancing.md +++ b/content/nginx/deployment-guides/global-server-load-balancing/ns1-global-server-load-balancing.md @@ -32,8 +32,8 @@ The solution functions alongside other NS1 capabilities, such as geo‑proximal - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) diff --git a/content/nginx/deployment-guides/google-cloud-platform/high-availability-all-active.md b/content/nginx/deployment-guides/google-cloud-platform/high-availability-all-active.md index 1f8134ed5..2596ddbf5 100644 --- a/content/nginx/deployment-guides/google-cloud-platform/high-availability-all-active.md +++ b/content/nginx/deployment-guides/google-cloud-platform/high-availability-all-active.md @@ -113,7 +113,7 @@ Create three GCE source instances. Use them as templates for later instance grou You can create source instances in either of two ways: -- [Based on a standard GCE VM image](#source-vm), you install NGINX Plus manually. This guide uses the latest Ubuntu LTS image at publication (Ubuntu 24.04 LTS). You can use any Unix or Linux OS that [NGINX Plus supports]({{< relref "../../technical-specs.md" >}}). +- [Based on a standard GCE VM image](#source-vm), you install NGINX Plus manually. This guide uses the latest Ubuntu LTS image at publication (Ubuntu 24.04 LTS). You can use any Unix or Linux OS that [NGINX Plus supports]({{< ref "nginx/technical-specs.md" >}}). - [Based on the prebuilt NGINX Plus image](#source-prebuilt) in the Google Marketplace, which at the time of publication runs on Ubuntu 14.04 LTS. The methods to create a source instance are different. Once you've created the source instances, all later instructions are the same. @@ -257,7 +257,7 @@ Both the configuration and content files are available at the [NGINX GitHub repo **Note:** Some commands require `root` privilege. If appropriate for your environment, prefix commands with the `sudo` command. -1. Install NGINX Plus. For instructions, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus.md" >}}). +1. Install NGINX Plus. For instructions, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}). 2. Clone the GitHub repository for the [all‑active load balancing deployment](https://github.com/nginxinc/NGINX-Demos/tree/master/gce-nginx-plus-deployment-guide-files). (Instructions for downloading the files directly from the GitHub repository are provided below, in case you prefer not to clone it.) diff --git a/content/nginx/deployment-guides/load-balance-third-party/apache-tomcat.md b/content/nginx/deployment-guides/load-balance-third-party/apache-tomcat.md index 7ea597997..a244a1475 100644 --- a/content/nginx/deployment-guides/load-balance-third-party/apache-tomcat.md +++ b/content/nginx/deployment-guides/load-balance-third-party/apache-tomcat.md @@ -21,8 +21,8 @@ This deployment guide explains how to use NGINX Open Source and F5 NGINX Plus to - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -39,7 +39,7 @@ Apache Tomcat 8.0 was used to prepare the documentation for this guide. ## Prerequisites and System Requirements - A Tomcat application server installed and configured on a physical or virtual system. -- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install the software on a fresh physical or virtual system. For the list of operating systems supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}). +- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install the software on a fresh physical or virtual system. For the list of operating systems supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}). - NGINX Open Source 1.9.5 and later, and NGINX Plus R7 and later. The instructions assume you have basic Linux system administration skills, including the following. Full instructions are not provided for these tasks. @@ -318,7 +318,7 @@ By default, NGINX Open Source and NGIN In NGINX Plus, you can also set up dynamic reconfiguration of an upstream group when the set of backend servers changes, using DNS or an API; see [Enabling Dynamic Reconfiguration of Upstream Groups](#reconfiguration). -For more information about proxying and load balancing, see [NGINX Reverse Proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. +For more information about proxying and load balancing, see [NGINX Reverse Proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. ### Configuring Basic Session Persistence @@ -690,7 +690,7 @@ server 10.100.100.11:8080 slow_start=30s; server 10.100.100.12:8080 slow_start=30s; ``` -For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/load-balancer/http-health-check.md" >}}). +For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}). ### Enabling Live Activity Monitoring @@ -699,7 +699,7 @@ NGINX Plus includes a live activity monitoring interface that provides key load Dashboard tab in NGINX Plus live activity monitoring dashboard -For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/monitoring/live-activity-monitoring.md" >}}). +For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}). The quickest way to configure the module and the built‑in dashboard is to download the sample configuration file from the NGINX website, and modify it as necessary. For more complete instructions, see [Live Activity Monitoring of NGINX Plus in 3 Simple Steps](https://www.nginx.com/blog/live-activity-monitoring-nginx-plus-3-simple-steps/). @@ -776,7 +776,7 @@ When you reload the NGINX Plus configuration file, for example by running the < ### Enabling Dynamic Reconfiguration of Upstream Groups -With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either the Domain Name System (DNS) or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< relref "../../admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. +With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either the Domain Name System (DNS) or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< ref "nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. #### Configuring the API Method diff --git a/content/nginx/deployment-guides/load-balance-third-party/microsoft-exchange.md b/content/nginx/deployment-guides/load-balance-third-party/microsoft-exchange.md index df907bd34..3a9158c19 100644 --- a/content/nginx/deployment-guides/load-balance-third-party/microsoft-exchange.md +++ b/content/nginx/deployment-guides/load-balance-third-party/microsoft-exchange.md @@ -18,8 +18,8 @@ This deployment guide explains how to use F5 NGINX Plus to load balance traffic - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -53,7 +53,7 @@ In the final section, you choose between basic Exchange load balancing and an en Exchange CASs can be configured for [HTTP Basic authentication](https://tools.ietf.org/html/rfc7617), as specified in this guide. -- A Linux system to host NGINX Plus (in on‑premises and private‑cloud deployments). To avoid potential conflicts with other applications, we recommend that you install NGINX Plus on a fresh system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}). +- A Linux system to host NGINX Plus (in on‑premises and private‑cloud deployments). To avoid potential conflicts with other applications, we recommend that you install NGINX Plus on a fresh system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}). - NGINX Plus R7 or later. TCP load balancing is available in NGINX Plus R6 and later. Support for the Microsoft NT LAN Manager (NTLM) is available in NGINX Plus R7 and later. @@ -325,10 +325,10 @@ Optionally, you can enable support for HTTP/2 in [Configuring HTTP/2 Support](#h You can install NGINX Plus on premises, in a private cloud, or in a public cloud such as the Amazon Elastic Compute Cloud (EC2), the Google Cloud Platform, or Microsoft Azure. See the instructions for your installation type: -- On‑premises or private cloud – [Installing NGINX Plus]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus.md" >}}) -- Amazon EC2 – [Installing NGINX Plus AMIs on Amazon EC2]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-amazon-web-services.md" >}}) +- On‑premises or private cloud – [Installing NGINX Plus]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}) +- Amazon EC2 – [Installing NGINX Plus AMIs on Amazon EC2]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus-amazon-web-services.md" >}}) - Google Compute Cloud – [Installing NGINX Plus on the Google Cloud Platform]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-google-cloud-platform.md" >}}) -- Microsoft Azure – [Installing NGINX Plus on Microsoft Azure]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-microsoft-azure.md" >}}) +- Microsoft Azure – [Installing NGINX Plus on Microsoft Azure]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus-microsoft-azure.md" >}}) ### Creating and Modifying Configuration Files @@ -1074,7 +1074,7 @@ NGINX Plus includes a live activity monitoring interface that provides key load Dashboard tab in NGINX Plus live activity monitoring dashboard -For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/monitoring/live-activity-monitoring.md" >}}). +For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}). The quickest way to configure the module and the built‑in dashboard is to download the sample configuration file from the NGINX website, and modify it as necessary. For more complete instructions, see [Live Activity Monitoring of NGINX Plus in 3 Simple Steps](https://www.nginx.com/blog/live-activity-monitoring-nginx-plus-3-simple-steps/). diff --git a/content/nginx/deployment-guides/load-balance-third-party/node-js.md b/content/nginx/deployment-guides/load-balance-third-party/node-js.md index 8cecf6bde..af2a2c964 100644 --- a/content/nginx/deployment-guides/load-balance-third-party/node-js.md +++ b/content/nginx/deployment-guides/load-balance-third-party/node-js.md @@ -23,8 +23,8 @@ This deployment guide explains how to use NGINX Open Source and F5 NGINX Plus to - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -43,7 +43,7 @@ The information in this deployment guide applies equally to open source Node.js ## Prerequisites and System Requirements - A Node.js application server installed and configured on a physical or virtual system. -- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}). +- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}). - NGINX Open Source or NGINX Plus installed on the physical or virtual system. Some features are available only with [NGINX Plus](#enhanced), including sophisticated session persistence, application health checks, live activity monitoring, and dynamic reconfiguration of upstream groups. For installation instructions for both products, see the [NGINX Plus Admin Guide]({{< ref "/nginx/admin-guide/installing-nginx/_index.md" >}}). The instructions assume you have basic Linux system administration skills, including the following. Full instructions are not provided for these tasks. @@ -323,7 +323,7 @@ By default, NGINX Open Source and NGINX Plus use the Round Robin algorithm for In NGINX Plus, you can also set up dynamic reconfiguration of an upstream group when the set of backend servers changes, using the Domain Name System (DNS) or an API; see [Enabling Dynamic Reconfiguration of Upstream Groups](#reconfiguration). -For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. +For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. ### Configuring Basic Session Persistence @@ -424,7 +424,7 @@ To enable basic caching of responses from the Node.js app server, add the follow Directive documentation: [proxy_cache](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache), [proxy_pass](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass) -For more complete information on caching, refer to the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. +For more complete information on caching, refer to the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. ### Configuring HTTP/2 Support @@ -641,7 +641,7 @@ server 192.168.33.12:8080 slow_start=30s; Parameter documentation: [slow_start](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#slow_start) -For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/load-balancer/http-health-check.md" >}}). +For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}). ### Enabling Live Activity Monitoring @@ -650,7 +650,7 @@ NGINX Plus includes a live activity monitoring interface that provides key load Dashboard tab in NGINX Plus live activity monitoring dashboard -For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/monitoring/live-activity-monitoring.md" >}}). +For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}). The quickest way to configure the module and the built‑in NGINX Plus dashboard is to download the sample configuration file from the NGINX website and modify it as necessary. For more complete instructions, see [Live Activity Monitoring of NGINX Plus in 3 Simple Steps](https://www.nginx.com/blog/live-activity-monitoring-nginx-plus-3-simple-steps/). @@ -713,7 +713,7 @@ When you reload the NGINX Plus configuration file, for example by running the < ### Enabling Dynamic Reconfiguration of Upstream Groups -With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either DNS or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< relref "../../admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. +With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either DNS or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< ref "nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. #### Configuring the API Method diff --git a/content/nginx/deployment-guides/load-balance-third-party/oracle-e-business-suite.md b/content/nginx/deployment-guides/load-balance-third-party/oracle-e-business-suite.md index c95cf5a07..88457fdfe 100644 --- a/content/nginx/deployment-guides/load-balance-third-party/oracle-e-business-suite.md +++ b/content/nginx/deployment-guides/load-balance-third-party/oracle-e-business-suite.md @@ -18,8 +18,8 @@ This deployment guide explains how to use F5 NGINX Plus to load balance traffic - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -33,15 +33,15 @@ This deployment guide explains how to use F5 NGINX Plus to load balance traffic The following systems and software are required: - Oracle EBS 12.2, installed and configured according to Oracle best practices. -- Linux system to host NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of operating sytsems supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}). +- Linux system to host NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of operating sytsems supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}). - NGINX Plus R6 or later. You can install NGINX Plus on premises, in a private cloud, or in a public cloud such as the Amazon Elastic Compute Cloud (EC2), the Google Cloud Platform, or Microsoft Azure. See the instructions for your installation type: -- On premises or private cloud – [Installing NGINX Plus]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus.md" >}}) -- Amazon Elastic Compute Cloud (EC2) – [Installing NGINX Plus AMIs on Amazon EC2]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-amazon-web-services.md" >}}) +- On premises or private cloud – [Installing NGINX Plus]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}) +- Amazon Elastic Compute Cloud (EC2) – [Installing NGINX Plus AMIs on Amazon EC2]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus-amazon-web-services.md" >}}) - Google Compute Cloud – [Installing NGINX Plus on the Google Cloud Platform]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-google-cloud-platform.md" >}}) -- Microsoft Azure – [Installing NGINX Plus on Microsoft Azure]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-microsoft-azure.md" >}}) +- Microsoft Azure – [Installing NGINX Plus on Microsoft Azure]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus-microsoft-azure.md" >}}) The instructions assume you have basic Linux system administration skills, including the following. Full instructions are not provided for these tasks. @@ -475,7 +475,7 @@ To configure load balancing, you first create a named _upstream group_, which li By default, NGINX and NGINX Plus use the Round Robin algorithm for load balancing among servers. The load balancer runs through the list of servers in the upstream group in order, forwarding each new request to the next server. In our example, the first request goes to 172.31.11.210, the second to 192.168.0.146, the third to 172.31.11.210, and so on. For information about the other available load‑balancing algorithms, see the NGINX Plus Admin Guide. -For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. +For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. ### Configuring Session Persistence @@ -577,7 +577,7 @@ server 172.31.0.146:8000 slow_start=30s; Parameter documentation: [slow_start](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#slow_start) -For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/load-balancer/http-health-check.md" >}}). +For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}). ### Configuring Caching for Application Acceleration @@ -623,7 +623,7 @@ Before configuring caching, make sure that the NGINX Plus host has adequate fre Directive documentation: [proxy_cache](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache), [proxy_cache_valid](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid), [proxy_pass](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass), [proxy_set_header](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_set_header) -For more complete information on caching, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. +For more complete information on caching, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. You can track cache usage using the following methods: @@ -767,7 +767,7 @@ The quickest way to configure live activity monitoring and the built‑in dashbo When you reload the NGINX Plus configuration file, for example by running the `nginx -s reload` command, the NGINX Plus dashboard is available immediately at http://_nginx-server-address_:8080. -For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/monitoring/live-activity-monitoring.md" >}}). +For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}). #### Monitoring with Third-Party Tools diff --git a/content/nginx/deployment-guides/load-balance-third-party/oracle-weblogic-server.md b/content/nginx/deployment-guides/load-balance-third-party/oracle-weblogic-server.md index d3a334cb2..1c0188761 100644 --- a/content/nginx/deployment-guides/load-balance-third-party/oracle-weblogic-server.md +++ b/content/nginx/deployment-guides/load-balance-third-party/oracle-weblogic-server.md @@ -21,8 +21,8 @@ This deployment guide explains how to use NGINX Open Source and F5 NGINX Plus to - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -45,7 +45,7 @@ For more information about deploying a Java application on Oracle Java Cloud Ser ## Prerequisites and System Requirements - An Oracle WebLogic Server application server installed and configured on a physical or virtual system. -- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}). +- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}). - NGINX Open Source 1.9.5 and later, or NGINX Plus R7 and later. The instructions assume you have basic Linux system administration skills, including the following. Full instructions are not provided for these tasks. @@ -320,7 +320,7 @@ By default, NGINX Open Source and NGINX Plus use the Round Robin algorithm for In NGINX Plus, you can also set up dynamic reconfiguration of an upstream group when the set of backend servers changes, using DNS or an API; see [Enabling Dynamic Reconfiguration of Upstream Groups](#reconfiguration). -For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. +For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. ### Configuring Basic Session Persistence @@ -434,7 +434,7 @@ proxy_cache_key $proxy_host$request_uri$cookie_jessionid; Directive documentation: [proxy_cache_key](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_key) -For more complete information on caching, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. +For more complete information on caching, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. ### Configuring HTTP/2 Support @@ -655,7 +655,7 @@ server 192.168.25.69:7001 slow_start=30s; Parameter documentation: [slow_start](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#slow_start) -For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/load-balancer/http-health-check.md" >}}). +For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}). ### Configuring Content Cache Purging @@ -691,7 +691,7 @@ Date: Sat, 03 May 2014 16:33:04 GMT Connection: keep-alive ``` -For more complete information about NGINX Open Source and NGINX Plus' caching capabilities, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}). +For more complete information about NGINX Open Source and NGINX Plus' caching capabilities, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}). ### Enabling Live Activity Monitoring @@ -700,7 +700,7 @@ NGINX Plus includes a live activity monitoring interface that provides key load Dashboard tab in NGINX Plus live activity monitoring dashboard -For more information about live activity monitoring, see the [NGINX Plus Admin Guide.]({{< relref "../../admin-guide/monitoring/live-activity-monitoring.md" >}}) +For more information about live activity monitoring, see the [NGINX Plus Admin Guide.]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}) The quickest way to configure live activity monitoring and the built‑in dashboard is to download the sample configuration file from the NGINX website and modify it as necessary. For more complete instructions, see [Live Activity Monitoring of NGINX Plus in 3 Simple Steps](https://www.nginx.com/blog/live-activity-monitoring-nginx-plus-3-simple-steps/) on our blog. @@ -774,7 +774,7 @@ When you reload the NGINX Plus configuration file, for example by running the < ### Enabling Dynamic Reconfiguration of Upstream Groups -With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either DNS or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< relref "../../admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. +With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either DNS or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< ref "nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. To enable dynamic reconfiguration of your upstream group of WebLogic Server app servers using the NGINX Plus API: diff --git a/content/nginx/deployment-guides/load-balance-third-party/wildfly.md b/content/nginx/deployment-guides/load-balance-third-party/wildfly.md index 8067d98ac..174c3a77c 100644 --- a/content/nginx/deployment-guides/load-balance-third-party/wildfly.md +++ b/content/nginx/deployment-guides/load-balance-third-party/wildfly.md @@ -22,8 +22,8 @@ This deployment guide explains how to use NGINX Open Source and F5 NGINX Plus to - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -40,7 +40,7 @@ The commercially supported version of the Wildfly software is the [Red Hat JBoss ## Prerequisites and System Requirements - A Wildfly or JBoss application server installed and configured on a physical or virtual system. -- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< relref "../../technical-specs.md" >}}). +- A Linux system to host NGINX Open Source or NGINX Plus. To avoid potential conflicts with other applications, we recommend you install NGINX Plus on a fresh physical or virtual system. For the list of Linux distributions supported by NGINX Plus, see [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}). - NGINX Open Source 1.9.5 or later, or NGINX Plus R7 or later. The instructions assume you have basic Linux system administration skills, including the following. Full instructions are not provided for these tasks. @@ -313,7 +313,7 @@ By default, NGINX Open Source and NGINX Plus use the Round Robin algorithm for In NGINX Plus, you can also set up dynamic reconfiguration of an upstream group when the set of backend servers changes, using DNS or an API; see [Enabling Dynamic Reconfiguration of Upstream Groups](#reconfiguration). -For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. +For more information on proxying and load balancing, see [NGINX Reverse Proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) and [HTTP Load Balancing]({{< relref "../../admin-guide/load-balancer/http-load-balancer.md" >}}) in the NGINX Plus Admin Guide, and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) and [Upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html) modules. ### Configuring Basic Session Persistence @@ -416,7 +416,7 @@ Another alternative is to cache server responses on the NGINX Open Source host b Directive documentation: [proxy_cache](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache), [proxy_pass](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass) -For more complete information on caching, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. +For more complete information on caching, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) and the reference documentation for the HTTP [Proxy](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) module. ### Configuring HTTP/2 Support @@ -634,7 +634,7 @@ server 192.168.33.12:8080 slow_start=30s; Parameter documentation: [slow_start](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#slow_start) -For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/load-balancer/http-health-check.md" >}}). +For information about customizing health checks, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}). ### Enabling Live Activity Monitoring @@ -643,7 +643,7 @@ NGINX Plus includes a live activity monitoring interface that provides key load Dashboard tab in NGINX Plus live activity monitoring dashboard -For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/monitoring/live-activity-monitoring.md" >}}). +For more information about live activity monitoring, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}). The quickest way to configure the module and the built‑in NGINX Plus dashboard is to download the sample configuration file from the NGINX website and modify it as necessary. For more complete instructions, see [Live Activity Monitoring of NGINX Plus in 3 Simple Steps](https://www.nginx.com/blog/live-activity-monitoring-nginx-plus-3-simple-steps/). @@ -717,7 +717,7 @@ When you reload the NGINX Plus configuration file, for example by running the < ### Enabling Dynamic Reconfiguration of Upstream Groups -With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either the Domain Name System (DNS) or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< relref "../../admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. +With NGINX Plus, you can reconfigure load‑balanced server groups (both HTTP and TCP/UDP) dynamically using either the Domain Name System (DNS) or the NGINX Plus API introduced in NGINX Plus R13. See the NGINX Plus Admin Guide for a more detailed discussion of the DNS and [API]({{< ref "nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) methods. #### Configuring the API Method diff --git a/content/nginx/deployment-guides/microsoft-azure/high-availability-standard-load-balancer.md b/content/nginx/deployment-guides/microsoft-azure/high-availability-standard-load-balancer.md index 4e97c90dd..25a8a9ba8 100644 --- a/content/nginx/deployment-guides/microsoft-azure/high-availability-standard-load-balancer.md +++ b/content/nginx/deployment-guides/microsoft-azure/high-availability-standard-load-balancer.md @@ -31,7 +31,7 @@ Azure Traffic Manager is a DNS‑based traffic load balancer that optimally dist ## About NGINX Plus -NGINX Plus is complementary to Standard Load Balancer. Operating at Layer 7 (the application layer), it uses more advanced load‑balancing criteria, including schemes that rely on the content of requests and the results of NGINX Plus's [active health checks]({{< relref "../../admin-guide/load-balancer/http-health-check.md" >}}). +NGINX Plus is complementary to Standard Load Balancer. Operating at Layer 7 (the application layer), it uses more advanced load‑balancing criteria, including schemes that rely on the content of requests and the results of NGINX Plus's [active health checks]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}). [NGINX Plus](https://www.f5.com/products/nginx/nginx-plus) is the commercially supported version of [NGINX Open Source](https://nginx.org/en). NGINX Plus is a complete application delivery platform, extending the power of NGINX with a host of enterprise‑ready capabilities that enhance an AWS web application deployment and are instrumental to building web applications at scale. @@ -39,8 +39,8 @@ NGINX Plus provides both reverse‑proxy features and load‑balancing features - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) diff --git a/content/nginx/deployment-guides/microsoft-azure/virtual-machines-for-nginx.md b/content/nginx/deployment-guides/microsoft-azure/virtual-machines-for-nginx.md index 961d7927f..d89c7c69e 100644 --- a/content/nginx/deployment-guides/microsoft-azure/virtual-machines-for-nginx.md +++ b/content/nginx/deployment-guides/microsoft-azure/virtual-machines-for-nginx.md @@ -14,7 +14,7 @@ These instructions explain how to create virtual machines (VMs) in the Microsoft The names and other settings used in this guide are appropriate for the high‑availability deployment described in [Active-Active HA for NGINX Plus on Microsoft Azure Using the Azure Standard Load Balancer]({{< ref "high-availability-standard-load-balancer.md" >}}), but the VMs can be used for any purpose. -For NGINX Plus, a faster alternative is to purchase a prebuilt VM in the [Microsoft Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps?search=NGINX%20Plus) (several current operating systems are available). For instructions, see [Installing NGINX Plus on Microsoft Azure]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus-microsoft-azure.md" >}}). +For NGINX Plus, a faster alternative is to purchase a prebuilt VM in the [Microsoft Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps?search=NGINX%20Plus) (several current operating systems are available). For instructions, see [Installing NGINX Plus on Microsoft Azure]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus-microsoft-azure.md" >}}). ## Prerequisites @@ -137,7 +137,7 @@ To install and configure NGINX Open Source or NGINX Plus on a VM, you need to o ## Installing NGINX Software -Once you have established a connection with an instance, you can install the NGINX software on it. Follow the instructions in the NGINX Plus Admin Guide for NGINX Open Source and [NGINX Plus]({{< relref "../../admin-guide/installing-nginx/installing-nginx-plus.md" >}}). The [Admin Guide]({{< ref "/nginx/admin-guide/" >}}) also provides instructions for many maintenance tasks. +Once you have established a connection with an instance, you can install the NGINX software on it. Follow the instructions in the NGINX Plus Admin Guide for NGINX Open Source and [NGINX Plus]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}). The [Admin Guide]({{< ref "/nginx/admin-guide/" >}}) also provides instructions for many maintenance tasks. ### Automating Installation with a Configuration Manager diff --git a/content/nginx/deployment-guides/migrate-hardware-adc/citrix-adc-configuration.md b/content/nginx/deployment-guides/migrate-hardware-adc/citrix-adc-configuration.md index 41ef9b58b..9d8adb652 100644 --- a/content/nginx/deployment-guides/migrate-hardware-adc/citrix-adc-configuration.md +++ b/content/nginx/deployment-guides/migrate-hardware-adc/citrix-adc-configuration.md @@ -24,8 +24,8 @@ NGINX Plus and Citrix ADC both act as a full reverse proxy and load balancer, s - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -269,7 +269,7 @@ server { Directive documentation: [health_check](https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html#health_check), [location](https://nginx.org/en/docs/http/ngx_http_core_module.html#location), [match](https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html#match), [proxy_pass](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass), [server](https://nginx.org/en/docs/http/ngx_http_core_module.html#server) -For more information about NGINX Plus health checks, see the [NGINX Plus Admin Guide]({{< relref "../../admin-guide/load-balancer/http-health-check.md" >}}). +For more information about NGINX Plus health checks, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/load-balancer/http-health-check.md" >}}). @@ -327,13 +327,13 @@ NGINX Plus and Citrix ADC handle high availability (HA) in similar but slightly Citrix ADC handles the monitoring and failover of the VIP in a proprietary way. - For [on‑premises deployments]({{< relref "../../admin-guide/high-availability/ha-keepalived.md" >}}), NGINX Plus uses a separate software package called **nginx-ha-keepalived** to handle the VIP and the failover process for an active‑passive pair of NGINX Plus servers. The package implements the VRRP protocol to handle the VIP. Limited [active‑active]({{< relref "../../admin-guide/high-availability/ha-keepalived-nodes.md" >}}) scenarios are also possible with the nginx-ha-keepalived package. + For [on‑premises deployments]({{< ref "nginx/admin-guide/high-availability/ha-keepalived.md" >}}), NGINX Plus uses a separate software package called **nginx-ha-keepalived** to handle the VIP and the failover process for an active‑passive pair of NGINX Plus servers. The package implements the VRRP protocol to handle the VIP. Limited [active‑active]({{< ref "nginx/admin-guide/high-availability/ha-keepalived-nodes.md" >}}) scenarios are also possible with the nginx-ha-keepalived package. Solutions for high availability of NGINX Plus in cloud environments are also available, including these: -- [Active‑Active HA for NGINX Plus on AWS Using AWS Network Load Balancer]({{< relref "../amazon-web-services/high-availability-network-load-balancer.md" >}}) -- [Active‑Passive HA for NGINX Plus on AWS Using Elastic IP Addresses]({{< relref "../amazon-web-services/high-availability-keepalived.md" >}}) -- [All‑Active HA for NGINX Plus on the Google Cloud Platform]({{< relref "../google-cloud-platform/high-availability-all-active.md" >}}) +- [Active‑Active HA for NGINX Plus on AWS Using AWS Network Load Balancer]({{< ref "nginx/deployment-guides/amazon-web-services/high-availability-network-load-balancer.md" >}}) +- [Active‑Passive HA for NGINX Plus on AWS Using Elastic IP Addresses]({{< ref "nginx/deployment-guides/amazon-web-services/high-availability-keepalived.md" >}}) +- [All‑Active HA for NGINX Plus on the Google Cloud Platform]({{< ref "nginx/deployment-guides/google-cloud-platform/high-availability-all-active.md" >}}) ## Logging in Citrix ADC and NGINX Plus @@ -342,7 +342,7 @@ Logging and monitoring are important supporting functionality for load balancing Citrix ADC logs errors in its _event log_ and NGINX Plus in its [_error log_](https://nginx.org/en/docs/ngx_core_module.html#error_log). By default, Citrix ADC does not log individual requests, but can be configured to do so, using a separate weblog client. NGINX Plus has an [_access log_](https://nginx.org/en/docs/http/ngx_http_log_module.html) for which you can define customized formats to log many metrics (as captured in [variables](https://nginx.org/en/docs/varindex.html)) from both requests and responses. -The [NGINX Plus API](https://nginx.org/en/docs/http/ngx_http_api_module.html) module collects numerous statistics, which you can access via the API, display on the built‑in live activity monitoring dashboard, or pass to third‑party monitoring tools. For more detail on logging and monitoring see the [NGINX Plus Admin Guide]({{< ref "/nginx/admin-guide/monitoring/_index.md" >}}). +The [NGINX Plus API](https://nginx.org/en/docs/http/ngx_http_api_module.html) module collects numerous statistics, which you can access via the API, display on the built‑in live activity monitoring dashboard, or pass to third‑party monitoring tools. For more detail on logging and monitoring see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/monitoring/live-activity-monitoring.md" >}}). ### Revision History diff --git a/content/nginx/deployment-guides/migrate-hardware-adc/f5-big-ip-configuration.md b/content/nginx/deployment-guides/migrate-hardware-adc/f5-big-ip-configuration.md index 9dba53893..b5f9621b4 100644 --- a/content/nginx/deployment-guides/migrate-hardware-adc/f5-big-ip-configuration.md +++ b/content/nginx/deployment-guides/migrate-hardware-adc/f5-big-ip-configuration.md @@ -22,8 +22,8 @@ NGINX Plus and BIG-IP LTM both act as - [Full‑featured HTTP, TCP, and UDP load balancing](https://www.nginx.com/products/nginx/load-balancing/) - [Intelligent session persistence](https://www.nginx.com/products/nginx/load-balancing/#session-persistence) -- [High‑performance reverse proxy]({{< relref "../../admin-guide/web-server/reverse-proxy.md" >}}) -- [Caching and offload of dynamic and static content]({{< relref "../../admin-guide/content-cache/content-caching.md" >}}) +- [High‑performance reverse proxy]({{< ref "nginx/admin-guide/web-server/reverse-proxy.md" >}}) +- [Caching and offload of dynamic and static content]({{< ref "nginx/admin-guide/content-cache/content-caching.md" >}}) - [Adaptive streaming to deliver audio and video to any device](https://www.nginx.com/products/nginx/streaming-media/) - [Application-aware health checks](https://docs.nginx.com/nginx/admin-guide/load-balancer/http-health-check/) and [high availability](https://docs.nginx.com/nginx/admin-guide/high-availability/) - [Advanced activity monitoring available via a dashboard or API](https://www.nginx.com/products/nginx/live-activity-monitoring/) @@ -93,19 +93,19 @@ In addition to these networking concepts, there are two other important technolo - **iRules** – iRules is a proprietary, event‑driven, content‑switching and traffic‑manipulation engine (based on TCL) used by BIG-IP LTM to control all aspects of data‑plane traffic. iRules are attached to virtual servers and are required for any type of content switching, such as choosing a pool based on URI, inserting headers, establishing affinity with JSESSIONIDs, and so on. iRules are event‑driven and are configured to fire for each new connection when certain criteria are met, such as when a new HTTP request is made to a virtual server or when a server sends a response to a client. - NGINX Plus natively handles content switching and HTTP session manipulation, eliminating the need to explicitly migrate most context‑based iRules and those which deal with HTTP transactions such as header manipulation. Most context‑based iRules can be translated to `server` and `location` blocks, and more complex iRules that cannot be duplicated with NGINX Plus directives and configuration block can be implemented with the [Lua]({{< relref "../../admin-guide/dynamic-modules/lua.md" >}}) or [JavaScript]({{< relref "../../admin-guide/dynamic-modules/nginscript.md" >}}) modules. For more information on translating iRules to NGINX Plus content rules, see [Migrating Layer 7 Logic from F5 iRules and Citrix Policies to NGINX and NGINX Plus](https://www.nginx.com/blog/migrating-layer7-logic-f5-irules-citrix-policies-nginx-plus/) on the NGINX blog. + NGINX Plus natively handles content switching and HTTP session manipulation, eliminating the need to explicitly migrate most context‑based iRules and those which deal with HTTP transactions such as header manipulation. Most context‑based iRules can be translated to `server` and `location` blocks, and more complex iRules that cannot be duplicated with NGINX Plus directives and configuration block can be implemented with the [Lua]({{< ref "nginx/admin-guide/dynamic-modules/lua.md" >}}) or [JavaScript]({{< ref "nginx/admin-guide/dynamic-modules/nginscript.md" >}}) modules. For more information on translating iRules to NGINX Plus content rules, see [Migrating Layer 7 Logic from F5 iRules and Citrix Policies to NGINX and NGINX Plus](https://www.nginx.com/blog/migrating-layer7-logic-f5-irules-citrix-policies-nginx-plus/) on the NGINX blog. - **High availability** – Conceptually, BIG-IP LTM and NGINX Plus handle high availability (HA) in the same way: each active‑passive pair of load balancers shares a floating "virtual" IP address (VIP) which maps to the currently active instance. If the active instance fails, the passive instance takes over and assumes the VIP. BIG-IP LTM uses a built‑in HA mechanism to handle the failover. - For [on‑premises deployments]({{< relref "../../admin-guide/high-availability/ha-keepalived.md" >}}), NGINX Plus uses a separate software package called **nginx-ha-keepalived** to handle the VIP and the failover process for an active‑passive pair of NGINX Plus servers. The package implements the VRRP protocol to handle the VIP. Limited [active‑active]({{< relref "../../admin-guide/high-availability/ha-keepalived-nodes.md" >}}) scenarios are also possible with the nginx-ha-keepalived package. + For [on‑premises deployments]({{< ref "nginx/admin-guide/high-availability/ha-keepalived.md" >}}), NGINX Plus uses a separate software package called **nginx-ha-keepalived** to handle the VIP and the failover process for an active‑passive pair of NGINX Plus servers. The package implements the VRRP protocol to handle the VIP. Limited [active‑active]({{< ref "nginx/admin-guide/high-availability/ha-keepalived-nodes.md" >}}) scenarios are also possible with the nginx-ha-keepalived package. Solutions for high availability of NGINX Plus in cloud environments are also available, including these: - - [Active‑Active HA for NGINX Plus on AWS Using AWS Network Load Balancer]({{< relref "../amazon-web-services/high-availability-network-load-balancer.md" >}}) - - [Active‑Passive HA for NGINX Plus on AWS Using Elastic IP Addresses]({{< relref "../amazon-web-services/high-availability-keepalived.md" >}}) - - [All‑Active HA for NGINX Plus on the Google Cloud Platform]({{< relref "../google-cloud-platform/high-availability-all-active.md" >}}) + - [Active‑Active HA for NGINX Plus on AWS Using AWS Network Load Balancer]({{< ref "nginx/deployment-guides/amazon-web-services/high-availability-network-load-balancer.md" >}}) + - [Active‑Passive HA for NGINX Plus on AWS Using Elastic IP Addresses]({{< ref "nginx/deployment-guides/amazon-web-services/high-availability-keepalived.md" >}}) + - [All‑Active HA for NGINX Plus on the Google Cloud Platform]({{< ref "nginx/deployment-guides/google-cloud-platform/high-availability-all-active.md" >}}) ## Converting F5 BIG-IP LTM Load-Balancer Configuration to NGINX Plus @@ -164,7 +164,7 @@ http { } ``` -Directive documentation: [listen](https://nginx.org/en/docs/http/ngx_http_core_module.html#listen), [location](https://nginx.org/en/docs/http/ngx_http_core_module.html#location), [proxy_pass](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass), [server virtual](https://nginx.org/en/docs/http/ngx_http_core_module.html#server), [server upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server), [upstream](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#upstream) +Directive documentation: [`listen`](https://nginx.org/en/docs/http/ngx_http_core_module.html#listen), [location](https://nginx.org/en/docs/http/ngx_http_core_module.html#location), [`proxy_pass`](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass), [`virtual server`](https://nginx.org/en/docs/http/ngx_http_core_module.html#server), [`upstream server`](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server), [`upstream`](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#upstream) ### SSL/TLS Offload (Termination and Proxy) diff --git a/content/nginx/deployment-guides/nginx-plus-high-availability-chef.md b/content/nginx/deployment-guides/nginx-plus-high-availability-chef.md index 6941d7ef0..d72f5f799 100644 --- a/content/nginx/deployment-guides/nginx-plus-high-availability-chef.md +++ b/content/nginx/deployment-guides/nginx-plus-high-availability-chef.md @@ -23,7 +23,7 @@ _ _ -To set up the highly available active/passive cluster, we’re using the [HA solution]({{< relref "../admin-guide/high-availability/ha-keepalived.md" >}}) provided by NGINX, Inc., which is based on [keepalived](http://www.keepalived.org) and the [Virtual Router Redundancy Protocol](https://tools.ietf.org/html/rfc2338) (VRRP). The solution comes with an interactive script for creating the `keepalived` configuration file, but here we’re using Chef to automate the complete setup process. +To set up the highly available active/passive cluster, we’re using the [HA solution]({{< ref "nginx/admin-guide/high-availability/ha-keepalived.md" >}}) provided by NGINX, Inc., which is based on [keepalived](http://www.keepalived.org) and the [Virtual Router Redundancy Protocol](https://tools.ietf.org/html/rfc2338) (VRRP). The solution comes with an interactive script for creating the `keepalived` configuration file, but here we’re using Chef to automate the complete setup process. ## Modifying the NGINX Cookbook diff --git a/content/nginx/deployment-guides/setting-up-nginx-demo-environment.md b/content/nginx/deployment-guides/setting-up-nginx-demo-environment.md index a7c86da12..9470ba00e 100644 --- a/content/nginx/deployment-guides/setting-up-nginx-demo-environment.md +++ b/content/nginx/deployment-guides/setting-up-nginx-demo-environment.md @@ -14,7 +14,7 @@ The instructions in this guide explain how to set up a simple demo environment t ## Prerequisites -This guide assumes you have already provisioned a number of host systems (physical servers, virtual machines, containers, or cloud instances) required for a deployment guide (if applicable) and installed NGINX Open Source or NGINX Plus on each instance as appropriate. For installation instructions, see the [NGINX Plus Admin Guide]({{< ref "/nginx/admin-guide/installing-nginx/_index.md" >}}). +This guide assumes you have already provisioned a number of host systems (physical servers, virtual machines, containers, or cloud instances) required for a deployment guide (if applicable) and installed NGINX Open Source or NGINX Plus on each instance as appropriate. For installation instructions, see the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}). Some commands require `root` privilege. If appropriate for your environment, prefix commands with the `sudo` command. @@ -194,7 +194,7 @@ The steps in this section configure an NGINX Plus instance to load balance requ If you are using these instructions to satisfy the prerequisites for one of our deployment guides, the Appendix in the guide specifies the names of the NGINX Plus instances used in it. -Repeat these instructions on each instance. Alternatively, you can configure one instance and share the configuration with its peers in a cluster. See the [NGINX Plus Admin Guide]({{< relref "../admin-guide/high-availability/configuration-sharing.md" >}}). +Repeat these instructions on each instance. Alternatively, you can configure one instance and share the configuration with its peers in a cluster. See the [NGINX Plus Admin Guide]({{< ref "nginx/admin-guide/high-availability/configuration-sharing.md" >}}). 1. Open a connection to the NGINX Plus instance and change the directory to **/**etc/nginx/conf.d**: