Instalação do PgSmart Web

Estando os requisitos mínimos atendidos, iniciamos a implantação da Plataforma PostgreSYS pela instalação do componente PgSmart que, por sua vez, fornecerá um guia intuitivo para a instalação dos demais componentes.

O PgSmart Web oferece uma interface gráfica (GUI) para a Plataforma PostgreSYS, permitindo que os usuários realizem as mesmas operações do PgSmart CLI por meio de uma navegação visual mais intuitiva no navegador.

Pré-Requisitos

• Registro do Agente do PgSmart por meio do PgSmart CLI na máquina em que vai rodar o servidor WEB.
• Instalação do PgSmart CLI, observando os requisitos mínimos.

O PgSmart Web é instalado pela opção Administração e Operação do Ambiente PostgreSYS do PgSmart CLI.

Sintaxe do Comando

Terminal input

    pgsmart install -s adm [Flags]

Terminal input

    pgsmart install --service=adm [Flags]

Flags:

• -a, --agent= <agent>. => Define o alias, hostname ou IP do servidor onde o PgSmart Agent 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. => Serviço de Administração e Operação do Ambiente PostgreSYS.

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.

Instruções

Terminal input

    pgsmart install -a <agent> -q --service=adm

Figura 1 -Instalação do PgSmart Web - Não Interativa

Vídeo

Carregando...

Instalação Interativa

Instalar

Terminal input

    pgsmart install

1. Selecione o Agente do PgSmart (ou Registrar um novo Agente).

2. Selecione o Serviço de Administração e Operação do Ambiente PostgreSYS.

3. Selecione o componente Cliente do PgSmart.

   3.1. Caso não tenha selecionado a opção de instalação da Base de Metadados, informe se deseja instalar uma base de Metadados Externa.

   • Em caso negativo, a Base de Metadados do Ambiente PostgreSYS será instalada.¹.
   • Em caso positivo, os dados de conexão serão configurados no PgSmart Web.

   3.2. Confirme a instalação do Repositório de pacotes padrão do PostgreSYS ou Informe a URL do repositório desejado:

   3.2.1. Informe o código de identificação.
   3.2.2. Informe o nome do repositório.
   3.2.3. Informe um usuário de acesso ao repositório. (opcional no caso de um repositório diferente do padrão Tecnisys).
   3.2.4. Informe uma senha de acesso ao repositório (opcional no caso de um repositório diferente do padrão Tecnisys).
   3.2.5. 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 (RPM-GPG-KEY-PGSYS).

       Por exemplo, para distribuições RHEL 8, Acesse:

       Caminho de arquivo

          https://repo.tecnisys.com.br/repository/yum/pgsys/repos/4.0.0/rhel-8-x86_64/RPM-GPG-KEY-PGSYS
       • 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 do PgSmart Web - 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.

   Terminal input

       pgsmart install --service=adm
   Terminal input

       pgsmart install --pgversion=17
   nota

   • A instalação pode ser verificada por meio dos seguintes comandos:

     Terminal input

         systemctl status pgsmart-web

   • Status do PgSmart Web

     Terminal input

         pgsmart web client status

   • Status do PostgreSQL que está em execução para manter o serviço do Banco de Metadados:

     Terminal input

         pgsmart web database status

Acessar

Carregando...

Vídeo

Acesso ao PgSmart Web

1. No seu navegador, acesse a web via https (https://<<IP onde foi instalado o serviço>>).

   Exemplo:

   Caminho de arquivo

       https://192.168.56.236:4435/

2. Informe o usuário e a senha (no primeiro acesso, será solicitado o cadastramento e confirmação da senha de acesso).

   

   Figura 3 -Instalação do PgSmart Web - Autenticação.

3. Configure o Método de Autenticação.

   

   Figura 4 -Instalação do PgSmart Web - método de autenticação.
   nota

   Nesta etapa da configuração inicial do PgSmart Web, é possível escolher o método de autenticação que será utilizado para acessar o sistema.
   Há duas opções disponíveis:

   • 🔐 Autenticação Local

     • Os dados de login e senha são mantidos de forma segura no banco de metadados da plataforma. Ideal para ambientes menores ou ambientes de teste onde não há a necessidade de integração com diretórios corporativos

     • Não depende de serviços externos.

     • A criação e administração dos usuários é feita manualmente, dentro da própria interface do sistema.

   • 🏢 Autenticação via LDAP

     • O LDAP (Lightweight Directory Access Protocol) é um protocolo utilizado para acessar e manter serviços de diretório, como o Active Directory.

     • Ao escolher esse método, o sistema se integra com um diretório corporativo, permitindo autenticação centralizada.

     • Os usuários utilizam as mesmas credenciais que já usam em outros sistemas da organização.

     • Permite integração com Active Directory ou outros serviços LDAP.

     • A gestão das credenciais é feita de forma centralizada

     • Ideal para empresas que já possuem controle de identidade consolidado.

     Obs:

     1. Independente do método de autenticação, será mantido um cadastro de usuários no banco de metadados da plataforma para fins de integridade, auditoria e controle de perfil;
     2. Quando utilizado o método de autenticação via LDAP, durante o primeiro acesso do usuário na plataforma, será criado um cadastro para este usuário com o login informado e com o perfil Analista por padrão.
     3. É possível configurar um usuário cadastrado para que sua autenticação seja feita de forma local ou via LDAP

Seja muito bem-vindo ao PgSmart Web!

Figura 3 -Instalação do PgSmart Web - Tela inicial.

nota

No PgSmart Web você pode contar com o Tutorial Guiado, um recurso interativo que o conduzirá por todas as funcionalidades da plataforma PostgreSYS, desde a configuração inicial até a administração dos serviços.
Com interface intuitiva, o tutorial facilita o uso do sistema, em especial para quem está começando agora com o ecossistema PostgreSQL.

Footnotes

1. A base de dados de metadados permitirá que alguns metadados possam ser editados (cadastro de usuário, ambiente, repositorio, registro de agentes, etc). Isto tudo ficará registrado no banco de dados. ↩