Download as
Browse Code »

Commit cda4f9ab5f20a133f52add28bb31fb91f506ebe4

Authored by Guilherme Andrade Del Cantoni
1 parent 4fc651ae
Exists in master and in 18 other branches Marcelotmpdesenv, Marctmp, desenv, feature-050, feature-50, feature-76, fix-101, fix-43, fix-58, fix-86, fix-89, fix-92, fix-93, fix-95, fix-96, fix-97, fix-99, fix-gearman

Ajustes diversos no manual de instalação do módulo

Showing 2 changed files with 429 additions and 193 deletions   Show diff stats
LEIAME.txt
  Diff comments   View file @cda4f9a
1 1 ========================================================================================================================================
2   -Módulo PEN
3   -Data de criação: 27/05/2016
4   -Data de atualizaçao: 09/08/2017
5   -Versão: 0.0.3
  2 +Módulo PEN
  3 +Data de criação: 27/05/2016
  4 +Data de atualizaçao: 09/08/2017
  5 +Versão: 0.0.3
6 6 =======================================================================================================================================
  7 +Módulo de Integração SEI - PEN
  8 +===================
  9 +
  10 +Data de criação: 27/05/2016
  11 +Data de atualizaçao: 12/09/2017
  12 +Versão: 1.0.0
  13 +
  14 +
  15 +### REQUISITOS PARA INSTALAÇÂO:
  16 +- SEI 3.0.5 (ou superior) instalada (verificar valor da constante de versão do SEI no arquivo sei/SEI.php)
  17 +
  18 +- 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.
  19 +- Caso o ambiente do ConectaGov utilizado nesta configuração esteja utilizando HTTPS com certificado digital do ICP-Brasil, será necessário configurar a cadeia de certificados do ICP-BRASIL como confiáveis nos nós de aplicação do SEI.
  20 +Como todas as comunicações realizadas com o ConectaGov utilizarão conexão segura via HTTPS com certificados digitais emitidos pela cadeia do ICP-Brasil, os servidores de aplicação precisam ser configurados para reconhecer esta cadeia como confiável, o que não é padrão nos sistemas operacionais atuais. Com isto, os seguintes comandos precisam ser executados em cada nós de aplicação do SEI, incluindo aquele responsável pelo tratamento das tarefas agendadas:
  21 + - Copie o certificado da cadeia de CA utilizado pelo ConectaGov para o diretório /usr/local/share/ca-certificates:
  22 +
  23 + > cp <CERTIFICADO-CA-ICP-BRASIL> /usr/local/share/ca-certificates
  24 +
  25 + - Efetue a atualização da lista de certificados confiáveis do SO
  26 +> sudo update-ca-certificates
  27 +>
  28 +- Para concluir os procedimentos de configuração do módulo, será necessário registrar no portal do Processo Eletrônico Nacional - PEN as unidades administrativas que poderão realizar trâmites externo ou recebimento de processos/documentos externo no SEI. Este procedimento precisa ser realizado pelo gestor de protocolo previamente habilitado no portal do PEN. Para maiores informações, acesse o endereço eletrônico http://conectagov.processoeletronico.gov.br/ ou entre em contato pelo e-mail processo.eletronico@planejamento.gov.br
  29 +
  30 +
  31 +### PROCEDIMENTOS PARA INSTALAÇÂO:
  32 +
  33 +1) Fazer backup dos banco de dados do SEI, SIP e repositórios de arquivos.
  34 +
  35 +2) Instalar o gearmand e o supervisord no servidor responsável por tratar o agendamento de tarefas do sistema.
  36 +**Importante:** É imprescindível que seja no mesmo nó em que está configurado o CRON de agendamento principal do SEI.
  37 +
  38 + # Pre-requisito. Caso contrario, os demais pacotes não são encontrados no CentOS7
  39 + yum install epel-release && yum update
  40 +
  41 + # Instalação do Gearman e supervisord
  42 + yum install supervisor gearmand libgearman libgearman-devel php56*-pecl-gearman
  43 +
  44 +
  45 +3) Configuração do supervisor.
  46 +**ATENÇÃO 1:** No parâmetro **'user'** deve ser configurado o usuário que executa o servidor web (verifique no seu servidor qual é o usuario. Ex.: apache)
  47 +**ATENÇÂO 2:** Verifique se a localização dos scripts ProcessarPendenciasRN.php e PendenciasTramiteRN.php estão corretas no parâmetro 'command'
  48 +
  49 + vi /etc/supervisord.conf
  50 + ...
  51 + # Adicione no final do arquivo
  52 + [program:sei_processar_pendencias]
  53 + command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/ProcessarPendenciasRN.php
  54 + numprocs=1
  55 + directory=/opt/sei/web
  56 + user=apache
  57 + autostart=true
  58 + autorestart=true
  59 + log_stderr=true
  60 + stdout_logfile=/var/log/supervisor/sei-supervisord-stdout.log
  61 + stderr_logfile=/var/log/supervisor/sei-supervisord-stderr.log
  62 +
  63 + [program:sei_monitorar_pendencias]
  64 + command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/PendenciasTramiteRN.php
  65 + numprocs=1
  66 + directory=/opt/sei/web
  67 + user=apache
  68 + autostart=true
  69 + autorestart=true
  70 + log_stderr=true
  71 + stdout_logfile=/var/log/supervisor/sei-supervisord-stdout.log
  72 + stderr_logfile=/var/log/supervisor/sei-supervisord-stderr.log
  73 +
  74 +4) Configurar agendamento de tarefas de reinicialização de serviços caso se identifique os estes estão indisponíveis
  75 +
  76 +Esta configuração é recomendada como contingência em conjunto com o Supervisor para garantir que os serviços de integração não serão desativados em caso de indisponibilidade momentânea da infraestrutura do ConectaGov.
  77 +
  78 +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.
  79 +
  80 +4.1) Copiar script de verificação dos serviços de integração do ConectaGov para a pasta de arquivos binários do SEI
  81 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo
  82 +cp [DIRETORIO_RAIZ_INSTALAÇÃO]/sei/web/modulos/pen/verificar-servicos.sh /opt/sei/bin/
  83 +
  84 +4.2) Configurar agendamento no cron
  85 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo
  86 +
  87 + # crontab -e
  88 + */10 * * * * [DIRETORIO_RAIZ_INSTALAÇÃO]`enter code here`/sei/bin/verificar-servicos.sh
  89 +
  90 +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
  91 +
  92 + 'SEI' => array(
  93 + 'URL' => 'http://[servidor sei]/sei',
  94 + 'Producao' => true,
  95 + 'RepositorioArquivos' => '/var/sei/arquivos',
  96 + 'Modulos' => array(),
  97 + ),
  98 +
  99 +Adicionar a referência ao módulo PEN na array da chave 'Modulos' indicada acima:
  100 +
  101 + 'Modulos' => array('PENIntegracao' => 'pen')
  102 +
  103 +7) Mover o diretório de arquivos do módulo "pen" para o diretório sei/web/modulos/.
