Manual/1.0.X/InstalacaoNoWindowsXP

Instalação do i-Educar 1.0.X no Windows XP

Índice

  1. Download do software
  2. Instalando a biblioteca PDFLib
  3. Instalando o PostgreSQL 8.2
  4. Criando o banco de dados
    1. Criando o usuário
    2. Criando o banco de dados
    3. Criando as tabelas do sistema
    4. Ajustando o search_path
    5. Configurando o acesso ao banco de dados
  5. Configurando o PHP
  6. Acessando a aplicação
  7. Bugs conhecidos
  8. Créditos

Instalar o i-Educar no Windows é um processo bastante fácil. Todas as dependências do i-Educar possuem versões compiladas para o Windows:

  • PHP 5.2
    • ext/gd
    • ext/pgsql
    • pecl/pdflib
  • Biblioteca PDFLib
  • Servidor web Apache
  • PostgreSQL 8.2

Observações mais detalhadas destas dependências estão em Pré-requisitos.

Este guia usou o EasyPHP mas você não deverá encontrar problemas para adaptá-lo a outros.

Download do software

Faça o download dos arquivos do sistema antes de prosseguir. A versão mais atual da família 1.0.X ( 1.0.2), está disponível em pacotes  ZIP e Gzip. Ao descompactar, você terá dois diretórios: intranet/ com os arquivos da aplicação e misc/, onde se encontra o script SQL para a criação do banco de dados.

Descompacte o arquivo e copie a pasta ieducar-XXX para o seu diretório web. No EasyPHP, esse diretório normalmente é o C:\EasyPHP\www:

Instalando a biblioteca PDFLib

A biblioteca PDFlib para o Windows já vem compilada. Diferentemente do PDFlib Lite, a versão disponível para o Windows é a comercial. Uma marca d'água será mostrada nos PDFs gerados até que você adquira uma licença de uso. Consulte o site da  PDFlib GmbH para maiores informações.

A versão disponível no tempo em que este guia foi escrito é a  7.0.4p2. Descompacte o ZIP e copie o arquivo libpdf_php.dll que está na pasta PDFlib-7.0.4p2-MSWin32-php\bind\php5\php-520 para o diretório de extensões do PHP. No EasyPHP, esse diretório é o C:\EasyPHP\php\ext. Após isso, edite novamente o arquivo php.ini, adicionando a seguinte linha: 

extension=libpdf_php.dll

Reinicie o seu Apache e acesse o seu arquivo info.php. Procure pela string pdf. Se estiver instalada corretamente, você verá uma tabela como a seguir:

 http://img207.imageshack.us/img207/4554/libpdfphpinfo.png

Instalando o PostgreSQL 8.2

O processo de instalação do PostgreSQL no Windows segue o padrão de outros softwares disponíveis par ao SO. Basta seguir as opções do instalador, que pode ser baixado  em formato Zip. No entanto, siga essas sugestões:

Na tela de configuração do serviço, deixe as opções padrões:

 http://img189.imageshack.us/img189/1232/pgsqlinstall1.png

Na tela Inicializar o agrupamento de banco de dados, deixe a opção Locale em C, dessa forma, você poderá criar bancos de dados com diferentes encodings. Anote a senha que você informar, será útil ao acessar o banco de dados pela ferramenta pgAdmin:

 http://img20.imageshack.us/img20/993/pgsqlinstall2.png

O restante da instalação não requer nenhuma observação em especial. Será criado um item no seu menu Iniciar > Todos os programas.

Criando o banco de dados

Ao instalar o PostgreSQL (veja procedimentos de instalação em Intalando o PostgreSQL 8.2 no Windows XP), um programa chamado pgAdmin é instalado automaticamente em seu sistema. O pgAdmin é um gerenciador gráfico de bancos de dados PostgreSQL gráfico, onde você pode realizar quase todas as tarefas de manutenção do seu servidor de banco de dados através de cliques.

Para iniciar o programa, clique em Iniciar > Todos os programas > PostgreSQL 8.2 > pgAdmin III

Criando o usuário

Para começar, precisamos criar o usuário que será dono do banco de dados. Esse passo é importante pois o usuário padrão do PostgreSQL é o postgres, que é um superusuário administrativo.

O nosso usuário será o ieducaruser e sua senha será ieducar. No seu pgAdmin, clique com o botão direito em cima de Login Roles e depois em New Login Role...:

 http://img152.imageshack.us/img152/935/pgadmincriandorole1.png

Nosso novo usuário se chamará ieducaruser e a senha será ieducar. Marque as opções Inherits rights from parent roles e Superuser, conforme a imagem:

 http://img366.imageshack.us/img366/2928/pgadmincriandodb2.png

Criando o banco de dados

Clique com o botão direito em cima de Databases e depois em Create new database:

 http://img503.imageshack.us/img503/7223/pgadmincriandodb1.png

Crie o seu banco de dados com o nome ieducardb e atribua o seu owner para o nosso recém criado usuário ieducaruser. Para o encoding, selecione LATIN1 e para o template template0:

 http://img152.imageshack.us/img152/561/pgadmincriandorole2.png

Seu banco de dados será listado após a criação:

 http://img411.imageshack.us/img411/1948/pgadminexecsql1.png

