pg_createcluster - 云端在线

程序：

您的姓名

pg_createcluster - 创建一个新的 PostgreSQL 集群

概要

pg_createcluster [选项] 版本 姓名 [-- 初始化数据库 选项]

商品描述

pg_createcluster 创建一个新的 PostgreSQL 服务器集群（即一组数据库
由一个 邮政局长（1）instance）并集成到多版本/多集群中
的架构 常见的PostgreSQL 包。

每个集群都由其版本和名称唯一标识。 名称可以是任意的。
在安装服务器包时创建的默认集群是 main。 然而，
您可能希望与其他超级用户一起创建用于测试的其他集群
共享服务器上的每个用户等。如果您尝试，pg_createcluster 将因错误而中止
使用该版本已存在的名称创建一个集群。

为了兼容性 systemd 服务单元，集群名称不应包含任何
破折号 (-). pg_ctcluster 将警告该问题，但操作成功。

给定一个主要的 PostgreSQL 版本 （如“8.2”或“8.3”）和一个集群 姓名，它创建了
/etc/postgresql/ 中的必要配置文件版本/姓名/; 特别是这些是
postgresql.conf, pg_ident.conf, pg_hba.conf, postgresql-common 的特定配置
文件 start.conf（见 STARTUP CONTROL 下面）、pg_ctl.conf 和一个符号链接日志
指向日志文件（默认情况下，/var/log/postgresql/postgresql-版本-姓名。日志）。

postgresql.conf 自动适应使用下一个可用端口，即第一个
现有集群尚未使用的端口（从 5432 开始）。

如果数据目录还不存在，PostgreSQL 的 初始化数据库(1) 命令用于
生成新的集群结构。 如果数据目录已经存在，则集成
到 常见的PostgreSQL 通过移动配置文件并设置
数据目录选项。 请注意，这 仅由 适用于数据目录
直接用 初始化数据库, 即所有配置文件（postgresql.conf 等）
必须存在于数据目录中。

如果给出了自定义套接字目录并且它不存在，则创建它。

如果日志文件不存在，则会创建它。 在任何情况下，权限都会调整为
允许对集群所有者的写访问。 请注意 postgresql.conf 可以是
自定义以指定 log_directory 和/或 log_filename； 如果这些选项中至少有一个
存在，则忽略集群配置目录中的符号链接日志。

如果存在默认的蛇油 SSL 证书（/etc/ssl/certs/ssl-cert-snakeoil.pem 和
/etc/ssl/private/ssl-cert-snakeoil.key)，postgres 用户在 ssl-cert Unix
组， pg_createcluster 将集群配置为使用此证书，并启用 SSL。
因此，默认情况下所有集群都将使用相同的 SSL 证书。 对于版本高达
9.1、数据目录中的符号链接将被创建（server.crt和server.key）； 9.2
稍后，将设置适当的 postgresql.conf 选项（ssl_cert_file 和
ssl_key_file）。 当然，您可以将其替换为特定于集群的证书。
同样对于 /etc/postgresql-common/root.crt 和 /etc/postgresql-common/root.crl，这些
文件将被配置为客户端证书 CA 和吊销列表（如果存在）。
（root.crt 最初是一个占位符，只有在添加真实证书时才会使用
到文件。）

配置

-u 用户, --用户=用户
将拥有集群并成为数据库超级用户的用户设置为给定的名称
或 uid。 默认情况下，这是用户 Postgres的. 集群不得由 root 拥有。

-g 组, --组=组
更改集群相关数据文件的组。 默认情况下，这将是
数据库所有者的主要组。

-d DIR, --数据目录=DIR
显式设置数据目录路径，用于存储所有实际
数据库和表。 这将变得相当大（很容易在五倍的数量级
存储在集群中的实际数据量）。 默认为
/var/lib/postgresql/版本/簇.

-s DIR, --socketdir=DIR
显式设置目录 邮政局长(1) 服务器存储 Unix 套接字用于
本地连接。 对于用户拥有的集群，默认为 /var/run/postgresql/
Postgres的及 / tmp目录 对于其他用户拥有的集群。 请注意 / tmp目录 是一个
unsafe 目录，因为每个人都可以在那里创建一个套接字并模拟
数据库服务器。 如果给定的目录不存在，则使用适当的
权限。

-l 径, --日志文件=径
显式设置路径 邮政局长(1)服务器日志文件。 默认为
/var/log/postgresql/postgresql-版本-簇。日志。

--区域设置=当地
设置数据库集群的默认语言环境。 如果未指定此选项，则
区域设置是从环境继承的 pg_createcluster 跑进来。

