Skip to content

Latest commit

 

History

History
177 lines (149 loc) · 6.65 KB

freebsd.md

File metadata and controls

177 lines (149 loc) · 6.65 KB
Raw

PostgreSQL

Para instalar o PostgreSQL em uma arquitetura BSD, existem 2 caminhos principais:

Vou abordar a instalação com o pkg e pela compilação.

Ports - pkg

O pkg é o gerenciador de pacotes padrão do FreeBSD e mantém um porte do PostgreSQL em seu repositório padrão. Primeiro, vamos fazer a atualização e instalar o port.

  pkg update
  pkg install postgresql11-server postgresql11-client

Ativando a inicialização do serviço e iniciando o PostgreSQL:

  sudo sysrc postgresql_enable=yes
  sudo service postgresql initdb
  sudo service postgresql start

A Configurando inicial do PostgreSQL, cria um usuário postgresql para gerenciar os recursos da execução(padrão do mundo BSD). Essa conta, por padrão, não possui senha, logo não é possivel logar nela fora do root, mas vamos precisar acessá-la para a configuração inicial:

  sudo su - postgres
  • 1ª Configuração: Senha do usuário(padrão) do banco de dados postgres
  psql -c "alter user postgres with password 'MinhaSenha123'"
  • 2ª Permitir Acesso remoto
  sudo su
  echo "listen_addresses='*'" >> /var/db/postgres/data11/postgresql.conf
  • 3ª Reiniciar Banco de Dados
  service postgresql restart

Caso tenha dúvidas adicionais, A configuração do PostgreSQL esta aqui

Compilação

Esta instalação pode ser mais complexa para alguns usuários, sendo aconselhável que se entenda o básico do build de projetos C/C++ via makefile e cmake. Antes de baixar os códigos-fonte, precisamos instalar as dependências (libs e utilitários) necessárias para o PostgreSQL. Para FreeBSD:

  sudo pkg install perl5 perl5-devel python3 libressl-devel libxml2 libxslt openldap-client llvm11 libedit lua53

Para GenericBSD:

  pkg install perl5 perl5-devel python3 libressl-devel libxml2 libxslt openldap-client llvm11 libedit readline editline lua53

Inicialmente vamos baixar o código-fonte do site official

  sudo su
  cd ~
  curl https://ftp.postgresql.org/pub/source/v11.20/postgresql-11.20.tar.gz --output postgresql11.tar.gz
  tar -xf postgresql-11.tar.gz

Por padrão, devemos sempre salvar os arquivos da instalação quando não temos um gerenciador de pacotes para cuidar da gestão. Assim sendo, vamos salvá-los no diretório /opt, mas o BSD não possui o diretório /opt, ele usa o /usr/local, então vamos criá-lo!

  mkdir /opt
  mv postgresql-11.20 /opt/
  cd /opt/postgresql-11.20

Agora com as dependencias e o código-fonte, vamos executar o script configure que esta dentro do diretorio /opt/postgresql-11.20.

  ./configure
  make
  make install

Vamos criar o usuario postgres, para delegar a ele os acessos aos arquivos uteis para o banco de dados:

  adduser postgres
  mkdir /usr/local/pgsql/data
  chown postgres /usr/local/pgsql/data

Vamos iniciar a base de dados e rodar os arquivos de tests, para confirmar!

  su - postgres
  /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data
  /usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data >logfile 2>&1 &
  /usr/local/pgsql/bin/createdb test
  /usr/local/pgsql/bin/psql test

Se chegou ate aqui fique com a configuração basica a seguir, se não veja o Thouboshuting

  • 1ª Configuração: Senha do usuario(Padrão) do banco de dados postgres
  psql -c "alter user postgres with password 'MinhaSenha123'"
  • 2ª Permitir Acesso remoto
  sudo su
  echo "listen_addresses='*'" >> /var/db/postgres/data11/postgresql.conf
  • 3ª Reiniciar Banco de Dados
  service postgresql restart

Troubleshooting

Essa sessão esta dividida em:

Erros adicionais, pense em abrir uma issue, mas saiba que o tempo dos mantener's é limitado.

Falha na Compilação

Caso existam erros na hora de rodar o ./configure, verifique o arquivo config.log

  cat config.log | grep -in error | more

Provavelmente os maiores problemas serão do linker e do choke me. O choke me e uma forma do programador verificar se a lib usada esta na versão correta, exemplo:

    #include <stdio.h>
    #include <crypt.h>

    int main() {
        #ifdef _XOPEN_VERSION
            printf("Versão da biblioteca crypt.h: %ld\n", _XOPEN_VERSION);
        #else
            printf("Biblioteca crypt.h não encontrada\n");
            chose me
        #endif

        return 0;
    }

Verifique esses if's para observar se tudo esta na versão correta! O lineker linka as bibliotecas aos executaveis, os erros devem ser parecidos com isso:

 1218:ld: error: unable to find library -lreadline

Ou

 1734:conftest.c:41:10 fatal error: 'crypt.h' file not found

Nesse caso você pode criar um arquivo main.c e colocar o #include <crypt.h> no programa e compila-lo usando o ld -L <pasta aonde esta a lib> para verificar se esta instalada, aponte para /usr/lib. Se não ouver a lib, você pode baixar os fontes ou a versão compilada da lib em FreshPort e GNU e rezar para que o build de certo! Boa sorte!

Falha nas Dependencias(pkg)

Verifique usando search nas dependencias, pode ser que sua distro tenha a mesma lib, mas com um nome diferente

  pkg search <dependencia>

Caso não exista eu vou colocar o link de cada dependencia aqui: