Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ DOCUMENTAO DE POCE!!O "#Educar "nstalando e con$igurando o sistema de gesto escolar "#Educar %Procedimento &ara "nstalao' (erso )*+,- %&'011 rev:1 i Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ .ndice DOCUMENTAO DE PROCESSO..........................................................................................................I 1 INTRODUO..................................................................................................................................... .....................1 2 INSTALAO BSICA E REQUISITOS............................................................................................................ ....................2 2.1 O sistema de gesto escolar I-educar.................................................................................. ....................2 2.1 Requisitos para a instalao................................................................................................................... ..2 2.2 Instalando dependncias............................................................................................................... ...........3 Instalando PostgrSQL !".#$............................................................................................................................ .........# # RE%ER&NCIAS......................................................................................................................................... ................' %&'011 rev:1 ii Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ * "ntroduo ( o)jetivo deste tra)al*o desenvolver um do+umento ,ue au-ilie na instala!o do sistema de .esto es+olar /'edu+ar em um servidor 0e)ian 1N2#3inu-. Neste do+umento +onsta os 4ro+edimentos 4ara a instala!o dos a4li+ativos e servidores ne+ess5rios 4ara a im4lementa!o do sistema /'Edu+ar. 1 Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ / "nstalao b0sica e re1uisitos Ser5 a4resentado um roteiro +ontendo todos os 4ro+edimentos 4ara a instala!o das de4end6n+ias e servidores ne+ess5rios 4ara o )om 7un+ionamento do sistema. /+* O sistema de gesto escolar "#educar Solu!8es 4r5ti+as 4ara otimi9ar o tra)al*o nas es+olas esto su)stituindo os mtodos +onven+ionais de administra!o es+olar. A .esto es+olar 4re+isa de 7erramentas ,ue a.ili9em os 4ro+essos e 7a+ilitem o a+om4an*amento das rotinas administrativas. &uando se 7ala em sistema de .eren+iamento es+olar estamos dis+utindo as4e+tos rela+ionados : utili9a!o de +om4utadores e so7t;are ,ue .eren+iam suas atividades. 2ma ve9 ,ue estes sistemas au-iliam no 4ro+esso de .esto es+olar< sua introdu!o au-ilia no 4ro+esso de 4adroni9a!o< aumento da e7i+i6n+ia< +oo4era!o e mel*ores servi!os. ( sistema 4ermite o +om4artil*amento do +onte=do a+ad6mi+o das es+olas ,ue +om48em a institui!o. >am)m 4ermite< entre v5rios o)jetivos< +om4artil*ar os dados e-istentes entre todas as es+olas do muni+?4io< tendo uma lin.ua.em =ni+a de in7orma!o a ser distri)u?da a seus usu5rios. As 4rin+i4ais ra98es ,ue justi7i+am a o4!o 4or um sistema in7ormati9ado< so ,ue os sistemas in7ormati9ados 4odem ser mais )aratos ou mais e7i+ientes. (s dados sero inseridos uma =ni+a ve9 e< da? 4or diante< 4odero se a+essados e modi7i+ados. (utro motivo ,ue os sistemas 4odem 4ro4i+iar a introdu!o de servi!os ,ue no e-istiam antes e assim ajudar no 4ro+essamento de um volume menor de tra)al*o. 2ma das 4rin+i4ais vanta.ens de um sistema in7ormati9ado a 7a+ilidade de reor.ani9ar e sele+ionar re.istros 4ara a 4rodu!o de di7erentes sa?das. ( sistema de .eren+iamento +ontrola as atividades essen+iais de uma es+ola< ,ue so: +adastro de institui!o< alunos< servidores< es+olas de uma institui!o< +ursos e sries de uma es+ola< dis+i4linas (vin+ulando a uma srie ou +urso)< turmas de uma es+ola< usu5rios +om n?veis de a+esso< in7raestrutura< +alend5rio letivo< dentre outros. " Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ /+/ e1uisitos &ara a instalao ( sistema o4era+ional 7oi utili9ado um 0e)ian 1N2#3inu- Et+* @.1 r+". A limita!o do sistema est5 intimamente li.ados a ,uantidade de a+essos simultAneos ao sistema a ser im4lementado. Para tanto< se.ue uma es4e+i7i+a!o m?nima +omo teste: M01uina Peri$2rico Descrio Bard 0isC 1 dis+o @01D Pro+essador 1 4ro+essador /ntel(E) Pentium(E) @ P2 ".FF1B9 GemHria "IFGD de memHria EAG Eede 1 Pla+a et*ernet %oi reali9ada a instala!o )5si+a do 0e)ian NetInstall< +om os 4ro+edimentos 4adr8es de atuali9a!o utili9ando os re4ositHrios o7i+iais do 0e)ian Et+* e Security. A4Hs o)termos o e,ui4amento e o sistema )5si+o instalado +om suas atuali9a!8es. Podemos 4rosse.uir +om a instala!o das a4li+a!8es. /+3 "nstalando de&end4ncias Para in+iarmos a instala!o do sistema /'edu+ar< 4re+iso ajustar o sistema o4era+ional< instalado as a4li+a!8es e servidores ,ue 7a9em 4arte da solu!o de .esto es+olar. Vamos 4or 4artes. /nstalaremos 4rimeiramente o A4a+*e" ,ue o servidor de a4li+a!o Je) e tera +omo 7un!o 4rin+i4al dis4oni)ili9ar via 4roto+olo B>>P 1 o 4ortal do sistema /'edu+ar. /nstalar a4li+a!8es no 0e)ian 1N2#3inu- relativamente sim4les. Pode'se utili9ar o apt-get ,ue reali9a automati+amente o download do software e suas de4end6n+ias da /nternet e instala no sistema o4era+ional. NOTA5 Para +ontinuar< 4artimos do 4rin+i4io ,ue j5 e-iste um sistema o4era+ional 0e)ian 1N2#3inu- )5si+o instalado no novo servidor. 1 B>>P: BK4er >e-t Pro+essor. L Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ "nstalando Postgre!67 %8+3' Para instalar o /'edu+ar< ,uanto ao servidor de )an+o de dados< o sistema re,uer Post.reS&3 " em sua verso $.L.-< 4orm no re4ositHrio do 0e)ian Et+* +onsta somente a verso $.1. Para manter a inte.ridade do sistema e instalar a verso ne+ess5ria< in+lua no ar,uivo /etc/apt/sources.list a a lin*a do re4ositHrio backports +on7orme 4ro+edimentos a)ai-o: omando: # vi /etc/apt/sources.list onte=do a ser inserido no 7inal do ar,uivo: deb http://www.backports.org/debian etch-backports main contrib non-free Eode os +omandos a)ai-o 4ara atuali9ar a lista de 4a+otes do re4ositHrio in+lu?do e instalar o servidor de )an+o de dados Post.reS&3. # 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-ipr postgresql-server-dev-8.3 NOTA5 A4Hs o uso na instala!o do Post.reS&3< remova ou +omente a lin*a inserida e rode o +omando Mapt-get updateN novamente. Se tudo o+orreu sem erros< 4odemos 4assar 4ara a instala!o do A4a+*e"< +aso +ontr5rio revise os 4ro+edimentos. "nstalando A&ac9e %/+:' e P;P %<+:' O ne+ess5rio ter um servidor Je) +om su4orte a lin.ua.em PBP alm do servidor de )an+o de dados Post.reS&3. Sendo assim rode o +omando a)ai-o 4ara instalar o A4a+*e". # apt-get install apache! apache!-utils gcc make g"" gcc NOTA5 (s 4a+otes make< gcc e g++ sero utili9ados na +om4ila!o da P0%3i). " Gais em *tt4:##4t.;iCi4edia.or.#;iCi#Post.reS&3. @ Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ omo o sistema 7oi +onstru?do utili9ando a lin.ua.em de 4ro.rama!o PBP L < 4re+iso instalar o PBP verso I no servidor< )em +omo o su4orte ao )an+o de dados Post.reS&3< ao servidor A4a+*e" e al.uns outros su4ortes re,ueridos 4elo sistema /'edu+ar. Para tanto< se.ue o +omando do apt ,ue j5 reali9a a instala!o desses su4ortes. # apt-get install php# php#-cli php#-common php-pear php-pear php#-gd php#- pgsql php-db libapache!-mod-php# php# 4*4I'dev Este +omando )ai-a e instala todos os 4a+otes 4*4Ps ne+ess5rios 4elo A4a+*e na inter4reta!o do +Hdi.o. "nstalando PD=7ib e PD=7ib#P;P Alm dos so7t;ares ,ue esto no re4ositHrio 0e)ian< im4ortante instalar o P0%3i) e P0%3i)'PBP 4ara ,ue o mHdulo de relatHrios 7un+ione ade,uadamente. (4tamos 4or +om4ilar esses a4li+ativos e 4ara tanto 7oi do+umentado o 4ro+esso de +om4ila!o da a4li+a!o. aso o seu PBPI ten*a sido +om4ilado< lem)re'se ,ue ne+ess5rio ,ue o PBPI< ,uando +on7i.urado QconfigureQ 4ara a +om4ila!o< seja 4assado 4or 4arAmetro a o4!o Q--with-pdflibQ. Veja o +omando de +om4ila!o do PBPI +omo e-em4lo: # ./configure --prefi$%/usr/local/php# --with- ap$s!%/usr/local/apache!/bin/ap$s --with-config-file- path%/usr/local/apache!/conf --with-pgsql%/usr/local/pgsql --with-pdo- pgsql%/usr/local/pgsql --with-b&! --enable-calendar --enable-dba --enable- sysvmsg --enable-wdd$ --enable-&ip --with-openssl --with-&lib --enable-bcmath --with-gd --enable-ftp --enable-e$if --with-pdflib ( PBPI e A4a+*e" do 0e)ian 1N2#3inu- 4ossu? tal su4orte sendo desne+ess5rio o 4asso des+rito a+ima. Dai-e o +Hdi.o 7onte do P0%3i) do endere!o *tt4:##;;;.4d7li).+om#do;nload#4d7li)'7amilK#4d7li)'lite#< verso 4ara 1N2#3inu- arma9enando dentro do diretHrio /usr/src< 4ois esse o diretRorio 4adro 4ara +Hdi.os. 0es+om4a+te e +on7i.ure o 4a+ote 4ara ser instalado +on7orme des+rito a)ai-o: # cd /usr/src/ # tar -$&vf '()lib-*ite-+.,.3.tar.g& # cd '()lib-*ite-+.,.3 #./configure -without-tcl -without-ruby -without--ava om o 4a+ote 4re4arado 4ara a +om4ila!o< 4ode'se instalar +om4ilar e instalar. 3 Gais em *tt4:##;;;.4*4.net. I Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ # make # make install om a )i)liote+a P0%3i) ()< instalada 4oss?vel reali9ar a instala!o da P0%3i) (PBP) 4ara o A4a+*e". Para tanto< )ai-e o 4a+ote do endere!o a)ai-o e reali9e a instala!o via QpearQ. Endere!o 4ara download: *tt4:##4e+l.4*4.net#4a+Ca.e#4d7li) omando 4ara instala!o: # pear -v install /usr/src/pdflib-!...#.tar Vo+6 ser5 ,uestionado so)re o path no ,ual 7oi instalada a P0%3i)< sendo assim< 4ode se utili9ar /usr/local< +omo se.ue o e-em4lo: path to pdflib installation/ : /usr/local A mensa.em e-i)ida no 7im da instala!o 4assa al.umas in7orma!8es 4ara +on7i.ura!o da )i)liote+a no PBP. Se.ue o e-em4lo: successfully committed 0 file operations install ok: channel://pecl.php.net/pdflib-!...# 1ou should add 2e$tension%pdf.so2 to php.ini Sendo assim< ne+ess5rio inserir no php.ini a lin*a +ontendo a )i)liote+a +om4ilada 4ara *a)ilitar este su4orte. No se 4reo+u4e +om ela a.ora< 4ois trataremos isso na +on7i.ura!o do A4a+*e". F Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ 3 Con$igurando o "#educar e ser>ios aso todos os 4ro+edimentos listados a+ima e-i)iram resultados sem erros< 4oss?vel ini+iar neste momento a +on7i.ura!o dos servidores ,ue 7oram instalados e im4lementar o sistema ajustando +ada um deles. 3+* Con$igurando o banco de dados Para +on7i.urar a )ase de dados< ne+ess5rio ,ue sejam de7inidos al.uns 4arAmetros +omo usu5rio da ,ue ter5 4ermisso 4ara a+essar a )ase de dados< o nome da )ase de dados a ser +riada e uma sen*a 4ara o usu5rio. Nesta do+umenta!o< sero utili9ados os dados a)ai-o: "n$orma?es &ara a base Dado =uno Nome do usu5rio iedu+aruser Sen*a iedu+ar Nome da )ase iedu+ard) A4Hs de7inir esses 4arAmetros )5si+os< ne+ess5rio lo.ar no )an+o de dados e 4ara a+ess5'la< ne+ess5rio estar lo+a.o +om o usu5rio MpostgresN ,ue o usu5rio administrador do Post.reS&3. Sendo assim< si.a as instru!8es a)ai-o des+ritas: # su 3 postgres A.ora a+esse a )ase de dados +on7orme se.uindo os +omandos e ser5 e-i)ido o 4rom4t da )ase de dados onde 4ode'se rodar +omandos S&3 @ . 4 psql postgres%# @ S&3: Structured Query Language uma lin.ua.em de 4es,uisa de+larativa 4ara )an+o de dados rela+ional. S Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ on7orme de7inido na ta)ela anterior< os +omandos a)ai-o +riam os usu5rios de tem 4ermisso de a+esso a )ase e modi7i+a al.umas 4ermiss8es 4ara a a )ase. postgres%# 567897 6:*7 ieducaruser; postgres%# 8*976 6:*7 ieducaruser <=9> ?@'76@?76 =A>76=9 A:5678976:*7 567897(B *:C=A; Se.uindo tam)m a ta)ela< 4ara alterar a sen*a utili9e o +omando a)ai-o: postgres%# 8*976 @?76 ieducaruser <=9> '8??<:6( DieducarD; Para +riar a )ase de dados use: postgres%# 567897 (898B8?7 ieducardb <=9> 97E'*897 % template, :<A76 % ieducaruser 7A5:(=AC % D*89=A.D; A.ora a 4arte mais im4ortante. ( +omando a)ai-o insere os +omandos S&3 +ontidos no script dento da )ase de dados +riada (ieducardb). 2se o +omando M!N 4ara sair do prompt do Post.reS&3 e +omo usu5rio postgres ainda< rode o se.uinte +omando: 4 psql -d ieducardb -f i-educar.sql aso o ten*a sido utili9ado outro nome de usu5rio 4ara a+essar a )ase de dados do /'edu+ar< 4ode ser utili9ando um +omando no edito M"IN 4ara alterar todas as o+orr6n+ias no script 4ara o novo nome. omando: # vi i-educar.sql omando a e-e+utar no "I. :Fs/ieducaruser/novoGusuario/g Ainda ne+ess5rio ajustar o servidor Post.reS&3 4ara a+eitar as +one-8es. Para isso in+lua as se.uintes lin*as no ar,uivo a)ai-o: omando: # vi /etc/postgresql/8.3/main/pgGhba.conf onte=do: $ Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ host ieducardb ieducaruser .!+.,.,../3! trust A4Hs essa modi7i+a!o< o servidor Post.reS&3 dever5 ser reini+iado utili9ando o +omando M/etc/init.d/postgres!l-#.$ restartN. 3+/ Con$igurando ser>idor @eb e P;P ( servidor A4a+*e )em sim4les de +on7i.urar. A,ui ser5 +olo+ado um e-em4lo de uma +on7i.ura!o 7un+ional< 4orm sim4li7i+ada. 2m dos 4ontos mais relevantes +on7i.urar o ar,uivo 4*4.ini +om os valores a)ai-o: omando: # vi /etc/php#/apache!/php.ini onte=do: phpGadminGvalue displayGerrors :n phpGadminGvalue outputGbuffering ,H0 phpGadminGvalue memoryGlimit 3!E phpGadminGvalue registerGglobals :ff phpGadminGvalue registerGlongGarrays :ff phpGadminGvalue registerGargcGargv :ff phpGadminGvalue magicGquotesGgpc :ff phpGadminGvalue allowGurlGinclude :n phpGadminGvalue defaultGsocketGtimeout 0, phpGadminGvalue session.useGtransGsid , phpGadminGvalue urlGrewriter.tags 2a%hrefIarea%hrefIframe%srcIinput%srcIform%Ifieldset%2 e$tension%/usr/local/php#/lib/php/e$tensions/no-debug-non-&ts-!,,0,0.3/pdf.so OA!5 Veri7i,ue se o path da )i)liote+a pdf.so est5 +orreto e ajuste +aso seja 4re+iso. Para validar se a sinta-e in+lu?da no ar,uivo de +on7i.ura!o est5 +orreta< e-e+ute o +omando a)ai-o: # ./apachectl configtest ?ynta$ :J omo 4ressu4omos ,ue j5 7oi reali9ado o do;nload dos +Hdi.os 7ontes assim +omo o do script S&3 utili9ando anteriormente. 0es+om4a+te os +Hdi.os +on7orme e-em4lo a)ai-o: # tar -$&vf ieducarG..,.tg& -5 /var/www T Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ NOTA5 ( diretHrio /%ar/www o &ocument'oot 4adro do A4a+*e" no 0e)ian. aso ten*a d=vidas valide as +on7i.ura!8es do A4a+*e" 4ara sa)er onde se lo+ali9a tal diretHrio. A.ora< reini+ie ou re+arre.ue o servidor Je) A4a+*e". # /etc/init.d/apache! restart aso ,ueira validar o 7un+ionamento da P0%3i)< 4ode ser utili9ado a 7un!o phpinfo< e via browser veja se os su4ortes soli+itados no php.ini 7oram modi7i+ados. &uanto a )i)liote+a P0%3i)< no phpinfo< deve ser e-i)ido no browser as se.uintes in7orma!8es: As +on7i.ura!8es 7oram reali9adas. A.ora di.ite no browser *tt4:##lo+al*ost#iedu+ar e se todos 4ro+edimentos anteriores resultaram su+esso< teremos o sistema 7un+ionando 4er7eitamente. Para se lo.ar no sistema os usu5rios so: "n$orma?es sobre usu0rios &ara acesso ao sistema Usu0rio !en9a =uno iedu+ar iedu+ar 2su5rio adm adm Administrador 10 Documentao de Processo Cobra Tecnologia Data Center Verso: <1.0> Autor: Edmilson de Novais Silva (Paj) ria!o: "1#10#"00$ B e$er4ncias !ites *tt4:##;;;.4d7li).+om#4rodu+ts#4d7li)#in7o#P0%li)'in'PBP'Bo;>o.4d7 *tt4:##*tt4d.a4a+*e.or.#do+s#"."# *tt4:##;;;.4ost.res,l.or.#do+s#$.L#stati+#inde-.*tml 11