======================================================================
PGTOOLS - v0.1
======================================================================

HISTRICO
=========
Esta  a primeira verso do pacote PgTools, escrita para PostgreSQL,
em portugus do Brasil.

O desenvolvimento e testes foram feitos em um servidor Linux Debian,
com kernel 2.4.x e PostgreSQL 7.3, 7.4, 8.0 e 8.1.

Os scripts deste pacote foram desenvolvidos inicialmente devido 
necessidade de se obter informaes detalhadas em relao s bases
de dados de uma instncia e tambm informaes detalhadas quanto
ao processamento e consumo de recursos do sistema operacional pelo
SGBD.

A linguagem escolhida para o desenvolvimento dos scripts foi o Bash,
tanto pela convinincia e recursos, quanto por estar disponvel em
todos os sistemas Linux mais utilizados.

Esta primeira verso do pacote contm os seguintes arquivos:
   pg_monitor_processos.sh
   pg_monitor_tamanho.sh
   leia-me.txt


OBJETIVOS
=========
O script "pg_monitor_processos.sh" tem como finalidade exibir os
processos executados no PostgreSQL, e o consumo de recursos destes
no sistema operacional, exibindo alm disto, quando for o caso, os
arquivos temporrios pelo SGBD (pgsql_tmp), que podem ser gerados
quando da criao de ndices e ordenaes. Este script executa em
loop em intervalos de 5 segundos at que seja interrompido (CTRL+C).

O script "pg_monitor_tamanho.sh" tem como finalidade exibir dados
da ocupao em disco pelas bases de dados de uma instncia, bem co-
mo a quantidade de bases de dados ativas (que aceitam conexes), a
quantidade de arquivos dos logs de transao (WAL Logs) e o espao
ocupado pelos mesmos. Alm disto, exibe informaes das parties
em disco. Este script executa uma vez a leitura e termina.

A tendncia  unificar estes scripts em um nico arquivo, minimizan-
do a redundncia de cdigo e melhor aproveitar alguns procedimentos.

 inteno publicar uma verso futura em ingls e, aps isto, estu-
dar a publicao em outras lnguas.


INSTALAO
==========
Para instalar basta descomprimir e descompactar o arquivo do pacote
e copi-lo para um local onde o usurio "postgres" (ou outro usado
para administrao do SGBD) tenha acesso para execuo e leitura.
Sugiro "/usr/local/".

Comando(s):
   tar -jxpvf pgtools-0.1.tar.bz2
   cp -afv ./pgtools /usr/local/
   chown -Rf postgres.postgres /usr/local/pgtools/
   chmod -f 755 /usr/local/pgtools/*.sh

Acrescente o caminho para o diretrio do pgtools na sua varivel PATH,
caso seja de sua convinincia.


REMOO
=======
Para remover o pacote, basta remover o diretrio de localizao dos
arquivos do pgtools.

Comando(s):
   rm -rf /usr/local/pgtools/


USO
===
Para usar, deve-se estar logado no sistema operacional como usurio
"postgres" (ou outro usado para administrao do SGBD) e executar o
script desejado.

Comando(s):
   cd /usr/local/pgtools/
   sh pg_monitor_processos.sh
   (ou)
   sh pg_monitor_tamanho.sh


Sugestes so bem vindas! Para contribuir, favor acessar a lista do
projeto no site "http://www.pgfoundry.org".

Bom proveito!

              Guilherme Augusto da Rocha Silva
                Brasil, 28 de abril de 2006.
