From b0b64b1edd4264df639d4480a89bb2709c8f48fc Mon Sep 17 00:00:00 2001 From: Eriksen Costa Paixão Date: Mon, 15 Feb 2010 22:14:23 +0000 Subject: [PATCH] Atualizado {{{CHANGELOG.txt}}} para release 1.1.0 e adicionado arquivo {{{LEIAME.txt}}} --- ieducar/CHANGELOG.txt | 4 ++-- ieducar/LEIAME.txt | 261 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 263 insertions(+), 2 deletions(-) create mode 100644 ieducar/LEIAME.txt diff --git a/ieducar/CHANGELOG.txt b/ieducar/CHANGELOG.txt index 2b8b421..9dd52d2 100644 --- a/ieducar/CHANGELOG.txt +++ b/ieducar/CHANGELOG.txt @@ -1,7 +1,7 @@ // $Id$ -i-Educar 1.1.0-beta2 2009-09-07 -------------------------------- +i-Educar 1.1.0 2010-02-15 +------------------------- - #37 by Eriksen, Walter Marinho: Grande limpeza no banco de dados. Apenas dados essenciais estão sendo distribuídos como países, estados e municípios diff --git a/ieducar/LEIAME.txt b/ieducar/LEIAME.txt new file mode 100644 index 0000000..757c3de --- /dev/null +++ b/ieducar/LEIAME.txt @@ -0,0 +1,261 @@ +// $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. \ No newline at end of file -- libgit2 0.21.2