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

• Registo do Agente do PgSmart por meio do PgSmart CLI na máquina em que vai rodar o serviço 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 Registar 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, indique 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 Indique a URL do repositório desejado:

   3.2.1. Indique o código de identificação. 3.2.2. Indique o nome do repositório. 3.2.3. Indique um usuário de acesso ao repositório. (opcional no caso dum repositório diferente do padrão Tecnisys). 3.2.4. Indique uma palavra-passe de acesso ao repositório (opcional no caso dum repositório diferente do padrão Tecnisys). 3.2.5. Confirme se deseja ativar a verificação da chave GPG.

   • Em caso afirmativo, indique o caminho para o ficheiro da chave GPG.

     nota

     • Para uma instalação local, não se esqueça de descarregar 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 ficheiros 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 ficheiro

       https://192.168.56.236:4435/

2. Indique o usuário e a palavra-passe (no primeiro acesso, será solicitado o cadastramento e confirmação da palavra-passe de acesso).

   

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

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

   

   Figura 3 -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 palavra-passe 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 controlo 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 controlo 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 5 -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, registo de agentes, etc). Isto tudo ficará registado no banco de dados. ↩