原文:http://www.xuchao.org/docs/postgresql/app-pg-ctl.html
pg_ctl
Synopsis
pg_ctlstart [-w] [-s] [-Ddatadir] [-lfilename] [-ooptions] [-ppath]
pg_ctlstop [-W] [-s] [-Ddatadir] [-m s[mart] | f[ast] | i[mmediate] ]
pg_ctlrestart [-w] [-s] [-Ddatadir] [-m s[mart] | f[ast] | i[mmediate] ] [-ooptions]
pg_ctlreload [-s] [-Ddatadir]
pg_ctlstatus [-Ddatadir]
pg_ctlkill [signal_name] [process_id]
描述
pg_ctl是一个用于启动,停止, 或者重起Postgresql后端服务器(postmaster), 或者显示一个运行着的服务器的状态的工具, 尽管我们可以手动启动服务器,但是pg_ctl封装了重新定向日志输出, 与终端和进程组合理分离,以及另外提供了一个选项用于有控制的关闭。
在start模式里会启动一个新的服务器。 服务器是在后台启动的,标准输入被附着到了/dev/null上。如果使用了-l,那么标准输出和标准错误被定向到一个日志文件, 要么就是重新定向到pg_ctl的标准输出(而不是标准错误)。 如果没有选定日志文件,pg_ctl的标准输出应该重新定向到一个文件或者用管道输出类似rotatelogs这样的日志旋转程序,否则,postmaster将把它的输出写到控制终端(在后台)并且将不会脱离 shell 的进程组。
在stop模式下,那个正在特定数据目录运行的服务器被关闭。 你可以用-m选项选择三种不同的关闭模式:"Smart"模式等待所有客户端中断联接。 这个是缺省。"Fast"模式并不等待客户端中断联接。 所有活跃事务都被回卷并且客户端都强制断开。"Immediate"模式将在没有干净关闭的情况下退出。这么做将导致在重新启动的时候的恢复。
restart实际上是先执行一个停止,然后紧跟一个启动。它允许变换postmaster命令行的选项。
reload模式简单地给postmaster发送一个SIGHUP信号,导致它重新读取她的配置文件 (postgresql.conf,pg_hba.conf等等) 这样就允许修改配置文件选项而不用完全重启系统来使之生效。
status模式监查一个服务器是否在指定的数据目录运行, 如果是,那么显示其PID和调用它的命令行选项。
kill模式允许你给一个指定的进程发送信号。 这个功能对Microsoft Windows特别有用,因为那里没有kill命令。 使用--help查看支持的信号的名字的列表。
选项
- -Ddatadir
- -lfilename
-
把服务器日志输出附加在filename文件上。 如果该文件不存在,那么创建它。umask设置为 077, 因此缺省时是不允许从其它用户向日志文件访问的。
- -mmode
-
声明关闭模式。mode可以是smart,fast,或者immediate,或者是这三个之一的第一个字母。
- -ooptions
-
声明要直接传递给postmaster的选项。
参数通常都用单或者双引号包围以保证它们作为一个整体传递。
- -ppath
-
声明postmaster可执行文件的位置。 缺省时postmaster是从和pg_ctl相同的目录取出,如果不是, 那么就是写死的安装目录。除非你想干点什么特别的事情,并且得到类似没有找到postmaster这样的错误, 否则没有必要使用这个选项。
- -s
- -w
-
等待启动或者关闭的完成。在 60 秒后超时。 这个参数是关闭时的缺省值。 成功的关闭是以删除PID文件为标志的。对于启动而言, 一次成功的psql -l就标志着成功。pg_ctl将视图使用对 psql 合适的端口,如果存在环境变量 PGPORT,那么用它。 否则,它将查找看看在postgresql.conf文件里面是否设置了一个端口。 如果都没有,它将使用Postgresql编译时的缺省端口(缺省是 5432)。 在等待的时候,pg_ctl将根据启动或者关闭的成功状况返回一个准确的退出代码。
- -W
-
不等待启动或者停止的完成。这是启动和重起的缺省。
文件
如果在数据目录里存在postmaster.opts.default文件,那么该文件将作为选项传递给postmaster, 除非被-o选项覆盖。
例子
启动服务器
启动服务器:
$ @H_603_404@pg_ctl start
启动服务器的一个例子, 等到服务器 启动了才退出:
$ @H_603_404@pg_ctl -w start
用于一个postmaster使用端口 5433,而且不带fsync运行,使用:
$ @H_603_404@pg_ctl -o "-F -p 5433" start
重起服务器
这个命令几乎等于先停止postmaster然后再启动她,只不过pg_ctl保存并重新使用上一次运行 postmaster 的命令行参数。重起服务器的最简单的方法是:
$ @H_603_404@pg_ctl restart
重起服务器,等待其停止和重起:
$ @H_603_404@pg_ctl -w restart
使用 5433 重起并且重起后关闭fsync:
$ @H_603_404@pg_ctl -o "-F -p 5433" restart
显示服务器状态
下面是来自pg_ctl的状态输出的例子:
$ @H_603_404@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'
这是在重起模式里使用的命令行
Linux下启动 cd到Postgressql安装目录下的bin目录 ./pg_ctl start -D /opt/Postgressql/9.0/data (-D 后的参数指数据库文件目录)