Commit 2069f73756ed7d46fd6748f763cd18c6556b0fe0

Authored by Guilherme Andrade Del Cantoni
1 parent 4d5d7424

Atualização no nome da pasta do módulo de mod-sei-barramento para pen, conforme …

…solicitação da comunidade
Showing 1 changed file with 48 additions and 30 deletions   Show diff stats
LEIAME.txt
... ... @@ -2,7 +2,6 @@
2 2 Módulo PEN
3 3 Data de criação: 27/05/2016
4 4 Data de atualizaçao: 09/08/2017
5   -Desenvolvimento: Join Tecnologia
6 5 Versão: 0.0.3
7 6 =======================================================================================================================================
8 7  
... ... @@ -11,8 +10,8 @@ PROCEDIMENTOS PARA INSTALAÇÃO:
11 10 ========================================================================================================================================
12 11  
13 12 REQUISITOS PARA INSTALAÇÂO:
14   - - SEI 3.0.5 instalada (verificar valor da constante de versão do SEI no arquivo sei/SEI.php).
15   - - O usuário de acesso ao banco de dados do SEI e SIP com as devidas permissões de acesso total ao banco de dados. Após a instalação do módulo, o usuário de manutenção deverá ser auterado para um contendo apenas as permissões de escrita no banco de dados.
  13 + - SEI 3.0.5 (ou superior) instalada (verificar valor da constante de versão do SEI no arquivo sei/SEI.php)
  14 + - Usuário de acesso ao banco de dados do SEI e SIP com as devidas permissões de acesso para modificar estrutuda do banco de dados. Após a instalação, o usuário de manutenção deverá ser alterado para outro contendo apenas as permissões de escrita no banco de dados.
16 15  
17 16 PROCEDIMENTOS PARA INSTALAÇÂO:
18 17  
... ... @@ -29,22 +28,23 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
29 28 3) Instalar o gearmand e o supervisord no servidor responsável por tratar o agendamento de tarefas do sistema.
30 29 Importante: É imprescindível que seja no mesmo nó em que está configurado o CRON de agendamento principal do SEI.
31 30  
32   - # Pre-requisito. Caso contrario, os demais pacotes nao sao encontrados no CentOS7
  31 + # Pre-requisito. Caso contrario, os demais pacotes nao são encontrados no CentOS7
33 32 yum install epel-release && yum update
34 33  
35 34 # Instalação do Gearman e supervisord
36   - yum install supervisor gearmand libgearman libgearman-devel php-pecl-gearman
  35 + yum install supervisor gearmand libgearman libgearman-devel php56*-pecl-gearman
37 36  
38 37  
39 38 4) Configuração do supervisor.
40   - No parametro 'user' abaixo deve ser configurado o usuario que executa o servidor web (verifique no seu servidor qual é o usuario. Ex.: apache)
  39 + ATENÇÂO: No parametro 'user' abaixo deve ser configurado o usuário que executa o servidor web (verifique no seu servidor qual é o usuario. Ex.: apache)
  40 + ATENÇÂO: Verifique se a localização dos scripts ProcessarPendenciasRN.php e PendenciasTramiteRN.php estão corretas no parâmetro 'command'
41 41  
42 42 vi /etc/supervisord.conf
43 43  
44 44 # Adicione no final do arquivo
45 45  
46 46 [program:sei_processar_pendencias]
47   - command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/mod-sei-barramento/rn/ProcessarPendenciasRN.php
  47 + command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/ProcessarPendenciasRN.php
48 48 numprocs=1
49 49 directory=/opt/sei/web
50 50 user=apache
... ... @@ -55,7 +55,7 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
55 55 stderr_logfile=/var/log/supervisor/sei-supervisord-stderr.log
56 56  
57 57 [program:sei_monitorar_pendencias]
58   - command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/mod-sei-barramento/rn/PendenciasTramiteRN.php
  58 + command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/PendenciasTramiteRN.php
