Manual de Instalação - Supremo Tribunal Federal
Contents
1. rio Telefone para contato 3217 3481 E mail flaviohOstf jus br Contato 3 Igor Ben cio de Mesquita Fun o Analista de Sistemas Telefone para contato 3217 4456 E mail IgorM stf jus br Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o INTRODU O O Smart Client a aplica o fornecida pelo STF como solu o de cliente para utiliza o de seu WebService Processo Eletr nico Seu prop sito principal facilitar e acelerar o processo de ades o ao WSProcessoEletronico e sua utiliza o O conte do a seguir tem como objetivo orientar a todos os procedimentos necess rios para a disponibiliza o do Smart Client num ambiente corporativo para que possa ser utilizado corretamente Para mais informa es sobre o aplicativo consulte a documenta o e STF WebServices Processo Eletr nico Smart Client Documenta o Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o 3 PR REQUISITOS PARA A INSTALA O O Smart Client foi desenvolvido utilizando a arquitetura JZEE 5 com Hibernate 3 2 5 ga utilizando annotations e Axis2 1 2 Os requisitos m nimos de funcionamento Software s o no caso da utiliza o como aplica o e JRE 6 dispon vel no equipamento onde ser executado e Banco de dados com especifica es d2. a framework Hibernate s o permitidos Essa compatibilidade e poss veis adapta es podem ser verificadas entrando em contato com o STF c Obten o dos scripts de cria o da base de dados tempor ria atrav s da P gina do WS Processo Eletr nico no Portal do STF Caso n o haja compatibilidade e seja necess ria a cria o de um script espec fico o STF deve ser contatado d Cria o de um schema ou tablespace pr prio para o Smart Client e cria o de um usu rio de Banco de Dados espec fico que seja owner do mesmo permiss o total N o recomendamos que o usu rio tenha permiss o a qualquer outro objeto do banco de dados pois o mesmo ser utilizado pela aplica o que necessita apenas das tabelas que ser o criadas para a mesma e Gera o da base de dados tempor ria do Smart Client atrav s dos scripts obtidos utilizando o usu rio criado 3 Solicitar permiss o de acesso ao WebService Processo Eletr nico atrav s do email g sspj Ostf jus br para cadastramento de rg o usu rio e obten o de nome de usu rio e senha para acesso Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o 5 INSTALA O Para a disponibiliza o do Smart Client e para seu correto funcionamento s o necess rios os seguintes passos 1 Obten o do pacote execut vel e da biblioteca de modelo do Banco de Dados utilizado na P gina do WS Processo Eletr ni
3. nico senha definida atrav s de funcionalidade do Smart Client v cliente proxy ativado truelfalse indica a ativa o de autentica o via proxy Caso seu valor seja false todos os atributos com prefixo cliente proxy s o ignorados vi cliente proxy endereco endere o ip ou nome do proxy a ser utilizado Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o vii viii xi xii xiii xiv XV xvi cliente proxy porta porta utilizada para acesso ao proxy cliente proxy dominio dom nio de rede onde se encontra o proxy cliente proxy authAnonima true false indica a utiliza o de autentica o an nima no proxy Caso seu valor seja false o atributo cliente proxy nomeUsuario ignorado assim como a senha configurada para o mesmo cliente proxy nomeUsuario nome login do usu rio a ser autenticado no proxy senha definida atrav s da funcionalidade do Smart Client cliente tempDir endere o no sistema de arquivos de diret rio para utiliza o pelo Smart Client de arquivos tempor rios utilizados em cache de transmiss o entre outros ATEN O a configura o do endere o deve seguir o padr o do sistema operacional utilizado cliente modoTeste truelfalse configura a ativa o do modo de teste do Smart Client fazendo com que algumas valida es sejam ignoradas como o impedimento de envio de um processo esp
4. Coordenadoria de Sistemas e STF Smart Client Manual de Instala o 3 Execu o de um dos comandos de envio de processo de acordo com os t picos 5 2 e 5 3 do documento e STF WebServices Processo Eletr nico Smart Client Documenta o 4 Consulta dos logs gerados ap s o envio do processo para verifica o das funcionalidades assim como altera es no controle de processamento 12
5. SUPREMO TRIBUNAL FEDERAL Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF WebServices Processo Eletr nico Smart Client Manual de Instala o Hist rico da Revis o EP A PR 30 07 2008 i Cria o do documento Igor Ben cio de Mesquita 08 08 2008 1 1 Altera es do documento Fl vio Henrique Rocha e Silva 13 08 2008 1 2 Inclus o de novos procedimentos Igor Ben cio de Mesquita 10 11 2008 1 3 Altera es para novo dom nio do STF Igor Ben cio de Mesquita 30 04 2009 1 4 Altera es para adequa o vers o Igor Ben cio de 1 13 3 Mesquita DA UT E Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o INDICE CONTATOS E E E E A A EE E A 3 INTRODU O o caos a a a EA a AR a A 4 PR REQUISITOS PARA A INSTALA O aeee 5 PRE INSTALA O or ato po Ra SR do o asa RR a L ER 6 INSTABA O oro und araa Rd A Da a O aar ar a 8 PROCEDIMENTOS DE TESTES INICIAIS ieisseesseseeeaeeaeearaearese arenas 11 Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o 1 CONTATOS Contato 1 Gustavo Sanches Fun o Coordenador de Sistemas Telefone para contato 3217 3488 E mail gustavo sanches Ostf jus br Contato 2 Fl vio Henrique Rocha e Silva Chefe da Se o de Sistemas do Processamento Fun o Judici
6. co no Portal do STF 2 Descompacta o do pacote completo em local apropriado para seu funcionamento de acordo com os pr requisitos 3 Inclus o da biblioteca de modelo descompactada no diret rio lib da aplica o 4 Configura o do aplicativo seguindo os procedimentos a seguir a Abertura do arquivo SmartClient jar utilizando ferramenta padr o de compacta o e remo o do arquivo cliente properties do pacote b Defini o dos par metros de configura o no arquivo cliente properties utilizando ferramenta padr o de edi o de arquivos de texto txt segundo as informa es a seguir i Todos os atributos de configura o do arquivo cliente properties consistem em nome do atributo nome composto separado por pontos e valor do atributo sendo os dois separados por um espa o e definidos em conjunto a cada linha S devem ser alterados os valores ap s o espa o sendo que a altera o em qualquer outra parte da estrutura ir gerar erros no aplicativo ii cliente endpoint endere o de acesso do WebService endpoint Processo Eletr nico configura o padr o para acesso do WebService em homologa o para testes iii cliente andamento endpoint endere o de acesso do WebService Acompanhamento Processual configura o padr o para acesso do WebService em homologa o para testes iv cliente webServiceAuth usuario usu rio do rg o a ser utilizado para acesso ao WebService Processo Eletr
7. ec fico j enviado dentre outras O par metro tamb m configura se ser o exibidos na linha de comando os comandos SQL e coment rios de debug durante a execu o cliente codigoOrigem num rico c digo do identificador nico do registro na tabela ORIGENS da base tempor ria do Smart Client que representa o rg o no qual est sendo utilizado o aplicativo cliente codigoProcedencia num rico c digo do identificador nico do registro na tabela PROCEDENCIAS da base tempor ria do Smart Client que representa o a Unidade Federativa ou outro tipo de regi o no qual est sendo utilizado o aplicativo cliente cert ativarEnvioCertificado truelfalse indica a ativa o do envio do certificado do rg o assinado pelo STF para troca de certificados Caso seu valor seja false o atributo cliente cert keystore url ignorado assim como a senha configurada para o mesmo cliente cert keystore url caminho no sistema de arquivos para o arquivo keystore Java jks contendo a o certificado do rg o assinado pelo STF para troca de certificados no acesso ao WebService senha definida atrav s da funcionalidade do Smart Client ATEN O a configura o do endere o deve seguir o padr o do sistema operacional utilizado Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o xvii cliente cert truststore url caminho no sistema de arquivos para o arquivo key
8. gura o de acordo com o t pico 5 5 do documento e STF WebServices Processo Eletr nico Smart Client Documenta o e Defini o das senhas segundo procedimento do comando f Disponibiliza o dos arquivos de keystore caso necess rio e truststore jks no diret rio configurado no arquivo cliente properties 10 Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o 6 PROCEDIMENTOS DE TESTES INICIAIS Pensando em facilitar e acelerar o processo de ado o desta aplica o o Smart Client foi desenvolvido contendo uma funcionalidade para aux lio em testes iniciais que gera dados fict cios para testes de todo o conjunto Smart Client WebServices Neste t pico listamos os procedimentos sugeridos para confer ncia do correto funcionamento do Smart Client utilizando essa funcionalidade Tais procedimentos s o essenciais para garantir que os testes com dados pr ximos aos reais sejam mais eficientes Seguem abaixo os procedimentos citados Para execu o dos mesmos levado em conta que todos os procedimentos de pr instala o e instala o foram executados corretamente 1 Execu o do comando dummy insert para inser o de dados fict cios na base tempor ria de acordo com o t pico 5 1 do documento e STF WebServices Processo Eletr nico Smart Client Documenta o 2 Verifica o da correta inser o dos dados na tabela tem
9. ica o script job ou outro software que enviar o comando de ativa o ao Smart Client deve ser feita via linha de comando portanto a permiss o para tal acesso pela mesma deve ser concedido d O servidor deve possuir acesso internet via proxy ou diretamente sem restri es de firewall para os endpoints dos Web Services utilizados assim como acesso via rede ao servidor de banco de dados no qual ser gerada a base do Smart Client e N o existem restri es de Sistemas Operacionais caso o mesmo possua a JRE corretamente instalada Por m algumas propriedades espec ficas devem ser definidas na configura o da aplica o A aplica o foi desenvolvida em ambiente Windows portanto quaisquer problemas ocorridos em outros ambientes devem ser reportados ao STF para solu o 2 Verifica o e prepara o de Base de Dados para utiliza o pelo Smart Client Os seguintes fatores devem ser observados a O Smart Client depende da utiliza o de base de dados pr pria instalada em SGBD do rgao usu rio Esta base de dados armazenar informa es tempor rias que ser o enviadas e ou recuperadas pelas aplica es integradas ao mesmo Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o b Deve ser verificada a compatibilidade da aplica o com o SGBD que ser utilizado pelo rg o Somente bancos de dados compat veis com os componentes JDBC e
10. ispon veis para Jdbc e Hibernate e Aplica o de origem em que possa ser implementada chamada de linha de comando Caso seja optada a utiliza o como componente o requisito m nimo exigido que a aplica o seja J2EE 5 Secretaria de Tecnologia da Informa o Coordenadoria de Sistemas e STF Smart Client Manual de Instala o 4 PR INSTALA O O aplicativo Smart Client uma aplica o de livre obten o e que n o necessita de nenhum procedimento de instala o propriamente dito apenas disponibiliza o de c pia e configura o Por m para seu correto funcionamento depende de alguns fatores que podem ser pr configurados no ambiente onde ser executado A seguir s o detalhados esses procedimentos que aconselhamos serem executados antes da disponibiliza o da aplica o diminuindo assim a chance de ocorr ncia de problemas Os procedimentos de pr instala o s o 1 Defini o de servidor onde ser disponibilizado o Smart Client Os seguintes fatores devem ser observados a O servidor deve possuir todos os pr requisitos de software documentados no item Pr requisitos para a instala o constantes neste documento b Deve ser disponibilizado um local seguro no sistema de arquivos do servidor pois o Smart Client utiliza arquivos para sua configura o e execu o sendo recomendado que o acesso aos mesmos seja restrito c A chamada da aplica o de origem apl
11. por ria observando a estrutura e seu funcionamento Seguem abaixo algumas breves explica es a CONTROLE PROCESSAMENTO tabela que controla o processamento do processo na base tempor ria informando se j foi enviado ao STF tendo assim um relacionamento 1 1 com a tabela de registro de processos Um controle de processamento pode tamb m n o conter nenhum relacionamento a um processo representando nesse caso um processamento de mais de um processo ou que n o seja relacionado ao mesmo para fins de log b LOG CONTROLE PROCESSAMENTO tabela de log referente a um controle de processamento A tabela cont m todo o log de tentativas de envio erros ou sucessos ocorridos num processamento espec fico c PROCESSO ORIGEM tabela de registro dos processos a serem enviados relacionados obrigatoriamente a um e somente um controle de processamento d PARTE PROCESSO ORIGEM tabela contendo as partes dos processos registrados inseridas por processo e ADVOGADO PROCESSO ORIGEM tabela dos advogados relacionados a cada parte inseridos por processo f PARTE ADVOGADO PROCESSO ORIGEM tabela de liga o entre as duas citadas acima g PECA PROCESSO ORIGEM tabela contendo as pe as processuais a serem enviadas com o c digo bin rio das imagens digitalizadas dos documentos As imagens digitalizadas para teste s o obtidas de um diret rio contido na estrutura do Smart Client 11 Secretaria de Tecnologia da Informa o
12. store Java jks contendo a cadeia de certificados dos WebServices acessados pelo Smart Client indicando sua confiabilidade senha definida atrav s da funcionalidade do Smart Client ATEN O a configura o do endere o deve seguir o padr o do sistema operacional utilizado xviii cliente validacao numeroOABPattern c digo que representa o padr o de formata o do n mero de OAB dos advogados para valida o padr o determinado pelo STF xix cliente validacao CPF Pattern c digo que representa o padr o de formata o do n mero de CPF para valida o padr o determinado pelo STF xx cliente validacao CNPJPattern c digo que representa o padr o de formata o do n mero de CNPJ para valida o padr o determinado pelo STF xxi cliente bd driver nome completo do driver de banco de dados a ser utilizado pelo JDBC xxii cliente bd dialect nome completo da classe de dialeto de banco a ser utilizada pelo Hibernate xxiii cliente bd usuario nome de usu rio login utilizado para acesso ao banco de dados senha definida atrav s da funcionalidade do Smart Client xxiv cliente bd url linha de endere amento de banco de dados de acordo com o driver JDBC Sua estrutura depende do padr o estabelecido pela tecnologia c Inser o do arquivo cliente properties alterado dentro do arquivo SmartClient jar substituindo o padr o d Chamada do comando de defini o de senhas para finaliza o da confi
Download Pdf Manuals
Related Search