======================================================================================================================================== Módulo PEN Data de criação: 27/05/2016 Data de atualizaçao: 20/07/2016 Desenvolvimento: Join Tecnologia Versão: 0.0.3 ======================================================================================================================================= ======================================================================================================================================== PROCEDIMENTOS PARA INSTALAÇÃO: ======================================================================================================================================== REQUISITOS PARA INSTALAÇÂO: - SEI 2.6.0.A9 instalada (verificar valor da constante de versão do SEI no arquivo sei/SEI.php). - O usuário de acesso ao banco de dados do SEI e SIP, constante nos arquivos ConfiguracaoSEI.php e ConfiguracaoSip.php, deverá ter permissão de acesso total ao banco de dados, permitindo, por exemplo, criação e exclusão de tabelas. - *** Até que as alterações realizadas no CORE do SEI sejam incluídas na versão de referencia (TRF4), os arquivos de codigo-fonte enviados juntamente com este modulo (arquivos_core_sei.tar.gz) deverão sobrescrever os arquivos existentes. Portanto, comece realizando este passo. *** PROCEDIMENTOS PARA INSTALAÇÂO: 1) Fazer backup dos banco de dados do SEI e SIP e do filesystem. 2) Instalar o gearmand e o supervisord no servidor que será responsável por tratar o agendamento de tarefas no sistema. É recomendado que seja no mesmo nó em que está configurado o CRON de agendamento principal do SEI. # Pre-requisito. Caso contrario, os demais pacotes nao sao encontrados no CentOS7 yum install epel-release # Instalação do Gearman e supervisord yum install supervisor gearmand libgearman libgearman-devel php-pecl-gearman 3) Configuração do supervisor. No parametro 'user' abaixo deve ser configurado o usuario que executa o servidor web (verifique no seu servidor qual é o usuario. Ex.: apache) vi /etc/supervisord.conf # Adicione no final do arquivo [program:sei_processar_pendencias] command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/ProcessarPendenciasRN.php numprocs=1 directory=/var/www/html/sei/ user=XXXXX autostart=true autorestart=true stdout_logfile=/tmp/sei.log stdout_logfile_maxbytes=1MB stderr_logfile=/tmp/sei_error.log stderr_logfile_maxbytes=1MB [program:sei_monitorar_pendencias] command=/usr/bin/php -c /etc/php.ini /opt/sei/web/modulos/pen/rn/PendenciasTramiteRN.php numprocs=1 directory=/var/www/html/sei/ user=XXXXX autostart=true autorestart=true stdout_logfile=/tmp/sei.log stdout_logfile_maxbytes=1MB stderr_logfile=/tmp/sei_error.log 4) 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 'SEI' => array( 'URL' => 'http://[servidor sei]/sei', 'Producao' => true, 'RepositorioArquivos' => '/var/sei/arquivos', 'Modulos' => array(), ), Adicionar a referência ao módulo PEN na array da chave 'Modulos' indicada acima: 'Modulos' => array('PEN' => dirname(__FILE__).'/institucional/pen'), 5) Criar o diretório "sei/institucional" (caso ainda não exista) e mover todo o diretório "pen" para dentro de "sei/institucional". 6) Colocar o arquivo do certificado digital no diretorio "sei/institucional/pen/" - Na fase de homologação o certificado que deve ser usado é o ORGAOall.pem. 7) Copiar o arquivo "sei_atualizar_versao_modulo_pen.php" para a pasta sei 8) Copiar o arquivo "sip_atualizar_versao_modulo_pen.php" para a pasta sip 9) Executar o script "sip_atualizar_versao_modulo_pen.php" para atualizar o banco de dados do SIP para o funcionamento do módulo: php sip_atualizar_versao_modulo_pen.php 10) 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. php sei_atualizar_versao_modulo_pen.php 11) CONFIGURAR OS PARÂMETROS DO MÓDULO PEN (Menu: Infra > Parametros) => PEN_ENDERECO_WEBSERVICE: Endereço do WebService do barramento - Homologação: https://homolog.pen.api.trafficmanager.net/interoperabilidade/soap/v1_1/ => PEN_ENDERECO_WEBSERVICE_PENDENCIAS: Endereço da api de pendências do barramento - Homologação: https://homolog.pen.pendencias.trafficmanager.net/ => PEN_ENVIA_EMAIL_NOTIFICACAO_RECEBIMENTO: Padrão N => PEN_ID_REPOSITORIO_ORIGEM: ID do repositório de origem do órgão na estrutura organizacional (ID gerado pelo Barramento) - Homologação: SIORG = 1 => PEN_LOCALIZACAO_CERTIFICADO_DIGITAL: Localização do certificado digital o órgão - Arquivo do passo 6 => PEN_SENHA_CERTIFICADO_DIGITAL: Senha do certificado digital - Na fase de homologação a senha padrão do certificado é 1234 => PEN_TIPO_PROCESSO_EXTERNO: Id do tipo de documento externo - Criar um Tipo de Processo (Administraçao > Tipos de Processo > Novo) externo genérico e OBRIGATORIAMENTE incluir uma Sugestão de Assunto (ex.: 900-Assuntos Diversos). => PEN_UNIDADE_GERADORA_DOCUMENTO_RECEBIDO: Id da unidade de origem que serão atribuídos os documentos recebidos de um outro órgão. 12) 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. => SEI_HABILITAR_NUMERO_PROCESSO_INFORMADO: 2 13) Realizar o mapeamento de tipos de documentos do SEI com as especies documentais do Barramento, tanto de envio quanto de recebimento. Esta configuração deve ser feita antes de começar a utilização do módulo. "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Recebimento" => "Cadastrar". "Administração" => "Tipos de Documentos" => "Mapeamento de Tipos de Documento" => "Envio" => "Cadastrar". Obs.: Os tipos de documentos a serem mapeados deverão estar configurados no SEI como Externo ou Interno/Externo 14) Atualizar a tabela pen_unidade com os seus respectivos valores do campo "id_unidade_rh". - Esses ID's de unidades são gerenciados pelo próprio orgão no Portal do Barramento: http://homolog.pen.portal.trafficmanager.net/ - Na fase de homologação esses valores serão passados pela DTI/MP 15) Iniciar Gearman e Supervisor service gearmand start && service supervisord start * Executar o comando "ps -ef" e verificar se os dois processos seguintes estão em execução: - /usr/bin/php -c /etc/php.ini /var/www/html/sei/institucional/pen/rn/PendenciasTramiteRN.php - /usr/bin/php -c /etc/php.ini /var/www/html/sei/institucional/pen/rn/ProcessarPendenciasRN.php Caso não esteja houve algum problema de configuração e a expedição de processos não irá funcionar. * Importante colocar o serviço para ser iniciado automaticamente juntamente com o servidor. 16) Dentro da pasta sei/institucional/pen existe um arquivo chamado "verificar-servicos.sh" que faz a verificação dos serviços do gearmand e do supervisord. Sugerimos que seja cadastrado um agendamento no CRON para rodar esse serviço periodicamente. 17) O Barramento de PEN ao calcular os hashs para gerar recibos de tramite, leva em consideração a data/horário. Portanto é importante que todos os nós da aplicação esteja sincronizados com o NTP.br. 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 18) É altamente aconselhável deixar o arquivo .pem do certificado digital fora do path do apache (var/www/html)