diff --git a/content/includes/nginx-plus/install/copy-jwt-to-etc-nginx-dir.md b/content/includes/nginx-plus/install/copy-jwt-to-etc-nginx-dir.md index 2e83bd0b5..c14190754 100644 --- a/content/includes/nginx-plus/install/copy-jwt-to-etc-nginx-dir.md +++ b/content/includes/nginx-plus/install/copy-jwt-to-etc-nginx-dir.md @@ -2,10 +2,8 @@ docs: --- -After downloading the JWT file, copy it to the **/etc/nginx/** directory and make sure it's named **license.jwt**: +Copy the downloaded JWT file to the **/etc/nginx/** directory and make sure it is named **license.jwt**: ```shell sudo cp .jwt /etc/nginx/license.jwt ``` - -Replace `.jwt` with the actual name of your downloaded JWT file. \ No newline at end of file diff --git a/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md b/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md index 1ab54b023..c2c01998d 100644 --- a/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md +++ b/content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md @@ -47,9 +47,8 @@ NGINX, Inc. provides packages for the following CentOS, Oracle Linux, RHEL, Alm |Version | Supported Platforms | | ---| --- | -|7.4+ | x86_64, aarch64/arm64 | -|8x | x86_64, aarch64/arm64, s390x | -|9x | x86_64, aarch64/arm64, s390x | +|8x | x86_64, aarch64/arm64 | +|9x | x86_64, aarch64/arm64 | {{}} @@ -155,7 +154,7 @@ The package can be installed from: ```shell curl -I 127.0.0.1 HTTP/1.1 200 OK - Server: nginx/1.27.0 + Server: nginx/1.27.4 ``` @@ -284,7 +283,7 @@ The package can be installed from: ```shell curl -I 127.0.0.1 HTTP/1.1 200 OK - Server: nginx/1.27.0 + Server: nginx/1.27.4 ``` @@ -299,8 +298,8 @@ NGINX provides packages for the following Ubuntu operating systems: | ---| ---| --- | |20.04 | focal | x86_64, aarch64/arm64, s390x | |22.04 | jammy | x86_64, aarch64/arm64, s390x | -|22.10 | kinetic | x86_64, aarch64/arm64 | -|23.04 | lunar | x86_64, aarch64/arm64 | +|24.04 | noble | x86_64, aarch64/arm64 | +|24.10 | oracular | x86_64, aarch64/arm64 | {{}} @@ -412,7 +411,7 @@ The package can be installed from: ```shell curl -I 127.0.0.1 HTTP/1.1 200 OK - Server: nginx/1.27.0 + Server: nginx/1.27.4 ``` @@ -425,7 +424,6 @@ NGINX provides packages for SUSE Linux Enterprise Server: |Version | Supported Platforms | | ---| --- | -|SLES 12 SP5+ | x86_64 | |SLES 15 SP2+ | x86_64 | {{}} @@ -508,10 +506,10 @@ NGINX provides packages for the following Alpine Linux operating systems: |Version | Supported Platforms | | ---| --- | -|3.15 | x86_64, aarch64/arm64 | -|3.16 | x86_64, aarch64/arm64 | -|3.17 | x86_64, aarch64/arm64 | |3.18 | x86_64, aarch64/arm64 | +|3.19 | x86_64, aarch64/arm64 | +|3.20 | x86_64, aarch64/arm64 | +|3.21 | x86_64, aarch64/arm64 | {{}} @@ -689,9 +687,9 @@ Prior to compiling NGINX Open Source from source, you need to install librarie - [PCRE](http://pcre.org/) – Supports regular expressions. Required by the NGINX [Core](https://nginx.org/en/docs/ngx_core_module.html) and [Rewrite](https://nginx.org/en/docs/http/ngx_http_rewrite_module.html) modules. ```shell - wget github.com/PCRE2Project/pcre2/releases/download/pcre2-10.42/pcre2-10.42.tar.gz - tar -zxf pcre2-10.42.tar.gz - cd pcre2-10.42 + wget github.com/PCRE2Project/pcre2/releases/download/pcre2-10.43/pcre2-10.43.tar.gz + tar -zxf pcre2-10.43.tar.gz + cd pcre2-10.43 ./configure make sudo make install @@ -700,9 +698,9 @@ Prior to compiling NGINX Open Source from source, you need to install librarie - [zlib](http://www.zlib.net/) – Supports header compression. Required by the NGINX [Gzip](https://nginx.org/en/docs/http/ngx_http_gzip_module.html) module. ```shell - wget http://zlib.net/zlib-1.2.13.tar.gz - tar -zxf zlib-1.2.13.tar.gz - cd zlib-1.2.13 + wget http://zlib.net/zlib-1.3.1.tar.gz + tar -zxf zlib-1.3.1.tar.gz + cd zlib-1.3.1 ./configure make sudo make install @@ -711,9 +709,9 @@ Prior to compiling NGINX Open Source from source, you need to install librarie - [OpenSSL](https://www.openssl.org/) – Supports the HTTPS protocol. Required by the NGINX [SSL](https://nginx.org/en/docs/http/ngx_http_ssl_module.html) module and others. ```shell - wget http://www.openssl.org/source/openssl-1.1.1v.tar.gz - tar -zxf openssl-1.1.1v.tar.gz - cd openssl-1.1.1v + wget http://www.openssl.org/source/openssl-3.0.13.tar.gz + tar -zxf openssl-3.0.13.tar.gz + cd openssl-3.0.13 ./Configure darwin64-x86_64-cc --prefix=/usr make sudo make install @@ -727,17 +725,17 @@ Download the source files for both the stable and mainline versions from [**ngin To download and unpack the source for the latest _mainline_ version, run: ```shell -wget https://nginx.org/download/nginx-1.27.0.tar.gz -tar zxf nginx-1.27.0.tar.gz -cd nginx-1.27.0 +wget https://nginx.org/download/nginx-1.27.4.tar.gz +tar zxf nginx-1.27.4.tar.gz +cd nginx-1.27.4 ``` To download and unpack source files for the latest _stable_ version, run: ```shell -wget https://nginx.org/download/nginx-1.26.1.tar.gz -tar zxf nginx-1.26.1.tar.gz -cd nginx-1.26.1 +wget https://nginx.org/download/nginx-1.26.3.tar.gz +tar zxf nginx-1.26.3.tar.gz +cd nginx-1.26.3 ``` @@ -752,8 +750,8 @@ An example of options to the `configure` script (should be typed as a single lin --sbin-path=/usr/local/nginx/nginx --conf-path=/usr/local/nginx/nginx.conf --pid-path=/usr/local/nginx/nginx.pid ---with-pcre=../pcre2-10.42 ---with-zlib=../zlib-1.2.13 +--with-pcre=../pcre2-10.43 +--with-zlib=../zlib-1.3.1 --with-http_ssl_module --with-stream --with-mail=dynamic @@ -841,8 +839,8 @@ If you do not need a module that is built by default, you can disable it by nami --pid-path=/usr/local/nginx/nginx.pid --with-http_ssl_module --with-stream ---with-pcre=../pcre2-10.42 ---with-zlib=../zlib-1.2.13 +--with-pcre=../pcre2-10.43 +--with-zlib=../zlib-1.3.1 --without-http_empty_gif_module ``` @@ -896,8 +894,8 @@ An example of the `configure` command that includes nondefault modules (should b --sbin-path=/usr/local/nginx/nginx --conf-path=/usr/local/nginx/nginx.conf --pid-path=/usr/local/nginx/nginx.pid ---with-pcre=../pcre2-10.42 ---with-zlib=../zlib-1.2.13 +--with-pcre=../pcre2-10.43 +--with-zlib=../zlib-1.3.1 --with-http_ssl_module --with-stream --with-mail diff --git a/content/nginx/admin-guide/installing-nginx/installing-nginx-plus.md b/content/nginx/admin-guide/installing-nginx/installing-nginx-plus.md index 6695f2d2b..051696147 100644 --- a/content/nginx/admin-guide/installing-nginx/installing-nginx-plus.md +++ b/content/nginx/admin-guide/installing-nginx/installing-nginx-plus.md @@ -26,10 +26,6 @@ This article explains how to install NGINX Plus on different operating systems, 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. {{< include "nginx-plus/install/install-ca-certificates-dependency-dnf.md" >}} 1. {{< include "nginx-plus/install/create-dir-for-crt-key.md" >}} @@ -44,6 +40,8 @@ This article explains how to install NGINX Plus on different operating systems, 1. {{< include "nginx-plus/install/install-nginx-plus-package-dnf.md" >}} +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} 1. {{< include "nginx-plus/install/configure-usage-reporting.md" >}} @@ -58,10 +56,6 @@ This article explains how to install NGINX Plus on different operating systems, 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. {{< include "nginx-plus/install/install-ca-certificates-dependency-yum.md" >}} 1. {{< include "nginx-plus/install/create-dir-for-crt-key.md" >}} @@ -76,6 +70,8 @@ This article explains how to install NGINX Plus on different operating systems, 1. {{< include "nginx-plus/install/install-nginx-plus-package-yum.md" >}} +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} 1. {{< include "nginx-plus/install/configure-usage-reporting.md" >}} @@ -130,10 +126,6 @@ CentOS 7.4, RHEL 7.4, and Oracle Linux 7.4 are deprecated as of NGINX Plus Relea 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. {{< include "nginx-plus/install/install-ca-certificates-dependency-dnf.md" >}} 1. {{< include "nginx-plus/install/create-dir-for-crt-key.md" >}} @@ -153,6 +145,8 @@ CentOS 7.4, RHEL 7.4, and Oracle Linux 7.4 are deprecated as of NGINX Plus Relea 1. {{< include "nginx-plus/install/install-nginx-plus-package-dnf.md" >}} +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/enable-nginx-service-at-boot.md" >}} 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} @@ -169,10 +163,6 @@ CentOS 7.4, RHEL 7.4, and Oracle Linux 7.4 are deprecated as of NGINX Plus Relea 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. {{< include "nginx-plus/install/install-ca-certificates-dependency-dnf.md" >}} 1. {{< include "nginx-plus/install/create-dir-for-crt-key.md" >}} @@ -192,6 +182,8 @@ CentOS 7.4, RHEL 7.4, and Oracle Linux 7.4 are deprecated as of NGINX Plus Relea 1. {{< include "nginx-plus/install/install-nginx-plus-package-dnf.md" >}} +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/enable-nginx-service-at-boot.md" >}} 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} @@ -210,10 +202,6 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. {{< include "nginx-plus/install/create-dir-for-crt-key.md" >}} 1. {{< include "nginx-plus/install/copy-crt-and-key.md" >}} @@ -282,6 +270,8 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: sudo apt install -y nginx-plus ``` +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} 1. {{< include "nginx-plus/install/configure-usage-reporting.md" >}} @@ -296,19 +286,6 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. Create the **/usr/local/etc/nginx/** directory for the JWT license file: - - ```shell - sudo mkdir -p /usr/local/etc/nginx - cd /usr/local/etc/nginx - ``` - -1. Rename the downloaded JWT file to **license.jwt** and copy it to the **/usr/local/etc/nginx** directory: - - ```shell - sudo cp license.jwt /usr/local/etc/nginx - ``` - 1. Install the prerequisite **ca_root_nss** package: ```shell @@ -340,6 +317,12 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: sudo pkg install nginx-plus ``` +1. Copy the downloaded JWT file to the **/usr/local/etc/nginx** directory and make sure it is named **license.jwt**: + + ```shell + sudo cp license.jwt /usr/local/etc/nginx + ``` + 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} 1. {{< include "nginx-plus/install/configure-usage-reporting.md" >}} @@ -354,10 +337,6 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. {{< include "nginx-plus/install/create-dir-for-crt-key.md" >}} 1. {{< include "nginx-plus/install/copy-crt-and-key.md" >}} @@ -399,6 +378,8 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: zypper install nginx-plus ``` +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} 1. {{< include "nginx-plus/install/configure-usage-reporting.md" >}} @@ -413,10 +394,6 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: 1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. Upload **nginx-repo.key** to **/etc/apk/cert.key** and **nginx-repo.crt** to **/etc/apk/cert.pem**. Ensure these files contain only the specific key and certificate — Alpine Linux doesn't support mixing client certificates for multiple repositories. 1. Put the NGINX signing public key in the **/etc/apk/keys** directory: @@ -444,13 +421,14 @@ NGINX Plus can be installed on the following versions of Debian or Ubuntu: sudo apk add nginx-plus ``` +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} 1. {{< include "nginx-plus/install/configure-usage-reporting.md" >}} 1. {{< include "nginx-plus/install/install-nginx-agent-for-nim.md" >}} - ## Install Dynamically Loadable Modules {#install_modules} NGINX Plus functionality can be extended with dynamically loadable modules that are not included in the prebuilt packages: @@ -637,7 +615,7 @@ As a workaround, in such environments NGINX Plus can be installed with a specia - Makes a backup copy of the configuration directory -- Has an option to upgrade an existing unprivileged installation of NGINX Plus +- Provides an option to upgrade an existing unprivileged installation of NGINX Plus Comparing to a standard installation of NGINX Plus, an unprivileged installation has certain limitations and restrictions: @@ -645,7 +623,7 @@ Comparing to a standard installation of NGINX Plus, an unprivileged installatio - The script is not intended to replace your operating system's package manager and does not allow for the installation of any software other than NGINX Plus and its modules. Modifications to the script for other installations are not covered by the support program. -- NGINX Plus will not start automatically, so, you must add custom `init` script/`systemd`unit file for each unprivileged installation on the host. +- NGINX Plus will not start automatically, so, you must add a custom `init` script or a `systemd` unit file for each unprivileged installation on the host. - all dependencies and libraries required by the NGINX Plus binary and its modules are not installed automatically and should be checked and installed manually. @@ -662,6 +640,10 @@ Before starting the unprivileged installation, make sure you have all the prereq To perform an unprivileged installation of NGINX Plus: +1. {{< include "licensing-and-reporting/download-jwt-crt-from-myf5.md" >}} + +1. Ensure that the downloaded JWT license file is named **license.jwt**. + 1. Obtain the script: ```shell @@ -674,14 +656,12 @@ To perform an unprivileged installation of NGINX Plus: chmod +x ngxunprivinst.sh ``` -1. Download NGINX Plus and its module packages for your operating system. The ``, `` and `` are your NGINX Plus certificate, private key, and JWT license obtained from [MyF5 Customer Portal](https://account.f5.com/myf5/): +1. Download NGINX Plus and its module packages for your operating system. The `` and `` are your NGINX Plus certificate and a private key required to access the NGINX Plus repo: ```shell - ./ngxunprivinst.sh fetch -c -k -j + ./ngxunprivinst.sh fetch -c -k ``` - {{< note >}} Starting from [NGINX Plus Release 33]({{< ref "nginx/releases.md#r33" >}}), a JWT license file (``) is required for each NGINX Plus instance. For more information, see [About Subscription Licenses]({{< ref "/solutions/about-subscription-licenses.md">}}). {{< /note >}} - If you need to install a particular version of NGINX Plus: - first, list all available NGINX Plus versions from the repository: @@ -690,13 +670,13 @@ To perform an unprivileged installation of NGINX Plus: ./ngxunprivinst.sh list -c -k ``` - - then specify a particular NGINX Plus version with the `-v` option: + - then specify a particular NGINX Plus version with the `-v` parameter: ```shell ./ngxunprivinst.sh fetch -c -k -v ``` -1. Extract the downloaded packages to the provided NGINX Plus prefix ``. An optional `-y` option will overwrite an existing installation (if any). Starting from version R33, the `-j` option that specifies the `` is mandatory: +1. Extract the downloaded packages to the program prefix `` specified by the `-p` parameter and specify the **license.jwt** `` with the `-j` parameter. The optional `-y` parameter allows overwriting an existing installation: ```shell ./ngxunprivinst.sh install [-y] -p -j @@ -708,7 +688,7 @@ To perform an unprivileged installation of NGINX Plus: /usr/sbin/nginx -p /etc/nginx -c /etc/nginx/conf.d ``` -With this script, you can also upgrade an existing unprivileged installation of NGINX Plus in the provided . An optional `-y` option performs a forced upgrade without any confirmation: +With this script, you can also upgrade an existing unprivileged installation of NGINX Plus in the provided ``. The optional `-y` parameter performs a forced upgrade without any confirmation: ```shell ./ngxunprivinst.sh upgrade [-y] -p @@ -732,10 +712,6 @@ To install NGINX Plus offline, you will need a machine connected to the Internet 1. Make sure you’ve downloaded the SSL certificate, private key, and the JWT file required for your NGINX Plus subscription. You can find these files in the MyF5 Customer Portal. For details on how to obtain these files, see [Step 1: Obtaining files on the machine connected to the Internet](#offline-obtain-files). -1. {{< include "nginx-plus/install/create-dir-for-jwt.md" >}} - -1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} - 1. {{< include "nginx-plus/install/create-dir-for-crt-key.md" >}} 1. {{< include "nginx-plus/install/copy-crt-and-key.md" >}} @@ -766,6 +742,8 @@ To install NGINX Plus offline, you will need a machine connected to the Internet rpm -ivh ``` +1. {{< include "nginx-plus/install/copy-jwt-to-etc-nginx-dir.md" >}} + 1. {{< include "nginx-plus/install/check-nginx-binary-version.md" >}} 1. Install NGINX Instance Manager 2.18 or later in your local environment to enable usage reporting, which is mandatory since R33. For more information, see [Disconnected environments](https://docs.nginx.com/nginx-instance-manager/disconnected/) and [About Subscription Licenses]({{< ref "/solutions/about-subscription-licenses.md">}}).