59 59 numprocs=1
60 60 directory=/opt/sei/web
61 61 user=apache
... ... @@ -72,11 +72,13 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
72 72 No mesmo servidor em que está instalado/configurado o supervisor e gearman (passo 3), configurar o script verificar-servicos.sh, localizado na raiz do módulo, no serviço de agendamento CRON. Sugerimos que o tempo de monitoramento e tentativa de reativação seja configurado em 10 minutos.
73 73  
74 74 # 1) Copiar script de verificação dos serviços de integração do ConectaGov para a pasta de arquivos binários do SEI
75   - cp /opt/sei/web/modulos/mod-sei-barramento/verificar-servicos.sh /opt/sei/bin/
  75 + ps: Altere a referência para <DIRETORIO_RAIZ_INSTALAÇÃO> descrito abaixo
  76 + cp <DIRETORIO_RAIZ_INSTALAÇÃO>/sei/web/modulos/pen/verificar-servicos.sh /opt/sei/bin/
76 77  
77 78 # 2) Configurar agendamento no cron
  79 + PS: Altere a referência para <DIRETORIO_RAIZ_INSTALAÇÃO> descrito abaixo
78 80 crontab -e
79   - */10 * * * * /opt/sei/bin/verificar-servicos.sh
  81 + */10 * * * * <DIRETORIO_RAIZ_INSTALAÇÃO>/sei/bin/verificar-servicos.sh
80 82  
81 83 6) Editar o arquivo "sei/ConfiguracaoSEI.php", tomando o cuidado de usar editor que não altere o charset do arquivo, para adicionar a referência ao módulo PEN na chave 'Modulos' abaixo da chave 'SEI': Atenção para as virgulas nos finais das linhas
82 84  
... ... @@ -89,11 +91,11 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
89 91  
90 92 Adicionar a referência ao módulo PEN na array da chave 'Modulos' indicada acima:
91 93  
92   - 'Modulos' => array('PENIntegracao' => 'mod-sei-barramento')
  94 + 'Modulos' => array('PENIntegracao' => 'pen')
93 95  
94 96  
95 97  
96   - 7) Mover o diretorio "mod-sei-barramento" para o diretorio sei/web/modulos/.
  98 + 7) Mover o diretorio de arquivos do módulo "pen" para o diretorio sei/web/modulos/.
97 99  
98 100 8) Colocar o arquivo do certificado digital utilizado para integração com o ConectaGov no diretorio "sei/config/". Este certificado será entregue junto com o pacote de integração.
99 101  
... ... @@ -102,18 +104,25 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
102 104 10) Copiar o arquivo de instalação do módulo no SIP "sip_atualizar_versao_modulo_pen.php" para a pasta sip/scripts
103 105  
104 106 11) Executar o script "sip_atualizar_versao_modulo_pen.php" para atualizar o banco de dados do SIP para o funcionamento do módulo:
105   - # php -c /etc/php.ini /opt/sip/scripts/sip_atualizar_versao_modulo_pen.php
  107 + PS: Altere a referência para <DIRETORIO_RAIZ_INSTALAÇÃO> descrito abaixo
  108 + # php -c /etc/php.ini <DIRETORIO_RAIZ_INSTALAÇÃO>/sip/scripts/sip_atualizar_versao_modulo_pen.php
106 109  
107 110 12) Executar o script "sei_atualizar_versao_modulo_pen.php" para inserção de dados no banco do SEI referente ao módulo.
108   - # php -c /etc/php.ini /opt/sei/scripts/sei_atualizar_versao_modulo_pen.php
  111 + PS: Altere a referência para <DIRETORIO_RAIZ_INSTALAÇÃO> descrito abaixo
  112 + # php -c /etc/php.ini <DIRETORIO_RAIZ_INSTALAÇÃO>/sei/scripts/sei_atualizar_versao_modulo_pen.php
109 113  
110   - 13) Atualizar a tabela [pen_unidade] com os seus respectivos valores do campo "id_unidade_rh".
  114 + 13) Atualizar a tabela [md_pen_unidade] com os seus respectivos valores do campo "id_unidade_rh".
  115 + PS: Esta configuração será realizada manualmente pela equipe de operações somente nesta primeira versão do módulo
