Skip to content

Add NAP v5.9.0 version info #1189

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

Merged
merged 7 commits into from
Sep 30, 2025
Merged

Add NAP v5.9.0 version info #1189

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
c905e83
fix: Update nim-app-protect-support.md
vvnginx Sep 30, 2025
c6bc4f9
fix : Add NAP 5.9.0 version info to NIM
vvnginx Sep 30, 2025
f2acb12
Update content/nim/nginx-app-protect/setup-waf-config-management.md
mjang Sep 30, 2025
4a3d980
Update content/nim/nginx-app-protect/setup-waf-config-management.md
vvnginx Sep 30, 2025
ed95f87
Merge branch 'main' into patch-1
mjang Sep 30, 2025
3bf1259
Update content/nim/nginx-app-protect/setup-waf-config-management.md
vvnginx Sep 30, 2025
503670d
Update content/nim/nginx-app-protect/setup-waf-config-management.md
vvnginx Sep 30, 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
2 changes: 1 addition & 1 deletion content/includes/nim/tech-specs/nim-app-protect-support.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ NGINX Instance Manager supports the following versions of [F5 WAF for NGINX](htt

| NGINX Instance Manager | F5 WAF for NGINX |
|------------------------|------------------------------------|
| 2.17.0–2.20.0 | Release 4.8.0–4.16.0, 5.1.0–5.8.0 |
| 2.17.0–2.20.0 | Release 4.8.0–4.16.0, 5.1.0–5.9.0 |
| 2.15.1–2.16.0 | Release 4.8.0–4.10.0 |
| 2.14.1–2.15.0 | Release 4.4.0–4.7.0 |
| 2.13.0–2.14.0 | Release 4.3.0–4.5.0 |
Expand Down
43 changes: 24 additions & 19 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 @@ -55,6 +55,7 @@ The table below shows which WAF compiler version to use for each version of F5 W

| F5 WAF for NGINX version | WAF compiler version |
|-------------------------------|----------------------------|
| 5.9.0 | nms-nap-compiler-v5.527.0 |
| 5.8.0 | nms-nap-compiler-v5.498.0 |
| 5.7.0 | nms-nap-compiler-v5.442.0 |
| 5.6.0 | nms-nap-compiler-v5.342.0 |
Expand Down Expand Up @@ -85,18 +86,22 @@ The table below shows which WAF compiler version to use for each version of F5 W

{{</bootstrap-table>}}

{{< call-out "note" >}}
Until recently, packages designed for installation on virtual machines were released as 4.x.x versions (NAP 4.15.0, NAP 4.16.0, etc.), while packages meant for installation on containers were provided as 5.x.x versions (NAP 5.7.0, NAP 5.8.0, and so on.). Beginning with v5.9.0, both the installation packages for virtual machines and those for containers will be categorized under the 5.x.x tag.
{{< /call-out >}}

### Debian or Ubuntu

To install the WAF compiler on Debian or Ubuntu, run the following command:

```shell
sudo apt-get install nms-nap-compiler-v5.498.0
sudo apt-get install nms-nap-compiler-v5.527.0
```

If you want to install more than one version of the WAF compiler on the same system, append the `--force-overwrite` option to the install command after the first installation:

```shell
sudo apt-get install nms-nap-compiler-v5.498.0 -o Dpkg::Options::="--force-overwrite"
sudo apt-get install nms-nap-compiler-v5.527.0 -o Dpkg::Options::="--force-overwrite"
```

{{< include "nim/nap-waf/restart-nms-integrations.md" >}}
Expand All @@ -120,7 +125,7 @@ To install the WAF compiler on RHEL 8.1 :
3. Install the WAF compiler:

```shell
sudo yum install nms-nap-compiler-v5.498.0
sudo yum install nms-nap-compiler-v5.527.0
```

### RHEL 9
Expand All @@ -142,7 +147,7 @@ To install the WAF compiler on RHEL 9:
3. Install the WAF compiler:

```shell
sudo yum install nms-nap-compiler-v5.498.0
sudo yum install nms-nap-compiler-v5.527.0
```

4. {{< include "nim/nap-waf/restart-nms-integrations.md" >}}
Expand All @@ -166,7 +171,7 @@ To install the WAF compiler on Oracle Linux 8.1:
3. Install the WAF compiler:

```shell
sudo yum install nms-nap-compiler-v5.498.0
sudo yum install nms-nap-compiler-v5.527.0
```

4. {{< include "nim/nap-waf/restart-nms-integrations.md" >}}
Expand Down Expand Up @@ -252,7 +257,7 @@ To install the WAF compiler on a system without internet access, complete these


Note : Version of NAP compiler can be referred from the table at the top of this page.
Current latest version 5.498.0 at the point of writing this document is used in below commands.
Current latest version 5.527.0 at the point of writing this document is used in below commands.

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

Expand Down Expand Up @@ -282,10 +287,10 @@ sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/fil
mkdir -p compiler && cd compiler
sudo apt-get update

sudo apt-get download nms-nap-compiler-v5.498.0
sudo apt-get download nms-nap-compiler-v5.527.0
cd ../
mkdir -p compiler/compiler.deps
sudo apt-get install --download-only --reinstall --yes --print-uris nms-nap-compiler-v5.498.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.527.0 | grep ^\' | cut -d\' -f2 | xargs -n 1 wget -P ./compiler/compiler.deps

tar -czvf compiler.tar.gz compiler/
```
Expand Down Expand Up @@ -328,11 +333,11 @@ sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/fil
mkdir -p compiler && cd compiler
sudo apt-get update

sudo apt-get download nms-nap-compiler-v5.498.0
sudo apt-get download nms-nap-compiler-v5.527.0

cd ../
mkdir -p compiler/compiler.deps
sudo apt-get install --download-only --reinstall --yes --print-uris nms-nap-compiler-v5.498.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.527.0 | grep ^\' | cut -d\' -f2 | xargs -n 1 wget -P ./compiler/compiler.deps
tar -czvf compiler.tar.gz compiler/
```

Expand Down Expand Up @@ -370,7 +375,7 @@ 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.498.0
sudo yumdownloader --resolve --destdir=nms-nap-compiler nms-nap-compiler-v5.527.0
tar -czvf compiler.tar.gz nms-nap-compiler/
```

Expand Down Expand Up @@ -414,7 +419,7 @@ EOF
sudo yum update -y
sudo mkdir -p nms-nap-compiler

sudo yumdownloader --resolve --destdir=nms-nap-compiler nms-nap-compiler-v5.498.0
sudo yumdownloader --resolve --destdir=nms-nap-compiler nms-nap-compiler-v5.527.0
tar -czvf compiler.tar.gz nms-nap-compiler/
```

Expand Down Expand Up @@ -1207,21 +1212,21 @@ sudo /opt/nms-nap-compiler/app_protect-<version>/bin/apcompile -h
**Example:**

```shell
sudo /opt/nms-nap-compiler/app_protect-5.498.0/bin/apcompile -h
sudo /opt/nms-nap-compiler/app_protect-5.527.0/bin/apcompile -h
```

**Expected output:**

```text
USAGE:
/opt/nms-nap-compiler/app_protect-5.498.0/bin/apcompile <options>
/opt/nms-nap-compiler/app_protect-5.527.0/bin/apcompile <options>

Examples:
/opt/nms-nap-compiler/app_protect-5.498.0/bin/apcompile -p /path/to/policy.json -o mypolicy.tgz
/opt/nms-nap-compiler/app_protect-5.498.0/bin/apcompile -p policyA.json -g myglobal.json -o /path/to/policyA_bundle.tgz
/opt/nms-nap-compiler/app_protect-5.498.0/bin/apcompile -g myglobalsettings.json --global-state-outfile /path/to/myglobalstate.tgz
/opt/nms-nap-compiler/app_protect-5.498.0/bin/apcompile -b /path/to/policy_bundle.tgz --dump
/opt/nms-nap-compiler/app_protect-5.498.0/bin/apcompile -l logprofA.json -o /path/to/logprofA_bundle.tgz
/opt/nms-nap-compiler/app_protect-5.527.0/bin/apcompile -p /path/to/policy.json -o mypolicy.tgz
/opt/nms-nap-compiler/app_protect-5.527.0/bin/apcompile -p policyA.json -g myglobal.json -o /path/to/policyA_bundle.tgz
/opt/nms-nap-compiler/app_protect-5.527.0/bin/apcompile -g myglobalsettings.json --global-state-outfile /path/to/myglobalstate.tgz
/opt/nms-nap-compiler/app_protect-5.527.0/bin/apcompile -b /path/to/policy_bundle.tgz --dump
/opt/nms-nap-compiler/app_protect-5.527.0/bin/apcompile -l logprofA.json -o /path/to/logprofA_bundle.tgz
```

### Confirm NGINX Agent configuration on the F5 WAF for NGINX instance
Expand Down