README.txt
// $Id$
CONTEÚDO
--------
* Requisitos
* Instalação
* Documentação
* Suporte técnico
* Licença
REQUISITOS
----------
O i-Educar requer um servidor web, PHP 5.2, PostgreSQL 8.2 e a biblioteca PDFLib
(versão Lite ou Commercial). O servidor web Apache 2 é recomendado mas qualquer
outro com suporte a PHP pode ser utilizado.
A biblioteca PDFLib Lite tem algumas restrições em sua utilização. Consulte a
licença da biblioteca para ver se o seu uso não cairá na necessidade de adquirir
uma licença comercial:
http://www.pdflib.com/products/pdflib-family/pdflib-lite/pdflib-lite-licensing
INSTALAÇÃO
----------
1. DOWNLOAD DO SOFTWARE
Faça o download dos arquivos do sistema antes de prosseguir. A versão atual
pode ser encontrada em:
http://www.softwarepublico.gov.br/dotlrn/clubs/ieducar/file-storage/index?folder_id=10855442.
Descompacte o pacote de sua preferência no diretório raiz do seu servidor web
Apache.
$ cd /var/www
$ mkdir ieducar; cd ieducar
$ tar -xzvf /caminho/pacotes/ieducar-X.X.X.tar.gz
2. CRIE O BANCO DE DADOS
Crie o banco de dados ao qual o i-Educar usará para armazenar todos os dados
digitados através da interface web. Os passos descritos nessa seção irão
criar:
* Um usuário ieducar no servidor PostgreSQL com a senha de acesso ieducar;
* Um banco de dados ieducar.
Observação: você pode usar o nome de usuário, banco de dados e senha que
desejar. Esses são apenas nomes padrões que a aplicação usa para conectar-se
ao banco.
Faça login no servidor de banco de dados PostgreSQL com o cliente psql:
$ su
# su - postgres
# psql
Alternativamente, com o sudo:
$ sudo -u postgres psql
Crie o usuário de banco de dados que será utilizado pelo i-Educar:
postgres=# CREATE ROLE ieducar;
postgres=# ALTER ROLE ieducar WITH SUPERUSER INHERIT NOCREATEROLE \
CREATEDB LOGIN PASSWORD 'ieducar';
Crie o banco de dados:
postgres=# CREATE DATABASE ieducar WITH TEMPLATE = template0 \
OWNER = ieducar ENCODING = 'LATIN1';
postgres=# \q
Execute o arquivo ieducar.sql que vem no i-Educar. O diretório em que esse
arquivo reside é o misc/database.
$ psql -d ieducar -f misc/database/ieducar.sql
Atenção: em algumas plataformas, o restore do banco pode acabar em um erro
FATAL. Se isso acontecer, experimente fazer o restore no mesmo diretório em
que se encontra o arquivo ieducar.sql.
Novamente no psql, execute o seguinte comando para configurar o search_path:
$ psql ieducar
postgres=# ALTER DATABASE ieducar SET search_path TO "$user", public, \
portal, cadastro, acesso, alimentos, consistenciacao, historico, \
pmiacoes, pmicontrolesis, pmidrh, pmieducar, pmiotopic, urbano;
postgres=# \q;
3. EDITE O ARQUIVO DE CONFIGURAÇÃO E CONCEDA PERMISSÕES DE ESCRITA
O i-Educar armazena algumas configurações necessárias para a aplicação em um
arquivo chamado ieducar.ini (em configuration/), que possui uma sintaxe bem
simples de entender. Caso tenha criado o banco de dados, nome de usuário ou
senha com um valor diferente de ieducar, basta editar esse arquivo para que
corresponda as suas escolhas:
[production]
; Configurações de banco de dados
app.database.dbname = ieducar
app.database.username = ieducar
app.database.hostname = localhost
app.database.password = ieducar
app.database.port = 5432
Exemplo: caso tenha nomeado seu banco de dados com ieducar_db, o usuário com
ieducar_user e a senha com ieducar_pass, o ieducar.ini ficaria da seguinte
forma:
[production]
; Configurações de banco de dados
app.database.dbname = ieducar_db
app.database.username = ieducar_user
app.database.hostname = localhost
app.database.password = ieducar_pass
app.database.port = 5432
Depois, conceda permissões de escrita nos diretórios intranet/tmp e
intranet/pdf. Uma forma prática é dar permissão de escrita para o usuário
dono do diretório e para usuários de um grupo. Nesse caso, mudaremos o grupo
desses diretórios para o grupo do usuário Apache.
# chmod 775 intranet/tmp intranet/pdf
# chgrp www-data intranet/tmp intranet/pdf
Observação: www-data é o nome do grupo Apache padrão em sistemas Debian.
Em outros sistemas, esse nome pode ser httpd, apache ou _www. Substitua de
acordo com o usado em seu sistema operacional.
4. CONFIGURE O APACHE OU CRIE UM VIRTUAL HOST
A partir da versão 1.1.X, o i-Educar inclui, por padrão, um arquivo chamado
.htaccess no diretório raiz da aplicação. Esse arquivo contém diretivas de
configuração do servidor Apache que tornam o i-Educar mais seguro.
Além disso, esse arquivo configura o PHP corretamente para as necessidades
da aplicação.
Para que esse arquivo seja executado a cada requisição, é necessário
configurar o Apache para que este execute os arquivos .htaccess ou criar um
Virtual Host. A primeira opção requer a edição do arquivo
/etc/apache2/site-available/default. A única diretiva a ser alterada é
AllowOverride (linha 11) para All:
9
10 Options Indexes FollowSymLinks MultiViews
11 AllowOverride All
12 Order allow,deny
13 allow from all
14
Reinicie o servidor Apache:
$ /etc/init.d/apache2 restart
A segunda opção requer a criação de um novo arquivo em
/etc/apache2/sites-available/. Crie um arquivo chamado ieducar.local com o
seguinte conteúdo:
ServerName ieducar.local
DocumentRoot /var/www/ieducar
AllowOverride all
Order deny,allow
Allow from all
Edite o arquivo /etc/hosts (no Windows esse arquivo fica em
C:\WINDOWS\system32\drivers\etc\hosts) e adicione a seguinte linha:
127.0.0.1 ieducar.local
Reinicie o servidor Apache:
$ /etc/init.d/apache2 restart
Pronto. Agora, acesse o endereço http://ieducar.local em seu navegador.
Atenção: configurar o seu servidor Apache (seguindo uma das opções
apresentadas) é importante para a segurança da aplicação. Assim, evita-se que
arquivos importantes como o configuration/ieducar.ini e os relatórios gerados
pela aplicação fiquem publicamente expostos para leitura através da Internet.
5. ACESSE A APLICAÇÃO
Abra o navegador de sua preferência e acesse o endereço
http://localhost/ieducar ou http://ieducar.local (caso tenha configurado um
Virtual Host). Faça o login na aplicação utilizando o usuário administrador.
O login e senha para acesso são admin e admin, respectivamente.
6. CONFIGURE O PHP
Esse passo é opcional caso tenha configurado o Apache (via AllowOverride ou
VirtualHost). Edite o arquivo php.ini da seguinte forma:
* memory_limit: altere para, no mínimo, 32M (devido a geração de relatórios
consumir bastante memória, pode ser necessário aumentar para uma quantidade
maior em plataformas 64 bits);
memory_limit = 32M
* error_reporting: altere para E_ALL & ~E_NOTICE para evitar que avisos do
nível E_NOTICE (comuns na versão atual), apareçam nas telas quebrando o
layout do sistema. E_ERROR é o recomendado para ambientes de produção.
error_reporting = E_ALL & ~E_NOTICE
* display_errors: altere para Off em produção:
display_errors = Off
* short_open_tag: altere para On.
short_open_tag = On
Observação: a localização do arquivo php.ini é diferente entre os sistemas
operacionais. No Debian/Ubuntu, o padrão é /etc/php5/apache2/php.ini. Para
descobrir onde o arquivo fica em seu sistema operacional, acesse o endereço
http://localhost/ieducar/info.php e procure por Loaded Configuration File.
Após qualquer alteração no arquivo php.ini, reinicie seu servidor web:
# /etc/init.d/apache2 restart
7. FONTE
* https://svn.softwarepublico.gov.br/trac/ieducar/wiki/Documentacao/1.1.X/Instalacao
DOCUMENTAÇÃO
------------
A documentação oficial do i-Educar está disponível em wiki:
http://svn.softwarepublico.gov.br/trac/ieducar/wiki
Problemas comuns de instalação podem ser encontrados no FAQ (perguntas
frequentes):
http://svn.softwarepublico.gov.br/trac/ieducar/wiki/Documentacao/FAQ/1.X
SUPORTE TÉCNICO
---------------
Suporte técnico pode ser encontrado nos fóruns da comunidade i-Educar no Portal
do Software Público Brasileiro (requer cadastro):
http://www.softwarepublico.gov.br/dotlrn/clubs/ieducar
LICENÇA
-------
O i-Educar é um Software Público Brasileiro (SPB), livre e licenciado pela
Creative Commons Licença Pública Geral versão 2 traduzida (CC GNU/GPL 2). Uma
cópia da licença está incluida nesta distribuição no arquivo LICENSE-pt_BR.txt.