postmaster

postmaster — 运行 Postgres 多用户后端

postmaster [ -B nBuffers ] [ -D DataDir ] [ -i ] [ -l ]
postmaster [ -B nBuffers ] [ -D DataDir ] [ -N nBackends ] [ -S ]
   [ -d [ DebugLevel ] [ -i ] [ -l ] [ -o BackendOptions ] [ -p port ]
postmaster [ -n | -s ] ...
  

输入

postmaster 接受下列命令行参数：

-B nBuffers

postmaster 为它启动的后端进程分配和管理的共享内存缓冲区数量。此值缺省为 64 个缓冲区，每个缓冲区是 8k 字节（或者 config.h 里设置的 BLCKSZ 大小）。

-D DataDir

声明用做数据库目录树的根的目录。如果没有给出 -D，缺省目录名是环境变量 PGDATA 的值。如果没有设置 PGDATA，那么使用的目录是 $POSTGRESHOME/data。如果两个环境变量和命令行选项都没有给出，用的缺省目录是编译时设置的。

-N nBackends

此 postmaster 允许启动的后端服务器的最大数目。缺省配置时，该值为 32，如果你的系统能支持更多进程，该值最大可以设置为 1024。缺省值和最大值都可以在制作 Postgres 时修改（参阅 src/include/config.h）。

-S

指明 postmaster 进程将以安静模式启动。也就是说，它将与用户的（控制）tty 脱离并且启动其自身的进程组。这个选项不应和调试选项结合使用，因为向标准输出和标准错误打印的任何信息都被丢弃。

-d [ DebugLevel ]

可选的参数 DebugLevel 决定后端服务器将产生的调试信息输出的数量。如果 DebugLevel 是一，将跟踪所有联接动作，而对其它的一律忽略。对于级别二或更高，后端进程的调试被打开并且 postmaster 显示更多信息，包括后端环境和处理动作。注意如果没有给后端服务器声明他们的调试输出指向的文件，则输出会出现在它们的父 postmaster 的控制 tty 上。

-i

这个选项打开 TCP/IP 或者网际域套接字通讯。没有这个选项，只能进行本地 Unix 域套接字通讯。

-l

这个选项打开 SSL 套接字通讯。同样还需要 -i 选项。要使用这个选项，编译时你必须打开了 SSL 选项。

-o BackendOptions

在 BackendOptions 里声明的 postgres 选项都传递给所有由这个 postmaster 启动的后端服务进程。如果选项字串包含任何空白，整个字串必须引起来。

-p port

声明 postmaster 侦听着等待连接的互联网 TCP/IP 端口或一个本地 Unix 域套接字文件扩展（描述符）．缺省的端口号是环境变量 PGPORT 的值。如果没有设置 PGPORT，缺省是 Postgres 编译时建立的值（通常是 5432）。如果你声明了一个非缺省端口，那么所有前端应用（包括 psql）都必须用命令行选项或者 PGPORT 声明同一个端口。

还有几个命令行选项用于在后端非正常退出时进行调试。这些选项用于在这种情况下控制 postmaster，而且没有一个选项是为了用于正常操作的。

用于这种状况的一般策略是通知所有其它后端必须退出，然后重新初始化共享内存和信号灯。这是因为一个出错的后端在退出前可能已经破坏了一些共享的状态。

这些特殊选项是：

-n

postmaster 将不会重新初始化共享数据结构。一个有经验的系统程序员这时就可以使用 shmemdoc 程序检查共享内存和信号灯状态。

-s

postmaster 将通过发送信号 SIGSTOP 停止所有其他后端进程，但不会导致它们退出。这样就允许系统程序员手工从所有后端进程收集输出的核心（core dumps）。

输出

semget: No space left on device

如果你看到这条信息，你应该运行 ipcclean 命令。干完这个之后，试着重新启动 postmaster。如果还不行，你可能需要按照安装指导里描述的那样配置你的内核的共享内存和信号灯。如果你在一台主机上运行多个 postmaster 实例，或者如果你的内核的共享内存和/或信号灯被限制得很小，你可能要重新配置你的内核以增加共享内存和信号灯参数。

小技巧：你也可以通过降低 -B 的参数以减少 Postgres 的共享内存的消耗，或者降低 -N 的参数减少 Postgres 的信号灯的消耗，以此可以推迟重新配置内核。

StreamServerPort: cannot bind to port

如果看到这样的信息，你应该确保没有其他的 postmaster 进程正在运行。判断这个情况的最简单的办法是使用命令

% ps -ax | grep postmaster
	

（这是在 BSD 类型的系统上），或者

% ps -e | grep postmast
	

（这是在 System V 类型或者 POSIX 兼容的系统象 HP-UX 上）。

如果你确信没有其他 postmaster 进程在运行但是你还是收到这个错误信息，试着用 -p 选项声明一个不同的端口。如果你终止 postmaster 后又马上用同一个端口运行它，你也有可能得到这个错误信息；这时，你必须多等几秒，等操作系统关闭了该端口后再试。最后如果你使用了一个操作系统认为是保留的端口，也可能导致这个错误信息。例如，我的 Unix 版本认为低于 1024 的端口号是可信任的因而只有 Unix 超级用户可以使用它们。

IpcMemoryAttach: shmat() failed: Permission denied

一个可能的解释是另外一个用户企图在同一端口上运行一个 postmaster 进程，该进程请求共享资源然后退出。因为 Postgres 的共享内存键是以赋予 postmaster 的端口号为基础的，因此在同一台主机上有好几个安装的话很有可能冲突。如果当前没有其他 postmaster 进程正在运行（见上面），运行 ipcclean 然后再尝试一下。如果其他 postmaster 镜象正在运行，你就不得不与那些进程的所有者协调端口号的分配和/或删除未用的共享内存段。

描述

postmaster 管理前端和后端进程之间的通讯，还负责分配共享缓冲池和 SysV 信号灯（在没有测试和设置指令的机器上）。postmaster 本身并不与用户交互并且应该作为一个后台进程启动。

每个 Postgres 安装每次应该只启动一个 postmaster。这里，一个安装意味着一个数据库目录和 postmaster 端口号。你可以在一台机器上运行多于一个 postmaster，前提是每个有不同的目录和端口号。

注意

如果有可能，不要使用 SIGKILL 杀死 postmaster。而应该使用 SIGHUP，SIGINT 或 SIGTERM （kill(1)的缺省信号）。用

% kill -KILL
   

或者其可选形式

% kill -9
   

会阻止 postmaster 在退出前释放它持有的系统资源（例如共享内存和信号灯）。这样就无法让你免于处理上面描述的共享内存的问题。

处理共享内存问题的有用的工具包括 ipcs(1)，ipcrm(1)，和 ipcclean(1)。

用法

用缺省值启动 postmaster 键入：

% nohup postmaster >logfile 2>&1 &
   

这条命令将在缺省端口（5432）启动 postmaster。这是最简单和最常用的启动 postmaster 的方法。

要在指定的端口启动 postmaster ：

% nohup postmaster -p 1234 &
   

这条命令将启动通过端口1234通讯的 postmaster。为了用 psql 与这个 postmaster 联接，你需要这样运行（psql）：

% psql -p 1234
   

或者设置环境变量 PGPORT：

% setenv PGPORT 1234
% psql