7 104  
8   -========================================================================================================================================
9   -PROCEDIMENTOS PARA INSTALAÇÃO:
10   -========================================================================================================================================
11   -
12   -REQUISITOS PARA INSTALAÇÂO:
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.
15   -
16   -PROCEDIMENTOS PARA INSTALAÇÂO:
17   -
18   - 1) Fazer backup dos banco de dados do SEI, SIP e repositórios de arquivos.
19   -
20   - 2) Caso o ambiente do ConectaGov utilizado nesta configuração esteja utilizando HTTPS com certificado digital do ICP-Brasil, será necessário configurar a cadeia de certificados do ICP-BRASIL como confiáveis nos nós de aplicação do SEI.
21   - Como todas as comunicações realizadas com o ConectaGov utilizarão conexão segura via HTTPS com certificados digitais emitidos pela cadeia do ICP-Brasil, os servidores de aplicação precisam ser configurados para reconhecer esta cadeia como confiável, o que não é padrão nos sistemas operacionais atuais. Com isto, os seguintes comandos precisam ser executados em cada nós de aplicação do SEI, incluindo aquele responsável pelo tratamento das tarefas agendadas:
22   - 2.1) Copie o certificado da cadeia de CA utilizado pelo ConectaGov para o diretório /usr/local/share/ca-certificates
23   - cp <CERTIFICADO-CA-ICP-BRASIL> /usr/local/share/ca-certificates
24   -
25   - 2.2) Efetue a atualização da lista de certificados confiáveis do SO
26   - sudo update-ca-certificates
27   -
28   - 3) Instalar o gearmand e o supervisord no servidor responsável por tratar o agendamento de tarefas do sistema.
29   - Importante: É imprescindível que seja no mesmo nó em que está configurado o CRON de agendamento principal do SEI.
30   -
31   - # Pre-requisito. Caso contrario, os demais pacotes nao são encontrados no CentOS7
32   - yum install epel-release && yum update
33   -
34   - # Instalação do Gearman e supervisord
35   - yum install supervisor gearmand libgearman libgearman-devel php56*-pecl-gearman
36   -
  105 +8) Colocar o arquivo do certificado digital utilizado para integração com o ConectaGov no diretório "sei/config/".
37 106  
38   - 4) Configuração do supervisor.
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'
  107 +Os certificados digitais necessários para conectar aos ambientes de desenvolvimento e homologação do PEN estão localizados no paco​te de instalação. Para o ambiente de produção, deverá ser utilizado um certificado digital válido gerado por uma Autoridade de Registro - AR confiável (Exemplo: ICP-Brasil, Certisign, Verisign, etc.).
41 108  
42   - vi /etc/supervisord.conf
  109 +9) Copiar o arquivo de instalação do módulo no SEI **sei_atualizar_versao_modulo_pen.php** para a pasta sei/scripts
43 110  
44   - # Adicione no final do arquivo
  111 +10) Copiar o arquivo de instalação do módulo no SIP **sip_atualizar_versao_modulo_pen.php** para a pasta sip/scripts
  112 +
  113 +11) Executar o script "sip_atualizar_versao_modulo_pen.php" para atualizar o banco de dados do SIP para o funcionamento do módulo:
  114 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo
