ircGraph 0.6.7 - 08/12/2002 - Ricardo Sartori <sartori@lrv.ufsc.br>

Requerimentos:
 - Perl >= 5.0 (http://www.perl.org)
 - RRDTool >= 1.0.32 (http://ee-staff.ethz.ch/~oetiker/webtools/rrdtool/)

Procedimentos para comecar a usar o ircgraph:
1 - Descomprimir o programa:
	tar xvfz ircgraph-0.6.x.tar.gz
2 - Entrar no diretorio criado:
	cd ircgraph-0.6.x/
3 - Editar o arquivo ircgraph.conf de acordo com suas necessidades e configuracoes.
	vi ircgraph.conf
    A diretiva ircservers deve possuir pelo menos um servidor de irc. Essa diretiva
    aceita uma lista de servidores, separados por virgula. O 1o servidor da lista
    eh o que vai servir de base para os dados da rede. Sugiro que esse servidor seja
    o mesmo do connectto, para evitar problemas com netsplits e lag.
    ********* OBSERVACAO *********
    O ircgraph.pl *EH* sensivel ao caso. Se o seu servidor se chama irc.MeUServidoR.com,
    o programa vai criar um arquivo RRD chamado irc.MeUServidoR.com e vai usar somente
    esse arquivo. Se voce definir ircservers = irc.meuservidor.com, o script *NAO* vai
    funcionar adequadamente. Use ircservers = irc.MeUServidoR.com. Defina os nomes dos
    servidores de maneira sensivel ao caso. Por enquanto, eh assim que funciona.
    ********* FIM DE OBSERVACAO *********
    Voce deve tambem definir a diretiva reponses. Leia o arquivo README.responses para
    saber mais.
4 - Rodar o programa ircgraph:
    /diretorio/ircgraph.pl [-d] [-l] [-c configfile] [-i IP] [-h]
    As flags tem as seguintes funcoes:
    -d = debug em stdout
    -l = log no arquivo de log especificado na diretiva logfile
    -c = arquivo de configuracao a ser usado pelo programa. Se essa flag nao for
	 especificada, o programa procurara pelos seguintes arquivos:
		/usr/local/etc/ircgraph.conf
		./ircgraph.conf
    -i = o programa vai tentar utilizar o IP especificado no argumento. Utilizar
    	 endereco ip em notacao decimal (ex: 201.202.203.204)
    -h = mostra o help do programa
5 - De 5 em 5 minutos voce pode gerar os graficos usando o programa makegraph:
    /diretorio/makegraph.pl [-c configfile] [-h] [-d]
	A flag -c segue a logica acima
	-h = mostra o help do programa
	-d = debug em stdout

6 - Voce pode automatizar o processo de criacao de grafico usando a seguinte linha
    na sua crontab:
*/5 * * * * /diretorio/makegraph.pl -c /diretorio/ircgraph.conf >> /dev/null
*/10 * * * * /diretorio/igcheck.pl /diretorio/ircgraph.conf

O igcheck.pl eh um script perl que le o arquivo de pid e verifica se o 
programa estah rodando ou nao. Para ele funcionar adequadaente, edite a linha 27
do script:
my($command)="/some/path/to/ircgraph.pl -c /some/path/to/ircgraph.conf &";
Se o igcheck descobrir que o arquivo de pid nao eh estavel e que o programa nao
estah rodando, o comando acima serah executado.

OBS: Alguns tipos de ircd se recusam a repassar informacoes solicitadas pelo comando
LUSERS * servidor. Para esse tipo de ircd, o ircgraph soh conseguirah coletar
os dados do servidor a qual ele estah conectado.

--------------------------------------------------
Ricardo Sartori
sartori@lrv.ufsc.br