--lc-整理=当地
--lc-ctype=当地
--lc-消息=当地
--lc-货币=当地
--lc-数字=当地
--lc-时间=当地
喜欢 --区域设置，但只设置指定类别中的语言环境。

-e 编码, --编码=编码
选择模板数据库的编码。 这也将是默认编码
以后创建的任何数据库，除非您在那里覆盖它。 默认是派生的
来自语言环境，或者 SQL_ASCII，如果这不起作用。 支持的字符集
PostgreSQL 服务器在文档中进行了描述。

备注: 不建议直接设置这个选项！ 改为设置语言环境。

-p 端口, --端口=端口
选择新集群监听的端口（对于 Unix 套接字和 TCP 端口）；
这必须是 1024 到 65535 之间的数字，因为 PostgreSQL 不以 root 身份运行
因此需要一个非特权端口号。 默认下一个空闲端口开始
从 5432 分配。

- 开始
创建集群后立即为集群启动一个服务器（即调用 pg_ctlcluster
版本 簇 开始吧）。 默认情况下，集群未启动。

--start-conf=自动|手册|禁用
在 start.conf 配置文件中设置初始值。 看 STARTUP CONTROL 联络一位教师
默认情况下， 汽车 使用，这意味着集群由
/etc/init.d/postgresql，即在系统启动时自动启动和停止。

-o 古柯=折扣值, --p选项 古柯=折扣值
要在新的 postgresql.conf 文件中设置的配置选项。

--createclusterconf=文件
可再生 创建集群配置文件 要使用的文件。 默认是
/etc/postgresql-common/createcluster.conf（或 $PGSYSCONFDIR/createcluster.conf）。

--环境=文件
替代默认值 环境 要使用的文件。 默认是
/etc/postgresql-common/environment（或 $PGSYSCONFDIR/environment）。 如果文件是
缺少，使用占位符字符串。 %v 和 %c 被替换； 查看默认值
联络一位教师

-- 初始化数据库 选项
选项直接传递给 初始化数据库（1）。

默认情况下， pg_createcluster 将 initdb 生成的 pg_hba.conf 文件更新为
在本地（unix）连接上使用对等身份验证，在 TCP（主机）上使用 md5
连接。 如果此处包含显式身份验证配置 (-A, --授权,
--auth-主机, --auth-本地)，pg_hba.conf 文件将保持不变。

STARTUP CONTROL

集群配置目录下的start.conf文件控制启动/停止
该集群的 postmaster 进程的行为。 该文件可以包含注释行（开始
'#')、空行，并且必须正好有一行包含以下关键字之一：

汽车
postmaster 进程在 init 脚本中自动启动/停止。 这是
如果文件丢失，也是默认值。

手册
postmaster 进程不是由 init 脚本处理的，而是手动控制
集群与 pg_ctcluster(1) 允许。

禁用
init 脚本和 pg_ctcluster(1) 允许启动/停止集群。
请注意，这不会阻止集群所有者调用较低级别的
控制 postmaster 进程的工具； 这个选项只是为了防止
维修过程中发生的事故，不会更多。

集群配置目录中的 pg_ctl.conf 文件可以包含额外的选项
传递给该集群的 pg_ctl。

DEFAULT 王斌金璟閣的價值觀

使用的一些默认值 pg_createcluster 可以修改
/etc/postgresql-common/createcluster.conf。 发生的 %v 被主要的取代
版本号，以及 %c 通过集群名称。 用 %% 对于文字 %.

创建_main_cluster （默认： true)
创建一个 主 当安装了新的 postgresql-xy 服务器包时集群。

启动配置 （默认： 汽车)
要使用的默认 start.conf 值。

数据目录 （默认： /var/lib/postgresql/%v/%c)
默认数据目录。

日志目录 （默认：未设置）
事务日志的默认目录。 使用时， 初始化数据库 将创建一个符号链接
pg_xlog 在数据目录中的这个位置。 默认未设置，即 pg_xlog 为
保留在数据目录中。

初始化数据库选项 （默认：未设置）
传递给的其他选项 初始化数据库.

其他选项
列出的所有其他选项都复制到新集群的 postgresql.conf 中，例如：

监听地址 = '*'
log_line_prefix = '%%t'

一些 postgresql.conf 选项被特殊对待：

SSL 如果默认蛇油证书存在并且是
如上所述，集群所有者可读。

统计临时目录
仅添加到 postgresql.conf（如果存在，并且对集群所有者可写），或
否则，如果父目录可写。

使用 onworks.net 服务在线使用 pg_createcluster