diff --git a/content/nginx/admin-guide/dynamic-modules/brotli.md b/content/nginx/admin-guide/dynamic-modules/brotli.md index 52e1389f2..66935fac6 100644 --- a/content/nginx/admin-guide/dynamic-modules/brotli.md +++ b/content/nginx/admin-guide/dynamic-modules/brotli.md @@ -17,8 +17,6 @@ The [ngx_brotli](https://github.com/google/ngx_brotli) module enables Brotli com - `ngx_brotli filter module` – for compressing responses on-the-fly - `ngx_brotli static module` - for serving pre-compressed files - - ## Prerequisites 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -34,10 +32,11 @@ The [ngx_brotli](https://github.com/google/ngx_brotli) module enables Brotli com - for CentOS, Oracle Linux, and RHEL: ```shell + sudo yum update && \ sudo yum install epel-release -y ``` - + ## Installation @@ -46,34 +45,39 @@ Install the Brotli module package `nginx-plus-module-brotli`. - for Amazon Linux 2 LTS, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-brotli + sudo yum update && \ + sudo yum install nginx-plus-module-brotli ``` - for Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-brotli + sudo dnf update && \ + sudo dnf install nginx-plus-module-brotli ``` - for Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-brotli + sudo apt update && \ + sudo apt install nginx-plus-module-brotli ``` - for SLES 15: ```shell - zypper install nginx-plus-module-brotli + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-brotli ``` - for FreeBSD: ```shell - pkg install nginx-plus-module-brotli + sudo pkg update && \ + sudo pkg install nginx-plus-module-brotli ``` - + ## Configuration @@ -102,14 +106,27 @@ After installation you will need to enable and configure Brotli modules in NGINX } ``` -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: + + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ```shell - nginx -t && nginx -s reload - ``` - ## More Info - [NGINX Module for Brotli Compression Reference](https://github.com/google/ngx_brotli) @@ -117,3 +134,5 @@ After installation you will need to enable and configure Brotli modules in NGINX - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) - [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/cookie-flag.md b/content/nginx/admin-guide/dynamic-modules/cookie-flag.md index b6744c690..ed344866a 100644 --- a/content/nginx/admin-guide/dynamic-modules/cookie-flag.md +++ b/content/nginx/admin-guide/dynamic-modules/cookie-flag.md @@ -12,28 +12,29 @@ type: > **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. - - -## Installation Instructions +## Installation 1. Install the Cookie-Flag module. For Amazon Linux, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-cookie-flag + sudo yum update && \ + sudo yum install nginx-plus-module-cookie-flag ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-cookie-flag + sudo apt update && \ + sudo apt install nginx-plus-module-cookie-flag ``` For SLES: ```shell - zypper install nginx-plus-module-cookie-flag + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-cookie-flag ``` For Alpine: @@ -46,18 +47,33 @@ type: ```nginx load_module modules/ngx_http_cookie_flag_filter_module.so; + + http { + # ... + } ``` 3. Perform additional configuration as required by the [module](https://github.com/AirisX/nginx_cookie_flag_module). -4. Reload NGINX Plus to enable the module: +4. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +5. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NGINX Module Reference for Adding Cookie Flag](https://github.com/AirisX/nginx_cookie_flag_module) @@ -65,3 +81,5 @@ type: - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) - [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md b/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md index 00ce6fe5d..02ab5e43c 100644 --- a/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md +++ b/content/nginx/admin-guide/dynamic-modules/dynamic-modules.md @@ -9,7 +9,6 @@ type: - how-to --- - ## 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]({{< 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. @@ -66,8 +65,6 @@ For module‑specific instructions, see the list of modules in the same section - [SPNEGO]({{< ref "spnego.md" >}}) - [XSLT]({{< ref "xslt.md" >}}) - - ### Prerequisites 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. @@ -123,11 +120,10 @@ To compile your own dynamic modules, please see our [blog](https://www.f5.com/co To uninstall a dynamic module, please follow the [Uninstalling a dynamic module]({{< ref "uninstall.md" >}}) article. - - ## See Also - [Installing NGINX Plus]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-plus.md" >}}) - [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/encrypted-session.md b/content/nginx/admin-guide/dynamic-modules/encrypted-session.md index b85831f13..47dece320 100644 --- a/content/nginx/admin-guide/dynamic-modules/encrypted-session.md +++ b/content/nginx/admin-guide/dynamic-modules/encrypted-session.md @@ -10,16 +10,12 @@ type: The Encrypted Session dynamic module provides encryption and decryption support for NGINX variables based on AES-256 with MAC. It is usually used with the [Set-Misc](https://docs.nginx.com/nginx/admin-guide/dynamic-modules/set-misc/) dynamic module and the NGINX [`rewrite`](https://nginx.org/en/docs/http/ngx_http_rewrite_module.html) module. - - ## Prerequisites 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. - - ## Installation 1. Install the Encrypted Session module package `nginx-plus-module-encrypted-session`. @@ -27,25 +23,29 @@ The Encrypted Session dynamic module provides encryption and decryption support For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-encrypted-session + sudo yum update && \ + sudo yum install nginx-plus-module-encrypted-session ``` for Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-encrypted-session + sudo dnf update && \ + sudo dnf install nginx-plus-module-encrypted-session ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-encrypted-session + sudo apt update && \ + sudo apt install nginx-plus-module-encrypted-session ``` For SLES: ```shell - zypper install nginx-plus-module-encrypted-session + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-encrypted-session ``` For Alpine: @@ -57,11 +57,10 @@ The Encrypted Session dynamic module provides encryption and decryption support For FreeBSD: ```shell - pkg install nginx-plus-module-encrypted-session + sudo pkg update && \ + sudo pkg install nginx-plus-module-encrypted-session ``` - - ## Configuration After installation you will need to enable and configure the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -71,19 +70,35 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ndk_http_module.so; load_module modules/ngx_http_encrypted_session_module.so; + + http { + # ... + } ``` {{< note >}} The directives must be in this order. {{< /note >}} 2. Perform additional configuration as required by the [module](https://github.com/openresty/encrypted-session-nginx-module). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NGINX encrypted-session-nginx-module Module Reference](https://github.com/openresty/encrypted-session-nginx-module) @@ -91,3 +106,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/fips.md b/content/nginx/admin-guide/dynamic-modules/fips.md index 7878303e7..831173191 100644 --- a/content/nginx/admin-guide/dynamic-modules/fips.md +++ b/content/nginx/admin-guide/dynamic-modules/fips.md @@ -11,8 +11,6 @@ type: For F5 NGINX Plus, the cryptographic boundary includes all functionality that is implemented by the [`http_ssl`](https://nginx.org/en/docs/http/ngx_http_ssl_module.html), [`http_v2`](https://nginx.org/en/docs/http/ngx_http_v2_module.html), [`stream_ssl`](https://nginx.org/en/docs/stream/ngx_stream_ssl_module.html), and [`mail_ssl`](https://nginx.org/en/docs/mail/ngx_mail_ssl_module.html) modules. These modules implement SSL and TLS operations for inbound and outbound connections which use HTTP, HTTP/2, TCP, and mail protocols. - - ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -22,25 +20,29 @@ For F5 NGINX Plus, the cryptographic boundary includes all functionality that is For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-fips-check + sudo yum update && \ + sudo yum install nginx-plus-module-fips-check ``` for Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-fips-check + sudo dnf update && \ + sudo dnf install nginx-plus-module-fips-check ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-fips-check + sudo apt update && \ + sudo apt install nginx-plus-module-fips-check ``` For SLES: ```shell - zypper install nginx-plus-module-fips-check + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-fips-check ``` For Alpine: @@ -52,11 +54,10 @@ For F5 NGINX Plus, the cryptographic boundary includes all functionality that is For FreeBSD: ```shell - pkg install nginx-plus-module-fips-check + sudo pkg update && \ + sudo pkg install nginx-plus-module-fips-check ``` - - ## Configuration After installation you will need to enable and configure the module in NGINX Plus configuration file `nginx.conf`. @@ -65,18 +66,33 @@ After installation you will need to enable and configure the module in NGINX Plu ```nginx load_module modules/ngx_fips_check_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/ogarrett/nginx-fips-check-module). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [FIPS Compliance for NGINX Plus](https://docs.nginx.com/nginx/fips-compliance-nginx-plus/) @@ -86,3 +102,5 @@ 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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/geoip.md b/content/nginx/admin-guide/dynamic-modules/geoip.md index b9129d07c..783b157aa 100644 --- a/content/nginx/admin-guide/dynamic-modules/geoip.md +++ b/content/nginx/admin-guide/dynamic-modules/geoip.md @@ -11,8 +11,6 @@ type: {{< 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]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -22,7 +20,8 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-geoip + sudo yum update && \ + sudo yum install nginx-plus-module-geoip ``` {{< note >}} Only 7.x version of CentOS, Oracle Linux, and RHEL is supported. {{< /note >}} @@ -31,13 +30,15 @@ type: For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-geoip + sudo apt update && \ + sudo apt install nginx-plus-module-geoip ``` For SLES: ```shell - zypper install nginx-plus-module-geoip + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-geoip ``` For Alpine: @@ -46,8 +47,6 @@ type: apk add nginx-plus-module-geoip ``` - - ## Configuration After installation you will need to enable and configure the module in NGINX Plus configuration file `nginx.conf`. @@ -65,13 +64,25 @@ After installation you will need to enable and configure the module in NGINX Plu 2. Perform additional configuration as required by the module ([HTTP](https://nginx.org/en/docs/http/ngx_http_geoip_module.html) or [TCP/UDP](https://nginx.org/en/docs/stream/ngx_stream_geoip_module.html)). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [GeoIP2 Dynamic Module Installation Instructions]({{< ref "geoip2.md" >}}) @@ -85,3 +96,5 @@ 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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/geoip2.md b/content/nginx/admin-guide/dynamic-modules/geoip2.md index 9237fc36b..aa06f7274 100644 --- a/content/nginx/admin-guide/dynamic-modules/geoip2.md +++ b/content/nginx/admin-guide/dynamic-modules/geoip2.md @@ -10,13 +10,13 @@ type: - how-to --- - + ## Module Info [MaxMind GeoIP2](https://www.maxmind.com/en/geoip2-databases) databases provide contextual data for a comprehensive profile of IP addresses, including geolocation data (region, state, city, postal code) and extra data (ISP, domain, connection type). Basing on these data, F5 NGINX Plus will be able to perform different user differentiation strategies, for example, provide different type of content depending on a country. - + ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -26,7 +26,8 @@ type: For CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-geoip2 + sudo yum update && \ + sudo yum install nginx-plus-module-geoip2 ``` {{< note >}} the GeoIP2 module cannot be installed on ppc64le version of CentOS, Oracle Linux, and RHEL. {{< /note >}} @@ -34,13 +35,15 @@ type: For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-geoip2 + sudo dnf update && \ + sudo dnf install nginx-plus-module-geoip2 ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-geoip2 + sudo apt update && \ + sudo apt install nginx-plus-module-geoip2 ``` For Alpine: @@ -52,7 +55,8 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-geoip2 + sudo pkg update && \ + sudo pkg install nginx-plus-module-geoip2 ``` @@ -74,13 +78,26 @@ After installation you will need to enable and configure the module in NGINX Plu 2. Perform additional configuration as required by the [module](https://github.com/leev/ngx_http_geoip2_module#user-content-download-maxmind-geolite2-database-optional). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: + + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ```shell - nginx -t && nginx -s reload - ``` - ## More Info - [Restricting Access by Geographical Location]({{< ref "nginx/admin-guide/security-controls/controlling-access-by-geoip.md" >}}) @@ -92,3 +109,5 @@ 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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/headers-more.md b/content/nginx/admin-guide/dynamic-modules/headers-more.md index 98cbf683d..49df24db4 100644 --- a/content/nginx/admin-guide/dynamic-modules/headers-more.md +++ b/content/nginx/admin-guide/dynamic-modules/headers-more.md @@ -9,7 +9,7 @@ type: - how-to --- - + ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -19,25 +19,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-headers-more + sudo yum update && \ + sudo yum install nginx-plus-module-headers-more ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-headers-more + sudo dnf update && \ + sudo dnf install nginx-plus-module-headers-more ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-headers-more + sudo apt update && \ + sudo apt install nginx-plus-module-headers-more ``` For SLES: ```shell - zypper install nginx-plus-module-headers-more + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-headers-more ``` For Alpine: @@ -49,7 +53,8 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-headers-more + sudo pkg update && \ + sudo pkg install nginx-plus-module-headers-more ``` @@ -62,17 +67,34 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_http_headers_more_filter_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/openresty/headers-more-nginx-module). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: + + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ```shell - nginx -t && nginx -s reload - ``` - ## More Info - [NGINX ngx_headers_more Module Reference](https://github.com/openresty/headers-more-nginx-module) @@ -80,3 +102,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.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 789e8d0c5..1707b63d1 100644 --- a/content/nginx/admin-guide/dynamic-modules/http-substitutions-filter.md +++ b/content/nginx/admin-guide/dynamic-modules/http-substitutions-filter.md @@ -9,7 +9,6 @@ type: - how-to --- - ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -19,35 +18,38 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-subs-filter + sudo yum update && \ + sudo yum install nginx-plus-module-subs-filter ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-subs-filter + sudo dnf update && \ + sudo dnf install nginx-plus-module-subs-filter ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-subs-filter + sudo apt update && \ + sudo apt install nginx-plus-module-subs-filter ``` For SLES: ```shell - zypper install nginx-plus-module-subs-filter + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-subs-filter ``` For FreeBSD: ```shell - pkg install nginx-plus-module-subs-filter + sudo pkg update && \ + sudo pkg install nginx-plus-module-subs-filter ``` - - ## Configuration After installation you will need to enable and configure the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -56,17 +58,33 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_http_subs_filter_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/yaoweibin/ngx_http_substitutions_filter_module). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NGINX Substitution Filter Module Reference](https://github.com/yaoweibin/ngx_http_substitutions_filter_module) @@ -74,3 +92,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/image-filter.md b/content/nginx/admin-guide/dynamic-modules/image-filter.md index 3967a3cdf..3d4a97f93 100644 --- a/content/nginx/admin-guide/dynamic-modules/image-filter.md +++ b/content/nginx/admin-guide/dynamic-modules/image-filter.md @@ -9,7 +9,6 @@ type: - how-to --- - ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -19,25 +18,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-image-filter + sudo yum update && \ + sudo yum install nginx-plus-module-image-filter ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-image-filter + sudo dnf update && \ + sudo dnf install nginx-plus-module-image-filter ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-image-filter + sudo apt update && \ + sudo apt install nginx-plus-module-image-filter ``` For SLES: ```shell - zypper install nginx-plus-module-image-filter + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-image-filter ``` For Alpine: @@ -49,11 +52,10 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-image-filter + sudo pkg update && \ + sudo pkg install nginx-plus-module-image-filter ``` - - ## Configuration After installation you will need to enable and configure the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -62,18 +64,33 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_http_image_filter_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://nginx.org/en/docs/http/ngx_http_image_filter_module.html). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NGINX Image Filter Module Reference](https://nginx.org/en/docs/http/ngx_http_image_filter_module.html) @@ -81,3 +98,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/lua.md b/content/nginx/admin-guide/dynamic-modules/lua.md index 61e51899a..87db66b69 100644 --- a/content/nginx/admin-guide/dynamic-modules/lua.md +++ b/content/nginx/admin-guide/dynamic-modules/lua.md @@ -10,15 +10,12 @@ type: Integrate Lua co-routines into the NGINX event-processing model with the community-authored Lua dynamic module. - ## Prerequisites 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. - - ## Installation Install the Lua module package `nginx-plus-module-lua`. @@ -26,25 +23,29 @@ Integrate Lua co-routines into the NGINX event-processing model with the communi For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-lua + sudo yum update && \ + sudo yum install nginx-plus-module-lua ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-lua + sudo dnf update && \ + sudo dnf install nginx-plus-module-lua ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-lua + sudo apt update && \ + sudo apt install nginx-plus-module-lua ``` For SLES: ```shell - zypper install nginx-plus-module-lua + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-lua ``` For Alpine: @@ -56,12 +57,10 @@ Integrate Lua co-routines into the NGINX event-processing model with the communi For FreeBSD: ```shell - pkg install nginx-plus-module-lua + sudo pkg update && \ + sudo pkg install nginx-plus-module-lua ``` - - - ## Configuration After installation, enable and configure the modules in NGINX Plus configuration file `nginx.conf`. @@ -72,20 +71,35 @@ After installation, enable and configure the modules in NGINX Plus configuration load_module modules/ndk_http_module.so; load_module modules/ngx_http_lua_module.so; load_module modules/ngx_stream_lua_module.so; + + http { + # ... + } ``` {{< note >}} The `ndk_http_module.so` module must be placed first. {{< /note >}} 2. Configure additional settings as needed for the modules. For details, see the [`lua-nginx-module`](https://github.com/openresty/lua-nginx-module) and [`stream-lua-nginx-module`](https://github.com/openresty/stream-lua-nginx-module) documentation. -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [The `lua-nginx-module` Module Reference](https://github.com/openresty/lua-nginx-module) @@ -97,3 +111,5 @@ After installation, enable and configure the modules in NGINX Plus configuration - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) - [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/ndk.md b/content/nginx/admin-guide/dynamic-modules/ndk.md index d17b9ca98..8f051f955 100644 --- a/content/nginx/admin-guide/dynamic-modules/ndk.md +++ b/content/nginx/admin-guide/dynamic-modules/ndk.md @@ -12,8 +12,6 @@ The NGINX Developer Kit (NDK) module makes it easier for module developers to de 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]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -23,25 +21,29 @@ The NDK module is also a prerequisite for [Encrypted Session]({{< ref "encrypted For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-ndk + sudo yum update && \ + sudo yum install nginx-plus-module-ndk ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-ndk + sudo dnf update && \ + sudo dnf install nginx-plus-module-ndk ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-ndk + sudo apt update && \ + sudo apt install nginx-plus-module-ndk ``` For SLES: ```shell - zypper install nginx-plus-module-ndk + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-ndk ``` For Alpine: @@ -53,11 +55,10 @@ The NDK module is also a prerequisite for [Encrypted Session]({{< ref "encrypted For FreeBSD: ```shell - pkg install nginx-plus-module-ndk + sudo pkg update && \ + sudo pkg install nginx-plus-module-ndk ``` - - ## Configuration After installation you will need to enable and configure the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -66,18 +67,33 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ndk_http_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/vision5/ngx_devel_kit). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NDK Module Reference](https://github.com/vision5/ngx_devel_kit) @@ -85,3 +101,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/nginscript.md b/content/nginx/admin-guide/dynamic-modules/nginscript.md index ae419595c..36c526018 100644 --- a/content/nginx/admin-guide/dynamic-modules/nginscript.md +++ b/content/nginx/admin-guide/dynamic-modules/nginscript.md @@ -10,7 +10,6 @@ type: - how-to --- - ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -20,25 +19,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-njs + sudo yum update && \ + sudo yum install nginx-plus-module-njs ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-njs + sudo dnf update && \ + sudo dnf install nginx-plus-module-njs ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-njs + sudo apt update && \ + sudo apt install nginx-plus-module-njs ``` For SLES: ```shell - zypper install nginx-plus-module-njs + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-njs ``` For Alpine: @@ -50,12 +53,10 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-njs + sudo pkg update && \ + sudo pkg install nginx-plus-module-njs ``` - - - ## Configuration After installation you will need to enable and configure the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -65,18 +66,33 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_http_js_module.so; load_module modules/ngx_stream_js_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://www.nginx.com/blog/introduction-nginscript/). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [njs Scripting Language Reference and Examples](https://nginx.org/en/docs/njs/) @@ -84,3 +100,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/nginx-waf.md b/content/nginx/admin-guide/dynamic-modules/nginx-waf.md index 006eb16d3..2eef16e7a 100644 --- a/content/nginx/admin-guide/dynamic-modules/nginx-waf.md +++ b/content/nginx/admin-guide/dynamic-modules/nginx-waf.md @@ -13,8 +13,6 @@ The F5 NGINX ModSecurity web application firewall (WAF) is built on ModSecurity {{< 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]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -24,7 +22,8 @@ The F5 NGINX ModSecurity web application firewall (WAF) is built on ModSecurity For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-modsecurity + sudo yum update && \ + sudo yum install nginx-plus-module-modsecurity ``` {{< note >}} ppc64le is currently not supported for Amazon Linux, CentOS, Oracle Linux, and RHEL. {{< /note >}} @@ -32,13 +31,15 @@ The F5 NGINX ModSecurity web application firewall (WAF) is built on ModSecurity For Amazon Linux 2023: ```shell - dnf install nginx-plus-module-modsecurity + sudo dnf update && \ + sudo dnf install nginx-plus-module-modsecurity ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-modsecurity + sudo apt update && \ + sudo apt install nginx-plus-module-modsecurity ``` {{< note >}} aarch64 and ppc64le is currently not supported for Ubuntu.{{< /note >}} @@ -46,7 +47,8 @@ The F5 NGINX ModSecurity web application firewall (WAF) is built on ModSecurity For SLES: ```shell - zypper install nginx-plus-module-modsecurity + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-modsecurity ``` For Alpine: @@ -55,9 +57,6 @@ The F5 NGINX ModSecurity web application firewall (WAF) is built on ModSecurity apk add nginx-plus-module-modsecurity ``` - - - ## Configuration After installation you will need to enable and configure the module in NGINX Plus configuration file `nginx.conf`. @@ -66,20 +65,35 @@ After installation you will need to enable and configure the module in NGINX Plu ```nginx load_module modules/ngx_http_modsecurity_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/SpiderLabs/ModSecurity/wiki/Reference-Manual). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: -4. [Configure](https://docs.nginx.com/nginx-waf/admin-guide/nginx-plus-modsecurity-waf-installation-logging/) the module. + ```shell + nginx -s reload + ``` +5. [Configure](https://docs.nginx.com/nginx-waf/admin-guide/nginx-plus-modsecurity-waf-installation-logging/) the module. - ## More Info - [ModSecurity Documentation](https://github.com/SpiderLabs/ModSecurity/wiki) diff --git a/content/nginx/admin-guide/dynamic-modules/opentracing.md b/content/nginx/admin-guide/dynamic-modules/opentracing.md index 4b609050f..935cbdde1 100644 --- a/content/nginx/admin-guide/dynamic-modules/opentracing.md +++ b/content/nginx/admin-guide/dynamic-modules/opentracing.md @@ -25,7 +25,8 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-opentracing + sudo yum update && \ + sudo yum install nginx-plus-module-opentracing ``` {{< note >}}the OpenTracing module cannot be installed on CentOS 6, Oracle Linux 6, and RHEL 6. {{< /note >}} @@ -33,19 +34,22 @@ type: For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-opentracing + sudo dnf update && \ + sudo dnf install nginx-plus-module-opentracing ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-opentracing + sudo apt update && \ + sudo apt install nginx-plus-module-opentracing ``` For SLES: ```shell - zypper install nginx-plus-module-opentracing + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-opentracing ``` {{< note >}} the OpenTracing module cannot be installed on SLES 12. {{< /note >}} @@ -59,7 +63,8 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-opentracing + sudo pkg update && \ + sudo pkg install nginx-plus-module-opentracing ``` @@ -73,15 +78,32 @@ After installation you will need to enable and configure the module in NGINX Plu ```nginx load_module modules/ngx_http_opentracing_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/opentracing-contrib/nginx-opentracing). You will also need to [install a tracer](https://github.com/opentracing-contrib/nginx-opentracing#building-from-source) (“portable binary plugin”) for your selected service. -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` @@ -92,3 +114,5 @@ After installation you will need to enable and configure the module in NGINX Plu - [NGINX Dynamic Modules]({{< ref "nginx/admin-guide/dynamic-modules/dynamic-modules.md" >}}) - [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.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 25f2db23d..bf1cc841f 100644 --- a/content/nginx/admin-guide/dynamic-modules/passenger-open-source.md +++ b/content/nginx/admin-guide/dynamic-modules/passenger-open-source.md @@ -20,25 +20,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-passenger + sudo yum update && \ + sudo yum install nginx-plus-module-passenger ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-passenger + sudo dnf update && \ + sudo dnf install nginx-plus-module-passenger ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-passenger + sudo apt update && \ + sudo apt install nginx-plus-module-passenger ``` For SLES: ```shell - zypper install nginx-plus-module-passenger + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-passenger ``` For Alpine: @@ -50,7 +54,8 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-passenger + sudo pkg update && \ + sudo pkg install nginx-plus-module-passenger ``` @@ -64,15 +69,32 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_http_passenger_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://www.phusionpassenger.com/library/install/nginx/). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` @@ -83,3 +105,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/perl.md b/content/nginx/admin-guide/dynamic-modules/perl.md index 79615816c..bc932dfc8 100644 --- a/content/nginx/admin-guide/dynamic-modules/perl.md +++ b/content/nginx/admin-guide/dynamic-modules/perl.md @@ -20,25 +20,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-perl + sudo yum update && \ + sudo yum install nginx-plus-module-perl ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-perl + sudo dnf update && \ + sudo dnf install nginx-plus-module-perl ``` For Debian/Ubuntu: ```shell - apt-get install nginx-plus-module-perl + sudo apt update && \ + sudo apt install nginx-plus-module-perl ``` For SLES: ```shell - zypper install nginx-plus-module-perl + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-perl ``` For Alpine: @@ -50,7 +54,8 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-perl + sudo pkg update && \ + sudo pkg install nginx-plus-module-perl ``` @@ -64,15 +69,32 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_http_perl_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://nginx.org/en/docs/http/ngx_http_perl_module.html). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` @@ -83,3 +105,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md b/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md index 4ff4627ff..297c115f0 100644 --- a/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md +++ b/content/nginx/admin-guide/dynamic-modules/prometheus-njs.md @@ -65,25 +65,25 @@ Install the `nginx-plus-module-prometheus` module. - For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-prometheus + sudo yum install nginx-plus-module-prometheus ``` - For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-prometheus + sudo dnf install nginx-plus-module-prometheus ``` - For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-prometheus + sudo apt install nginx-plus-module-prometheus ``` - For SLES: ```shell - zypper install nginx-plus-module-prometheus + sudo zypper install nginx-plus-module-prometheus ``` - For Alpine: @@ -95,7 +95,7 @@ Install the `nginx-plus-module-prometheus` module. For FreeBSD: ```shell - pkg install nginx-plus-module-prometheus + sudo pkg install nginx-plus-module-prometheus ``` {{< note >}} The [`nginx-plus-module-njs`]({{< ref "nginscript.md" >}}) module will also be installed together with the module. {{< /note >}} @@ -373,3 +373,5 @@ stream { - [NGINX Dynamic Modules]({{< ref "dynamic-modules.md" >}}) - [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/rtmp.md b/content/nginx/admin-guide/dynamic-modules/rtmp.md index aa8e7d214..800753af3 100644 --- a/content/nginx/admin-guide/dynamic-modules/rtmp.md +++ b/content/nginx/admin-guide/dynamic-modules/rtmp.md @@ -19,25 +19,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-rtmp + sudo yum update && \ + sudo yum install nginx-plus-module-rtmp ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-rtmp + sudo dnf update && \ + sudo dnf install nginx-plus-module-rtmp ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-rtmp + sudo apt update && \ + sudo apt install nginx-plus-module-rtmp ``` For SLES: ```shell - zypper install nginx-plus-module-rtmp + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-rtmp ``` For Alpine: @@ -49,7 +53,8 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-rtmp + sudo pkg update && \ + sudo pkg install nginx-plus-module-rtmp ``` @@ -63,15 +68,32 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_rtmp_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/arut/nginx-rtmp-module). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` @@ -82,3 +104,7 @@ 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]({{< ref "nginx/technical-specs.md" >}}) + +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/set-misc.md b/content/nginx/admin-guide/dynamic-modules/set-misc.md index a5b42f47d..3ee03391e 100644 --- a/content/nginx/admin-guide/dynamic-modules/set-misc.md +++ b/content/nginx/admin-guide/dynamic-modules/set-misc.md @@ -10,7 +10,7 @@ type: - how-to --- - + ## Prerequisites 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -18,7 +18,7 @@ type: 2. Prior to installing the module, verify that the [NDK]({{< ref "ndk.md" >}}) module is already installed. - + ## Installation Install the Set-Misc module package `nginx-plus-module-set-misc`. @@ -26,25 +26,29 @@ Install the Set-Misc module package `nginx-plus-module-set-misc`. For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-set-misc + sudo yum update && \ + sudo yum install nginx-plus-module-set-misc ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-set-misc + sudo dnf update && \ + sudo dnf install nginx-plus-module-set-misc ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-set-misc + sudo apt update && \ + sudo apt install nginx-plus-module-set-misc ``` For SLES: ```shell - zypper install nginx-plus-module-set-misc + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-set-misc ``` For Alpine: @@ -56,11 +60,12 @@ Install the Set-Misc module package `nginx-plus-module-set-misc`. For FreeBSD: ```shell - pkg install nginx-plus-module-set-misc + sudo pkg update && \ + sudo pkg install nginx-plus-module-set-misc ``` - + ## Configuration @@ -71,20 +76,37 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ndk_http_module.so; load_module modules/ngx_http_set_misc_module.so; + + http { + # ... + } ``` {{< note >}} The directives must be in this order. {{< /note >}} 2. Perform additional configuration as required by the [module](https://github.com/openresty/set-misc-nginx-module). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: + + ```shell + nginx -t + ``` + + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ```shell - nginx -t && nginx -s reload - ``` - ## More Info - [NGINX `ngx_set_misc` Module Reference](https://github.com/openresty/set-misc-nginx-module) @@ -92,3 +114,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/spnego.md b/content/nginx/admin-guide/dynamic-modules/spnego.md index d81f059bc..134113063 100644 --- a/content/nginx/admin-guide/dynamic-modules/spnego.md +++ b/content/nginx/admin-guide/dynamic-modules/spnego.md @@ -9,7 +9,6 @@ type: - how-to --- - ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -19,25 +18,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-auth-spnego + sudo yum update && \ + sudo yum install nginx-plus-module-auth-spnego ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-auth-spnego + sudo dnf update && \ + sudo dnf install nginx-plus-module-auth-spnego ``` For Debian and Ubuntu:: ```shell - apt-get install nginx-plus-module-auth-spnego + sudo apt update && \ + sudo apt install nginx-plus-module-auth-spnego ``` For SLES: ```shell - zypper install nginx-plus-module-auth-spnego + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-auth-spnego ``` For Alpine: @@ -49,12 +52,10 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-auth-spnego + sudo pkg update && \ + sudo pkg install nginx-plus-module-auth-spnego ``` - - - ## Configuration After installation you will need to enable and configure the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -63,18 +64,33 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/spnego-http-auth-nginx-module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://github.com/stnoonan/spnego-http-auth-nginx-module). -3. Test the configuration and reload NGINX Plus to enable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NGINX Module for HTTP SPNEGO Auth Reference](https://github.com/stnoonan/spnego-http-auth-nginx-module) @@ -83,3 +99,6 @@ After installation you will need to enable and configure the module in F5 NGINX - [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) +- [NGINX Plus Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}}) diff --git a/content/nginx/admin-guide/dynamic-modules/uninstall.md b/content/nginx/admin-guide/dynamic-modules/uninstall.md index 2ee946ac6..ec5874a71 100644 --- a/content/nginx/admin-guide/dynamic-modules/uninstall.md +++ b/content/nginx/admin-guide/dynamic-modules/uninstall.md @@ -8,7 +8,6 @@ type: - how-to --- - ## Instructions 1. To uninstall a dynamic module: @@ -16,36 +15,33 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum remove + sudo yum remove ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf remove + sudo dnf remove ``` For Debian and Ubuntu: ```shell - apt-get remove + sudo apt remove ``` For SLES: ```shell - zypper remove + sudo zypper remove ``` For FreeBSD: ```shell - pkg delete + sudo pkg delete ``` - - - ## Configuration After uninstalling the package, you will need to disable the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -54,14 +50,25 @@ After uninstalling the package, you will need to disable the module in F5 NGINX 2. In NGINX Plus configuration file, remove all directives related to the dynamic module. -3. Test the configuration and reload NGINX Plus to disable the module: +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + + Expected output of the command: + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NGINX Module Reference](https://nginx.org/en/docs/) @@ -70,3 +77,5 @@ After uninstalling the package, you will need to disable the module in F5 NGINX - [NGINX Plus Technical Specifications]({{< ref "nginx/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 1c2d8351f..0a2117ea4 100644 --- a/content/nginx/admin-guide/dynamic-modules/xslt.md +++ b/content/nginx/admin-guide/dynamic-modules/xslt.md @@ -9,7 +9,6 @@ type: - how-to --- - ## Installation 1. Check the [Technical Specifications]({{< ref "nginx/technical-specs.md" >}}) page to verify that the module is supported by your operating system. @@ -19,25 +18,29 @@ type: For Amazon Linux 2, CentOS, Oracle Linux, and RHEL: ```shell - yum install nginx-plus-module-xslt + sudo yum update && \ + sudo yum install nginx-plus-module-xslt ``` For Amazon Linux 2023, AlmaLinux, Rocky Linux: ```shell - dnf install nginx-plus-module-xslt + sudo dnf update && \ + sudo dnf install nginx-plus-module-xslt ``` For Debian and Ubuntu: ```shell - apt-get install nginx-plus-module-xslt + sudo apt update && \ + sudo apt install nginx-plus-module-xslt ``` For SLES: ```shell - zypper install nginx-plus-module-xslt + sudo zypper refresh && \ + sudo zypper install nginx-plus-module-xslt ``` For Alpine: @@ -49,12 +52,10 @@ type: For FreeBSD: ```shell - pkg install nginx-plus-module-xslt + sudo pkg update && \ + sudo pkg install nginx-plus-module-xslt ``` - - - ## Configuration After installation you will need to enable and configure the module in F5 NGINX Plus configuration file `nginx.conf`. @@ -63,18 +64,33 @@ After installation you will need to enable and configure the module in F5 NGINX ```nginx load_module modules/ngx_http_xslt_module.so; + + http { + # ... + } ``` 2. Perform additional configuration as required by the [module](https://nginx.org/en/docs/http/ngx_http_xslt_module.html). -3. Test the configuration and reload NGINX Plus to enable the module +3. Test the NGINX Plus configuration. In a terminal, type-in the command: - ```shell - nginx -t && nginx -s reload - ``` + ```shell + nginx -t + ``` + Expected output of the command: + + ```shell + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf is successful + ``` + +4. Reload the NGINX Plus configuration to enable the module: + + ```shell + nginx -s reload + ``` - ## More Info - [NGINX ngx_http_xslt_module Reference](https://nginx.org/en/docs/http/ngx_http_xslt_module.html) @@ -82,3 +98,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]({{< ref "nginx/technical-specs.md" >}}) + +- [Uninstalling a Dynamic Module]({{< ref "uninstall.md" >}})