ngx_mgmt_module

ngx_mgmt_module 모듈은 NGINX Plus 라이선스 검증과 사용 리포트를 전송할 수 있게 합니다. 이는 nginx/1.27.2 (nginx-plus-r33) 인스턴스부터 필수적입니다.

JWT 라이선스 파일인 license.jwt 파일을 /etc/nginx/(Linux), /usr/local/etc/nginx/(FreeBSD), 혹은 license token 지시문에 명시된 경로에 위치시켜야 합니다. 라이선스 파일은 MyF5에서 받을 수 있습니다.

사용 리포트는 보안 연결을 통해 F5의 라이선싱 엔드포인트에 매 시간 전송됩니다. 대안으로, 네트워크 제한 환경에서는 F5 라이선싱 엔드포인트로 리포트를 보낼 수 있는 F5 NGINX Instance Manager로 리포트를 전송하도록 설정할 수 있습니다.

기본적으로 F5 라이선싱 엔드포인트에서 첫 사용 리포트를 수신하지 못하면 NGINX는 트래픽 처리를 멈춥니다.

이 기능은 상업용 구독의 일부로 사용 가능합니다.

예제 구성

mgmt {
    # in case if custom path is required
    license_token custom/file/path/license.jwt;

    # in case of reporting to NGINX Instance Manager
    usage_report endpoint=NIM_FQDN;
}

Directives

Syntax:	mgmt { ... }
Default: —
Context: main

사용 리포트 및 라이선스 관리 지침이 지정되는 설정 파일 컨텍스트를 제공합니다.

Syntax:	enforce_initial_report on | off;
Default: enforce_initial_report on;
Context: mgmt
This directive appeared in version 1.27.2.

첫 사용 리포트 전송을 위한 180일의 유예 기간을 활성화하거나 비활성화합니다.

첫 사용 리포트는 NGINX가 처음으로 설치된 이후 실행하자마자 전송됩니다. 기본적으로 F5 라이선싱 엔드포인트에서 첫 사용 리포트를 수신하지 못하면 NGINX는 리포트 전송 이 성공할때까지 트래픽 처리를 멈춥니다. 이 지시문을 off로 설정하면 F5 라이선싱 엔드포인트에서 초기 사용 리포트를 수신하기까지의 180일의 유예 기간을 활성화합니다.

Syntax:	license_token file;
Default: license_token license.jwt;
Context: mgmt
This directive appeared in version 1.27.2.

JWT 라이선스 file을 정의합니다. 기본적으로 license.jwt 파일은 /etc/nginx/(Linux) 혹은 /usr/local/etc/nginx/(FreeBSD)에 있어야 합니다.

Syntax:	resolver address ... [valid=time] [ipv4=on|off] [ipv6=on|off] [status_zone=zone];
Default: —
Context: mgmt

사용 리포트 엔드포인트 이름 확인에 사용할 네임서버를 설정합니다. 기본적으로 시스템 resolver를 사용합니다.

자세한 내용은 resolver를 참고하세요.

Syntax:	ssl_crl file;
Default: —
Context: mgmt

사용 리포트 엔드포인트 인증서 검증에 사용하는 PEM 형식의 revoked certificates(CRL) file 을 정의합니다.

Syntax:	ssl_trusted_certificate file;
Default: ssl_trusted_certificate system CA bundle;
Context: mgmt

사용 리포트 엔드포인트 인증서 검증에 사용하는 PEM 형식의 신뢰할 수 있는 CA 인증서 file 을 정의합니다.

Syntax:	ssl_verify on | off;
Default: ssl_verify on;
Context: mgmt

사용 리포트 엔드포인트 인증서 검증을 활성화하거나 비활성화합니다.

1.27.2 이전 버전의 경우, 기본값은 off입니다.

Syntax:	state_path path;
Default: —
Context: mgmt
This directive appeared in version 1.27.2.

ngx_mgmt_module 모듈로 인해 생성된 상태 파일(nginx-mgmt-*)을 저장할 디렉터리를 정의합니다. 기본 디렉터리는 /var/lib/nginx/state(Linux), /var/db/nginx/state(FreeBSD) 입니다.

Syntax:	usage_report [endpoint=address] [interval=time];
Default: usage_report endpoint=product.connect.nginx.com interval=1h;
Context: mgmt

사용 리포트 엔드포인트의 address와 port를 설정합니다. interval 파라미터는 리포트 사이의 시간을 설정합니다.

1.27.2 이전 버전의 경우, 기본값은 nginx-mgmt.local, 30m 입니다.