pg_createcluster - Online na nuvem

PROGRAMA:

NOME

pg_createcluster - cria um novo cluster PostgreSQL

SINOPSE

pg_createcluster [opções] versão nome [-- banco de dados de inicialização opções]

DESCRIÇÃO

pg_createcluster cria um novo cluster de servidor PostgreSQL (ou seja, uma coleção de bancos de dados
servido por um chefe dos correios(1) instância) e o integra ao multi-versão / multi-cluster
arquitetura do postgresql-comum pacote.

Cada cluster é identificado exclusivamente por sua versão e nome. O nome pode ser arbitrário.
O cluster padrão criado na instalação de um pacote de servidor é o principal. Contudo,
você pode querer criar outros clusters para teste, com outros superusuários, um cluster para
cada usuário em um servidor compartilhado, etc. pg_createcluster abortará com um erro se você tentar
crie um cluster com um nome que já existe para essa versão.

Para compatibilidade com sistema unidades de serviço, o nome do cluster não deve conter nenhum
travessões (-). pg_ctlcluster avisará sobre o problema, mas terá sucesso com a operação.

Dado um PostgreSQL principal versão (como "8.2" ou "8.3") e um cluster nome, isso cria o
arquivos de configuração necessários em / etc / postgresql /versão/nome/; em particular, estes são
postgresql.conf, pg_ident.conf, pg_hba.conf, uma configuração específica postgresql-common
arquivo start.conf (veja STARTUP CONTROLE abaixo), pg_ctl.conf e um log de link simbólico que
aponta para o arquivo de log (por padrão, / var / log / postgresql / postgresql-versão-nome.registro).

postgresql.conf é automaticamente adaptado para usar a próxima porta disponível, ou seja, a primeira
porta (a partir de 5432) que ainda não é usada por um cluster já existente.

Se o diretório de dados ainda não existe, o PostgreSQL's banco de dados de inicialização(1) comando é usado para
gerar uma nova estrutura de cluster. Se o diretório de dados já existe, ele é integrado
no postgresql-comum estrutura movendo o arquivo de configuração e definindo o
opção data_directory. Por favor, note que este só funciona para diretórios de dados que foram
criado diretamente com banco de dados de inicialização, ou seja, todos os arquivos de configuração (postgresql.conf etc.)
deve estar presente no diretório de dados.

Se um diretório de soquete personalizado é fornecido e não existe, ele é criado.

Se o arquivo de log não existir, ele será criado. Em qualquer caso, as permissões são ajustadas para
permitir acesso de gravação ao proprietário do cluster. Observe que postgresql.conf pode ser
personalizado para especificar log_directory e / ou log_filename; se pelo menos uma dessas opções
estiver presente, o log do link simbólico no diretório de configuração do cluster será ignorado.

Se o certificado SSL snakeoil padrão existir (/etc/ssl/certs/ssl-cert-snakeoil.pem e
/etc/ssl/private/ssl-cert-snakeoil.key), e o usuário postgres está no ssl-cert Unix
grupo, pg_createcluster configura o cluster para usar este certificado e habilita SSL.
Portanto, todos os clusters usarão o mesmo certificado SSL por padrão. Para versões até
9.1, links simbólicos no diretório de dados serão criados (server.crt e server.key); para 9.2
e mais tarde, as opções postgresql.conf apropriadas serão definidas (ssl_cert_file e
ssl_key_file). Claro, você pode substituí-lo por um certificado específico de cluster.
Da mesma forma para /etc/postgresql-common/root.crt e /etc/postgresql-common/root.crl, estes
os arquivos serão configurados como certificado de CA do cliente e lista de revogação, quando presente.
(root.crt é inicialmente um espaço reservado que só será usado se certificados reais forem adicionados
para o arquivo.)

OPÇÕES

-u usuário, --user =usuário
Defina o usuário que possui o cluster e se torna o superusuário do banco de dados com o nome fornecido
ou uid. Por padrão, este é o usuário postgres. Um cluster não deve pertencer à raiz.

-g grupo, --group =grupo
Altere o grupo dos arquivos de dados relacionados ao cluster. Por padrão, este será o
grupo primário do proprietário do banco de dados.

-d dir, --datadir =dir
Defina explicitamente o caminho do diretório de dados, que é usado para armazenar todos os
bancos de dados e tabelas. Isso se tornará muito grande (facilmente na ordem de cinco vezes
a quantidade de dados reais armazenados no cluster). Padrões para
/ var / lib / postgresql /versão/cacho.

-s dir, --socketdir =dir
Defina explicitamente o diretório onde o chefe dos correios(1) servidor armazena o soquete Unix para
conexões locais. O padrão é / var / run / postgresql / para clusters pertencentes ao usuário
postgres e / Tmp para clusters pertencentes a outros usuários. Esteja ciente de que / Tmp é um
diretório inseguro, já que todos podem criar um soquete lá e representar o
servidor de banco de dados. Se o diretório fornecido não existir, ele será criado com o apropriado
permissões.

-l caminho, --logfile =caminho
Defina explicitamente o caminho para o chefe dos correios(1) arquivo de log do servidor. Padrões para
/ var / log / postgresql / postgresql-versão-cacho.registro.

--locale =local
Defina o código do idioma padrão para o cluster de banco de dados. Se esta opção não for especificada, o
localidade é herdada do ambiente que pg_createcluster corre em

--lc-collate =local
--lc-ctype =local
--lc-messages =local
--lc-monetário =local
--lc-numeric =local
--lc-time =local
Como --localidade, mas apenas define o local na categoria especificada.

-e codificação, --encoding =codificação
Selecione a codificação do banco de dados de modelo. Esta também será a codificação padrão
de qualquer banco de dados que você criar posteriormente, a menos que você o substitua lá. O padrão é derivado
da localidade ou SQL_ASCII se isso não funcionar. Os conjuntos de caracteres suportados por
o servidor PostgreSQL são descritos na documentação.

Note: Não é recomendado definir esta opção diretamente! Em vez disso, defina o local.

-p porta, --port =porta
Selecione a porta em que o novo cluster escuta (para o soquete Unix e a porta TCP);
deve ser um número entre 1024 e 65535, já que o PostgreSQL não roda como root
e, portanto, precisa de um número de porta sem privilégios. Por padrão, a próxima porta livre iniciando
de 5432 é atribuído.

--começar
Inicie imediatamente um servidor para o cluster após criá-lo (ou seja, chame o pg_ctlcluster
versão cacho começar). Por padrão, o cluster não é iniciado.

--start-conf = auto|manual|inválido
Defina o valor inicial no arquivo de configuração start.conf. Ver STARTUP CONTROLE abaixo.
Por padrão, o auto é usado, o que significa que o cluster é tratado por
/etc/init.d/postgresql, ou seja, inicia e para automaticamente na inicialização do sistema.

-o guc=valor, --pgopção guc=valor
Opção de configuração a ser definida no novo arquivo postgresql.conf.

--createclusterconf =lima
Alternative createcluster.conf arquivo a ser usado. O padrão é
/etc/postgresql-common/createcluster.conf (ou $ PGSYSCONFDIR / createcluster.conf).

--environment =lima
Padrão alternativo meio Ambiente arquivo a ser usado. O padrão é
/ etc / postgresql-common / environment (ou $ PGSYSCONFDIR / environment). Se o arquivo for
ausente, uma string de espaço reservado é usada. % v e% c são substituídos; veja VALORES PADRÃO
abaixo.

-- banco de dados de inicialização opções
Opções passadas diretamente para banco de dados de inicialização(1).

Por padrão, pg_createcluster irá atualizar o arquivo pg_hba.conf gerado pelo initdb para
use autenticação de pares em conexões locais (unix) e md5 em TCP (host)
conexões. Se a configuração de autenticação explícita estiver incluída aqui (-A, --auth,
--auth-host, --auth-local), o arquivo pg_hba.conf não será alterado.

STARTUP CONTROLE

O arquivo start.conf no diretório de configuração do cluster controla o início / parada
comportamento do processo postmaster desse cluster. O arquivo pode conter linhas de comentário (iniciado
com '#'), linhas vazias e deve ter exatamente uma linha com uma das seguintes palavras-chave:

auto
O processo postmaster é iniciado / interrompido automaticamente no script de inicialização. Isto é
também o padrão se o arquivo estiver ausente.

manual
O processo postmaster não é tratado pelo script de inicialização, mas controlando manualmente o
agrupar com pg_ctlcluster(1) é permitido.

inválido
Nem o script de inicialização nem pg_ctlcluster(1) têm permissão para iniciar / parar o cluster.
Esteja ciente de que isso não impedirá o proprietário do cluster de chamar o nível inferior
ferramentas para controlar o processo postmaster; esta opção serve apenas para prevenir
acidentes durante a manutenção, não mais.

O arquivo pg_ctl.conf no diretório de configuração do cluster pode conter opções adicionais
passado para o pg_ctl desse cluster.

PADRÃO VALORES

Alguns valores padrão usados ​​por pg_createcluster pode ser modificado em
/etc/postgresql-common/createcluster.conf. Ocorrências de %v são substituídos pelos principais
número da versão e %c pelo nome do cluster. Usar %% para um literal %.

create_main_cluster (Predefinição: verdadeiro)
Crie uma principal cluster quando um novo pacote de servidor postgresql-xy é instalado.

start_conf (Predefinição: auto)
Valor start.conf padrão a ser usado.

diretório_dados (Predefinição: / var / lib / postgresql /% v /% c)
Diretório de dados padrão.

xlogdir (Padrão: não definido)
Diretório padrão para logs de transações. Quando usado, banco de dados de inicialização irá criar um link simbólico de
pg_xlog no diretório de dados para este local. Não definido por padrão, ou seja, pg_xlog é
permanece no diretório de dados.

opções_initdb (Padrão: não definido)
Outras opções para passar para banco de dados de inicialização.

Outras opções
Todas as outras opções listadas são copiadas para o postgresql.conf do novo cluster, por exemplo:

listen_addresses = '*'
log_line_prefix = '%% t'

Algumas opções postgresql.conf são tratadas especialmente:

ssl Apenas adicionado ao postgresql.conf se os certificados padrão do snakeoil existirem e forem
legível para o proprietário do cluster conforme detalhado acima.

diretório_stats_temp
Apenas adicionado ao postgresql.conf se existente e gravável para o proprietário do cluster, ou
senão se o diretório pai for gravável.

Use pg_createcluster online usando serviços onworks.net