111 116 - Esses ID's de unidades são gerenciados pelo próprio orgão no Portal do ConectaGov: http://conectagov.processoeletronico.gov.br
112 117 - Na fase de homologação do sistema, estes valores serão passados pela SETIC/MP junto com o certificado digital de cliente
113 118  
  119 + Exemplo:
  120 + update md_pen_unidade set id_unidade_rh = <ID_CONECTAGOV> where id_unidade = <ID_UNIDADE_SEI>;
  121 +
  122 +
114 123  
115 124 14) Configuração de unidade administrativa virtual para gerenciamento de envio e recebimento de processos pelo módulo
116   - Esta configuração é necessária para o SEI realizar as devidas regras de registro de históricos de trâmites externos e bloqueio de edição de processos/documentos. Tal unidade será utilizada internamente pelo módulo e não deverá ter acesso liberado para nenhum usuário do sistema.
  125 + Esta configuração é necessária para o SEI realizar as devidas regras de registro de históricos de trâmites externos e bloqueio de edição metadados de processos/documentos. Tal unidade será utilizada internamente pelo módulo e não deverá ter acesso liberado para nenhum usuário do sistema.
117 126  
118 127 14.1) Acessar o SIP e criar uma nova unidade administrativa com as seguintes configurações:
119 128 sigla: EXTERNO
... ... @@ -124,13 +133,15 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
124 133  
125 134 14.3) Obter o número de identificação da nova unidade para posterior configuração dos parâmetros do módulo de integração. O código da nova unidade pode ser obtido através da funcionalidade SEI >> Administração >> Unidades >> Listar
126 135  
127   - 14) Configuração de tipo de processo a ser aplicado aos processos recebidos de outras instituições
128   - Como o processo de recebimento de novos processos será feito de forma automática pelo módulo de integração, o sistema precisa atribuir um Tipo de Processo padrão para o novo procedimento recebido.
  136 + 15) Configuração de tipo de processo a ser aplicado aos processos recebidos de outras instituições
  137 + Como o processo de recebimento de novos processos será feito de forma automática pelo módulo de integração, o sistema precisa atribuir um Tipo de Processo padrão para o novo procedimento recebido. Importante lembrar que a criação de um novo tipo de processo não é obrigatório, sendo possível utilizar outro pré-existente.
  138 + Caso a opção for pela criação de um novo tipo de processo específico, segue abaixo sugestão para configuração:
129 139  
130 140 15.1) Criar um novo Tipo de Processo pela funcionalidade SEI >> Administração >> Tipo de Processo
131   - Nome: Processo Externo
  141 + Nome: Demanda Externa: Outros Órgãos Públicos
132 142 Descrição: Processos recebidos de outras instituições
133   - Sugestão de Assuntos: <A CLASSIFICAÇÃO DE ASSUNTO DEVE SER DEFINIDO JUNTAMENTE COM A ÁREA DE DOCUMENTAÇÃO>
  143 + Sugestão de Assuntos: <A CLASSIFICAÇÃO DE ASSUNTO DEVE SER DEFINIDO JUNTAMENTE COM A ÁREA DE DOCUMENTAÇÃO>
  144 + Ex: 019.01 - INFORMAÇÕES SOBRE O ÓRGÃO
134 145 Restringir aos Órgãos: <vazio>
135 146 Restringir às Unidades: <vazio>
136 147 Níveis de Acesso Permitidos: Público
... ... @@ -159,8 +170,15 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
159 170  
160 171 => PEN_LOCALIZACAO_CERTIFICADO_DIGITAL: Localização do certificado digital o órgão
161 172 - Arquivo do passo 6
  173 +
  174 + => PEN_NUMERO_TENTATIVAS_TRAMITE_RECEBIMENTO:
  175 + - Valor padrão: 3
162 176  
  177 + => PEN_TAMANHO_MAXIMO_DOCUMENTO_EXPEDIDO:
  178 + - Valor padrão: 50
  179 +
163 180 => PEN_SENHA_CERTIFICADO_DIGITAL: Senha do certificado digital
  181 + PS: Configuração de senha será modificada na próxima versão para utilização de criptografia
164 182  
165 183 => PEN_TIPO_PROCESSO_EXTERNO: Id do tipo de documento externo
166 184 - Configurar com o ID do Tipo de Processo Externo configurado no passo 15
... ... @@ -169,22 +187,22 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
169 187 - Configurar com o ID da Unidade criada no passo 14
170 188  
171 189  
  190 +
