PG_CTL(1) | PostgreSQL Server Applications | PG_CTL(1) |
pg_ctl - 啓動,停止和重啓 PostgreSQL 服務器
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 是一個用於啓動,停止, 或者重起 PostgreSQL 後端服務器(postmaster), 或者顯示一個運行着的服務器的狀態的工具, 儘管我們可以手動啓動服務器,但是 pg_ctl 封裝了重新定向日誌輸出, 與終端和進程組合理分離,以及另外提供了一個選項用於有控制的關閉。
在 start 模式裏會啓動一個新的服務器。 服務器是在後臺啓動的,標準輸入被附着到了 /dev/null 上。如果使用了 -l,那麼標準輸出和標準錯誤被定向到一個日誌文件, 要麼就是重新定向到 pg_ctl 的標準輸出(而不是標準錯誤)。 如果沒有選定日誌文件,pg_ctl 的標準輸出應該重新定向到一個文件或者用管道輸出到另外一個進程, 比如那些日誌旋轉程序,否則,postmaster 將把它的輸出寫到控制終端(在後臺)並且將不會脫離 shell 的進程組。
在 stop 模式下,那個正在特定數據目錄運行的服務器被關閉。 你可以用 -m 選項選擇三種不同的關閉模式:"Smart" 模式等待所有客戶端中斷聯接。 這個是缺省。"Fast" 模式並不等待客戶端中斷聯接。 所有活躍事務都被回捲並且客戶端都強制斷開。 "Immediate" 模式將在沒有乾淨關閉的情況下退出。這麼做將導致在重新啓動的時候的恢復。
restart 實際上是先執行一個停止,然後緊跟一個啓動。它允許變換 postmaster 命令行的選項。
reload 模式簡單地給 postmaster 發送一個 SIGHUP 信號,導致它重新讀取她的配置文件 (postgresql.conf, pg_hba.conf 等等) 這樣就允許修改配置文件選項而不用完全重啓系統來使之生效。
status 模式監查一個服務器是否在指定的數據目錄運行, 如果是,那麼顯示其 PID 和調用它的命令行選項。
參數通常都用單或者雙引號包圍以保證它們作爲一個整體傳遞。
其它的環境變量,參閱
postmaster(1).
等待完全啓動還不是一個定義得很完整的操作, 如果訪問控制設置爲本地客戶端在沒有手工交互的情況下不能訪問的話還可能會失效。(比如,口令認證)。
啓動服務器:
$ pg_ctl start
啓動服務器的一個例子,
等到服務器
啓動了才退出:
$ pg_ctl -w start
用於一個 postmaster 使用端口
5433,而且不帶 fsync
運行,使用:
$ pg_ctl -o "-F -p 5433" start
$ pg_ctl stop
停止服務器,使用 -m 開關允許我們控制如何把後端停下來。 -w等待服務器停止。-m 聲明後端的停止模式。
這個命令幾乎等於先停止 postmaster 然後再啓動她,只不過 pg_ctl 保存並重新使用上一次運行 postmaster 的命令行參數。重起服務器的最簡單的方法是:
$ pg_ctl restart
重起服務器,等待其停止和重起:
$ pg_ctl -w restart
使用 5433
重起並且重起後關閉
fsync:
$ pg_ctl -o "-F -p 5433" restart
下面是來自 pg_ctl 的狀態輸出的例子:
$ pg_ctl status pg_ctl: postmaster is running (pid: 13718) Command line was: /usr/local/pgsql/bin/postmaster '-D' '/usr/local/pgsql/data' '-p' '5433' '-B' '128'
Postgresql 中文網站 何偉平 <laser@pgsqldb.org>
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
2003-11-02 | Application |