pg_ctl - Online na nuvem

PROGRAMA:

NOME

pg_ctl - inicializar, iniciar, parar ou controlar um servidor PostgreSQL

SINOPSE

pg_ctl init [db] [-s] [-D diretório de dados] [-o opções do initdb]

pg_ctl começo [-w] [-t segundo] [-s] [-D diretório de dados] [-l nome do arquivo] [-o opções] [-p caminho] [-c]

pg_ctl Pare [-W] [-t segundo] [-s] [-D diretório de dados] [-m inteligente] | velozes] | imediato]]

pg_ctl restart [-w] [-t segundo] [-s] [-D diretório de dados] [-c]
[-m inteligente] | velozes] | imediato]] [-o opções]

pg_ctl recarregar [-s] [-D diretório de dados]

pg_ctl estado [-D diretório de dados]

pg_ctl a promover [-s] [-D diretório de dados]

pg_ctl matar nome_do_sinal id_do_processo

pg_ctl cadastre-se [-N me sirva] [-U nome de usuário] [-P senha] [-D diretório de dados]
[-S auto] | exigem]] [-w] [-t segundo] [-s] [-o opções]

pg_ctl cancelar o registro [-N me sirva]

DESCRIÇÃO

pg_ctl é um utilitário para inicializar um cluster de banco de dados PostgreSQL, iniciando, parando ou
reiniciar o servidor de banco de dados PostgreSQL (postgres(1)), ou exibindo o status de um
servidor em execução. Embora o servidor possa ser iniciado manualmente, pg_ctl encapsula tarefas
como redirecionar a saída do log e desconectar-se adequadamente do terminal e do grupo de processos.
Ele também oferece opções convenientes para desligamento controlado.

A o init or banco de dados de inicialização modo cria um novo cluster de banco de dados PostgreSQL. Um cluster de banco de dados é um
coleção de bancos de dados gerenciados por uma única instância do servidor. Este modo invoca
da banco de dados de inicialização comando. Ver banco de dados de inicialização(1) para obter detalhes.

In começo modo, um novo servidor é iniciado. O servidor é iniciado em segundo plano, e seu
a entrada padrão é anexada a / dev / null (ou nul no Windows). Em sistemas semelhantes ao Unix, por
padrão, a saída padrão do servidor e o erro padrão são enviados para o padrão do pg_ctl
saída (não erro padrão). A saída padrão de pg_ctl deve então ser redirecionada para um
arquivo ou canalizado para outro processo, como um programa de rotação de log como rotatelogs; de outra forma
postgres irá escrever sua saída para o terminal de controle (do fundo) e irá
não deixe o grupo de processos do shell. No Windows, por padrão, a saída padrão do servidor
e o erro padrão é enviado ao terminal. Esses comportamentos padrão podem ser alterados por
utilização -l para anexar a saída do servidor a um arquivo de log. Uso de qualquer -l ou saída
o redirecionamento é recomendado.

In Pare modo, o servidor que está sendo executado no diretório de dados especificado é encerrado.
Três métodos diferentes de desligamento podem ser selecionados com o -m opção. O modo “inteligente” espera
para que todos os clientes ativos se desconectem e qualquer backup online seja concluído. Se o servidor estiver em
hot standby, recuperação e replicação de streaming serão encerrados assim que todos os clientes
desconectado. O modo “rápido” (o padrão) não espera que os clientes se desconectem e irá
encerrar um backup online em andamento. Todas as transações ativas são revertidas e
os clientes são desconectados à força e o servidor é encerrado. O modo “imediato” irá
abortar todos os processos do servidor imediatamente, sem um desligamento limpo. Isso levará a um
crash-recovery executado na próxima reinicialização.

restart modo efetivamente executa uma parada seguida por um início. Isso permite alterar o
postgres opções de linha de comando. restart pode falhar se os caminhos relativos especificados forem
especificado na linha de comando durante a inicialização do servidor.

recarregar modo simplesmente envia o postgres processar um sinal SIGHUP, fazendo-o reler seu
arquivos de configuração (postgresql.conf, pg_hba.conf, etc.). Isso permite a mudança de
opções do arquivo de configuração que não requerem uma reinicialização completa para terem efeito.

estado modo verifica se um servidor está sendo executado no diretório de dados especificado. Se for,
o PID e as opções de linha de comando que foram usados ​​para invocá-lo são exibidos. Se o
o servidor não está em execução, o processo retorna um status de saída de 3. Se um dado acessível
diretório não for especificado, o processo retorna um status de saída de 4.

In a promover modo, o servidor em espera que está sendo executado no diretório de dados especificado é
comandado para sair da recuperação e iniciar as operações de leitura e gravação.

matar modo permite que você envie um sinal para um processo especificado. Isto é particularmente
valioso para o Microsoft Windows que não possui um comando kill. Use --help para ver um
lista de nomes de sinais suportados.

