Pular para o conteúdo principal

Começando com PostgreSYS​

Esta secção irá guiá-lo de forma rápida e objectiva através dos primeiros passos do processo de implantação da Plataforma PostgreSYS no seu ambiente de base de dados.

Ao final, poderá aceder ao PgSmart Web, ou PgSmart CLI, para instalar e configurar os componentes desejados.

Recomendamos a leitura da secção Visão Geral para uma melhor compreensão da Arquitectura da Plataforma.

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

  1. Descarregar 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 ligaçã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 numa máquina cliente, ou utilitária, para interagir com o(s) PgSmart Agent instalado(s).

  1. Descarregar 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. Registar um PgSmart Agent

    Terminal input
    pgsmart config agent

    3.1. Seleccione Registo de Agentes.

    3.2. Seleccione Registar e informe os dados do PgSmart Agent.

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

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

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

    3.6. Insira a chave de ligação do PgSmart Agent.

    3.7. Prima <enter> para confirmar o Registo do Agente.

O PgSmart Web é a interface web para gestão dos Ambientes de Base 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. Prima <enter> para seleccionar Administração e Operação do Ambiente PostgreSYS.

    1.2. Com a tecla de <espaço> e <enter>, seleccione Base de Metadados juntamente com Cliente do PgSmart (já seleccionado por defeito).

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

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

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

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

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

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

  2. Aceder ao PgSmart Web através do navegador

  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, terá o PgSmart CLI e o PgSmart Web disponíveis num único contentor.

Seguem os passos para importar e executar o contentor:

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

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

  2. Descarregar a imagem Docker dos clientes do PgSmart

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

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

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

  4. Opcionalmente, aceder ao pgsmart CLI no contentor em execução

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

  5. Aceder ao PgSmart Web através do navegador

  https://localhost:4435