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

Atenção: este artigo foi migrado do antigo Portal do SPB e pode estar desatualizado, isso significa que pode ter algumas informações que não se aplicam mais. Caso tenha alguma dúvida ou sugestão, acesse a Home desta wiki, onde tem um link apontando para um espaço que foi reservado para isto.

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:

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:

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:

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...:

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:

Criando o banco de dados

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

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:

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

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:

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

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:

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

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

Clique em Refresh para recarregar o banco de dados:

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:

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.

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".

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.

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.