cadastre-se O modo permite registrar um serviço do sistema no Microsoft Windows. o -S opção
permite a seleção do tipo de início de serviço, seja "automático" (iniciar serviço automaticamente em
inicialização do sistema) ou “demanda” (iniciar serviço sob demanda).

cancelar o registro O modo permite cancelar o registro de um serviço do sistema no Microsoft Windows. Esse
desfaz os efeitos do cadastre-se comando.

OPÇÕES

-c
--arquivo-core
Tentar permitir travamentos do servidor para produzir arquivos principais, em plataformas onde este é
possível, levantando qualquer limite de recurso flexível colocado nos arquivos principais. Isso é útil em
depurar ou diagnosticar problemas, permitindo que um rastreamento de pilha seja obtido de um
processo de servidor com falha.

-D diretório de dados
--pgdata diretório de dados
Especifica a localização do sistema de arquivos dos arquivos de configuração do banco de dados. Se isso é
omitido, a variável de ambiente PGDATA é usado.

-l nome do arquivo
--registro nome do arquivo
Anexe a saída do log do servidor para nome do arquivo. Se o arquivo não existir, ele será criado.
O umask é definido como 077, portanto, o acesso ao arquivo de log não é permitido a outros usuários por
padrão.

-m modo
--modo modo
Especifica o modo de desligamento. modo pode ser inteligente, rápido ou imediato, ou o primeiro
carta de um destes três. Se for omitido, rápido será usado.

-o opções
Especifica opções a serem passadas diretamente para o postgres comando; opção múltipla
invocações são anexadas.

As opções geralmente devem ser colocadas entre aspas simples ou duplas para garantir que
eles são passados ​​como um grupo.

-o opções do initdb
Especifica opções a serem passadas diretamente para o banco de dados de inicialização comando.

As opções geralmente devem ser colocadas entre aspas simples ou duplas para garantir que
eles são passados ​​como um grupo.

-p caminho
Especifica a localização do executável postgres. Por padrão, o executável postgres
é retirado do mesmo diretório que pg_ctl, ou na falta disso, o cabeado
diretório de instalação. Não é necessário usar esta opção a menos que você esteja fazendo
algo incomum e obter erros que o executável do postgres não foi encontrado.

No modo init, esta opção especifica analogamente a localização do executável initdb.

-s
- silencioso
Imprima apenas erros, sem mensagens informativas.

-t
--tempo esgotado
O número máximo de segundos de espera ao aguardar a inicialização ou desligamento para
completo. O padrão é o valor de PGCTLTIMEOUT variável de ambiente ou, se não
definido, para 60 segundos.

-V
--versão
Imprima a versão pg_ctl e saia.

-w
Aguarde a inicialização ou desligamento ser concluído. Esperar é a opção padrão para
desligamentos, mas não inicializações. Ao esperar pela inicialização, pg_ctl repetidamente tenta
conectar ao servidor. Ao esperar pelo desligamento, pg_ctl espera que o servidor
remova seu arquivo PID. Esta opção permite a entrada de uma senha SSL na inicialização.
pg_ctl retorna um código de saída com base no sucesso da inicialização ou desligamento.

-W
Não espere a inicialização ou desligamento ser concluído. Este é o padrão para iniciar e
modos de reinicialização.

-?
--Socorro
Mostre ajuda sobre os argumentos da linha de comando pg_ctl e saia.

Opções for Windows
-e fonte
Nome da fonte do evento para pg_ctl usar para registrar no log de eventos durante a execução
como um serviço do Windows. O padrão é PostgreSQL. Observe que isso controla apenas o
log do próprio pg_ctl; uma vez iniciado, o servidor irá usar a fonte do evento
especificado por event_source. Se o servidor falhar durante a inicialização antecipada, ele também pode
log usando a fonte de eventos padrão PostgreSQL.

-N me sirva
Nome do serviço do sistema a ser registrado. O nome será usado como nome do serviço
e o nome de exibição.

-P senha
Senha para o usuário iniciar o serviço.

-S tipo de início
Inicie o tipo de serviço do sistema a ser registrado. tipo de início pode ser automático, demanda ou
a primeira letra de um desses dois. Se for omitido, auto é usado.

-U nome de usuário
Nome de usuário para o usuário iniciar o serviço. Para usuários de domínio, use o formato
Domínio \ nome de usuário.

MEIO AMBIENTE

PGCTLTIMEOUT
Limite padrão do número de segundos de espera ao aguardar a inicialização ou desligamento para
completo. Se não for definido, o padrão é 60 segundos.

PGDATA
Local padrão do diretório de dados.

pg_ctl, como a maioria dos outros utilitários PostgreSQL, também usa as variáveis ​​de ambiente
suportado pela libpq (consulte a Seção 31.14, “Variáveis ​​de ambiente”, na documentação). Para
variáveis ​​de servidor adicionais, consulte postgres(1).

Use pg_ctl online usando serviços onworks.net