Portal do Software Pblico Brasileiro

Sistema CAU Central de Atendimento

ao Usurio
Manual de Instalao v 1.0

Braslia, 20 de janeiro de 2012

Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

Sumrio
Licena deste Documento ....................................................................................................................3
Introduo ao Sistema CAU.................................................................................................................4
Caractersticas e principais funcionalidades....................................................................................4
Instalao do Sistema...........................................................................................................................5
Requisitos gerais para instalao.....................................................................................................5
Pr-requisitos de Software...............................................................................................................5
Passo-a-passo da Instalao no Sistema Operacional Linux...........................................................6
Instalando Apache, PHP5 e PostgreSQL....................................................................................6
Download do software................................................................................................................6
Criao do Banco de Dados........................................................................................................6
Edite o arquivo de configurao e conceda permisses de escrita..............................................7
Edite o arquivo de configurao da biblioteca JpGraph.............................................................7
Configurando o PHP...................................................................................................................7
Configurao do Servidor Web Passo Opcional......................................................................8
Acessando a aplicao................................................................................................................8
Link da Licena Jridica Creative Commons.......................................................................................9

Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

Licena deste Documento
Para a utilizao deste documento necessrio seguir as regras da licena Creative
Commons pela mesma Licena 2.5 Brasil (http://creativecommons.org/licenses/by-ncsa/2.5/br/deed.pt_BR).
Voc tem a liberdade de:
Compartilhar copiar, distribuir e transmitir a obra.

Remixar criar obras derivadas.

Sob as seguintes condies:
Atribuio Voc deve creditar a obra da forma especificada pelo autor ou
licenciante (mas no de maneira que sugira que estes concedem qualquer aval a
voc ou ao seu uso da obra).
Compartilhamento pela mesma licena Se voc alterar, transformar ou criar
em cima desta obra, voc poder distribuir a obra resultante apenas sob a
mesma licena, ou sob uma licena similar presente.
Ficando claro que:
Renncia Qualquer das condies acima pode ser renunciada se voc obtiver
permisso do titular dos direitos autorais.
Domnio Pblico Onde a obra ou qualquer de seus elementos estiver em domnio
pblico sob o direito aplicvel, esta condio no , de maneira alguma, afetada pela
licena.
Outros Direitos Os seguintes direitos no so, de maneira alguma, afetados pela
licena:
Limitaes e excees aos direitos autorais ou quaisquer usos livres aplicveis;
Os direitos morais do autor;
Direitos que outras pessoas podem ter sobre a obra ou sobre a utilizao da obra,
tais como direitos de imagem ou privacidade.
Aviso Para qualquer reutilizao ou distribuio, voc deve deixar claro a terceiros os
termos da licena a que se encontra submetida esta obra. A melhor maneira de fazer isso
com um link para esta pgina.

Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

Introduo ao Sistema CAU
A instalao do Sistema CAU um processo bastante simples. O sistema possui duas
interfaces de interao: cau e gestaoti. A interface cau destinada a abertura e
acompanhamento de chamados pelos usurios demandantes, j a interface gestaoti
destinada ao atendimento e gerenciamento das demandas e todas as atividades de
configurao do sistema. Por este motivo, neste manual vrias vezes nos referimos ao
termo gestaoti ao invs do nome do sistema cau. Neste manual utilizaremos o termo
sisgestaoti para referenciar a raiz da aplicao, caso queira voc pode utilizar outro.
Caractersticas e principais funcionalidades
O cdigo fonte (que livre e aberto) est disponvel para ser baixado livremente no Portal
do SPB e sua implementao em PHP, tendo como camada de armazenamento o
sistema gerenciador de banco de dados PostgreSQL.
O sistema possui vrias funcionalidades entre as quais destacam-se:

Gesto de Ativos de TI
Sistemas de Informao
Servidores
Patrimnio
Anlise de impacto (Gesto de Configurao)
Gesto de Profissionais de TI e Clientes
Cadastro dos profissionais de TI
Cadastro de equipes
Time sheet
Cadastro dos clientes
Gesto de Chamados a TI
Gesto de requisies de servio
Gesto de incidentes
Gesto de problemas
Gesto de nveis de servios
Gesto de Mudanas
Relatrios de Apoio a Deciso

Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

Instalao do Sistema
Requisitos gerais para instalao
Sugerimos que este guia seja executado por um usurio com experincia em
configurao bsica de Apache, PHP e PostgreSQL.
Este roteiro est baseado no Sistema Operacional GNU/Linux Debian Lenny.
Este manual pressupe que o servidor de aplicaoo Web e o banco de dados estaro
instalados no mesmo servidor.
Pr-requisitos de Software
Os requisitos mnimos de software para a correta instalao do Sistema CAU so:
PHP 5.x
php5-gd
php5-pgsql
Servidor Web Apache
PostgreSQL 8.3 ou superior

Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

Passo-a-passo da Instalao no Sistema Operacional Linux

Instalando Apache, PHP5 e PostgreSQL

$ apt-get install apache2
$ apt-get install postgresql-8.4
$ apt-get install php5 libapache2-mod-php5 php5-gd php5-pgsql

Download do software
Faa o download dos arquivos do sistema antes de prosseguir. A verso atual, 1.0, est
disponvel em pacotes ZIP e GZip. Descompacte o pacote de sua preferncia no diretrio
raiz do seu servidor web Apache (no Debian, geralmente o diretrio raiz /var/www).
$ cd /var/www
$ unzip /caminho/cau-1.0.zip
$ mv cau-1.0 sisgestaoti

Criao do Banco de Dados

Crie o banco de dados ao qual o CAU usar para armazenar todos os dados digitados
atravs da interface web. Os passos descritos nessa seo iro criar:
Um usurio gestaoti no servidor PostgreSQL com a senha de acesso 'gestaoti';
Um banco de dados gestaoti.
Observao: voc pode usar o nome de usurio, banco de dados e senha que desejar.
Esses so apenas nomes padres que a aplicao usa para conectar-se ao banco.
Faa login no servidor de banco de dados PostgreSQL com o cliente psql:
$ su
# su - postgres
# psql

Alternativamente, com o sudo:

$ sudo -u postgres psql

Crie o usurio de banco de dados que ser utilizado pelo CAU:

postgres=# CREATE ROLE gestaoti;
postgres=# ALTER ROLE gestaoti WITH SUPERUSER INHERIT NOCREATEROLE
CREATEDB LOGIN PASSWORD 'gestaoti';

Crie o banco de dados:

postgres=# CREATE DATABASE gestaoti WITH TEMPLATE = template0 ENCODING =
'UTF8' LC_COLLATE = 'pt_BR.utf8' LC_CTYPE = 'pt_BR.utf8';
postgres=# ALTER DATABASE gestaoti OWNER TO gestaoti;
postgres=# \q
Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

Execute o arquivo script_gestaoti.sql que vem no cau. O diretrio em que esse arquivo
reside o install.
$
sudo
-u
postgres
psql
/var/www/sisgestaoti/install/script_gestaoti.sql

-d

gestaoti

-f

Edite o arquivo de configurao e conceda permisses de escrita

O CAU armazena algumas configuraes necessrias para a aplicao em um arquivo
chamado gestaoti_configs.inc.php (em /var/www/sisgestaoti/gestaoti/), que possui uma
sintaxe bem simples de entender. Caso tenha criado o banco de dados, nome de usurio
ou senha com um valor diferente de gestaoti, basta editar esse arquivo para que
corresponda as suas escolhas:
$gestaoti_settings['db_postgres_host']='localhost';
$gestaoti_settings['db_postgres_port']='5432';
$gestaoti_settings['db_postgres_name']='gestaoti';
$gestaoti_settings['db_postgres_user']='gestaoti';
$gestaoti_settings['db_postgres_pass']='gestaoti';
$gestaoti_settings['db_postgres_enconding']='LATIN1';

Depois, conceda permisses de escrita no diretrio cau/anexos. Uma forma prtica dar
permisso de escrita para o usurio dono do diretrio e para usurios de um grupo. Nesse
caso, mudaremos o grupo desses diretrios para o grupo do usurio Apache.
# chmod -R 775 /var/www/sisgestaoti/cau/anexos
# chown -R www-data.www-data /var/www/sisgestaoti/

Observao: www-data o nome do grupo Apache padro em sistemas Debian. Em

outros sistemas, esse nome pode ser httpd, apache ou _www. Substitua de acordo com o
usado em seu sistema operacional.
Edite o arquivo de configurao da biblioteca JpGraph
Configure o diretrio onde esto instaladas as fontes. Edite o arquivo jpg-config.inc.php
em /var/www/sisgestaoti/gestaoti/include/PHP/class. Por padro o sistema CAU utiliza a
fonte arial.ttf basta inclu-la no diretrio abaixo (no caso para sistemas Debian). Esta fonte
est includa no pacote ttf-mscorefonts-installer da distribuio Debian Lenny.
DEFINE("TTF_DIR","/usr/X11R6/lib/X11/fonts/truetype/");

Configurando o PHP
Edite o arquivo php.ini da seguinte forma:

register_globals: altere para On

register_globals = on

Observao: a localizao do arquivo php.ini diferente entre os sistemas operacionais.

Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

No Debian/Ubuntu, o padro /etc/php5/apache2/php.ini.
Aps qualquer alterao no arquivo php.ini, reinicie seu servidor web:
# /etc/init.d/apache2 restart

Configurao do Servidor Web (Passo Opcional)

Agora criaremos um virtual host no servidor. Crie um novo arquivo em /etc/apache2/sitesavailable/ chamado sisgestaoti.local com o seguinte contedo:
<VirtualHost *:80>
ServerName sisgestaoti.local
DocumentRoot /var/www/sisgestaoti/
<Directory /var/www/sisgestaoti>
AllowOverride all
Order deny,allow
Allow from all
</Directory>
</VirtualHost>

Edite
o
arquivo
/etc/hosts
(no
Windows
esse
arquivo
C:\WINDOWS\system32\drivers\etc\hosts) e adicione a seguinte linha:
127.0.0.1

fica

em

sisgestaoti.local

Habilite o Virtual Host:

# a2ensite sisgestaoti.local

Reinicie o servidor Apache:

# /etc/init.d/apache2 restart

Pronto. Agora, acesse o endereo http://sisgestaoti.local em seu navegador.

Acessando a aplicao
Abra o navegador de sua preferncia e acesse o endereo http://localhost/sisgestaoti ou
http://sisgestaoti.local (caso tenha configurado um Virtual Host). Faa o login na
aplicao utilizando o usurio administrador. O login e senha para acesso so admin e
admin, respectivamente.

Manual de Instalao do CAU

Portal do Software Pblico Brasileiro

Link da Licena Jridica Creative Commons
http://creativecommons.org/licenses/by-sa/2.5/br/legalcode

Manual de Instalao do CAU