45 115  
46   - [program:sei_processar_pendencias]
47   - command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/ProcessarPendenciasRN.php
48   - numprocs=1
49   - directory=/opt/sei/web
50   - user=apache
51   - autostart=true
52   - autorestart=true
53   - log_stderr=true
54   - stdout_logfile=/var/log/supervisor/sei-supervisord-stdout.log
55   - stderr_logfile=/var/log/supervisor/sei-supervisord-stderr.log
  116 + # php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sip/scripts/sip_atualizar_versao_modulo_pen.php
  117 +
  118 +12) Executar o script **sei_atualizar_versao_modulo_pen.php** para inserção de dados no banco do SEI referente ao módulo.
  119 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo
56 120  
57   - [program:sei_monitorar_pendencias]
58   - command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/PendenciasTramiteRN.php
59   - numprocs=1
60   - directory=/opt/sei/web
61   - user=apache
62   - autostart=true
63   - autorestart=true
64   - log_stderr=true
65   - stdout_logfile=/var/log/supervisor/sei-supervisord-stdout.log
66   - stderr_logfile=/var/log/supervisor/sei-supervisord-stderr.log
  121 + # php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sei/scripts/sei_atualizar_versao_modulo_pen.php
67 122  
  123 +13) Atualizar a tabela [md_pen_unidade] com os seus respectivos valores do campo "id_unidade_rh".
68 124  
69   - 5) Configurar agendamento de tarefas de reinicialização de serviços caso se identifique os estes estão indisponíveis
70   - Esta configuração é recomendada como contingência em conjunto com o Supervisor para garantir que os serviços de integração não serão desativados em caso de indisponíbilidade momentânea da infraestrutura do ConectaGov.
  125 +Atenção: Esta configuração será realizada diretamente no banco de dados somente nesta primeira versão do módulo. Os ID's de unidades são gerenciados pela própria instituiçao no portal do Processo Eletrônico Nacional: http://conectagov.processoeletronico.gov.br.
  126 +Na fase de homologação do sistema, estes valores serão passados pela SETIC/MP.
71 127  
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.
  128 + update md_pen_unidade set id_unidade_rh = [ID_UNIDADE_PEN] where id_unidade = [ID_UNIDADE_SEI];
73 129  
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   - 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/
  130 +14) Configuração de unidade administrativa virtual para gerenciamento de envio e recebimento de processos pelo módulo.
77 131  
78   - # 2) Configurar agendamento no cron
79   - PS: Altere a referência para <DIRETORIO_RAIZ_INSTALAÇÃO> descrito abaixo
80   - crontab -e
81   - */10 * * * * <DIRETORIO_RAIZ_INSTALAÇÃO>/sei/bin/verificar-servicos.sh
  132 +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.
82 133  
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
  134 +14.1) Acessar o SIP e criar uma nova unidade administrativa com as seguintes configurações:
84 135  
85   - 'SEI' => array(
86   - 'URL' => 'http://[servidor sei]/sei',
87   - 'Producao' => true,
88   - 'RepositorioArquivos' => '/var/sei/arquivos',
89   - 'Modulos' => array(),
90   - ),
91   -
92   - Adicionar a referência ao módulo PEN na array da chave 'Modulos' indicada acima:
93   -
94   - 'Modulos' => array('PENIntegracao' => 'pen')
  136 + sigla: EXTERNO
  137 + nome: Unidade Externa
95 138  
96   -
  139 +14.2) Configurar a nova unidade na hierarquia do SEI, através da funcionalidade SIP >> Hierarquias >> Montar
97 140  
98   - 7) Mover o diretorio de arquivos do módulo "pen" para o diretorio sei/web/modulos/.
  141 +Sugerimos que está unidade seja configurada no mesmo nível hierárquico da unidade de teste padrão existente no SEI. Para saber qual é a unidade de testes, basta verificar o parâmetro do SEI chamado **SEI_UNIDADE_TESTE**
99 142  
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.
  143 +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*
101 144  
102   - 9) Copiar o arquivo de instalação do módulo no SEI "sei_atualizar_versao_modulo_pen.php" para a pasta sei/scripts
  145 +15) Configuração de tipo de processo a ser aplicado aos processos recebidos de outras instituições.
103 146  
104   - 10) Copiar o arquivo de instalação do módulo no SIP "sip_atualizar_versao_modulo_pen.php" para a pasta sip/scripts
105   -
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:
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
109   -
110   - 12) Executar o script "sei_atualizar_versao_modulo_pen.php" para inserção de dados no banco do SEI referente ao módulo.
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
  147 +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.
113 148  
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
116   - - Esses ID's de unidades são gerenciados pelo próprio orgão no Portal do ConectaGov: http://conectagov.processoeletronico.gov.br
117   - - Na fase de homologação do sistema, estes valores serão passados pela SETIC/MP junto com o certificado digital de cliente
  149 +Caso a opção for pela criação de um novo tipo de processo específico, segue abaixo sugestão para configuração:
118 150  
119   - Exemplo:
120   - update md_pen_unidade set id_unidade_rh = <ID_CONECTAGOV> where id_unidade = <ID_UNIDADE_SEI>;
  151 +15.1) Criar um novo Tipo de Processo pela funcionalidade *SEI >> Administração >> Tipo de Processo*
