From 2fe1a5764f8619d401914143be3793b0de686776 Mon Sep 17 00:00:00 2001 From: vvnginx Date: Wed, 30 Jul 2025 18:00:58 +0530 Subject: [PATCH 1/6] fix: Update manual install steps for RHEL-9 --- content/includes/installation/add-nms-repo.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/content/includes/installation/add-nms-repo.md b/content/includes/installation/add-nms-repo.md index 05639f135..b2deac84c 100644 --- a/content/includes/installation/add-nms-repo.md +++ b/content/includes/installation/add-nms-repo.md @@ -25,6 +25,11 @@ Add the NGINX Instance Manager repository: sudo yum module disable nginx:1.14 sudo yum module enable nginx:1.20 ``` + - **RHEL 9**: If you're installing on RHEL 9 and using the distro's NGINX, run the following commands to use the new version of NGINX (1.20 at the time of this update): + + ```bash + sudo yum install nginx-1.20.* + ``` - **Amazon Linux 2** From c81288a06536a48678bd36aa2d2e96655e7ec05e Mon Sep 17 00:00:00 2001 From: vvnginx Date: Wed, 30 Jul 2025 18:18:22 +0530 Subject: [PATCH 2/6] fix: Update NAP compiler version to latest --- .../setup-waf-config-management.md | 23 +++++++++++-------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/content/nim/nginx-app-protect/setup-waf-config-management.md b/content/nim/nginx-app-protect/setup-waf-config-management.md index 5d7751e7e..f20f1faa0 100644 --- a/content/nim/nginx-app-protect/setup-waf-config-management.md +++ b/content/nim/nginx-app-protect/setup-waf-config-management.md @@ -277,6 +277,9 @@ To install the WAF compiler on a system without internet access, complete these - **Step 1:** Generate the WAF compiler package on a system that has internet access. - **Step 2:** Move the generated package to the offline target system and install it. +Note : Version of NAP compiler can be referred from the table at the top of this page. +Current latest version 5.442.0 at the point of writing this document is used in below commands. + {{}} {{%tab name="Ubuntu"%}} @@ -303,10 +306,10 @@ sudo tee /etc/apt/sources.list.d/nms.list sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/files/90pkgs-nginx mkdir -p compiler && cd compiler sudo apt-get update -sudo apt-get download nms-nap-compiler-v5.342.0 +sudo apt-get download nms-nap-compiler-v5.442.0 cd ../ mkdir -p compiler/compiler.deps -sudo apt-get install --download-only --reinstall --yes --print-uris nms-nap-compiler-v5.342.0 | grep ^\' | cut -d\' -f2 | xargs -n 1 wget -P ./compiler/compiler.deps +sudo apt-get install --download-only --reinstall --yes --print-uris nms-nap-compiler-v5.442.0 | grep ^\' | cut -d\' -f2 | xargs -n 1 wget -P ./compiler/compiler.deps tar -czvf compiler.tar.gz compiler/ ``` @@ -347,10 +350,10 @@ sudo tee /etc/apt/sources.list.d/nms.list sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/files/90pkgs-nginx mkdir -p compiler && cd compiler sudo apt-get update -sudo apt-get download nms-nap-compiler-v5.342.0 +sudo apt-get download nms-nap-compiler-v5.442.0 cd ../ mkdir -p compiler/compiler.deps -sudo apt-get install --download-only --reinstall --yes --print-uris nms-nap-compiler-v5.342.0 | grep ^\' | cut -d\' -f2 | xargs -n 1 wget -P ./compiler/compiler.deps +sudo apt-get install --download-only --reinstall --yes --print-uris nms-nap-compiler-v5.442.0 | grep ^\' | cut -d\' -f2 | xargs -n 1 wget -P ./compiler/compiler.deps tar -czvf compiler.tar.gz compiler/ ``` @@ -367,9 +370,9 @@ sudo dpkg -i ./compiler/*.deb {{%/tab%}} -{{%tab name="RHEL8, RHEL9, Oracle-9 "%}} +{{%tab name="RHEL9, Oracle-9 "%}} -### Install on RHEL 8, RHEL 9, or Oracle Linux 9 +### Install on RHEL 9 or Oracle Linux 9 #### Step 1: On a system with internet access @@ -386,7 +389,7 @@ sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nms.repo sudo yum-config-manager --disable rhel-9-appstream-rhui-rpms sudo yum update -y sudo mkdir -p nms-nap-compiler -sudo yumdownloader --resolve --destdir=nms-nap-compiler nms-nap-compiler-v5.342.0 +sudo yumdownloader --resolve --destdir=nms-nap-compiler nms-nap-compiler-v5.442.0 tar -czvf compiler.tar.gz nms-nap-compiler/ ``` @@ -403,9 +406,9 @@ sudo dnf install *.rpm --disablerepo=* {{%/tab%}} -{{%tab name="Oracle-8"%}} +{{%tab name="Redhat-8, Oracle-8"%}} -### Install on Oracle Linux 8 +### Install on RHEL-8 or Oracle Linux 8 #### Step 1: On a system with internet access @@ -428,7 +431,7 @@ EOF sudo yum update -y sudo mkdir -p nms-nap-compiler -sudo yumdownloader --resolve --destdir=nms-nap-compiler nms-nap-compiler-v5.342.0 +sudo yumdownloader --resolve --destdir=nms-nap-compiler nms-nap-compiler-v5.442.0 tar -czvf compiler.tar.gz nms-nap-compiler/ ``` From 455b461d95f61c26b6ab80b13385ad5e1b7ca708 Mon Sep 17 00:00:00 2001 From: vvnginx Date: Wed, 30 Jul 2025 18:30:04 +0530 Subject: [PATCH 3/6] fix: setup-waf-config-management.md --- content/nim/nginx-app-protect/setup-waf-config-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/nim/nginx-app-protect/setup-waf-config-management.md b/content/nim/nginx-app-protect/setup-waf-config-management.md index f20f1faa0..c1c17fd9b 100644 --- a/content/nim/nginx-app-protect/setup-waf-config-management.md +++ b/content/nim/nginx-app-protect/setup-waf-config-management.md @@ -270,7 +270,7 @@ error when creating the nginx repo retriever - NGINX repo certificates not found If needed, you can also [install the WAF compiler manually](#install-the-waf-compiler). -## Install the WAF compiler in a disconnected environment +## Install/Update the WAF compiler in a disconnected environment To install the WAF compiler on a system without internet access, complete these steps: From f4edeca743229afa5a4598f91ec013e97460a55f Mon Sep 17 00:00:00 2001 From: vvnginx Date: Thu, 31 Jul 2025 13:09:36 +0530 Subject: [PATCH 4/6] Update content/nim/nginx-app-protect/setup-waf-config-management.md Co-authored-by: yar --- content/nim/nginx-app-protect/setup-waf-config-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/nim/nginx-app-protect/setup-waf-config-management.md b/content/nim/nginx-app-protect/setup-waf-config-management.md index c1c17fd9b..68650c0a0 100644 --- a/content/nim/nginx-app-protect/setup-waf-config-management.md +++ b/content/nim/nginx-app-protect/setup-waf-config-management.md @@ -270,7 +270,7 @@ error when creating the nginx repo retriever - NGINX repo certificates not found If needed, you can also [install the WAF compiler manually](#install-the-waf-compiler). -## Install/Update the WAF compiler in a disconnected environment +## Install or update the WAF compiler in a disconnected environment To install the WAF compiler on a system without internet access, complete these steps: From 393dcd2ee87f07a65bdfb892c2eaaffb31a292df Mon Sep 17 00:00:00 2001 From: vvnginx Date: Thu, 31 Jul 2025 13:10:04 +0530 Subject: [PATCH 5/6] Update content/includes/installation/add-nms-repo.md Co-authored-by: yar --- content/includes/installation/add-nms-repo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/includes/installation/add-nms-repo.md b/content/includes/installation/add-nms-repo.md index b2deac84c..037ec3e09 100644 --- a/content/includes/installation/add-nms-repo.md +++ b/content/includes/installation/add-nms-repo.md @@ -25,7 +25,7 @@ Add the NGINX Instance Manager repository: sudo yum module disable nginx:1.14 sudo yum module enable nginx:1.20 ``` - - **RHEL 9**: If you're installing on RHEL 9 and using the distro's NGINX, run the following commands to use the new version of NGINX (1.20 at the time of this update): + - **RHEL 9**: If you're installing NGINX Open Source package from the yum repository on RHEL 9, run the following commands to use the new version of NGINX Open Source (1.20 at the time of this update): ```bash sudo yum install nginx-1.20.* From 32982e7b79d837f049804dc2f568c129052db726 Mon Sep 17 00:00:00 2001 From: vvnginx Date: Tue, 12 Aug 2025 22:24:13 +0530 Subject: [PATCH 6/6] fix: Update setup-waf-config-management.md --- .../nginx-app-protect/setup-waf-config-management.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/nim/nginx-app-protect/setup-waf-config-management.md b/content/nim/nginx-app-protect/setup-waf-config-management.md index 8829cb28e..fa7a56bcc 100644 --- a/content/nim/nginx-app-protect/setup-waf-config-management.md +++ b/content/nim/nginx-app-protect/setup-waf-config-management.md @@ -99,9 +99,9 @@ sudo apt-get install nms-nap-compiler-v5.442.0 -o Dpkg::Options::="--force-overw {{< include "nim/nap-waf/restart-nms-integrations.md" >}} -### RHEL 8.1 or later +### RHEL 8.1 -To install the WAF compiler on RHEL 8.1 or later: +To install the WAF compiler on RHEL 8.1 : 1. Download the `dependencies.repo` file to the `/etc/yum.repos.d` directory: @@ -121,9 +121,9 @@ To install the WAF compiler on RHEL 8.1 or later: sudo yum install nms-nap-compiler-v5.442.0 ``` -### RHEL 9 or later +### RHEL 9 -To install the WAF compiler on RHEL 9 or later: +To install the WAF compiler on RHEL 9: 1. Download the `dependencies.repo` file to the `/etc/yum.repos.d` directory: @@ -145,9 +145,9 @@ To install the WAF compiler on RHEL 9 or later: 4. {{< include "nim/nap-waf/restart-nms-integrations.md" >}} -### Oracle Linux 8.1 or later +### Oracle Linux 8.1 -To install the WAF compiler on Oracle Linux 7.4 or later: +To install the WAF compiler on Oracle Linux 8.1: 1. Download the `dependencies.repo` file to the `/etc/yum.repos.d` directory: