| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
pg_ctl start [-w] [-s] [-D
datadir
] [-l
filename
] [-o
options
] [-p
path
]
pg_ctl stop [-W] [-s] [-D
datadir
] [-m
s[mart] | f[ast] | i[mmediate]
]
pg_ctl restart [-w] [-s] [-D
datadir
] [-m
s[mart] | f[ast] | i[mmediate]
] [-o
options
]
pg_ctl reload [-s] [-D
datadir
]
pg_ctl status [-D
datadir
]
pg_ctl kill [
signal_name
] [
process_id
]
pg_ctl register [-N
servicename
] [-U
username
] [-P
password
] [-D
datadir
] [-w] [-o
options
]
pg_ctl unregister [-N
servicename
]
pg_ctl는 PostgreSQL의 연구 최종 단계 서버( postgres )를 기동, 정지, 재기동한다 혹은 가동중의 서버 상태를 표시하기 위한 유틸리티입니다. 비록 서버는 수동으로 기동하는 일도 가능하지만, pg_ctl는 로그 출력의 리디렉트나, 터미널과 프로세스 그룹의 적절한 분리등의 작업을 캡슐화해 줍니다. 한층 더 정지(shutdown) 제어를 위한 편리한 옵션도 제공합니다.
start모드에서는, 새로운 서버가 시작합니다. 서버는 백그라운드에서 기동되어 표준 입력은/dev/null에 접속됩니다. 표준 출력과 표준 에러는, (-l옵션이 사용되었을 경우) 로그 파일에 추가되거나 pg_ctl의 표준 출력(표준 에러 출력이 아닙니다)에 리디렉트 됩니다. 로그 파일을 지정하지 않는 경우,pg_ctl의 표준 출력은, 파일에 리디렉트 하는지, rotatelogs같은 로그 회전 프로그램과 같은 다른 프로세스에 파이프로 건네주어야 합니다. 그렇게 하지 않으면postgres는 출력을(백그라운드로부터) 제어 단말에 쓸 수 있을 것이고 쉘의 프로세스 그룹으로부터 떼어낼 수가 없습니다.
stop모드는, 지정된 데이터 디렉토리에서 가동하고 있는 서버를 정지(슛다운)합니다. 3개의 다른 정지 메소드는 -m옵션을 선택할 수 있습니다. "Smart"모드는 모든 클라이언트가 연결이 끊길 때까지 기다립니다. 이것이 기본값입니다. "Fast"모드는 클라이언트가 절단 할 때까지 기다리지 않습니다. 모든 실행중의 트랜잭션(transaction)를 롤백(rollback) 해, 클라이언트와의 접속을 강제적으로 연결이 끊긴 후 서버를 정지합니다. "Immediate"모드는, 클린 정지(shutdown) 처리없이, 모든 서버 프로세스를 중단합니다. 이것을 지정하면(자), 재기동시에 복구가 실행됩니다.
restart모드는 효과적으로 시작하면서 실행되는 정지를 실행합니다. 이 때 postgres 명령 라인 옵션을 변경할 수가 있습니다.
reload모드는 postmaster프로세스를 SIGHUP시그널을 보냅니다. (postgresql.conf, pg_hba.conf등) 설정 파일을 재읽기하는 이유 입니다. 이것에 의해 완전한 재기동을 하는 일 없이 설정 파일의 옵션의 변경을 반영시킬 수가 있습니다.
status모드는 지정한 데이터 디렉토리에서 서버가 기동하고 있을지 어떨지를 확인합니다. 기동하고 있는 경우는PID와 서버를 기동할 때에 사용된 명령 라인 옵션을 표시합니다.
kill모드에서는 지정한 프로세스에 시그널을 송신할 수가 있습니다. 이것은 특히,kill커멘드를 가지지 않는Microsoft Windows로 유용합니다. 서포트하는 시그널명의 일람은--help를 사용해 확인해 주세요.
register모드에 의해 Microsoft Windows상에서 시스템 서비스를 등록할 수가 있습니다.
unregister에 의해 이전에 register명령에 의해 등록된 Microsoft Windows상의 시스템 서비스를 등록 해제할 수가 있습니다.
데이터베이스 파일의 파일 시스템상의 장소를 지정합니다. 이것이 생략 되었을 경우 PGDATA환경 변수가 사용됩니다.
서버 로그 출력물을 filename 에 추가합니다. 그 파일이 존재하지 않는 경우는 작성됩니다. umask는 077으로 설정되기 되고 다른 사용자로부터의 로그 파일에의 액세스는 기본값에서는 허가되지 않습니다.
정지(슛다운) 모드를 지정합니다. mode 는smart,fast,immediate, 혹은 이 3개의 모드명의 처번? 1 문자를 잡을 수가 있습니다.
직접postgres에게 건네지는 옵션을 지정합니다.
이 옵션은 통상, 1 그룹으로서 건네받는 것을 보증하기 위해서, 단일 인용부호 또는 이중 인용부호로 둘러싸입니다.
postgres의 실행 프로그램의 위치를 지정합니다. 기본값에 의해 postgres의 실행 가능성은 pg_ctl와 같은 디렉토리에 있는 것으로 부터 실행됩니다. 또, 이 디렉토리에 존재하지 않으면, 설치 디렉토리가 hard-wired 됩니다. 이 옵션은, 무엇인가 이례적인 일을 하고 있어postgres 실행가능성이 발견되지 않는 에러가 나오는 경우 사용할 필요는 없습니다.
오직 에러 메세지만을 표시하고 그 외의 정보를 표시하지 않습니다.
기동 혹은 정지 처리가 완료하는 것을 기다립니다. 디폴트의 대기 시간은 60초입니다. 정지(shutdown) 처리의 기본값입니다. 성공적인 정지(shutdown)는 PID파일이 삭제에 의해 나타납니다. 시작을 위해 psql -l가 성공할지 어떨지에 의해 확인할 수 있습니다. pg_ctl는 psql에 적절한 포트를 사용하려고 합니다. PGPORT환경 변수가 지정되고 있으면, 그것이 사용됩니다. 그렇지 않으면 postgresql.conf파일로 포트가 설정되어 있다면 어느쪽이나 설정되어 있지 않은 경우는,PostgreSQL의 컴파일시의 기본의 포트가 사용됩니다(기본값은 5432). 대기하고 있는 동안 pg_ctl는 기동 혹은 정지가 성공에 기초한 올바른 종료 코드를 돌려줍니다.
시작 혹은 정지가 완료하는 것을 기다리지 않습니다. 이것은 시작과 재시작의 기본값입니다.
기본값의 데이터 보존 장소입니다.
psql 의 기본값 포트입니다(-w옵션으로 사용됩니다).
이 다른 서버 변수에 대해서는 postgres 을 참조해 주세요. 또, 이 유틸리티는 다른 대부분의PostgreSQL유틸리티와 같이 libpq로 지원되는 환경 변수를 사용합니다(Section 29.12를 참조해 주세요).
데이터 디렉토리에 이 파일이 존재여부는 pg_ctl가 서버가 현재 가동중인가 아닌가를 결정하는데 도움을 줍니다.
이 파일이 데이터 디렉토리에 있으면 pg_ctl(start모드)는 -o로 덧쓰기되는 것을 제외하고 이 파일의 내용을 옵션으로서postgres에 건네줍니다.
이 파일이 데이터 디렉토리에 있으면 pg_ctl(의restart모드)는, -o옵션으로 덧쓰기되는 것과 달리 이 파일의 내용을 옵션으로서postgres에 건네줍니다. 또, 이 파일의 내용이status모드로 표시됩니다.
데이터 디렉토리에 놓여지는 이 파일은start모드로 -w가 사용되었을 때에 psql과 함께 사용하는 적절한 포트를 찾아내기 위해서 해석됩니다.
완전한 기동을 실시할 때까지의 대기 조작은 충분히 설계되고 있지 않습니다. 액세스 제어의 설정으로서 로컬 클라이언트는 대화적으로 조작을 실시하지 않으면 접속할 수 없게 되어 있는 경우는 실패할 가능성이 있습니다(패스워드 인증이 필요한 경우 등).
서버를 시작합니다.
$ pg_ctl start
이하는 서버가 일어설 때까지 대기하는 기동 예입니다.
$ pg_ctl -w start
포트 5433을 사용해 fsync없음으로 서버를 기동합니다.
$ pg_ctl -o "-F -p 5433" start
서버의 재시작은 서버를 정지해 한번 더 기동하는 것과 거의 같지만, 다른 것은 pg_ctl가 이전 실행하던 인스턴스에게 건네져 있던 명령 라인 옵션을 보존하고 재이용하는 것입니다. 아래와 같이는 서버를 재기동하는 가장 간단한 방법입니다.
$ pg_ctl restart
서버의 재시작을 위해 서버의 정지(shut down)을 기다리고 나서 시작하는 방법입니다.
$ pg_ctl -w restart
이하는 포트 5433을 사용해 재시작해, 그 후에fsync를 무효로 하는 방법입니다.
$ pg_ctl -o "-F -p 5433" restart