121 152  
  153 +> Nome: Demanda Externa: Outros Órgãos Públicos Descrição:
  154 +> Processos recebidos de outras instituições Sugestão de Assuntos: [A
  155 +> CLASSIFICAÇÃO DE ASSUNTO DEVE SER DEFINIDO JUNTAMENTE COM A ÃREA DE DOCUMENTAÇÃO]
  156 +> Ex: 019.01 - INFORMAÇÕES SOBRE O ÓRGÃO
  157 +> Restringir aos Órgãos: [vazio]
  158 +> Restringir às Unidades: [vazio]
  159 +> Níveis de Acesso Permitidos: Público
  160 +> Nível de Acesso Sugerido: Público
  161 +> Processo único no órgão por usuário: Não
  162 +> Interessado: Não
  163 +> Interno do Sistema: Sim
122 164  
  165 +15.2) Obter o número de ID do novo Tipo de Processo para posterior configuração dos parâmetros do módulo de integração. O ID do novo Tipo de Processo pode ser obtido através da funcionalidade *SEI >> Administração >> Tipo de Processo >> Listar*
123 166  
124   - 14) Configuração de unidade administrativa virtual para gerenciamento de envio e recebimento de processos pelo módulo
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.
  167 +16) Configurar os parâmetros do Módulo de Integração Pen (Menu: *SEI >> Infra >> Parâmetros*)
  168 +
  169 +**PEN_ENDERECO_WEBSERVICE:** [Endereço dos serviços de integração do PEN]
126 170  
127   - 14.1) Acessar o SIP e criar uma nova unidade administrativa com as seguintes configurações:
128   - sigla: EXTERNO
129   - nome: Unidade Externa
  171 +- Desenvolvimento:
  172 +https://pen-api.trafficmanager.net/interoperabilidade/soap/v1_1/
  173 +- Homologação: https://homolog.pen.api.trafficmanager.net/interoperabilidade/soap/v1_1/
  174 +- Produção: https://api.conectagov.processoeletronico.gov.br/interoperabilidade/soap/v1_1/
130 175  
131   - 14.2) Configurar a nova unidade na hierarquia do SEI, através da funcionalidade SIP >> Hierarquias >> Montar
132   - Sugerimos que está unidade seja configurada no mesmo nível hierarquico da unidade de teste padrão existente no SEI. Para saber qual é a unidade de testes, basta verificar o parâmetro do SEI chamado SEI_UNIDADE_TESTE
  176 +**=> PEN_ENDERECO_WEBSERVICE_PENDENCIAS**: [Endereço dos serviços de notificação de trâmites de processos]
133 177  
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
  178 +- Desenvolvimento:
  179 + https://pen-pendencias.trafficmanager.net/
  180 +- Homologação:
  181 + https://homolog.pen.pendencias.trafficmanager.net/
  182 +- Produção:
  183 + https://pendencias.conectagov.processoeletronico.gov.br/
135 184  
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:
  185 +**=> PEN_ID_REPOSITORIO_ORIGEM:**
  186 +ID do repositório de origem do órgão na estrutura organizacional. Este identificador é enviado para a instituição junto com o pacote de integração.
  187 +Exemplo: 1 (Código de identificação da estrutura organizacional do Poder Executivo [SIORG])
139 188  
140   - 15.1) Criar um novo Tipo de Processo pela funcionalidade SEI >> Administração >> Tipo de Processo
141   - Nome: Demanda Externa: Outros Órgãos Públicos
142   - Descrição: Processos recebidos de outras instituições
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
145   - Restringir aos Órgãos: <vazio>
146   - Restringir às Unidades: <vazio>
147   - Níveis de Acesso Permitidos: Público
148   - Nível de Acesso Sugerido: Público
149   - Exclusivo da Ouvidoria: Não
150   - Processo único no órgão por usuário interessado: Não
151   - Interno do Sistema: Sim
  189 +**=> PEN_LOCALIZACAO_CERTIFICADO_DIGITAL:**
  190 +Localização do certificado digital o órgão (arquivo do passo 8)
152 191  
153   - 15.2) Obter o número de ID do novo Tipo de Processo para posterior configuração dos parâmetros do módulo de integração. O ID do novo Tipo de Processo pode ser obtido através da funcionalidade SEI >> Administração >> Tipo de Processo >> Listar
  192 +**=> PEN_NUMERO_TENTATIVAS_TRAMITE_RECEBIMENTO:**
  193 +Valor padrão: 3
  194 +
  195 +**=> PEN_TAMANHO_MAXIMO_DOCUMENTO_EXPEDIDO:**
  196 +Valor padrão: 50
154 197  
155   - 15) Configurar os parâmetros do Módulo de Integração Pen (Menu: SEI >> Infra >> Parâmetros)
156   -
157   - => PEN_ENDERECO_WEBSERVICE: Endereço dos serviços de integração do PEN
158   - - Desenvolvimento: https://pen-api.trafficmanager.net/interoperabilidade/soap/v1_1/
159   - - Homologação: https://homolog.pen.api.trafficmanager.net/interoperabilidade/soap/v1_1/
160   - - Produção: https://api.conectagov.processoeletronico.gov.br/interoperabilidade/soap/v1_1/
  198 +**=> PEN_SENHA_CERTIFICADO_DIGITAL:**
  199 +Senha do certificado digital
  200 +Atenção: Configuração de senha será modificada na próxima versão para utilização de criptografia
