설명

pg_ctl 명령은 PostgreSQL 데이터베이스 서버 (postgres) 제반 작업을 수행한다. 이 작업은 데이터베이스 클러스터 초기화, 서버 시작, 중지, 재시작, 서버 상태 출력등이다. 물론 서버는 postgres 명령으로 직접 실행할 수 있으나, pg_ctl 명령을 이용하면, 보다 쉽고, 안전하게 관리할 수 있다. 서버의 로그 처리나, 하위 프로세스 관리나, 중지 방법을 보다 직관적으로 선택할 있게 한다.

init 또는 initdb 모드는 PostgreSQL 데이터베이스 클러스터를 만드는 일을 한다. 데이터베이스 클러스터란 하나의 서버 인스턴스가 관리하는 최상위 자료 집합이다. 이 작업은 내부적으로 initdb 명령을 사용한다. 이 명령의 자세한 설명은 initdb 설명서에서 다룬다.

start 모드는 서버를 실행하는 일을 한다. 이 서버는 백그라운드로 실행되며, 표준 입력 장치로 /dev/null 장치를 사용한다(Windows에서는 nul). 표준 출력 장치는 여느 유닉스 프로그램과 마찮가지로, /dev/stdout, /dev/stderr 장치를 사용한다. (유닉스 장치 개념을 잘 모르는 이들을 위한 설명 - 아주 단순하게 설명하면, 서버가 출력하는 각종 메시지 가운데, 오류 메시지들은 /dev/stderr 쪽으로 보내고, 나머지는 /dev/stdout 즉 사용자가 현재 보고 있는 화면으로 보낸다. - 옮긴이) 이렇기 때문에, 파이프를 이용해서, 서버 로그를 rotatelogs 프로그램으로 보낼 수 있다. (이 부분에 대한 자세한 설명은 유닉스, 리눅스 설명서를 살펴 보면 된다.) 이와 달리 이 표준 출력과 표준 오류 장치로 보내는 내용을 파일로 저장하려면, -l 옵션을 사용하면 된다. (실 업무 환경에서는 서버 로그 처리는 서버 환경 설정에서 지정하기 때문에, pg_ctl 명령에 의해서 만들어지는 로그는 극히 적다. pg_ctl 명령이 시스템 부팅 때 자동으로 실행되는 경우라면, 이 명령어 실행 내역을 보관하기 위해서 -l 옵션이 필요 할지도 모르겠지만, 서버 실행을 사용자 직접 한다면, postgres 서버 로그는 로그 파일로 따로 저장하도록 설정하고, pg_ctl 실행 로그는 작업자가 화면에서 바로 보는 것이 일반적이다. - 옮긴이)

stop 모드는 서버를 중지하는 일을 한다. 서버 중지 방법은 세가지다. 이는 -m 옵션으로 지정한다. “Smart”: 이 모드는 새 연결 금지, 기존 연결 끊길 때까지 대기, 모든 온라인 백업 종료한다. “Fast”: 현재 접속해 있는 클라이언트의 모든 작업을 강제로 중지하고, 모든 클라이언트 접속을 끊고, 서버를 중지한다. “Immediate”: 클라이언트 세션 정리 작업을 모두 무시하고, 즉시 서버를 중지한다. 이렇게 중지된 서버가 재실행되면, 자동 복구 모드로 실행된다.

restart 모드는 서버 재실행하는 일을 한다. 여기서 postgres 명령행 옵션이나, 환경 설정 파일 내용을 바꾸고 그것을 서버 재실행 해야만 하는 경우 이 모드를 사용한다. 만약 서버를 실행 할 때, 상대 경로를 지정했다면, 그 시작할 때의 위치에서 재실행해야 정상적으로 재실행 될 수 있다. 그렇지 않은 경우는 오류가 발생할 수 있다.

reload 모드는 단순하게 postgres 서버 프로세스에 SIGHUP 시그널만 보낸다. 이 신호를 받으면, 서버는 환경 설정 파일(postgresql.conf, pg_hba.conf 등)을 다시 불러 온다. 이렇게 해서 서버 재시작 없이 환경 설정을 바꿀 때 이용한다. 물론 재시작을 해야만 변경 할 수 있는 환경 설정은 설정 파일에서 변경 했다 하더라도 이 때 반영되지 않는다.

status 모드는 지정한 데이터 디렉터리를 사용하는 서버 실행 상태를 보여준다. 실행 중인 서버가 있다면, 그 서버의 PID와 명령행 옵션을 보여준다. 실행 중인 서버가 없다면, pg_ctl 실행 반환 값으로 3을 반환하고 종료한다. 지정한 데이터 디렉터리로 접근 할 수 없다면, 4를 반환하고 종료한다.

promote 모드는 해당 서버가 읽기 전용 보조 서버였다면, 운영 서버와의 관계를 끊고, 그 서버를 읽기-쓰기 가능한 또 다른 운영 서버로 바꾸는 일을 한다.

logrotate mode rotates the server log file. For details on how to use this mode with external log rotation tools, see 24.3절.

kill 모드는 지정한 프로세스에 지정한 시그널을 보내는 일을 한다. 이 명령은 내장된 kill 명령이 없는 Microsoft Windows 환경에서도 사용할 수 있다. 사용할 수 있는 시그널 이름은 --help 옵션을 이용해 볼 수 있는 도움말에서 소개하고 있다.

register 모드는 Microsoft Windows 에서 PostgreSQL 서버 운영을 위해 시스템 서비스로 등록하는 일을 한다. -S 옵션으로 해당 서비스 시작 유형을 지정할 수 있다. “auto”는 OS 시작 할 때 자동으로 실행, “demand”는 수동으로 서비스를 시작한다.

unregister 모드는 Microsoft Windows 에서 등록한 해당 서비스를 삭제하는 일을 한다. register 작업의 반대 일이다.

옵션

구문상 옵션 지정은 바르게 했지만, 그 옵션이 사용하는 모드와 관계 없다면, 그 옵션들은 무시된다.

환경 변수

pg_ctl의 여러 모드는 데이터 디렉터리를 꼭 지정해야 한다. 이 때, -D 옵션을 생략하면, 이 PGDATA 환경 변수값을 사용한다.

pg_ctl 명령도 대부분 여러 PostgreSQL 도구들과 마찬가지로 libpq 라이브러를 사용하기 때문에, 이 라이브러리에서 사용할 수 있는 환경 변수들을 사용할 수 있다(33.14절 참조).

추가적으로 서버에서 사용하는 환경 변수 설명은 postgres에서 소개하고 있다.

관련 파일

예제

$ pg_ctl start

$ pg_ctl -o "-F -p 5433" start

$ pg_ctl stop

$ pg_ctl stop -m smart

$ pg_ctl restart

$ pg_ctl -o "-F -p 5433" restart

$ pg_ctl status

pg_ctl: server is running (PID: 13718)
/usr/local/pgsql/bin/postgres "-D" "/usr/local/pgsql/data" "-p" "5433" "-B" "128"

관련 항목