Pular para o conteúdo principal

Começando com PostgreSYS​

Esta seção irá guiá-lo de forma rápida e objetiva através dos primeiros passos do processo de implantação da Plataforma PostgreSYS em seu ambiente de banco e dados.

Ao final, você poderá acessar o PgSmart Web, ou PgSmart CLI, para instalar e configurar os componentes desejados.

Recomendamos a leitura da seção Visão Geral para uma melhor compreensão da Arquitetura da Plataforma.

O primeiro passo é instalar o PgSmart Agent em todas as máquinas/servidores que deseja gerenciar.

  1. Baixar o pacote de instalação

    Terminal input
    wget --user=USUARIO --password=SENHA https://repo.tecnisys.com.br/yum/pgsys/pgsmart/4.1/rhel-8-x86_64/pgsmart-agent-4.1-1.el8.x86_64.rpm

  2. Instalar o pacote de instalação

    RHEL / CentOS / Rocky / Alma / SUSE / openSUSE

    • Usando o comando rpm -ivh

      Terminal input
      sudo rpm -ivh pgsmart-agent-4.1-1.el8.x86_64.rpm

    • Usando o comando dnf install para distros RHEL-like

      Terminal input
      sudo dnf install pgsmart-agent-4.1-1.el8.x86_64.rpm

    • Usando o comando zypper install para distros SUSE-like

      Terminal input
      sudo zypper install pgsmart-agent-4.1-1.el8.x86_64.rpm

    Debian / Ubuntu

    • Usando o comando apt install

      Terminal input
      sudo apt-get update
      sudo apt-get install pgsmart-agent-4.1-amd64.deb

  3. Iniciar o serviço

    Terminal input
    sudo systemctl enable --now pgsmart-agent

  4. Obter a chave de conexão

    Terminal input
    cat /opt/pgsmart-agent/pgsmart.yml | grep connectionKey
nota

Para maiores detalhes sobre o processo de instalação consulte Instalação do PgSmart Agent.

O próximo passo é instalar o PgSmart CLI em um máquina cliente, ou utilitária, para interagir com o(s) PgSmart Agent instalado(s).

  1. Baixar o pacote de instalação

    Terminal input
    wget --user=USUARIO --password=SENHA https://repo.tecnisys.com.br/yum/pgsys/pgsmart/4.1/rhel-8-x86_64/pgsmart-client-4.1-1.el8.x86_64.rpm

  2. Instalar o pacote de instalação

    RHEL / CentOS / Rocky / Alma / SUSE / openSUSE

    • Usando o comando rpm -ivh

      Terminal input
      sudo rpm -ivh pgsmart-client-4.1-1.el8.x86_64.rpm

    • Usando o comando dnf install para distros RHEL-like

      Terminal input
      sudo dnf install pgsmart-client-4.1-1.el8.x86_64.rpm

    • Usando o comando zypper install para distros SUSE-like

      Terminal input
      sudo zypper install pgsmart-client-4.1-1.el8.x86_64.rpm

    Debian / Ubuntu

    • Usando o comando apt install

      Terminal input
      sudo apt-get update
      sudo apt-get install pgsmart-client-4.1-amd64.deb

  3. Registrar um PgSmart Agent

    Terminal input
    pgsmart config agent

    3.1. Selecione Registro de Agentes.

    3.2. Selecione Registrar e informe os dados do PgSmart Agent.

    3.3. Tecle <enter> para usar o hostname ou IP padrão da máquina onde o PgSmart Agent está instalado.

    3.4. Tecle <enter> para usar a porta padrão utilizada pelo PgSmart Agent ou informe a porta desejada.

    3.5. Tecle <enter> para usar o alias (apelido) padrão do PgSmart Agent ou informe o alias desejado.

    3.6. Insira a chave de conexão do PgSmart Agent.

    3.7. Tecle <enter> para confirmar o Registro do Agente.

O PgSmart Web é a interface web para gerenciamento dos Ambientes de Banco de Dados PostgreSYS.

Alguns recursos da Plataforma estão disponíveis somente através desta interface. O seu uso é altamente recomendado.

  1. Instalar o PgSmart Web via PgSmart CLI

    Terminal input
    pgsmart install

    1.1. Tecle <enter> para selecionar Administração e Operação do Ambiente PostgreSYS.

    1.2. Com a tecla de <espaço> e <enter>, selecione Base de Metadados juntamente com Cliente do PgSmart (já selecionado por padrão).

    1.3. Tecle <enter> para prosseguir com a seleção da opção PgSmart Web.

    1.4. Tecle <enter> para cadastrar o Repositório da Tecnisys (a opção Sim já vem selecionada).

    1.5. Informe o endereço do repositório de pacotes (<enter> para selecionar o repositório oficial da Tecnisys).

    1.6. Informe seu Usuário de acesso ao repositório de pacotes.

    1.7. Informe sua Senha de acesso ao repositório de pacotes.

    1.8. Tecle <enter> para confirmar a verificação da chave GPG (a opção Sim já vem selecionada).

  2. Acessar o PgSmart Web através do browser

  https://<hostname-pgsmart-web>:4435

Uma forma rápida e simples de executar as interfaces clientes do PgSmart é através da sua imagem Docker.

Com ela, você terá o PgSmart CLI e o PgSmart Web disponíveis em um único container.

Seguem os passos para importar e executar o container:

  1. Fazer o login no repositório oficial da Tecnisys

    Terminal input
    docker login -u <seu email> repo.tecnisys.com.br

  2. Baixar a imagem Docker dos clientes do PgSmart

    Terminal input
    docker pull repo.tecnisys.com.br/pgsys/pgsmart-client:4.1

  3. Executar um container (mapeando a porta de acesso ao PgSmart Web)

    Terminal input
    docker run -p 4435:4435 -d pgsmart-client

  4. Opcionalmente, acessar o pgsmart CLI no container em execução

    Terminal input
    docker exec -it <container-id> bash

  5. Acessar o PgSmart Web através do browser

  https://localhost:4435