17.3. 启动数据库服务器

17.3.1. 服务器启动失败
17.3.2. 客户端连接问题

在任何人可以访问数据库前,你必须启动数据库服务器。 数据库服务器程序是lightdb

如果您使用的是 LightDB 的预打包版本,那么几乎可以肯定的是,它包含了根据操作系统的约定将服务器作为后台任务运行的规定。 使用包的基础设施来启动服务器比自己弄清楚如何启动要简单得多。有关详细信息,请参阅包级文档。

手动启动服务器的基本方法是直接调用 lightdb,使用 -D 选项指定数据目录的位置,例如:

$ lightdb -D /usr/local/lightdb-x/data

这将把服务器放在前台运行。这个步骤同样必须以LightDB用户帐户登录来操作。如果没有-D选项,服务器将尝试使用环境变量LTDATA命名的目录。如果这个环境变量也没有提供则导致失败。

通常最好在后台启动lightdb。要这样做,使用常用的 Unix shell 语法:

$ lightdb -D /usr/local/lightdb-x/data >logfile 2>&1 &

如上所示,把服务器的stdoutstderr输出存储到某个地方是非常重要的。这将对审计目的和诊断问题有所帮助(更深入的有关日志文件处理的讨论请见(Section 23.3)。

lightdb还接受其它一些命令行选项。更多的信息请见lightdb参考页 和下面的Chapter 18

这些 shell 语法很容易让人觉得无聊。因此我们提供了包装器程序lt_ctl以简化一些任务。例如:

lt_ctl start -l logfile

将在后台启动服务器并且把输出放到指定的日志文件中。-D选项和lightdb中的一样。lt_ctl还可以用于停止服务器。

通常,你会希望在计算机启动的时候启动数据库服务器。自动启动脚本是操作系统相关的。在 contrib/start-scripts 目录中有一些随 LightDB 分发的示例脚本。安装将需要 root 权限。

不同的系统在引导时有不同的启动守护进程的习惯。许多系统有一个文件/etc/rc.local/etc/rc.d/rc.local。其他的使用init.drc.d目录。不管你做什么,服务器必须由LightDB用户账户而不是 root或任何其他用户启动。因此你可能应该在你的命令中使用su lightdb -c '...'这种形式。例如:

su lightdb -c 'lt_ctl start -D /usr/local/lightdb-x/data -l serverlog'

下面是一些更加与操作系统相关的建议(在每一种情况中要确保在我们展示通用值的地方使用正确的安装目录和用户名)。

当服务器在运行时,它的PID被保存在数据目录中的postmaster.pid文件。这样做 可以防止多个服务器实例运行在同一个数据目录中,并且也可以被用来关闭服务器。

17.3.1. 服务器启动失败

有几个常见的原因会导致服务器启动失败。通过检查服务器日志或使用手工启动的方法(不做标准输出或标准错误的重定向), 就可以看到出现什么错误消息。下面我们详细地解释一些最常见的错误消息。

LOG:  could not bind IPv4 address "127.0.0.1": Address already in use
HINT:  Is another postmaster already running on port 5432? If not, wait a few seconds and retry.
FATAL:  could not create any TCP/IP sockets

正如这个消息所说的,这表示:你试图在一个已经有服务器运行着的端口上再启动另一个服务器。不过,如果核心错误消息不是Address already in use或其变体,那就有可能是别的问题。 例如,试图在一个被保留的端口上启动服务器会收到下面这样的消息:

$ lightdb -p 666
LOG:  could not bind IPv4 address "127.0.0.1": Permission denied
HINT:  Is another postmaster already running on port 666? If not, wait a few seconds and retry.
FATAL:  could not create any TCP/IP sockets

像这样的消息:

FATAL:  could not create shared memory segment: Invalid argument
DETAIL:  Failed system call was shmget(key=5440001, size=4011376640, 03600).

可能意味着你的内核对共享内存区的限制小于LightDB试图创建的工作区域(本例中是 4011376640 字节)。这只有在您将 shared_memory_type 设置为 sysv 时才有可能发生。在这种情况下,你可以试着以小于正常数量的缓冲区(shared_buffers)启动服务器,或者重新配置内核以增加共享内存允许的尺寸。 当你试图在同一台机器上启动多个服务器,并且它们所需的总空间超过了内核的限制,也会报这个错。

一个这样的错误:

FATAL:  could not create semaphores: No space left on device
DETAIL:  Failed system call was semget(5440126, 17, 03600).

意味着你已经用光了磁盘空间。它的意思是你的内核对System V信号量的限制小于LightDB想创建的数量。和上面一样,你可以通过减少允许的连接数(max_connections)来绕开这个限制,但最终你还是会希望提高内核的限制。

关于配置System V IPC功能的细节请见Section 17.4.1

17.3.2. 客户端连接问题

尽管可能在客户端出现的错误情况范围宽广而且是应用相关的,但的确有几种与服务器的启动方式直接相关。除了下面提到的几种错误之外的问题都应该在相应的客户端应用文档中。

ltsql: error: connection to server at "server.joe.com" (123.123.123.123), port 5432 failed: Connection refused
        Is the server running on that host and accepting TCP/IP connections?

这是常见的I couldn't find a server to talk to失败。上面的情况看起来是发生在尝试 TCP/IP 通信时。常见的错误是忘记把服务器配置成允许 TCP/IP 连接。

另外,当试图通过 Unix 域套接字与本地服务器通信时,你会看到这个:

ltsql: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such file or directory
        Is the server running locally and accepting connections on that socket?

如果服务器确实在运行,检查客户端的套接字路径(这里是 /tmp)的理解与服务器的unix_socket_directories设置的一致性。

连接失败信息总是显示服务器地址或套接字路径名,有助于验证客户端是不是尝试连接到正确的位置。 如果实际上没有服务器在那里监听,典型的核心错误消息将是Connection refusedNo such file or directory(值得注意的是这种环境中的Connection refused表示服务器得到了你的连接请求并拒绝了它。 那种情况会产生一个不同的消息,如Section 19.10中所示)。 其它像Connection timed out这样的消息可能表示更基础的问题,如缺少网络连接,或者有防火墙阻塞了连接。