Criando as tabelas do sistema

Para criar as tabelas do i-Educar, basta executar o arquivo SQL que se encontra na pasta misc/. Siga os passos:

Clique em cima do banco de dados ieducardb na lista de banco de dados e, depois, clique em SQL, na barra de opções:

 http://img12.imageshack.us/img12/1948/pgadminexecsql1.png

Agora, clique no ícone da pasta (Open file...) e selecione o arquivo SQL que está na pasta misc/:

 http://img9.imageshack.us/img9/5338/pgadminexecsql2.png

O conteúdo do arquivo aparecerá na caixa de texto. Antes de executar a query, é necessário apagar duas linhas que são usadas apenas na importação pela linha de comando. Essas linhas estão logo no começo do arquivo, role apenas um pouco a barra de rolagem:

 http://img22.imageshack.us/img22/5135/pgadminexecsql3.png

Agora, clique no botão play na barra de opções:

 http://img13.imageshack.us/img13/879/pgadminexecsql4.png

Ao final, o arquivo deverá ter sido executado sem nenhum problema:

 http://img149.imageshack.us/img149/8615/pgadminexecsql5.png

Clique em Refresh para recarregar o banco de dados:

 http://img16.imageshack.us/img16/3235/pgadminexecsql6t.png

Expanda o banco de dados ieducardb clicando no botão + ao lado esquerdo. Você perceberá que novos schemas foram criados. Nesses esquemas que se encontram as tabelas usadas pelo i-Educar:

 http://img10.imageshack.us/img10/4535/pgadminexecsql7.png

Pronto. Seu banco de dados já está criado!

Ajustando o search_path

Para terminar a configuração do banco de dados, iremos ajustar o search_path do PostgreSQL. Clique com o botão direito no login role ieducaruser através do pgAdmin e escolha a opção Properties.

 http://img197.imageshack.us/img197/575/pgadminsearchpath1.png

Vá para a guia Variables e escolha na caixa de seleção Variable name a opção search_path. Como valor, coloque o seguinte: 

"$user", public, portal, cadastro, acesso, alimentos, consistenciacao, historico, pmiacoes, pmicontrolesis, pmidrh, pmieducar, pmiotopic, urbano

 http://img188.imageshack.us/img188/8061/pgadminsearchpath2.png

Clique em Add/change e depois em OK. Pronto.

Configurando o acesso ao banco de dados

Caso tenha escolhido outros nomes para o banco de dados (senão, pule esse passo) e para o usuário dono do banco, edite as seguintes variáveis no arquivo intranet/include/clsBanco.inc.php: 

/*protected*/var $strHost    = "localhost";    // IP do servidor do banco de dados (localhost para banco de dados na mesma máquina)
/*protected*/var $strBanco   = "ieducardb";    // Nome do banco de dados
/*protected*/var $strUsuario = "ieducaruser";  // Usuário do banco de dados
/*protected*/var $strSenha   = "ieducar";      // Senha do usuário do banco de dados

Configurando o PHP

O i-Educar funciona com a configuração padrão do PHP 5. Apenas alguns ajustes são necessários para evitar um mau comportamento da aplicação. Edite o arquivo php.ini ajustando as seguintes diretivas:

  • memory_limit: altere para no mínimo 32M (devido ao gerador de relatórios, em plataformas 64 bit, pode ser necessário aumentar para uma quantidade maior); 
    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; 
    error_reporting = E_ALL & ~E_NOTICE
  • display_errors: altere para Off em produção e deixe On para no seu ambiente de desenvolvimento. 
    display_errors = Off
  • short_open_tag: altere para On. 
    short_open_tag = On
  • habilite a extensão pgsql descomentando a seguinte linha: 
    extension=php_pgsql.dll

Dica: Para descobrir onde o arquivo php.ini fica em seu sistema operacional, crie um arquivo chamado info.php no diretório raiz do seu servidor web com o seguinte código do quadro a seguir e, então, acesse o endereço  http://localhost/info.php e procure pela string: "Loaded Configuration File". 

<?php phpinfo(); ?>

Dica: No EasyPHP, ao clicar com o botão direito do mouse no ícone do programa no System Tray, uma lista de opções aparece. Vá para Configuração > PHP que o arquivo php.ini será aberto no Bloco de notas.

 http://img36.imageshack.us/img36/8288/ieducareasyphpphpini.png

Acessando a aplicação

Após tudo configurado, é hora de acessar o i-Educar. Digite na barra de endereço do seu navegador o endereço http://localhost/ieducar-XXX (XXX é o número da versão que você instalou).

Existem dois usuários administrativos por padrão:

  • Usuário/matrícula adm e senha adm
  • Usuário/matrícula ieducar e senha ieducar (possui permissões nos módulos Escola e Biblioteca)

Bugs conhecidos

A plataforma Windows tem um problema relacionado a geração de PDFs. Veja o ticket #35 para maiores informações.

Créditos

Esse guia só foi possível graças ao auxílio da  Priscilla Ramos (Lupa Treinamentos) e da  Ilmara Martins (Fucapi) que relataram suas experiências com o i-Educar na plataforma Windows.