Skip to main content

Installation via Packages

This section will guide you quickly and objectively through the first steps of the PostgreSYS Platform deployment process in your database environment.

At the end, you will be able to access PgSmart Web, or PgSmart CLI, to install and configure the desired components.

We recommend reading the Overview section for a better understanding of the Platform Architecture.

Running via Docker

For a quick installation alternative using containers, check out our guide on Running via Docker.

PgSmart Agent Installation​

The first step is to install the PgSmart Agent on all machines/servers you want to manage.

  1. Download the installation package

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

  2. Install the PgSmart Agent

    RHEL / CentOS / Rocky / Alma / SUSE / openSUSE

    • Using the rpm -ivh command

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

    • Using the dnf install command for RHEL-like distros

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

    • Using the zypper install command for SUSE-like distros

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

    Debian / Ubuntu

    • Using the apt-get install command

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

  3. Start the service

    Terminal input
    sudo systemctl enable --now pgsmart-agent

  4. Get 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.

PgSmart CLI Installation​

The next step is to install the PgSmart CLI on a client or utility machine to interact with the installed PgSmart Agent(s).

  1. Download the installation package

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

  2. Install PgSmart CLI

    RHEL / CentOS / Rocky / Alma / SUSE / openSUSE

    • Using the rpm -ivh command

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

    • Using the dnf install command for RHEL-like distros

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

    • Using the zypper install command for SUSE-like distros

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

    Debian / Ubuntu

    • Using the apt install command

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

  3. Register a PgSmart Agent

    Terminal input
    pgsmart config client

    3.1. Select Agent Registration.

    3.2. Select Register and enter the PgSmart Agent data.

    3.3. Press <enter> to use the default hostname or IP of the machine where the PgSmart Agent is installed.

    3.4. Press <enter> to use the default port used by the PgSmart Agent or enter the desired port.

    3.5. Press <enter> to use the default alias (nickname) of the PgSmart Agent or enter the desired alias.

    3.6. Enter the connection key of the PgSmart Agent.

    3.7. Press <enter> to confirm the Agent Registration.

PgSmart Web Installation​

PgSmart Web is the web interface for managing PostgreSYS Database Environments.

Some Platform features are only available through this interface. Its use is highly recommended.

  1. Install PgSmart Web via PgSmart CLI

    Terminal input
    pgsmart install

    1.1. Press <enter> to select PostgreSYS Environment Administration and Operation.

    1.2. Using <space> and <enter>, select Metadata Database along with PgSmart Client (already selected by default).

    1.3. Press <enter> to proceed with the selection of PgSmart Web.

    1.4. Press <enter> to register the Tecnisys Repository (the Yes option is already selected).

    1.5. Enter the package repository address (<enter> to select the official Tecnisys repository).

    1.6. Enter your Username for accessing the package repository.

    1.7. Enter your Password for accessing the package repository.

    1.8. Press <enter> to confirm GPG key verification (the Yes option is already selected).

  2. Access PgSmart Web through the browser

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