161 201  
162   - => PEN_ENDERECO_WEBSERVICE_PENDENCIAS: Endereço dos serviços de notificação de trâmites de processos
163   - - Desenvolvimento: https://pen-pendencias.trafficmanager.net/
164   - - Homologação: https://homolog.pen.pendencias.trafficmanager.net/
165   - - Produção: https://pendencias.conectagov.processoeletronico.gov.br/
  202 +**=> PEN_TIPO_PROCESSO_EXTERNO:**
  203 +Id do tipo de documento externo. Configurar com o ID do Tipo de Processo Externo configurado no passo 15
166 204  
167   - => PEN_ID_REPOSITORIO_ORIGEM: ID do repositório de origem do órgão na estrutura organizacional
168   - Este identificador é enviado para a instituição junto com o pacote de integração
169   - Exemplo: 1 (Código de identificação da estrutura organizacional do Poder Executivo [SIORG])
  205 +**=> PEN_UNIDADE_GERADORA_DOCUMENTO_RECEBIDO:**
  206 +Id da unidade de origem que serão atribuídos os documentos recebidos de um outro órgão. Configurar com o ID da Unidade criada no passo 14
170 207  
171   - => PEN_LOCALIZACAO_CERTIFICADO_DIGITAL: Localização do certificado digital o órgão
172   - - Arquivo do passo 6
173 208  
174   - => PEN_NUMERO_TENTATIVAS_TRAMITE_RECEBIMENTO:
175   - - Valor padrão: 3
176   -
177   - => PEN_TAMANHO_MAXIMO_DOCUMENTO_EXPEDIDO:
178   - - Valor padrão: 50
  209 +17) Iniciar Gearman e Supervisor
  210 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo:
179 211  
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
  212 + service gearmand start && service supervisord start
182 213  
183   - => PEN_TIPO_PROCESSO_EXTERNO: Id do tipo de documento externo
184   - - Configurar com o ID do Tipo de Processo Externo configurado no passo 15
  214 +Executar o comando "ps -ef" e verificar se os dois processos seguintes estão em execução:
185 215  
186   - => PEN_UNIDADE_GERADORA_DOCUMENTO_RECEBIDO: Id da unidade de origem que serão atribuídos os documentos recebidos de um outro órgão.
187   - - Configurar com o ID da Unidade criada no passo 14
  216 + /usr/bin/php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sei/modulos/pen/rn/PendenciasTramiteRN.php
  217 +
  218 + /usr/bin/php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sei/modulos/pen/rn/ProcessarPendenciasRN.php
188 219  
  220 +Caso não esteja houve algum problema de configuração e a expedição de processos não irá funcionar.
  221 +Atenção: Importante colocar o serviço para ser iniciado automaticamente juntamente com o servidor.
189 222  
  223 +18) Realizar o mapeamento de tipos de documentos do SEI com as especies documentais definidas no PEN, tanto de envio quanto de recebimento.
190 224  
191   - 16) Iniciar Gearman e Supervisor
192   - PS: Altere a referência para <DIRETORIO_RAIZ_INSTALAÇÃO> descrito abaixo
193   - service gearmand start && service supervisord start
  225 +Esta configuração deve ser feita antes de começar a utilização do módulo.
194 226  
195   - * Executar o comando "ps -ef" e verificar se os dois processos seguintes estão em execução:
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
198   - Caso não esteja houve algum problema de configuração e a expedição de processos não irá funcionar.
199   -
200   - * Importante colocar o serviço para ser iniciado automaticamente juntamente com o servidor.
  227 +- "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Recebimento" => "Cadastrar"
  228 +- "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Envio" => "Cadastrar".
201 229  
  230 +Obs.: Os tipos de documentos a serem mapeados deverão estar configurados no SEI como Externo ou Interno/Externo
202 231  
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.
204   - => SEI_HABILITAR_NUMERO_PROCESSO_INFORMADO: 2
  232 +
  233 +19) O protocolo de comunicação implementado pelo PEN realiza a geração e assinatura digital de recibos de entrega 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.
205 234  
  235 +Este link pode ajudar a configurar conforme o SO utilizado: http://ntp.br/guia-linux-comum.php
206 236  
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.
208   - "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Recebimento" => "Cadastrar".
209   - "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Envio" => "Cadastrar".
210 237  
211   - Obs.: Os tipos de documentos a serem mapeados deverão estar configurados no SEI como Externo ou Interno/Externo
  238 +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.
212 239  
213   -
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
  240 +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.
216 241  
  242 +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.
217 243  
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.
... ...
README.md
  Diff comments   View file @cda4f9a