172 191 16) Iniciar Gearman e Supervisor
  192 + PS: Altere a referência para <DIRETORIO_RAIZ_INSTALAÇÃO> descrito abaixo
173 193 service gearmand start && service supervisord start
174 194  
175 195 * Executar o comando "ps -ef" e verificar se os dois processos seguintes estão em execução:
176   - - /usr/bin/php -c /etc/php.ini /var/www/html/sei/institucional/pen/rn/PendenciasTramiteRN.php
177   - - /usr/bin/php -c /etc/php.ini /var/www/html/sei/institucional/pen/rn/ProcessarPendenciasRN.php
  196 + - /usr/bin/php -c /etc/php.ini <DIRETORIO_RAIZ_INSTALAÇÃO>/sei/modulos/pen/rn/PendenciasTramiteRN.php
  197 + - /usr/bin/php -c /etc/php.ini <DIRETORIO_RAIZ_INSTALAÇÃO>/sei/modulos/pen/rn/ProcessarPendenciasRN.php
178 198 Caso não esteja houve algum problema de configuração e a expedição de processos não irá funcionar.
179 199  
180 200 * Importante colocar o serviço para ser iniciado automaticamente juntamente com o servidor.
181 201  
182 202  
183   -############################# REVISAR NECESSIDADE DESTA CONFIGURAÇÃO #############################
184 203 17) Certificar se o SEI está habilitado para permitir criação de processo com numeração informada. Esta configuração é obrigatória para o funcionamento do módulo PEN.
185   -
186 204 => SEI_HABILITAR_NUMERO_PROCESSO_INFORMADO: 2
187   -##################################################################################################
  205 +
188 206  
189 207 18) Realizar o mapeamento de tipos de documentos do SEI com as especies documentais definidas no PEN, tanto de envio quanto de recebimento. Esta configuração deve ser feita antes de começar a utilização do módulo.
190 208 "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Recebimento" => "Cadastrar".
... ... @@ -192,11 +210,11 @@ PROCEDIMENTOS PARA INSTALAÇÂO:
192 210  
193 211 Obs.: Os tipos de documentos a serem mapeados deverão estar configurados no SEI como Externo ou Interno/Externo
194 212  
195   -
196 213  
197   - 20) O protocolo de comunicação implementado pelo ConectaGov realiza a geração e assinatura digital de recibos de entraga e conclusão dos trâmites de processo. Para a correta geração dos recibos pelo módulo, é indispensável que todos os nós da aplicação estejam configurados com o serviço de sincronização de relógios oficial NTP.br.
198   -
199   - Este link pode ajudar a configurar conforme o SO utilizado: https://www.vivaolinux.com.br/artigo/Servidor-NTP-Configuracao-e-ajuste-de-data-e-hora
  214 + 19) O protocolo de comunicação implementado pelo ConectaGov realiza a geração e assinatura digital de recibos de entraga e conclusão dos trâmites de processo. Para a correta geração dos recibos pelo módulo, é indispensável que todos os nós da aplicação estejam configurados com o serviço de sincronização de relógios oficial NTP.br.
  215 + Este link pode ajudar a configurar conforme o SO utilizado: http://ntp.br/guia-linux-comum.php
200 216  
201 217  
202   - 21) Configurar as permissões de segurança para os perfis e unidades que poderão realizar o trâmite externo de processos no sistema. Por padrão, as funcionalidades estão disponíveis apenas para o peril de usuário Protocolo
  218 + 20) Configurar as permissões de segurança para os perfis e unidades que poderão realizar o trâmite externo de processos no sistema.
  219 + Por padrão, as funcionalidades (recursos) criados pelo módulo não são atribuídos automaticamente à um perfil específico do sistema, evitando sua disponibilização para todos os usuários do sistema sem a prévia definição dos administradores.
  220 + Sugerimos que seja criado um novo perfil de usuário que receberá as permissões aos novos recursos incluidos pelo módulo (pen_*). Este novo perfil deverá ser atribuído aos usuários que podem realizar o trâmite externo de processos para outras instituições.
... ...