Commit b7483b5005b6e0e104d242926d566d4dfe10d5cf

Authored by Daniel Ruoso
1 parent 6eaa2274
Exists in master

melhorias na documentacao, vamos fechar a versao 1.3

Showing 2 changed files with 65 additions and 28 deletions   Show diff stats
Dependencias
... ... @@ -284,7 +284,6 @@ libxml-compile-cache-perl
284 284 libxml-compile-perl
285 285 libxml-compile-soap-perl
286 286 libxml-compile-tester-perl
287   -libxml-compile-tranport-soapxmpp-perl
288 287 libxml-compilex-tranport-soapxmpp-perl
289 288 libxml-dom-perl
290 289 libxml-libxml-common-perl
... ...
LEIAME
... ... @@ -49,6 +49,21 @@ diretórios:
49 49 documentacao: contém um conjunto diverso de documentações geradas
50 50 sobre o sistema, incluindo materiais utilizados em treinamentos.
51 51  
  52 +DESCOMPACTANDO OS ARQUIVOS
  53 +================================================================================
  54 +
  55 +Uma vez que você tenha o arquivo do sistema, vc pode descompactá-lo em
  56 +qualquer lugar utilizando o comando:
  57 +
  58 +tar xzf "Sistema de Atendimento - v1.2.tar.gz"
  59 +
  60 +Depois que descompactar, como root execute:
  61 +
  62 +mv trunk /usr/share/fila
  63 +
  64 +Isso é importante porque as configurações padrão que vêm com o sistema
  65 +indicam essa localização.
  66 +
52 67 PREPARACAO DAS DEPENDENCIAS
53 68 ================================================================================
54 69  
... ... @@ -69,7 +84,19 @@ executar o comando (como root):
69 84  
70 85 apt-get install `cat /tmp/Dependencias`
71 86  
72   -Com esse comando, todos os pacotes necessários deverão ser instalados.
  87 +Com esse comando, todos os pacotes necessários deverão ser
  88 +instalados. Sempre que for mencionado alguma pasta do sistema,
  89 +entende-se que é a partir do diretório /usr/share/fila.
  90 +
  91 +Existe um patch que precisa ser aplicado (foi submetido aos autores do
  92 +módulo mas ainda não foi aceito), isso é fundamental para o correto
  93 +funcionamento do sistema. Para isso execute:
  94 +
  95 +cd /usr/share/perl5
  96 +patch -p4 /usr/share/fila/patches/DBIx-Class-ResultSource.patch
  97 +
  98 +Ele deve dar uma mensagem como "Hunk xxxx succeeded", o que indica que
  99 +funcionou.
73 100  
74 101 INSTALACAO DO BANCO DE DADOS
75 102 ================================================================================
... ... @@ -79,43 +106,54 @@ PostgreSql devido ao uso extensivo de cálculos temporais,
79 106 funcionalidade essa que é uma das características fortes desse banco
80 107 de dados.
81 108  
82   -A configuração do banco de dados é feita nos arquivos:
  109 +O sistema de atendimento está homologado apenas com o Postgresql 8.3
  110 +(versão disponível no Debian Lenny). Para instalar o servidor de banco
  111 +de dados execute (como root):
  112 +
  113 +apt-get install postgresql-8.3
  114 +
  115 +O sistema de atendimento está configurado por padrão para utilizar o
  116 +usuário "fila" com a senha "senha" no banco de dados, conectando-se ao
  117 +banco "fila". Para configurar o servidor de banco de dados execute
  118 +(como root):
  119 +
  120 +su -c 'su postgres'
83 121  
84   - Fila-Servico/fila_servico.yml
85   - Fila-Administracao/fila_administracao.yml.
  122 +O comando acima vai abrir um novo prompt de comando, agora com o
  123 +usuário administrador do postgres, então poderemos criar o usuário
  124 +"fila" no banco de dados utilizando o comando.
86 125  
87   -Esses arquivos contém a configuração dos endereços para conexão e do
88   -nome do banco de dados. A configuração padrão presente no código como
89   -distribuído utiliza o banco de dados em "localhost", no banco de dados
90   -"fila" utilizando o usuário "fila" com a senha "senha". Você deve
91   -personalizar esses arquivos de acordo com a situação real no seu
92   -ambiente.
  126 +createuser -P fila
93 127  
94   -Adicionalmente, o sistema de agendamento tem a configuração presente
95   -no arquivo:
  128 +Primeiro ele vai pedir a senha para o novo usuário. Digite "senha" e
  129 +depois dê enter. Ele vai perguntar se o usuário deve ser um
  130 +superusuário, você pode responder que não. Ele vai perguntar se ele
  131 +pode criar outras "roles" (como o postgres chama os usuários), você
  132 +pode responder que não, e finalmente ele vai perguntar também se ele
  133 +pode criar bancos de dados, aí você responde que sim.
96 134  
97   - Fila-Agendamento/fila_agendamento.yml
  135 +Depois disso você pode digitar "exit" e dar enter, para sair do prompt
  136 +do usuário postgres.
98 137  
99   -O sistema de Agendamento usa um banco de dados diferente, para
100   -permitir que o agendamento seja feito em uma máquina diferente ou até
101   -mesmo em uma rede diferente, uma vez que o sistema de agendamento deve
102   -ser visível para a internet, enquanto o sistema de agendamento deve
103   -ser preservado dentro de uma rede privada.
  138 +Para criar o banco de dados execute o seguinte comando (pode ser como
  139 +usuário normal):
104 140  
105   -Para popular os bancos de dados, você pode usar os scripts:
  141 +createdb -Ufila -h127.0.0.1 fila
106 142  
107   - Fila-Servico/script/fila_servico_db.pl
  143 +Ele vai pedir a senha do usuário "fila", então é só digitar
  144 +"senha". Então ele terá o banco de dados criado.
108 145  
109   -e
  146 +Para popular os bancos de dados, você pode usar o script, (pode ser
  147 +como usuário comum). De dentro do diretório Fila-Serviço, execute:
110 148  
111   - Fila-Agendamento/script/fila_agendamento_db.pl
  149 +./script/fila_servico_db.pl | psql -Ufila -h127.0.0.1 fila
112 150  
  151 +Ele irá pedir a senha do banco de dados novamente, digite "senha",
  152 +depois "enter"
113 153  
114   -para executar cada um desses scripts você deve entrar nos diretórios
115   -Fila-Servico e Fila-Agendamento respectivamente. Esses scripts geram
116   -um conjunto de instruções sql que podem ser utilizadas como entrada
117   -para o psql para a criação das estruturas de dados, incluindo alguns
118   -dados de exemplo.
  154 +Esse script gera um conjunto de instruções sql que podem
  155 +ser utilizadas como entrada para o psql para a criação das estruturas
  156 +de dados, incluindo alguns dados de exemplo.
119 157  
120 158  
121 159 EXECUTANDO O SISTEMA
... ...