1   -# Módulo de Integração do SEI com o Barramento de Serviços do PEN
2   -
3   -Procedimentos para colaborar com o desenvolvimento do módulo.
4   -
5   -1. Baixe os códigos-fontes do SEI na versão compatível com o módulo
6   -2. Crie o diretório sei/institucional, caso ainda não exista, para receber os códigos do módulo
7   -3. No diretório sei/institucional faça o clone do projeto
8   -4. Configure o módulo nos arquivos de configuração do SEI, seção SEI > Modulos
9   -```php
10   - 'Modulos' => array('PEN' => dirname(__FILE__).'/institucional/mod-sei-barramento')
11   -```
12   -5. Copie os arquivos de atualização do banco de dados do módulos para os devidos sistemas.
13   - * Copiar o arquivo "sei_atualizar_versao_modulo_pen.php" para a pasta sei
14   - * Copiar o arquivo "sip_atualizar_versao_modulo_pen.php" para a pasta sip
15   -
16   -6. Execute a atualização do banco de dados do SEI e SIP
17   -* Executar o script "sip_atualizar_versao_modulo_pen.php" para atualizar o banco de dados do SIP para o funcionamento do módulo:
18   -```bash
19   - php sip_atualizar_versao_modulo_pen.php
20   -```
21   -* Executar o script "sei_atualizar_versao_modulo_pen.php" para inserção de dados no banco do SEI referente as funcionalidades desenvolvidas no módulo.
22   -```bash
23   - php sei_atualizar_versao_modulo_pen.php
24   -```
  1 +Módulo de Integração SEI - PEN
  2 +===================
  3 +
  4 +Data de criação: 27/05/2016
  5 +Data de atualizaçao: 12/09/2017
  6 +Versão: 1.0.0
  7 +
  8 +
  9 +### REQUISITOS PARA INSTALAÇÂO:
  10 +- SEI 3.0.5 (ou superior) instalada (verificar valor da constante de versão do SEI no arquivo sei/SEI.php)
  11 +
  12 +- 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.
  13 +- Caso o ambiente do ConectaGov utilizado nesta configuração esteja utilizando HTTPS com certificado digital do ICP-Brasil, será necessário configurar a cadeia de certificados do ICP-BRASIL como confiáveis nos nós de aplicação do SEI.
  14 +Como todas as comunicações realizadas com o ConectaGov utilizarão conexão segura via HTTPS com certificados digitais emitidos pela cadeia do ICP-Brasil, os servidores de aplicação precisam ser configurados para reconhecer esta cadeia como confiável, o que não é padrão nos sistemas operacionais atuais. Com isto, os seguintes comandos precisam ser executados em cada nós de aplicação do SEI, incluindo aquele responsável pelo tratamento das tarefas agendadas:
  15 + - Copie o certificado da cadeia de CA utilizado pelo ConectaGov para o diretório /usr/local/share/ca-certificates:
  16 +
  17 + > cp <CERTIFICADO-CA-ICP-BRASIL> /usr/local/share/ca-certificates
  18 +
  19 + - Efetue a atualização da lista de certificados confiáveis do SO
  20 +> sudo update-ca-certificates
  21 +>
  22 +- Para concluir os procedimentos de configuração do módulo, será necessário registrar no portal do Processo Eletrônico Nacional - PEN as unidades administrativas que poderão realizar trâmites externo ou recebimento de processos/documentos externo no SEI. Este procedimento precisa ser realizado pelo gestor de protocolo previamente habilitado no portal do PEN. Para maiores informações, acesse o endereço eletrônico http://conectagov.processoeletronico.gov.br/ ou entre em contato pelo e-mail processo.eletronico@planejamento.gov.br
  23 +
  24 +
  25 +### PROCEDIMENTOS PARA INSTALAÇÂO:
  26 +
  27 +1) Fazer backup dos banco de dados do SEI, SIP e repositórios de arquivos.
  28 +
  29 +2) Instalar o gearmand e o supervisord no servidor responsável por tratar o agendamento de tarefas do sistema.
  30 +**Importante:** É imprescindível que seja no mesmo nó em que está configurado o CRON de agendamento principal do SEI.
  31 +
  32 + # Pre-requisito. Caso contrario, os demais pacotes não são encontrados no CentOS7
  33 + yum install epel-release && yum update
  34 +
  35 + # Instalação do Gearman e supervisord
  36 + yum install supervisor gearmand libgearman libgearman-devel php56*-pecl-gearman
  37 +
  38 +
  39 +3) Configuração do supervisor.
  40 +**ATENÇÃO 1:** No parâmetro **'user'** deve ser configurado o usuário que executa o servidor web (verifique no seu servidor qual é o usuario. Ex.: apache)
  41 +**ATENÇÂO 2:** Verifique se a localização dos scripts ProcessarPendenciasRN.php e PendenciasTramiteRN.php estão corretas no parâmetro 'command'
  42 +
  43 + vi /etc/supervisord.conf
  44 + ...
  45 + # Adicione no final do arquivo
  46 + [program:sei_processar_pendencias]
  47 + command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/ProcessarPendenciasRN.php
  48 + numprocs=1
  49 + directory=/opt/sei/web
  50 + user=apache
  51 + autostart=true
  52 + autorestart=true
  53 + log_stderr=true
  54 + stdout_logfile=/var/log/supervisor/sei-supervisord-stdout.log
  55 + stderr_logfile=/var/log/supervisor/sei-supervisord-stderr.log
  56 +
  57 + [program:sei_monitorar_pendencias]
  58 + command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/PendenciasTramiteRN.php
  59 + numprocs=1
  60 + directory=/opt/sei/web
  61 + user=apache
  62 + autostart=true
  63 + autorestart=true
  64 + log_stderr=true
  65 + stdout_logfile=/var/log/supervisor/sei-supervisord-stdout.log
  66 + stderr_logfile=/var/log/supervisor/sei-supervisord-stderr.log
  67 +
  68 +4) Configurar agendamento de tarefas de reinicialização de serviços caso se identifique os estes estão indisponíveis
  69 +
  70 +Esta configuração é recomendada como contingência em conjunto com o Supervisor para garantir que os serviços de integração não serão desativados em caso de indisponibilidade momentânea da infraestrutura do ConectaGov.
  71 +
  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 +
  74 +4.1) Copiar script de verificação dos serviços de integração do ConectaGov para a pasta de arquivos binários do SEI
  75 +Atenção: 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/
  77 +
  78 +4.2) Configurar agendamento no cron
  79 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo
  80 +
  81 + # crontab -e
  82 + */10 * * * * [DIRETORIO_RAIZ_INSTALAÇÃO]`enter code here`/sei/bin/verificar-servicos.sh
  83 +
  84 +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
  85 +
  86 + 'SEI' => array(
  87 + 'URL' => 'http://[servidor sei]/sei',
  88 + 'Producao' => true,
  89 + 'RepositorioArquivos' => '/var/sei/arquivos',
  90 + 'Modulos' => array(),
  91 + ),
  92 +
  93 +Adicionar a referência ao módulo PEN na array da chave 'Modulos' indicada acima:
  94 +
  95 + 'Modulos' => array('PENIntegracao' => 'pen')
  96 +
  97 +7) Mover o diretório de arquivos do módulo "pen" para o diretório sei/web/modulos/.
  98 +
  99 +8) Colocar o arquivo do certificado digital utilizado para integração com o ConectaGov no diretório "sei/config/".
  100 +
  101 +Os certificados digitais necessários para conectar aos ambientes de desenvolvimento e homologação do PEN estão localizados no paco​te de instalação. Para o ambiente de produção, deverá ser utilizado um certificado digital válido gerado por uma Autoridade de Registro - AR confiável (Exemplo: ICP-Brasil, Certisign, Verisign, etc.).
  102 +
  103 +9) Copiar o arquivo de instalação do módulo no SEI **sei_atualizar_versao_modulo_pen.php** para a pasta sei/scripts
  104 +
  105 +10) Copiar o arquivo de instalação do módulo no SIP **sip_atualizar_versao_modulo_pen.php** para a pasta sip/scripts
  106 +
  107 +11) Executar o script "sip_atualizar_versao_modulo_pen.php" para atualizar o banco de dados do SIP para o funcionamento do módulo:
  108 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo
  109 +
  110 + # php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sip/scripts/sip_atualizar_versao_modulo_pen.php
  111 +
  112 +12) Executar o script **sei_atualizar_versao_modulo_pen.php** para inserção de dados no banco do SEI referente ao módulo.
  113 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo
  114 +
  115 + # php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sei/scripts/sei_atualizar_versao_modulo_pen.php
  116 +
  117 +13) Atualizar a tabela [md_pen_unidade] com os seus respectivos valores do campo "id_unidade_rh".
  118 +
  119 +Atenção: Esta configuração será realizada diretamente no banco de dados somente nesta primeira versão do módulo. Os ID's de unidades são gerenciados pela própria instituiçao no portal do Processo Eletrônico Nacional: http://conectagov.processoeletronico.gov.br.
  120 +Na fase de homologação do sistema, estes valores serão passados pela SETIC/MP.
  121 +
  122 + update md_pen_unidade set id_unidade_rh = [ID_UNIDADE_PEN] where id_unidade = [ID_UNIDADE_SEI];
  123 +
  124 +14) Configuração de unidade administrativa virtual para gerenciamento de envio e recebimento de processos pelo módulo.
  125 +
  126 +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.
  127 +
  128 +14.1) Acessar o SIP e criar uma nova unidade administrativa com as seguintes configurações:
  129 +
  130 + sigla: EXTERNO
  131 + nome: Unidade Externa
  132 +
  133 +14.2) Configurar a nova unidade na hierarquia do SEI, através da funcionalidade SIP >> Hierarquias >> Montar
  134 +
  135 +Sugerimos que está unidade seja configurada no mesmo nível hierárquico da unidade de teste padrão existente no SEI. Para saber qual é a unidade de testes, basta verificar o parâmetro do SEI chamado **SEI_UNIDADE_TESTE**
  136 +
  137 +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*
  138 +
  139 +15) Configuração de tipo de processo a ser aplicado aos processos recebidos de outras instituições.
  140 +
  141 +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.
  142 +
  143 +Caso a opção for pela criação de um novo tipo de processo específico, segue abaixo sugestão para configuração:
  144 +
  145 +15.1) Criar um novo Tipo de Processo pela funcionalidade *SEI >> Administração >> Tipo de Processo*
  146 +
  147 +> Nome: Demanda Externa: Outros Órgãos Públicos Descrição:
  148 +> Processos recebidos de outras instituições Sugestão de Assuntos: [A
  149 +> CLASSIFICAÇÃO DE ASSUNTO DEVE SER DEFINIDO JUNTAMENTE COM A ÁREA DE DOCUMENTAÇÃO]
  150 +> Ex: 019.01 - INFORMAÇÕES SOBRE O ÓRGÃO
  151 +> Restringir aos Órgãos: [vazio]
  152 +> Restringir às Unidades: [vazio]
  153 +> Níveis de Acesso Permitidos: Público
  154 +> Nível de Acesso Sugerido: Público
  155 +> Processo único no órgão por usuário: Não
  156 +> Interessado: Não
  157 +> Interno do Sistema: Sim
  158 +
  159 +15.2) Obter o número de ID do novo Tipo de Processo para posterior configuração dos parâmetros do módulo de integração. O ID do novo Tipo de Processo pode ser obtido através da funcionalidade *SEI >> Administração >> Tipo de Processo >> Listar*
  160 +
  161 +16) Configurar os parâmetros do Módulo de Integração Pen (Menu: *SEI >> Infra >> Parâmetros*)
  162 +
  163 +**PEN_ENDERECO_WEBSERVICE:** [Endereço dos serviços de integração do PEN]
  164 +
  165 +- Desenvolvimento:
  166 +https://pen-api.trafficmanager.net/interoperabilidade/soap/v1_1/
  167 +- Homologação: https://homolog.pen.api.trafficmanager.net/interoperabilidade/soap/v1_1/
  168 +- Produção: https://api.conectagov.processoeletronico.gov.br/interoperabilidade/soap/v1_1/
  169 +
  170 +**=> PEN_ENDERECO_WEBSERVICE_PENDENCIAS**: [Endereço dos serviços de notificação de trâmites de processos]
  171 +
  172 +- Desenvolvimento:
  173 + https://pen-pendencias.trafficmanager.net/
  174 +- Homologação:
  175 + https://homolog.pen.pendencias.trafficmanager.net/
  176 +- Produção:
  177 + https://pendencias.conectagov.processoeletronico.gov.br/
  178 +
  179 +**=> PEN_ID_REPOSITORIO_ORIGEM:**
  180 +ID do repositório de origem do órgão na estrutura organizacional. Este identificador é enviado para a instituição junto com o pacote de integração.
  181 +Exemplo: 1 (Código de identificação da estrutura organizacional do Poder Executivo [SIORG])
  182 +
  183 +**=> PEN_LOCALIZACAO_CERTIFICADO_DIGITAL:**
  184 +Localização do certificado digital o órgão (arquivo do passo 8)
  185 +
  186 +**=> PEN_NUMERO_TENTATIVAS_TRAMITE_RECEBIMENTO:**
  187 +Valor padrão: 3
  188 +
  189 +**=> PEN_TAMANHO_MAXIMO_DOCUMENTO_EXPEDIDO:**
  190 +Valor padrão: 50
  191 +
  192 +**=> PEN_SENHA_CERTIFICADO_DIGITAL:**
  193 +Senha do certificado digital
  194 +Atenção: Configuração de senha será modificada na próxima versão para utilização de criptografia
  195 +
  196 +**=> PEN_TIPO_PROCESSO_EXTERNO:**
  197 +Id do tipo de documento externo. Configurar com o ID do Tipo de Processo Externo configurado no passo 15
  198 +
  199 +**=> PEN_UNIDADE_GERADORA_DOCUMENTO_RECEBIDO:**
  200 +Id da unidade de origem que serão atribuídos os documentos recebidos de um outro órgão. Configurar com o ID da Unidade criada no passo 14
  201 +
  202 +
  203 +17) Iniciar Gearman e Supervisor
  204 +Atenção: Altere a referência para [DIRETORIO_RAIZ_INSTALAÇÃO] descrito abaixo:
  205 +
  206 + service gearmand start && service supervisord start
  207 +
  208 +Executar o comando "ps -ef" e verificar se os dois processos seguintes estão em execução:
  209 +
  210 + /usr/bin/php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sei/modulos/pen/rn/PendenciasTramiteRN.php
  211 +
  212 + /usr/bin/php -c /etc/php.ini [DIRETORIO_RAIZ_INSTALAÇÃO]/sei/modulos/pen/rn/ProcessarPendenciasRN.php
  213 +
  214 +Caso não esteja houve algum problema de configuração e a expedição de processos não irá funcionar.
  215 +Atenção: Importante colocar o serviço para ser iniciado automaticamente juntamente com o servidor.
  216 +
  217 +18) Realizar o mapeamento de tipos de documentos do SEI com as especies documentais definidas no PEN, tanto de envio quanto de recebimento.
  218 +
  219 +Esta configuração deve ser feita antes de começar a utilização do módulo.
  220 +
  221 +- "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Recebimento" => "Cadastrar"
  222 +- "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Envio" => "Cadastrar".
  223 +
  224 +Obs.: Os tipos de documentos a serem mapeados deverão estar configurados no SEI como Externo ou Interno/Externo
  225 +
  226 +
  227 +19) O protocolo de comunicação implementado pelo PEN realiza a geração e assinatura digital de recibos de entrega 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.
  228 +
  229 +Este link pode ajudar a configurar conforme o SO utilizado: http://ntp.br/guia-linux-comum.php
  230 +
  231 +
  232 +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.
  233 +
  234 +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.
  235 +
  236 +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.
  237 +
... ...