From 4cdcbd5120f8bc6a6104ad09eac90e0c2de1e1ee Mon Sep 17 00:00:00 2001 From: Eriksen Costa Paixão Date: Mon, 20 Jul 2009 17:54:35 +0000 Subject: [PATCH] Atualizado arquivo README.txt com novos procedimentos para instalação e configuração da aplicação --- ieducar/README.txt | 225 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 212 insertions(+), 13 deletions(-) diff --git a/ieducar/README.txt b/ieducar/README.txt index e6b4411..757c3de 100644 --- a/ieducar/README.txt +++ b/ieducar/README.txt @@ -13,10 +13,9 @@ CONTEÚDO REQUISITOS ---------- -O i-Educar requer um servidor web, PHP 5 (5.2 recomendado), PostgreSQL 8.2 -(a versão 8.2 é obrigatória) e a biblioteca PDFLib (versão Lite ou não). O -servidor web Apache 2 é recomendado mas qualquer outro com suporte a PHP pode -ser utilizado. +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 @@ -27,17 +26,221 @@ http://www.pdflib.com/products/pdflib-family/pdflib-lite/pdflib-lite-licensing INSTALAÇÃO ---------- -Por favor, consulte nosso manual sobre os procedimentos de instalação em: -http://svn.softwarepublico.gov.br/trac/ieducar/wiki/Documentacao/1.X/Instalacao +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: +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 +Problemas comuns de instalação podem ser encontrados no FAQ (perguntas frequentes): http://svn.softwarepublico.gov.br/trac/ieducar/wiki/Documentacao/FAQ/1.X @@ -55,8 +258,4 @@ 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. - - - -Obrigado por usar o i-Educar! \ No newline at end of file +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