Versão 4.1.0

Instalação do Serviço de Alta Disponibilidade

Os componentes do Ecossistema PostgreSQL com as quais o PgSmart se integra para fornecer o serviço de alta disponibilidade são: Patroni, etcd e HAProxy.

Pré-Requisitos

Instalação do PgSmart CLI, observando os requisitos mínimos .
Repositório de Pacotes extras para resolver dependências indiretas. Em conformidade com as políticas de segurança e suporte de cada organização, a Tecnisys não fornece tais pacotes. Para distribuições da família Enterprise Linux, o repositório Extra Packages for Enterprise Linux - EPEL geralmente fornece as dependências indiretas necessárias.
Inicialização do serviço do Agente do PgSmart em todas as máquinas do ambiente de banco de dados.
Terminal input
```
    systemctl start pgsmart-agent
```
Acesso com o usuário local psgmart. Por exemplo:
Terminal input
```
    su - pgsmart
```
Registro dos Agentes do PgSmart do PgSmart por meio do PgSmart-Client.

alerta
Recomendamos servidores exclusivos para cada componente do serviço de alta disponibilidade.

alerta
O Agente de alta disponibilidade, representado pelo componente Patroni, deve ser instalado no mesmo servidor do Serviço de Banco de Dados, representado pelo componente PostgreSQL.

Sintaxe do Comando

Terminal input

    pgsmart install -a <agent> --service ha --ha-components={agent|dcs|proxy) [Flags]

Flags

-M, --pg-version=(11-17). => Versão majoritária do PostgreSQL a ser instalada. Será usada a release mais recente da versão escolhida.
-a, --agent= <agent>. => Define o alias, hostname ou IP do servidor onde um Agente do PgSmart está instalado.
-h, --help. => Mostra a ajuda.
-q, --quiet. => Execução não interativa para a instalação dos serviços. Usada juntamente com --service, --pgversion e --agent.
-s, --service=(adm|db|backup|pool|ha|obs) => Serviços da Plataforma PostgreSYS.
--ha-components=(agent|dcs|proxy). => Componentes do serviço de Alta Disponibilidade. Usada em conjunto com as opções --quiet, --service=ha e --agent. Sendo:

-- agent => Agente de Alta Disponibilidade -- dcs => Repositório de Configurações Distribuído -- proxy => Proxy de Alta Disponibilidade

Instalação Não-Interativa

Este modo de instalação é ativado pela opção quiet (--quiet, -q) e sua execução utiliza os valores padrão (default) para os parâmetros não informados. Contudo, esta opção é desabilitada na primeira instalação, visto a necessidade de criação do Repositório de Pacotes do PostgreSYS baseado nas informações solicitadas interativamente.

Comando
Vídeo

Terminal input

    pgsmart install -q -a <agent> --service=ha --ha-components={agent|dcs|proxy)

Figura 1 -Instalação HA - Não Interativa

Instalação Interativa

Instruções
Agente
DCS
Proxy

Terminal input

    pgsmart install

Selecione o Agente do PgSmart (ou Registrar um novo Agente).
Selecione o serviço Alta Disponibilidade .
Selecione o Componente de alta disponibilidade desejado (agent|dcs|proxy).
Selecione a Versão majoritária base do PostgreSQL .
Selecione a Release da versão majoritária do PostgreSQL .
Confirme a instalação:
Confirme se deseja instalar/atualizar o Repositório de Pacotes do PostgreSYS.

7.1. Em caso positivo, selecione Informar e:
- Informe a URL do repositório desejado.
- Informe o código de identificação.
- Informe o nome do repositório.
- Informe um usuário de acesso ao repositório. (opcional no caso de um repositório diferente do padrão Tecnisys).
- Informe uma senha de acesso ao repositório (opcional no caso de um repositório diferente do padrão Tecnisys).
- Confirme se deseja ativar a verificação da chave GPG.
  - Em caso afirmativo, informe o caminho para o arquivo da chave GPG.
    nota
    Para uma instalação local, não se esqueça de baixar e importar a chave pública GPG dos repositórios (PGSYS-GPG-KEY).
    
    Por exemplo, para distribuições Enterprise Linux (RHEL-like), acesse:
    
    URL da Chave GPG
    https://repo.tecnisys.com.br/repository/yum/pgsys/components/4.1.0/rhel-8-x86_64/PGSYS-GPG-KEY/PGSYS-GPG-KEY
    
    Para distribuições SUSE e similares, acesse:
    
    URL da Chave GPG
    https://repo.tecnisys.com.br/repository/zypp/pgsys/components/4.1.0/sles-15-x86_64/PGSYS-GPG-KEY/PGSYS-GPG-KEY
    
    Para distribuições Debian, Ubuntu e similares, acesse:
    
    URL da Chave GPG
    https://repo.tecnisys.com.br/repository/apt/pgsys/components/4.1.0/PGSYS-GPG-KEY.asc
    
    Os arquivos compactados (tar.gz) dos pacotes de instalação de componentes e utilitários já contemplam a chave pública GPG.
    Figura 2 -Instalação HA - Interativa
Variações do Comando para Instalação Interativa

Alguns parâmetros podem ser repassados previamente, no comando, entretanto, sem a opção quiet (--quiet, -q) a execução continua interativa, sendo estes parâmetros utilizados com os valores padrão (default) nos prompts.

Exemplos:
Terminal input
```
    pgsmart install --service=ha
```
Terminal input
```
    pgsmart install --ha-components=agent
```

Notas Finais

nota

O processo de instalação pode ser acompanhado pelo arquivo de log do PgSmart:

Terminal input

    tail -f /var/log/pgsmart-agent/pgsmart.log

Terminal input

    tail -f /var/log/pgsmart-client/pgsmart.log

nota

O PgSmart define variáveis de ambiente (PGDATA, PGBIN, entre outras) no arquivo bash_profile do usuário corrente que serão carregadas em novas sessões. Caso deseje carregar imediatamente estas variáveis execute o comando abaixo após a instalação:

Terminal input

    source ~/.bash_profile

Flags​

Variações do Comando para Instalação Interativa​

Flags

Variações do Comando para Instalação Interativa