Skip to content

docs: update the NAP and NIM versions for NAP 4.14.0 and 5.6.0 #417

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 6 commits into from
Apr 17, 2025
Merged

docs: update the NAP and NIM versions for NAP 4.14.0 and 5.6.0 #417

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
a36d8f0
Update nim-app-protect-support.md w.r.t NAP version 4.14 release
vvnginx Apr 16, 2025
ca91bff
Update setup-waf-config-management.md w.r.t NAP compiler v5.342.0 rel…
vvnginx Apr 16, 2025
682e946
Merge branch 'main' into patch-1
ADubhlaoich Apr 17, 2025
76b73b3
Merge branch 'main' into patch-1
ADubhlaoich Apr 17, 2025
e87bce5
Merge branch 'main' into patch-1
mjang Apr 17, 2025
d3dbe88
Merge branch 'main' into patch-1
vvnginx Apr 17, 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 [NGINX App Protect WAF

| NGINX Instance Manager | NGINX App Protect WAF |
|------------------------|------------------------------------|
| 2.17.0–2.19.1 | Release 4.8.0–4.13.0, 5.1.0–5.5.0 |
| 2.17.0–2.19.1 | Release 4.8.0–4.14.0, 5.1.0–5.6.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
30 changes: 16 additions & 14 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 @@ -53,11 +53,13 @@ The following table shows the NGINX App Protect WAF Release version and its corr

| NGINX App Protect WAF Release version | WAF Compiler |
|---------------------------------------|----------------------------|
| NGINX App Protect WAF 5.6.0 | nms-nap-compiler-v5.342.0 |
| NGINX App Protect WAF 5.5.0 | nms-nap-compiler-v5.264.0 |
| NGINX App Protect WAF 5.4.0 | nms-nap-compiler-v5.210.0 |
| NGINX App Protect WAF 5.3.0 | nms-nap-compiler-v5.144.0 |
| NGINX App Protect WAF 5.2.0 | nms-nap-compiler-v5.48.0 |
| NGINX App Protect WAF 5.1.0 | nms-nap-compiler-v5.17.0 |
| NGINX App Protect WAF 4.14.0 | nms-nap-compiler-v5.342.0 |
| NGINX App Protect WAF 4.13.0 | nms-nap-compiler-v5.264.0 |
| NGINX App Protect WAF 4.12.0 | nms-nap-compiler-v5.210.0 |
| NGINX App Protect WAF 4.11.0 | nms-nap-compiler-v5.144.0 |
Expand Down Expand Up @@ -95,15 +97,15 @@ The following table shows the NGINX App Protect WAF Release version and its corr
Install the WAF compiler, then restart the `nms-integrations` service:

```bash
sudo apt-get install nms-nap-compiler-v5.264.0
sudo apt-get install nms-nap-compiler-v5.342.0
```

{{<note>}}

- If you want to have more than one version of the `nms-nap-compiler` installed on your system at once, you'll need to append `-o Dpkg::Options::="--force-overwrite"` to the `nms-nap-compiler` installation commands after your initial `nms-nap-compiler` installation. For example, the installation command would look like this:

```bash
sudo apt-get install nms-nap-compiler-v5.264.0 -o Dpkg::Options::="--force-overwrite"
sudo apt-get install nms-nap-compiler-v5.342.0 -o Dpkg::Options::="--force-overwrite"
```

{{</note>}}
Expand All @@ -115,7 +117,7 @@ Download the file dependencies.repo to `/etc/yum.repos.d`, enable the `codeready
```bash
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/dependencies.repo
sudo subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
sudo yum install nms-nap-compiler-v5.264.0
sudo yum install nms-nap-compiler-v5.342.0
```

### RHEL 7.4 or later; CentOS
Expand All @@ -124,7 +126,7 @@ Download the file `dependencies.repo` to `/etc/yum.repos.d`, enable the RHEL 7 s
```bash
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/dependencies.repo
sudo yum-config-manager --enable rhui-REGION-rhel-server-optional rhui-REGION-rhel-server-releases rhel-7-server-optional-rpms
sudo yum install nms-nap-compiler-v5.264.0
sudo yum install nms-nap-compiler-v5.342.0
```

### Amazon Linux 2 LTS
Expand All @@ -136,7 +138,7 @@ sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/app-protect-7.re
sudo amazon-linux-extras enable epel
sudo yum clean metadata
sudo yum install epel-release
sudo yum install nms-nap-compiler-v5.264.0
sudo yum install nms-nap-compiler-v5.342.0
```

### Oracle Linux 7.4 or later
Expand All @@ -145,7 +147,7 @@ Download the file `dependencies.repo` to `/etc/yum.repos.d`, enable the `ol8_cod
```bash
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/dependencies.repo
sudo yum-config-manager --enable ol8_codeready_builder
sudo yum install nms-nap-compiler-v5.264.0
sudo yum install nms-nap-compiler-v5.342.0
```

### Download from MyF5
Expand Down Expand Up @@ -1088,24 +1090,24 @@ Check if the WAF compiler has been installed and is working properly by viewing
sudo /opt/nms-nap-compiler/app_protect-<version>/bin/apcompile -h
```

For example, to view the help description for WAF compiler 5.264.0, run the following command:
For example, to view the help description for WAF compiler 5.342.0, run the following command:

``` bash
sudo /opt/nms-nap-compiler/app_protect-5.264.0/bin/apcompile -h
sudo /opt/nms-nap-compiler/app_protect-5.342.0/bin/apcompile -h
```

The output looks similar to the following example:

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

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

Expand Down
Loading