<Starting, Stopping, and Reloading Configuration>

Nginx 실행파일을 실행하여 시작한다. Nginx 실행된 이후에는 -s 파라미터를 가지고 다른 작업을 수행하도록 있다. 다음과 같은 문법을 갖는다.


nginx -s signal


Signal 다음 값을 가질 있다.

Stop : fast shutdown

Quit : graceful shutdown

Reload : 설정 파일 reload

Reopen : 로그 파일 reopen


예를 들어 현재 처리 중인 request 모두 처리하고 nginx 종료하고자 한다면 다음 command 실행하면 된다.


nginx -s quit


  • command nginx 실행할 때와 동일한 user 실행해야 한다.

설정 파일의 변경은 변경된 설정 파일을 reload command 통해서 nginx 전달해야 적용된다. 설정 파일을 reload하는 command 다음과 같다.


nginx -s reload


Master Process 설정 파일 reload signal 받으면 새로운 설정 파일에 대한 syntax validation 체크하고, 적용한다. 적용이 끝나면 master process 새로운 worker process 실행하고, 기존의 worker process에는 shutdown 요청을 보낸다. 과정 중간에 오류가 발생하면 master process 변경 사항을 roll back하고 계속해서 old worker process 작업을 수행한다. Old worker process shutdown 메시지를 받으면 새로운 connection 받는 것을 중지하고 현재 처리 중인 request 완료될 때까지 계속해서 서비스를 제공한다. 모든 처리 중인 request 완료되었을 , old worker process 종료된다.


Signal kill utility 같은 Unix tool 도움을 받아서 nginx 전달될 수도 있다. 경우 signal 주어진 process ID 통해서 직접적으로 nginx process에 전달된다. Process ID로는 nginx master process ID 사용한다. 기본적으로 nginx.pid /usr/local/nginx/log 폴더나 /var/run 폴더에 저장된다. 예를 들어서, master process ID 1628이라면, nginx graceful shutdown 위한 Quit signal 다음과 같이 보낼 있다.


kill -s QUIT 1628


모든 기동중인 nginx process 대한 리스트를 얻으려면 다음과 같이 ps utility 사용할 있다.


ps -ax | grep nginx


Nginx 보내는 signal 대한 자세한 정보는 Controlling nginx (http://nginx.org/en/docs/control.html) 통해서 얻을 있다.

TAG

01. Preface

2015/03/31 13:23

[여기에 있는 내용은 Nginx 홈페이지(http://nginx.org/en/docs/beginners_guide.html)에서 제공하는 초보자용 가이드(Beginner's Guide) 문서를 번역한 것이다. 원문 참조를 원한다면 홈페이지를 참조하기 바란다.]


가이드에서는 nginx 대한 개본적인 소개와 nginx 통해 수행할 있는 간단한 task들에 대해서 설명하고 있다. 독자들의 컴퓨터에 nginx 이미 설치되어 있다고 가정하고 있는데, 아직 설치되어 있지 않다면 Installing nginx (http://nginx.org/en/docs/install.html) 페이지를 참고하기 바란다. 가이드를 통해서 nginx start, stop, reload, nginx 설정 파일의 구조, nginx 통해서 static content 제공하는 방법, proxy server 설정하는 방법, FastCGI application 접속하는 방법들을 설명하고자 한다.


Nginx 하나의 master process 여러 개의 worker process 가지고 있다. Master process 주요 기능은 configuration 읽어서 처리하고, worker process들을 유지/관리하는 것이다. Worker process request 대한 실제 처리 작업을 수행한다. Nginx event-based model 채택했고, worker process 효율적인 request 분산을 위해서 OS-dependent mechanism 가지고 있다. Worker process 숫자는 설정 파일에 정의된다. 이용 가능한 CPU core 수에 맞춰서 자동으로 할당되거나 설정 파일에 정의된 값으로 고정된다.


Nginx nginx 모듈들의 작업은 설정 파일에 의해서 결정된다. 기본적으로 nginx 설정 파일 이름은 nginx.conf이고, 위치는 /usr/local/nginx/conf /usr/local/etc/nginx이다.