FIEL Contbil

Desenvolvimento Financiamento
www.apoenasoftwarelivre.com.br www.bancariospoa.com.br
Manual de
Instalao
Verso 2.0
Introduo
O FIEL Contbil um software livre desenvolvido pela !"OE#!
$olu%es em $oftware Livre Ltda e financiado inicialmente pelo $indicato dos
&ancrios de "orto !le're e (e'io.
)rata*se de um inovador $istema de Contabilidade e Oramento +ue
visa beneficiar no somente os seus usurios mas toda a sociedade , medida
+ue distribui livremente o con-ecimento.
O FIEL Contbil esta licenciado sob a licena Creative Commons .
-ttp/00creativecommons.or'0licenses0b1*nc*sa02.30br0deed.pt 4 o +ue
si'nifica +ue voc5 pode/
6sar livremente este sistema7
8odificar o sistema7
Distribuir as modifica%es feitas desde +ue mantendo os crditos
dos autores.
9oc5 no pode em -ip:tese al'uma/
Fa;er uso comercial do produto.
! se'uir tem*se e<plica%es tcnicas sobre os procedimentos para
instalao do sistema em ambiente =#60Linu<.
Cabe ressaltar +ue o sistema pode tambm ser instalado em outros
ambientes operacionais porm os procedimentos de instalao devero ser
revistos.
APOENA Solues e! So"t#are Li$re Ltda.
(e+uisitos Funcionais
"ara instalar o FIEL Contbil voc5 ter +ue ter um computador
.denominado >$ervidor?4 com os se'uintes sistemas0aplicativos instalados/
$istema Operacional =#60Linu<7
$ervidor @eb !pac-e7
$uporte a Lin'ua'em de pro'ramao "A" B.C ou superior7
$ervidor de &anco de Dados "ost're$DL E.F ou superior.
"ara a utili;ao do $istema FIEL Contbil basta +ue voc5 ten-a um
computador com um browser devidamente confi'urado e com acesso , rota
do servidor.
O $istema FIEL Contbil um $istema @eb ou seGa todas as
transa%es so reali;adas no $ervidor. O computador cliente ir somente
enviar0receber os dados di'itados e processados atravs do browser. O
sistema foi desenvolvido e testado nos browsers 8o;illa Firefo< #estcape e
Internet E<plorer. O uso de outros nave'adores ou vers%es muito anti'as
destas pode causar distor%es estticas na apresentao da tela.
"rocedimentos para Instalao
#esta etapa iremos presumir +ue o instalador do software possui
con-ecimento tcnico dos se'uintes assuntos/
$istema Operacional =#60Linu<7
Confi'urao e iniciali;ao dos servios do =#60Linu<7
Edio de ar+uivos de confi'urao.
%a. Eta&a ' Pre&arando o a!biente
! confi'urao do ambiente =#60Linu< varia muito de distribuio para
distribuio.
Ini(iali)ando o Post*reS+L
6ma ve; instalado e confi'urado o "ost're$DL ser necessrio
confi'urar a sen-a do usurio postgres atravs do se'uinte comando/
# passwd postgres
Certifi+ue*se de +ue o servio post'res+l esteGa rodando em sua
m+uina. Caso seu servidor de banco de dados no seGa o mesmo
e+uipamento onde estar sendo -ospedada a a aplicao ten-a certe;a +ue o
servio postmaster est rodando com o parHmetro -i .verifi+ue isso
e<ecutando ps ax | grep postmaster 4.
!lm de preparar o ambiente do banco de dados voc5 tambm
precisar fa;er al'uns aGustes na confi'urao do "A".
"or padro o "A" assume +ue o tempo m<imo para e<ecuo de
processos pe+ueno. "orm como o FIEL Contbil 'era documentos "DFs
e<tensos precisa*se aGustar o parHmetro max_execution_time para um valor
maior +ue o padro.
Edite o ar+uivo /etc/php.ini e aGuste a se'uinte diretiva como
se'ue/
max_execution_time = 600
Certi+ue*se tambm +ue o ar+uivo /etc/php.ini tem a se'uinte
declarao/
register_globals = on
2a. Eta&a ' ,es(o!&a(tando o ar-u$io "iel(ontabil.)i&
Dependendo da distribuio =#60Linu< e da verso do !pac-e
instalada este poder ter como diret:rio rai; .root4 um camin-o diferente.
"ara efeitos didticos estaremos assumindo ao lon'o das e<plica%es
+ue o diret:rio rai; do !pac-e o diret:rio /var/www/html/ . $e o diret:rio
do !pac-e for outro voc5 dever ade+uar os comandos ao pat- utili;ado.
Dentro do diret:rio do !pac-e crie uma pasta c-amada
fielcontabil.
# cd /var/www/html
# mdir fielcontabil
Lo'o ap:s copie o ar+uivo fielcontabil.!ip para o diret:rio recm
criado e descompacte o ar+uivo usando o utilitrio un!ip.
$upondo +ue voc5 ten-a salvo o ar+uivo em seu diret:rio
/home/pedro os comandos seriam os se'uintes/
# cd /var/www/html/fielcontabil
# cp /home/pedro/fielcontabil.!ip .
# un!ip fielcontabil
!p:s voc5 reali;ar estas opera%es voc5 ter a aplicao instalada em
seu servidor. "orm para +ue ela funcione perfeitamente precisamos criar o
banco de dados do sistema e aGustar os parHmetros de acesso ao &anco de
Dados como veremos a se'uir.
.a. Eta&a ' Criando o S/0, "iel(ontabil
O FIEL Contbil possui dois scripts de criao do &anco de Dados/
fielcontabil.s"l e cria#ados$asicos.s"l . Estes scripts encontram*se
em /var/www/html/fielcontabil/scripts/. "ara criar o banco de dados
e<ecute os se'uintes comandos/
# su postgres
% cd /var/www/html/fielcontabil/scripts
% createdb fielcontabil
% ps"l fielcontabil & fielcontabil.s"l
% ps"l fielcontabil & cria#ados$asicos.s"l
I!&ortante1 #ote +ue os comandos devem ser e<ecutados como
usurio postgres. $e voc5 est usando como outro usurio o banco voc5
ter +ue liberar o acesso ao banco de dados no "ost're$DL pela se'uinte
se+u5ncia de comandos/
% ps"l fielcontabil
# '()*+) ,-)( nomeusuario .*--/0(# = 1senhausuario12
# 3(*4+ *55 04 #*+*$*-) fielcontabil +0 nomeusuario2
# 6"
2a. Eta&a ' A3ustando &ar4!etros do Siste!a
!p:s e<ecutado o script o banco de dados estar criado. O banco de
dados +ue acompan-a o FIEL Contbil est va;io. !penas possui em seu
cadastro al'uns parHmetros utili;ados pelo sistema e um Inico usurio
cadastrado J o usurio admin.
"ara +ue o banco de dados possa ser acessado pela aplicao
necessrio fa;er aGustes no ar+uivo de confi'urao do servidor "ost're$DL.
O ar+uivo a ser editado c-ama*se pg_hba.conf e normalmente se encontra
em /var/lib/pgs"l/data/.
$upondo +ue o endereo I" de seu servidor seGa 789.76:.7.700 .e
conse+Kentemente sua netmasL 9;;.9;;.9;;.04 edite o a+uivo pg_hba.conf
e acrescente a lin-a/
host fielcontabil 789.76:.7.700 9;;.9;;.9;;.0 trust
"ara +ue as altera%es ten-am efeito voc5 dever reiniciali;ar o servio
postgres"l.
2a. Eta&a ' A3ustando os &ar4!etros do Siste!a
"or Iltimo precisamos definir os dados para acesso ao banco de dados
pelo FIEL Contbil.
"ara facilitar a confi'urao do FIEL Contbil criamos um s-ell script
+ue reali;a estes aGustes para voc5.
cd /var/www/html/fielcontabil/
./install
$i'a as orienta%es +ue esto na tela e o sistema ir confi'urar
automaticamente os pat-s e defini%es de acesso a banco de dados. $e voc5
e<ecutar este script voc5 pode pular direto para a Ma. Etapa J )estando a
!plicao.
Caso voc5 #NO ten-a e<ecutado o script ou +ueira fa;er tudo
manualmente si'a as instru%es a se'uir/
Edite o ar+uivo /var/www/html/fielcontabil/config.php e aGuste
as confi'ura%es para acesso ao &anco de Dados. ! se'uir apresenta*se o
conteIdo inicial do ar+uivo config.inc/
<define=>$*4'0?@?fielcontabil?A2
<define=>,-,*(B0?@?postgres?A2
<define=>-)4C*?@?senhadopostgres?A2
<define=>C0-+?@?789.76:.7.700?A2
<define=>.0(+*?@?;DE9?A2
!Guste o ar+uivo conforme suas confi'ura%es.
5a. Eta&a ' Con"i*urando o &at6 da a&li(ao
Como o FIEL Contbil tem uma estrutura de diret:rios precisamos
indicar para a aplicao +ual o diret:rio rai; do !pac-e.
Edite o ar+uivo /var/www/html/fielcontabil/classes/cw.inc e
aGuste a diretiva/
<define=>(00+-B-+)F*?@?/var/www/html/fielcontabil/?A2
#o es+uea de incluir a Iltima barra no pat-.
7a. Eta&a ' 8estando a A&li(ao
!p:s reali;ados todos os aGustes necessrios voc5 poder testar a
aplicao atravs de +ual+uer computador +ue possua um nave'ador web
.browser4.
$upondo +ue voc5 esteGa testando no pr:prio servidor entre na
se'uinte 6(L/
httpG//localhost/fielcontabil/
O sistema ir e<ibir uma tela como a se'uinte/
"ara acessar o sistema utili;e os se'uintes dados/
usurio/ admin
sen-a/ admin
! se'uir apresenta*se uma breve descrio das caracterOsticas do
sistema focando em detal-es importantes para os profissionais envolvidos
com a administrao da rea de informtica.
CaracterOsticas Funcionais
Esta documentao visa esclarecer al'uns aspectos relevantes para o
profissional de informtica +ue reali;ar a instalao do sistema. !spectos
particulares de contabilidade no so abordados nem como um detal-amento
das op%es.
O usurios do FIEL Contbil so distribuOdos em tr5s -iear+uias a
saber/
Os ad!inistradores do siste!a +ue so os responsveis pela
'esto do sistema em um nOvel mais abran'ente. O administrador do
sistema pode acessar todas as funcionalidades do sistema inclusive
cadastrar os novos usurios. #ormalmente o administrador o
sistema uma pessoa da rea de )I +ue se responsabili;a pela
implantao e estabilidade do sistema7
Os su&er$isores +ue so os profissionais de contabilidade
.contadores4 responsveis pela contabilidade controlada. O
su&er$isor a pessoa responsvel pela contabilidade da empresa e
pode reali;ar todas as opera%es contbeis. Dual+uer lanamento
contbil deve ser aprovado pelo su&er$isor para +ue possa ter
efeito na contabilidade.
Os o&eradores so os profissionais +ue iro lanar todas as
opera%es contbeis no sistema. #o entanto estas somente tero
valor ap:s serem liberadas por um su&er$isor.
6ma ve; lo'ado no sistema todas as transa%es reali;adas no banco
de dados so arma;enados em um ar+uivo de LO= para permitir uma
auditoria futura.
Este ar+uivo de LO= pode ser confi'urado pelo administrador para
arma;enar um nImero limitado de dias das transa%es reali;adas. Esta
confi'urao feita no menu Ad!inistrao do Siste!a 0 Par4!etros do
Siste!a.
/erao de Ar-ui$os P,F
Duando solicitado o sistema 'era ar+uivos em formato "DF para
apresentao dos relat:rios contbeis.
Estes relat:rios ficam arma;enados temporariamente no diret:rio
/var/www/html/fielcontabil/pdfs/ . O diret:rio deve estar com atributo
HHH para +ue o usurio nobodI possa criar os documentos.
(eali;ando &acLup da base de dados
8ais importante +ue re'istrar toda a contabilidade de uma
or'ani;ao possuir estes re'istros arma;enados de forma se'ura em meio
ma'ntico.
"ara reali;ar bacLup dos dados do FIEL Contbil voc5 dever e<ecutar
a se'uinte se+u5ncia de comandos/
# su postgres
% cd /var/lib/pgs"l/data
% pg_dump -d fielcontabil J bacup.s"l
O parHmetro -d indica +ue a saOda do ar+uivo dever ser atravs de
clusulas $DL completas incluindo o comando I#$E().
9oc5 pode criar varia%es em cima da e<ecuo do pg_dump. 6ma
su'esto a criao de um processo cron +ue e<ecute o p'Pdump em um
-orrio pr*estabelecido .o pg_dump s: pode ser e<ecutado pelo usurio
postgres4.
Contratando $uporte e Customi;a%es
"or se tratar de um software livre no fornecemos suporte tcnico
'ratuito.
Caso voc5 +ueira contratar suporte para o FIEL Contbil a !"OE#!
$oftware Livre est apta a prestar suporte tcnico via Internet.
Eventualmente poder sur'ir a necessidade da criao de novas
funcionalidades no sistema bem como a inte'rao com outros sistemas de
informao G e<istentes na or'ani;ao.
#o dei<e de contatar a !"OE#!. $omente uma empresa sria
comprometida com a filosofia do software livre poderia disponibili;ar a
sociedade um sistema de taman-a importHncia. E est apta a atender de
forma eficiente a +ual+uer demanda +ue ven-a a sur'ir.
Dados para contato/
Departamento Comercial/ comercialQapoenasoftwarelivre.com.br
$uporte )cnico/ suporteQapoenasoftwarelivre.com.br
Fone/ .RF4 C22R*SF*C3
Pro3eto FIELerOsticas
do FIEL CLiberdade de es(ol6ail