Instalacao Ieducar v1.0

download Instalacao Ieducar v1.0

of 13

Transcript of Instalacao Ieducar v1.0

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    DOCUMENTAO DE PROCESSO

    I-EducarInstalando e configurando o sistema de gesto

    escolar I-Educar

    (Procedimento para Instalao)

    Verso

    FQ-011 rev:1 i

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    ndiceDOCUMENTAO DE PROCESSO..........................................................................................................I

    1 INTRODUO..........................................................................................................................................................12 INSTALAO BSICA E REQUISITOS................................................................................................................................2

    2.1 O sistema de gesto escolar I-educar......................................................................................................22.1 Requisitos para a instalao.....................................................................................................................22.2 Instalando dependncias..........................................................................................................................3

    Instalando PostgreSQL (8.3)............................................................................................................................ .........33 REFERNCIAS.........................................................................................................................................................6

    FQ-011 rev:1 ii

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    1 Introduo

    O objetivo deste trabalho desenvolver um documento que auxilie na instalao do sistema de gesto escolar I-educar em um servidor Debian GNU/Linux.

    Neste documento consta os procedimentos para a instalao dos aplicativos e servidores necessrios para a implementao do sistema I-Educar.

    1

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    2 Instalao bsica e requisitos

    Ser apresentado um roteiro contendo todos os procedimentos para a instalao das dependncias e servidores necessrios para o bom funcionamento do sistema.

    2.1 O sistema de gesto escolar I-educar

    Solues prticas para otimizar o trabalho nas escolas esto substituindo os mtodos convencionais de administrao escolar. A gesto escolar precisa de ferramentas que agilizem os processos e facilitem o acompanhamento das rotinas administrativas.

    Quando se fala em sistema de gerenciamento escolar estamos discutindo aspectos relacionados utilizao de computadores e software que gerenciam suas atividades.

    Uma vez que estes sistemas auxiliam no processo de gesto escolar, sua introduo auxilia no processo de padronizao, aumento da eficincia, cooperao e melhores servios.

    O sistema permite o compartilhamento do contedo acadmico das escolas que compem a instituio. Tambm permite, entre vrios objetivos, compartilhar os dados existentes entre todas as escolas do municpio, tendo uma linguagem nica de informao a ser distribuda a seus usurios.

    As principais razes que justificam a opo por um sistema informatizado, so que os sistemas informatizados podem ser mais baratos ou mais eficientes. Os dados sero inseridos uma nica vez e, da por diante, podero se acessados e modificados. Outro motivo que os sistemas podem propiciar a introduo de servios que no existiam antes e assim ajudar no processamento de um volume menor de trabalho.

    Uma das principais vantagens de um sistema informatizado a facilidade de reorganizar e selecionar registros para a produo de diferentes sadas.

    O sistema de gerenciamento controla as atividades essenciais de uma escola, que so: cadastro de instituio, alunos, servidores, escolas de uma instituio, cursos e sries de uma escola, disciplinas (vinculando a uma srie ou curso), turmas de uma escola, usurios com nveis de acesso, infraestrutura, calendrio letivo, dentre outros.

    2

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    2.2 Requisitos para a instalao

    O sistema operacional foi utilizado um Debian GNU/Linux Etch 4.1 rc2.

    A limitao do sistema est intimamente ligados a quantidade de acessos simultneos ao sistema a ser implementado. Para tanto, segue uma especificao mnima como teste:

    Mquina

    Perifrico Descrio

    Hard Disk 1 disco 40GB

    Processador 1 processador Intel(R) Pentium(R) 4 CPU 2.66GHz

    Memria 256MB de memria RAMRede 1 Placa ethernet

    Foi realizada a instalao bsica do Debian NetInstall, com os procedimentos padres de atualizao utilizando os repositrios oficiais do Debian Etch e Security.

    Aps obtermos o equipamento e o sistema bsico instalado com suas atualizaes. Podemos prosseguir com a instalao das aplicaes.

    2.3 Instalando dependncias

    Para inciarmos a instalao do sistema I-educar, preciso ajustar o sistema operacional, instalado as aplicaes e servidores que fazem parte da soluo de gesto escolar.

    Vamos por partes. Instalaremos primeiramente o Apache2 que o servidor de aplicao Web e tera como funo principal disponibilizar via protocolo HTTP1 o portal do sistema I-educar.

    Instalar aplicaes no Debian GNU/Linux relativamente simples. Pode-se utilizar o apt-get que realiza automaticamente o download do software e suas dependncias da Internet e instala no sistema operacional.

    NOTA: Para continuar, partimos do principio que j existe um sistema operacional Debian GNU/Linux bsico instalado no novo servidor.

    1 HTTP: Hyper Text Processor.

    3

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    Instalando PostgreSQL (8.3)

    Para instalar o I-educar, quanto ao servidor de banco de dados, o sistema requer PostgreSQL2 em sua verso 8.3.x, porm no repositrio do Debian Etch consta somente a verso 8.1. Para manter a integridade do sistema e instalar a verso necessria, inclua no arquivo /etc/apt/sources.list a a linha do repositrio backports conforme procedimentos abaixo:

    Comando:

    # vi /etc/apt/sources.listContedo a ser inserido no final do arquivo:

    deb http://www.backports.org/debian etch-backports main contrib non-free

    Rode os comandos abaixo para atualizar a lista de pacotes do repositrio includo e instalar o servidor de

    banco de dados PostgreSQL.

    # apt-get update# apt-get install -t etch-backports debian-backports-keyring# apt-get install -t etch-backports postgresql-8.3 postgresql-client-8.3 postgresql-plperl-8.3 postgresql-plpython-8.3 postgresql-pltcl-8.3 postgresql-contrib-8.3 postgresql-8.3-ip4r postgresql-server-dev-8.3

    NOTA: Aps o uso na instalao do PostgreSQL, remova ou comente a linha inserida e rode o comando apt-get update novamente.

    Se tudo ocorreu sem erros, podemos passar para a instalao do Apache2, caso contrrio revise os procedimentos.

    Instalando Apache (2.X) e PHP (5.X)

    necessrio ter um servidor Web com suporte a linguagem PHP alm do servidor de banco de dados PostgreSQL. Sendo assim rode o comando abaixo para instalar o Apache2.

    # apt-get install apache2 apache2-utils gcc make g++ gcc

    NOTA: Os pacotes make, gcc e g++ sero utilizados na compilao da PDFLib.

    2 Mais em http://pt.wikipedia.org/wiki/PostgreSQL.

    4

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    Como o sistema foi construdo utilizando a linguagem de programao PHP3, preciso instalar o PHP verso 5 no servidor, bem como o suporte ao banco de dados PostgreSQL, ao servidor Apache2 e alguns outros suportes requeridos pelo sistema I-educar. Para tanto, segue o comando do apt que j realiza a instalao desses suportes.

    # apt-get install php5 php5-cli php5-common php-pear php-pear php5-gd php5-pgsql php-db libapache2-mod-php5 php5 php5-dev

    Este comando baixa e instala todos os pacotes php's necessrios pelo Apache na interpretao do cdigo.

    Instalando PDFLib e PDFLib-PHP

    Alm dos softwares que esto no repositrio Debian, importante instalar o PDFLib e PDFLib-PHP para que o mdulo de relatrios funcione adequadamente. Optamos por compilar esses aplicativos e para tanto foi documentado o processo de compilao da aplicao.

    Caso o seu PHP5 tenha sido compilado, lembre-se que necessrio que o PHP5, quando configurado "configure" para a compilao, seja passado por parmetro a opo "--with-pdflib". Veja o comando de compilao do PHP5 como exemplo:

    # ./configure --prefix=/usr/local/php5 --with-apxs2=/usr/local/apache2/bin/apxs --with-config-file-path=/usr/local/apache2/conf --with-pgsql=/usr/local/pgsql --with-pdo-pgsql=/usr/local/pgsql --with-bz2 --enable-calendar --enable-dba --enable-sysvmsg --enable-wddx --enable-zip --with-openssl --with-zlib --enable-bcmath --with-gd --enable-ftp --enable-exif --with-pdflib

    O PHP5 e Apache2 do Debian GNU/Linux possu tal suporte sendo desnecessrio o passo descrito acima.

    Baixe o cdigo fonte do PDFLib do endereo http://www.pdflib.com/download/pdflib-family/pdflib-lite/, verso para GNU/Linux armazenando dentro do diretrio /usr/src, pois esse o diretorio padro para cdigos.

    Descompacte e configure o pacote para ser instalado conforme descrito abaixo:

    # cd /usr/src/# tar -xzvf PDFlib-Lite-7.0.3.tar.gz # cd PDFlib-Lite-7.0.3 #./configure -without-tcl -without-ruby -without-java

    Com o pacote preparado para a compilao, pode-se instalar compilar e instalar.

    3Mais em http://www.php.net.

    5

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    # make # make install

    Com a biblioteca PDFLib (C), instalada possvel realizar a instalao da PDFLib (PHP) para o Apache2. Para tanto, baixe o pacote do endereo abaixo e realize a instalao via "pear".

    Endereo para download: http://pecl.php.net/package/pdflib

    Comando para instalao:

    # pear -v install /usr/src/pdflib-2.1.5.tar

    Voc ser questionado sobre o path no qual foi instalada a PDFLib, sendo assim, pode se utilizar /usr/local, como segue o exemplo:

    path to pdflib installation? : /usr/local

    A mensagem exibida no fim da instalao passa algumas informaes para configurao da biblioteca no PHP. Segue o exemplo:

    successfully committed 6 file operations install ok: channel://pecl.php.net/pdflib-2.1.5 You should add "extension=pdf.so" to php.ini

    Sendo assim, necessrio inserir no php.ini a linha contendo a biblioteca compilada para habilitar este suporte. No se preocupe com ela agora, pois trataremos isso na configurao do Apache2.

    6

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    3 Configurando o I-educar e servios

    Caso todos os procedimentos listados acima exibiram resultados sem erros, possvel iniciar neste momento a configurao dos servidores que foram instalados e implementar o sistema ajustando cada um deles.

    3.1 Configurando o banco de dados

    Para configurar a base de dados, necessrio que sejam definidos alguns parmetros como usurio da que ter permisso para acessar a base de dados, o nome da base de dados a ser criada e uma senha para o usurio.

    Nesta documentao, sero utilizados os dados abaixo:

    Informaes para a base

    Dado Funo

    Nome do usurio ieducaruser

    Senha ieducar

    Nome da base ieducardb

    Aps definir esses parmetros bsicos, necessrio logar no banco de dados e para acess-la, necessrio estar locago com o usurio postgres que o usurio administrador do PostgreSQL. Sendo assim, siga as instrues abaixo descritas:

    # su postgres

    Agora acesse a base de dados conforme seguindo os comandos e ser exibido o prompt da base de dados onde pode-se rodar comandos SQL4.

    $ psqlpostgres=#

    4 SQL: Structured Query Language uma linguagem de pesquisa declarativa para banco de dados relacional.

    7

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    Conforme definido na tabela anterior, os comandos abaixo criam os usurios de tem permisso de acesso a base e modifica algumas permisses para a a base.

    postgres=# CREATE ROLE ieducaruser;

    postgres=# ALTER ROLE ieducaruser WITH SUPERUSER INHERIT NOCREATEROLE CREATEDB LOGIN;

    Seguindo tambm a tabela, para alterar a senha utilize o comando abaixo:

    postgres=# ALTER USER ieducaruser WITH PASSWORD 'ieducar';

    Para criar a base de dados use:

    postgres=# CREATE DATABASE ieducardb WITH TEMPLATE = template0 OWNER = ieducaruser ENCODING = 'LATIN1';

    Agora a parte mais importante. O comando abaixo insere os comandos SQL contidos no script dento da base de dados criada (ieducardb). Use o comando \q para sair do prompt do PostgreSQL e como usurio postgres ainda, rode o seguinte comando:

    $ psql -d ieducardb -f i-educar.sql

    Caso o tenha sido utilizado outro nome de usurio para acessar a base de dados do I-educar, pode ser utilizando um comando no edito VI para alterar todas as ocorrncias no script para o novo nome.

    Comando:

    # vi i-educar.sqlComando a executar no VI.

    :%s/ieducaruser/novo_usuario/g

    Ainda necessrio ajustar o servidor PostgreSQL para aceitar as conexes. Para isso inclua as seguintes linhas no arquivo abaixo:

    Comando:

    # vi /etc/postgresql/8.3/main/pg_hba.conf Contedo:

    8

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    host ieducardb ieducaruser 127.0.0.1/32 trust

    Aps essa modificao, o servidor PostgreSQL dever ser reiniciado utilizando o comando /etc/init.d/postgresql-8.3 restart.

    3.2 Configurando servidor Web e PHP

    O servidor Apache bem simples de configurar. Aqui ser colocado um exemplo de uma configurao funcional, porm simplificada.

    Um dos pontos mais relevantes configurar o arquivo php.ini com os valores abaixo:

    Comando:

    # vi /etc/php5/apache2/php.iniContedo:

    php_admin_value display_errors On php_admin_value output_buffering 4096 php_admin_value memory_limit 32M php_admin_value register_globals Off php_admin_value register_long_arrays Off php_admin_value register_argc_argv Off php_admin_value magic_quotes_gpc Off php_admin_value allow_url_include On php_admin_value default_socket_timeout 60 php_admin_value session.use_trans_sid 0 php_admin_value url_rewriter.tags "a=href,area=href,frame=src,input=src,form=,fieldset="extension=/usr/local/php5/lib/php/extensions/no-debug-non-zts-20060613/pdf.so

    OBS: Verifique se o path da biblioteca pdf.so est correto e ajuste caso seja preciso.

    Para validar se a sintaxe includa no arquivo de configurao est correta, execute o comando abaixo:

    # ./apachectl configtest Syntax OK

    Como pressupomos que j foi realizado o download dos cdigos fontes assim como o do script SQL utilizando anteriormente. Descompacte os cdigos conforme exemplo abaixo:

    # tar -xzvf ieducar_1.0.tgz -C /var/www

    9

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    NOTA: O diretrio /var/www o DocumentRoot padro do Apache2 no Debian. Caso tenha dvidas valide as configuraes do Apache2 para saber onde se localiza tal diretrio.

    Agora, reinicie ou recarregue o servidor Web Apache2.

    # /etc/init.d/apache2 restart

    Caso queira validar o funcionamento da PDFLib, pode ser utilizado a funo phpinfo, e via browser veja se os suportes solicitados no php.ini foram modificados.

    Quanto a biblioteca PDFLib, no phpinfo, deve ser exibido no browser as seguintes informaes:

    As configuraes foram realizadas. Agora digite no browser http://localhost/ieducar e se todos procedimentos anteriores resultaram sucesso, teremos o sistema funcionando perfeitamente.

    Para se logar no sistema os usurios so:

    Informaes sobre usurios para acesso ao sistema

    Usurio Senha Funo

    ieducar ieducar Usurio

    adm adm Administrador

    10

  • Documentao de ProcessoCobra Tecnologia Data Center Verso: Autor: Edmilson de Novais Silva (Paj) Criao: 21/10/2008

    4 Referncias

    Sites

    http://www.pdflib.com/products/pdflib/info/PDFlib-in-PHP-HowTo.pdf

    http://httpd.apache.org/docs/2.2/

    http://www.postgresql.org/docs/8.3/static/index.html

    11