Read Me

GRITO

1. Introdução

	Segue aqui um passo a passo em tom informal para "instalar" e criar um ponto inicial do sistema. O GRITO é independente de sistema operacional, foi testado em GNU/Linux e Windows. Instalar está com aspas pois não é preciso instalar o GRITO. É preciso instalar os softwares os quais o grito utiliza, estes são: Apache / Php / Mysql. Além disso, é preciso criar o banco de dados 'telefonia' (ou outro nome) e inserir as informações iniciais.

2. Pré Requisitos

	É preciso instalar o servidor web Apache ou qualquer outro servidor, mas aconselhamos fortemente a usar o Apache. O GRITO usa uma camada de abstração de dados a qual é independente do SGBD (sistema de gerenciamento de banco de dados). Foi testado seu funcionamento com o servidor Mysql e esse README vai tratar a instalaçao junto ao Mysql.


2.1 Apache

	O servidor Apache existe como pacote para quase todas as distribuições de GNU/Linux. Instale o mais recente. Para qualquer dúvida ou instalação em outro sistema operacional consulte www.apache.org.

2.2 Php

	GRITO foi testado com o php4 e php5. Deve-se habilitar a configuração register-globals. (em breve faremos com que está exigência não exista mais). Procure pelo Php em www.php.net ou procure o pacote da sua distribuição preferida.

2.3 Mysql

	Testamos com sucesso o mysql4 e mysql5. Baixar em www.mysql.org. O GRITO utiliza uma biblioteca de abstração de dados chamada adodb (http://adodb.sourceforge.net). Essa biblioteca funciona tambem com outros bancos de dados como Postgres e Oracle. Ainda não foi testado o funcionamento do GRITO com outro SGBD mas deve funcionar já que a adodb funciona. Para mudar de mysql para outro banco de dados deve-se alterar o arquivo /includes/config_BD.php.	

2.4 Debian
	
	Ok, se vc é usuário debian ou de alguma distribuição derivada (ubuntu, kurumin,etc.) aqui vão algumas instruções para rodar o grito. Como as dependências Apache/Php/Mysql são pacotes bem definidos no apt do debian se torna uma tarefa relativamente mais tranquila instala-los.
	$su 			#entre com seu password (se estiver usando o ubuntu/kubuntu utilize '$sudo passwd' para escolher um password para root)
	$apt-get update
	$apt-get install apache2
	$apt-get install php5
	$apt-get install libapache2-mod-php5
	$/etc/init.d/apache2 restart
	$apt-get install mysql-server

	Não se esqueça de configurar os usuários do mysql. O mysql instala por padrao sem password para root e somente acesso local.(www.mysql.org) Tambem lembrar de habilitar "register globals" no Php.	

2.5 Xampp

	Se voce utiliza outro sistema operacional ou obteve muitos problemas para instalar dos modos descritos acima você pode baixar um pacote o qual instala os elementos sozinho. Aconselhamos instalar o XAMPP (www.apachefriends.org/en/xampp.html). O XAMPP pode ser baixado para Linux, Windows, Mac OS X e Solaris. É muito fácil de instalar também.

3. Ponto Inicial (database insertions)

	Bom, supondo que o combo apache/mysql/php foi instalado corretamente, copie todos os arquivos do grito baixados do svn para a pasta pública (pode ser algo como public_html, www, ou no caso do XAMPP fica em /opt/lampp/htdocs). Utilizando um browser já deve ser possível ver a tela inicial do GRITO (o endereço deve ser http://127.0.0.1:80 ou :8080, depende da configuração do Apache). Ao tentar 'logar' você deve se perguntar: qual o usuário e a senha inicial (default)? Ainda nenhuma. Para ter um usuário principal ainda é preciso preencher o banco de dados com as informações iniciais do sistema. Crie um banco de dados chamado telefonia.
	
	Agora rode o script telefonia_ponto_inicial.sql no mysql.
	$mysql -u root -p < telefonia_ponto_inicial.sql
	(note que o xampp precisa ser iniciado e ele instala os executáveis em /opt/lampp/bin)

	Para 'logar' no GRITO inicialmente utilize o usuario 'admin' e a senha 'admin'. Como critério de segurança crie um novo usuário com acesso total e desative o usuário admin.

4. Estrutura de arquivos

	Como explicado pelo diagrama da documentação o grito, o diretório de ramais e o sistema de contas são sistemas complementares. Seguindo uma boa conduta de organização, é aconselhável fazer a seguinte mudança de organização: onde temos, por exemplo '/www/grito/ramais', mover a pasta ramais para o mesmo nível de grito. 

5. Configuração do acesso banco de dados.

	Configurar as informações de usuário, senha, host e nome do banco nos seguintes arquivos: 'grito/includes/config_BD.php' e 'ramais/includes/config_BD.php'

# A fazer: colocar esses arquivos de configuração do banco de dados fora da pasta compartilhada pelo apache. Isto é, no repertório local. Também alterar propriedades quanto a leitura e execução.