Skip to main content

Getting Started with PostgreSYS​

This section will guide you through the installation process and the initial steps to use PostgreSYS.

At the end, you will be able to access the Web interface to start configuring the components of your environment.

We recommend reading the Platform Architecture to better understand the details of each component.

  1. Download the package

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

  2. Install the RPM

    Terminal input
    rpm -ivh pgsmart-agent-4.0.0-1.el8.x86_64.rpm

  3. Start the service

    Terminal input
    systemctl enable --now pgsmart-agent

  4. Retrieve the connection key

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

    For more details about the installation process, refer to [PgSmart Agent Installation].

  1. Download the package

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

  2. Install the RPM

    Terminal input
    rpm -ivh pgsmart-client-4.0.0-1.el8.x86_64.rpm

  3. Register the Agent

    Terminal input
    pgsmart config agent
    3.1. Detalhamento dos passos
    • Select Agent Registration
    • Select Register and enter the Agent information:
    • Press <enter> to use the default hostname or IP of the server where the PgSmart Agent is installed.
    • Press <enter> to use the default port used by the Agent.
    • Press <enter> to use the Agent's default alias (nickname).
    • Enter the connection key obtained in the previous step - PgSmart Agent - Get the Connection Key.
    • Press <enter> to confirm the Agent registration.

  1. Install via CLI

    Terminal input
    pgsmart install
    • Press <enter> to select PostgreSYS Environment Administration and Operation.
    • Using <space> and <enter>, select Metadata Database along with PgSmart Client (already selected by default).
    • Press <enter> to proceed with the selection of PgSmart Web.
    • Press <enter> to register the Tecnisys Repository (yes is already selected by default).
      • Enter the repository address (<enter> to select the official Tecnisys repository).
    • Enter your Username.
    • Enter your Password.
    • Press <enter> to confirm the GPG key verification (yes is already selected by default).

  2. Access PgSmart Web

    https://<IP where the service was installed>:4435

A quick and simple way to run the web interface is using the Docker image.

With it, you will have both PgSmart CLI and PgSmart Web in a single container.

  1. Log in to the official Tecnisys repository

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

  2. Pull the image

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

  3. Run a container (mapping the access port to PgSmart Web)

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

  4. Optionally, access the PgSmart CLI in the running container

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