Skip to content

fix: Update manual install steps for RHEL-9 #908

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

fix: Update manual install steps for RHEL-9 #908

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
2fe1a57
fix: Update manual install steps for RHEL-9
vvnginx Jul 30, 2025
c81288a
fix: Update NAP compiler version to latest
vvnginx Jul 30, 2025
455b461
fix: setup-waf-config-management.md
vvnginx Jul 30, 2025
f4edeca
Update content/nim/nginx-app-protect/setup-waf-config-management.md
vvnginx Jul 31, 2025
393dcd2
Update content/includes/installation/add-nms-repo.md
vvnginx Jul 31, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions content/includes/installation/add-nms-repo.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 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.*
```

- **Amazon Linux 2**

Expand Down
25 changes: 14 additions & 11 deletions content/nim/nginx-app-protect/setup-waf-config-management.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -270,13 +270,16 @@ 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 or update the WAF compiler in a disconnected environment

To install the WAF compiler on a system without internet access, complete these steps:

- **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.

{{<tabs name="WAF compiler installation in offline environment">}}

{{%tab name="Ubuntu"%}}
Expand All @@ -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/
```

Expand Down Expand Up @@ -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/
```

Expand All @@ -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

Expand All @@ -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/
```

Expand All @@ -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

Expand All @@ -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/
```

Expand Down
Loading