Verso 1.0 05/11/2011 Ttulo Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Autor Fabrio de !o"es Mello# Feli$e %ie&enbac' olaborao Lus Fernando (aiva S)*ia + ,er-ncia de Inova.es Tecnol/0icas - %SI1M(2, !ireitos %3Seller Servios de In&or*4tica LT%5. !ata riao 06111112 I"#ortante (ara este $rocedi*ento reco*enda-se con'eci*entos na instalao de siste*as o$eracionais linu7 e a$t-0et. 2 servidor 8ue ser4 utiliado $ara instalao dever4 estar conectado a internet# $ois os $acotes sero bai7ados dos re$osit/rios. 1. $evis%es &ro !ata 'bserva%es 2. Instalao Ubuntu Server 12.04 LTS 2.1 - !o(nload 9o site 'tt$:11;;;.ubuntu.co*10etubuntu1do;nload-server e7iste* dis$onveis $ara do;nload a verso 12.04LTS de acordo co* a sua ar8uitetura <2 ou =4 bits. !ica) Se o seu servidor $ossuir *ais de 4,3 de *e*/ria !5M ento instale a verso =4 bits do siste*a o$eracional. 2.2 - Instalao 5 instalao do Ubuntu Server deve ser $adro. (ara *aiores in&or*a.es acessar: 'tt$s:11'el$.ubuntu.co*112.041server0uide1>1inde7.'t*l 2.* + ,dio ar-uivos de con./urao Su0eri*os utiliar o editor ?vi*@ $ara edio dos ar8uivos de conA0urao 8ue sero alterados nessa instalao. Mais in&or*a.es sobre o ?vi*@ $ode* ser obtidas e*: 'tt$:11;;;.vi*.or0 (40ina 1112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 2.4 + 'bserva%es Bsse *anual conte*$la a instalao de u* Servidor $ara uso do e-cidade# necessitando ento 8ue o usu4rio ten'a outro co*$utador $ara acesso# via Fire&o7# ao siste*a ou instale o a*biente 0r4Aco no servidor Cno reco*endado $ara a*bientes de $roduoD# durante a instalao do servidor voc- deve &ornecer u* no*e de usu4rio di&erente de ?dbseller@# $ois *ais adiante o *es*o ser4 utiliado $ara ad*inistrar o B-cidade: $ sudo apt-get install ubuntu-desktop *. Instalao 0ost/reS1L 2.2 3se" oti"i4ao de #er5or"ance6 *.1 - 0re#arao (ara instalar o (ost0reSEL F.2 tere*os de utiliar u*a &erra*enta do a$t c'a*ada ?a$t- add-re$ositor"@ 8ue nos $rove as Glti*as atualia.es dos $acotes re8ueridos atravHs de u* canal se0uro e conA4vel u*a ve 8ue os $acotes so distribudos $elos *antenedores do $acote no Ubuntu server 12.04. (ara isso $recisa*os realiar os se0uintes $assos: >ertiA8ue-se de ter instaldo o $acote: $ sudo apt-get install python-software-properties B* se0uida adicione os se0uintes re$osit/rios co* o co*ando ?a$t-add-re$ositor"@ I sudo apt-add-repository ppa:pitti/postgresql 2bserva.es: Maiores detal'es sobre a utiliao do re$osit/rio $ode* ser encontradas no site 'tt$s:11launc'$ad.net1J$itti1Karc'ive1$ost0res8l *.2 - Instalao (ara instalar o (ost0reSEL F.2 basta utiliar a &erra*enta a$t-0et: $ sudo apt-get update $ sudo apt-get install postgresql-9.2 postgresql-contrib-9.2 *.* - on./urao luster (40ina 2112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 %eve*os utiliar o encodin0 L5TI91 CIS2-LL6F-1D no >luster do (ost0reSEL F.2 onde ser4 instalado o e-cidade. aD !e*over o cluster atual: $ sudo pg_dropcluster --stop 9.2 main bD >orri0ir a ordenao do encode no IS2-LL6F-1: $ sudo vi /usr/share/i18n/locales/pt_BR cD 5dicionar no trec'o do L>M>2LL5TB as lin'as a se0uir# entre ?L>M>2LL5TB@ e ?B9% L>M>2LL5TB@: LC_COLLATE copy "iso14651_t1" reorder-after <U00A0> <U0020><CAP>;<CAP>;<CAP>;<U0020> reorder-end END LC_COLLATE dD !edeAnir o locale $ sudo localedef -i pt_BR -c -f ISO-8859-1 -A /usr/share/locale/locale.alias pt_BR eD re0erar o locale alterado e reconA0urar o siste*a $ara &aer uso dele: $ sudo locale-gen pt_BR $ sudo dpkg-reconfigure locales $ export LC_ALL=pt_BR $ sudo echo LC_ALL=pt_BR >> /etc/environment &D >riar novo cluster co*o L5TI91: $ sudo pg_createcluster -e LATIN1 9.2 main 0D Iniciar servidor (ost0reSEL $ sudo /etc/init.d/postgresql start 'D Bditar o 1etc1$ost0res8l1F.21*ain1$0M'ba.con& e dei7ar con&or*e se0ue: (40ina <112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 $ sudo vim 1etc1$ost0res8l1F.21*ain1$0M'ba.con& Alterar as linhas no final do arquivo que esto sem o #, colocando trust no lugar da ltima coluna: local all all trust host all all 127.0.0.1/32 trust host all all ::1/128 trust iD !ecarre0ar as conA0ura.es do (ost0reSEL: $ sudo /etc/init.d/postgresql reload ND 5$/s a recriao do cluster o resultado da veriAcao deve ser o 8ue se0ue: $ psql -U postgres -h localhost -l List of databases Name | Owner | Encoding --------------------------------+----------+---------- postgres | postgres | LATIN1 template0 | postgres | LATIN1 template1 | postgres | LATIN1 (3 rows) *.4 - on./urao 0rinci#al 37etc7#ost/res-l72.27"ain7#ost/res-l.con56 aD >onA0ura.es a sere* alteradas no $ost0res8l.con& Co restante dos $ar)*etros Aca* inalteradosD: $ sudo vim /etc/postgresql/9.2/main/postgresql.conf (40ina 4112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 listen_addresses = '*' max_connections = 20 bytea_output = 'escape' max_locks_per_transaction = 256 default_with_oids = on escape_string_warning = off standard_conforming_strings = off bD !einiciar (ost0reSEL: $ sudo /etc/init.d/postgresql restart 4. Instalao A#ac8e 2 4.1 - Instalao (ara instalar o 5$ac'e 2 basta utiliar a &erra*enta a$t-0et: $ sudo apt-get install apache2 4.2 - ,ditar ar-uivo 7etc7a#ac8e27a#ac8e2.con5 $ sudo vim /etc/apache2/apache2.conf aD 5lterar o $ar)*etro Ti*eout $ara 12000 Timeout 12000 %ica: >aso voc- utilie $ro7" Cs8uidD na sua rede te* 8ue atentar $ara o ?read ti*eout@ do *es*o e* 8ue o $adro H 10 *inutos# e de$endendo do $rocessa*ento a ser e&etuado no siste*a# u* $ro0ra*a $ode levar be* *ais de 10 *inutos $ara e7ecutar CB7: >4lculo de Fol'a de (a0a*entoD ento ser4 necess4rio au*entar o valor desse $ar)*etro. bD 5dicionar as se0uintes lin'as ao Anal do ar8uivo: # linhas adicionadas para o e-cidade LimitRequestLine 16382 LimitRequestFieldSize 16382 4.* - ,ditar ar-uivo 7etc7a#ac8e27con5.d7c8arset aD 5lterar o $ar)*etro 5dd%e&ault>'arset (40ina 6112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 AddDefaultCharset ISO-8859-1 AT,&9:'; uidado #ara no dei<ar o Add!e5ault8arset co"entado= ou se>a= co" o caracter ? no inicio;; 4.4 - riao 0asta Ar-uivos Te"#or@rios aD %eve ser criada u*a $asta ?t*$@ no %2>UMB9TM!22T do 5$ac'e C1var1;;;D $ sudo mkdir /var/www/tmp $ sudo chown -R www-data.www-data /var/www/tmp $ sudo chmod -R 777 /var/www/tmp A. Instalao 0B0 A A.1 - Instalao (ara instalar o (O( 6 e os */dulos necess4rios basta utiliar a &erra*enta a$t-0et: $ sudo apt-get install php5 php5-gd php5-pgsql php5-cli php5-mhash php5-mcrypt AT,&9:'; As bibliotecas Cbc"at8D= C!'MD e C"bstrin/D deve" estar instaladas ta"bE". &as distribui%es baseadas e" !ebian elas ve" co"#iladas >unto ao #acote do 0B0A e no e<iste e" se#arado= "as e" outras distribui%es Linu< isso #ode ser di5erente. A.1 - on./urao aD >riar $asta $ara os lo0s do (O(6 $ sudo mkdir /var/www/log $ sudo chown -R www-data.www-data /var/www/log bD 5certar $er*iss.es do 1var1lib1$'$6 $ sudo chown root.www-data /var/lib/php5 $ sudo chmod g+r /var/lib/php5 cD Bditar o ar8uivo 1etc1$'$61a$ac'e21$'$.ini e *odiAcar os $ar)*etros: (40ina =112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 2bserva.es: os $ar)*etros a sere* conA0urados 8ue na lin'a inicia* co* o caracter P# este deve ser retirado. $ sudo vim /etc/php5/apache2/php.ini register_globals = on register_long_arrays = on register_argc_argv = on post_max_size = 64M magic_quotes_gpc = on upload_max_filesize = 64M default_socket_timeout = 60000 max_execution_time = 60000 max_input_time = 60000 memory_limit = 512M allow_call_time_pass_reference = on error_reporting = E_ALL & ~E_NOTICE display_errors = off log_errors = on error_log = /var/www/log/php-scripts.log session.gc_maxlifetime = 7200 dD !einiciar Servidor Qeb 5$ac'e $ sudo /etc/init.d/apache2 restart F. Instalao Libre'Gce F.1 - Instalao (ara instalar o Libre2Rce basta utiliar a &erra*enta a$t-0et: $ sudo apt-get install libreoffice-writer python-uno openjdk-6-jre F.2 - on./urao 5dicione o 8ue est4 e* Sne0ritoS ao ar8uivo 1etc1rc.local. 5ntes da lin'a 8ue contH* ?e7it 0@: $ sudo vim /etc/rc.local /usr/bin/soffice -accept="socket,host=localhost,port=8100;urp;" -nofirststartwizard -headless & (40ina T112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 exit 0 AT,&9H';; >aso voc- utilie outra distribuio Linu7 ou instalou o 2$en2Rce de outra &or*a# deve veriAcar o ar8uivo S1var1;;;1e-cidade1bin1oo2$d&1oo2$d&.s'S $ara aNustar correta*ente o ca*in'o do 2$en2Rce na vari4vel S''III,S e do ("t'on na vari4vel S'''0JTB'&S $ara 8ue a inte0rao do e-cidade co* o 2$en2Rce &uncione correta*ente. K. Instalao e-cidade K.1 - Introduo 5ntes de *ais nada deve*os obter o $acote co* a verso deseNada# e $ara isso $recisa*os entender a no*enclatura de u* $acote do so&t;are con&or*e se0ue: e-cidade-VERSAO.RELEASE.SUBRELEASE-SISTEMAOPERACIONAL.TIPO.tar.bz2 UB!S52: 9G*ero da verso do e-cidade. B7: 2 !BLB5SB: 9G*ero da release atual do e-cidade. B7: < SU3!BLB5SB: 9G*ero da sub-release Cta*bH* c'a*ado de co*$ilaoD do e- cidade. B7: < SISTBM52(B!5>I295L: Siste*a 2$eracional $ara o 8ual &oi 0erado o $acote de instalao. 5tual*ente so*ente Slinu7S H su$ortado (40ina L112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 TI(2: Ti$o do (acote# se no e7istir nen'u* co*ent4rio ento esse H u* $acote de atualiao de verso# caso contr4rio ser4 indicado $elo ter*o Sco*$letoS 8ue H u* $acote $ara u*a nova instalao. U* e7e*$lo do $acote da verso 2.<.< Acaria assi*: e-cidade-2.3.3-linux.completo.tar.bz2 (pacote para nova instalao da verso 2.3.3) K.2 - Usu@rio Ad"inistrador %eve*os criar u* usu4rio $ara ad*inistrar o e-cidade. >riare*os ento o usu4rio ?dbseller@. aD >riando o usu4rio no 0ru$o correto. $ sudo useradd -d /home/dbseller -g www-data -k /etc/skel -m -s /bin/bash dbseller $ sudo passwd dbseller (definir a senha default como dbseller) bD (ara corri0ir as $er*iss.es de criao de ar8uivos deve*os *odiAcar o ?lo0in.de&s@ e setar*os o $ar)*etro ?u*asV@ $ara ao valor ?002@ da se0uinte *aneira: $ sudo vi /etc/login.defs UMASK 002 2bserva.es: os $ar)*etros a sere* conA0urados 8ue na lin'a inicia* co* o caracter P# este deve ser retirado. K.* - riao Lase de !ados do e-cidade (ara e7e*$liAcar a instalao utiliare*os o $acote deno*inado Se-cidade-2.<.<- linu7.co*$leto.tar.b2S 8ue dever4 ser bai7ado do (ortal do So&t;are (Gblico# co*unidade e-cidade. 1. %esco*$actar o $acote no diret/rio 1t*$ (40ina F112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 $ cd /tmp $ sudo tar jxvf e-cidade-2.3.3-linux.completo.tar.bz2 2. >riao da base de dados Cc'a*are*os a base de Se-cidadeSD $ sudo cd e-cidade-2.3.3-linux.completo/sql $ psql -U postgres -h localhost template1 -c "create role ecidade with superuser login password 'ecidade'" $ psql -U postgres -h localhost template1 -c "create role dbseller with login password 'dbseller'" $ createdb -U ecidade e-cidade $ psql -U ecidade e-cidade -f e-cidade-2.3.3.sql 2> /tmp/erros.txt $ vim /tmp/erros.txt $ psql -U ecidade e-cidade -c "VACUUM ANALYZE VERBOSE;" 'bserva%es: >aso voc- 8ueira instalar o e-cidade utiliando u*a base de dados $ara de*onstrao# ou seNa# co* dados Actcios ento no ite* 2# lin'a 6 ao invHs de recu$erar o ar8uivo ?e-cidade-2.<.<.s8l@ *ude $ara ?e-cidade-de*o-2.<.<.s8l@. K.4 - Instalao do #acote do e-cidade aD 5cessar o $acote e co$iar $ro0ra*as $ara $asta do 5$ac'e2 $ cd /tmp/e-cidade-2.3.3-linux.completo $ sudo cp -r e-cidade /var/www bD 5Nustar $er*iss.es da $asta $ sudo chown -R dbseller.www-data /var/www/e-cidade $ sudo chmod -R 775 /var/www/e-cidade $ sudo chmod -R 777 /var/www/e-cidade/tmp cD >onA0urar acesso a base de dados C con&er-ncia D $ sudo vim /var/www/e-cidade/libs/db_conn.php (Ajustar as variveis:) $DB_USUARIO = 'ecidade'; $DB_SENHA = ''; // Ou se for definida alguma senha para o usuario ecidade no postgresql $DB_SERVIDOR = 'localhost'; $DB_PORTA = '5432'; (40ina 10112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 $DB_PORTA_ALT = '5432'; $DB_BASE = 'e-cidade'; K.A + Acesso ao e-cidade aD Se voc- o$tou $or instalar o a*biente 0r4Aco Cubuntu-desVto$D Nunto ao servidor con&or*e descrito no ite* 2.4 ento basta abrir o nave0ador Fire&o7 e acessar a url: 'tt$:11local'ost1e-cidade bD >aso voc- ten'a instalado o servidor se* a*biente 0r4Aco# ento a$artir de u* co*$utador desVto$ abra o nave0ador Fire&o7 e acesse a url: 'tt$:11Wi$MdoMservidorX1e-cidade 2nde ?i$MdoMservidor@ indica o entereo I( atribudo na instalao do servidor Ubuntu. cD 9a tela de lo0in do e-cidade in&or*ar o usu4rio ?dbseller@ e dei7ar a sen'a e* branco. AT,&9:'; ' Iire5o< deve estar co" as C#o#-u#D 8abilitadas #ara o I0 do Servidor #ara -ue o e-cidade #ossa 5uncionar. K.F - Instalao do e-cidadeonline 2 $acote e-cidadeonline H o servio dis$onvel ao cidado. aD 5cessar o $acote e co$iar $ro0ra*as $ara $asta do 5$ac'e2 $ cd /tmp/e-cidade-2.3.3-linux.completo $ sudo cp -r e-cidadeonline /var/www bD 5Nustar $er*iss.es da $asta $ sudo chown -R dbseller.www-data /var/www/e-cidadeonline $ sudo chmod -R 775 /var/www/e-cidadeonline $ sudo chmod -R 777 /var/www/e-cidadeonline/tmp cD >onA0urar acesso a base de dados C con&er-ncia D $ sudo vim /var/www/e-cidadeonline/libs/db_conn.php (Ajustar as variveis:) (40ina 11112 Manual Instalao e-cidade no Ubuntu Server 12.04 LTS Verso 1.0 05/11/2011 $DB_INSTITUICAO = 1; $DB_SERVIDOR = 'localhost'; $DB_BASEDADOS = 'e-cidade'; $DB_USUARIO = 'ecidade'; $DB_SENHA = ''; // Ou se for definida alguma senha para o usuario ecidade no postgresql $DB_PORTA = '5432'; 1. Mloss@rio Ter"o Si/ni.cado encodin0 'tt$:11en.;iVi$edia.or01;iVi1>'aracterMencodin0 cluster 'tt$:11;;;.$ost0res8l.or01docs1L.21interactive1creatin0-cluster.'t*l a$t-0et 'tt$:11;;;.debian.or01doc1*anuals1a$t-'o;to 'tt$:11$t.;iVi$edia.or01;iVi15dvancedM(acVa0in0MTool Ui* 'tt$:11;;;.vi*.or0 Fire&o7 'tt$:11;;;.*oilla.or01Are&o7 %3Seller Siste*as 'tt$:11;;;.dbseller.co*.br $ro7" 'tt$:11$t.;iVi$edia.or01;iVi1(ro7" s8uid 'tt$:11$t.;iVi$edia.or01;iVi1S8uid (40ina 12112