Instalação e uso do H3270

Transcrição

1 Instalação e uso do H3270 Projeto Libertas-BR 8 de setembro de 2005 Este documento descreve o processo de instalação do H Introdução O H3270 é um programa que permite acessar terminais IBM 3270 via browser. É instalado um servidor web que fará o acesso direto ao terminal IBM 3270 e que pode ser conectado pela intranet ou internet por navegadores web. Quanto à definição dos navegadores utilizados, não existe uma dependência de arquitetura, pode-se utilizar tanto navegadores de Linux quanto navegadores para Windows. O H3270 funciona como um intermediário entre as conexões das estações de trabalho e o servidor IBM Veja o esquema abaixo: 1

2 2 Instalação do servidor 2.1 Pré-instalação Todos os arquivos que precisem de download, serão guardados em $H3270_INSTALL, neste caso $H3270_INSTALL=/root/h3270. Como usuário root, altere o seu arquivo.profile, acrescentando as seguintes linhas: JAVA_HOME=/usr/local/java CATALINA_HOME=/usr/local/tomcat TOMCAT_HOME=/usr/local/tomcat PATH=$PATH:$JAVA_HOME/bin:$CATALINA_HOME/bin export PATH JAVA_HOME CATALINA_HOME TOMCAT_HOME Agora faça o logout e login para as alterações terem efeito. 2.2 Instalação Apache É necessário instalar o apache juntamente com o módulo de integração do Tomcat com o apache: aptitude install apache libapache-mod-jk libapache-mod-ssl 2.3 Instalação Java J2SDK Antes de fazer qualquer coisa, é necessário ter instalado o jdk com a versão pelo menos 1.4. Entre no endereço: e faça o download do pacote j2sdk linux-i586.bin. chmod u+x $H3270_INSTALL/j2sdk-1_4_2_05-linux-i586.bin cd /usr/local $H3270_INSTALL/j2sdk-1_4_2_05-linux-i586.bin ln -s /usr/local/j2sdk1.4.2_05 /usr/local/java 2.4 Instalação h3270 Para instalar o servidor h3270, entre no endereço abra o link Download e faça o download do arquivo h bin-linux.tgz. 2

3 Depois de feito o download, siga os passos: tar zxvf h bin-linux.tgz cp -rf h bin-linux/jakarta-tomcat /usr/local/tomcat Agora inicie o tomcat com o comando: /usr/local/tomcat/bin/startup.sh Verifique se funcionou, abrindo com algum browser o endereço: Integração do Tomcat com o Apache É preciso configurar o Apache para ele rodar junto com o Tomcat. Abra o arquivo /etc/apache/http.conf e adicione as seguintes linhas: # mod_jk JkWorkersFile /etc/libapache-mod-jk/workers.properties # Where to put jk logs # Update this path to match your logs directory location (put mod_jk.log next to access_log) JkLogFile /var/log/apache/mod_jk.log # Set the jk log level [debug/error/info] JkLogLevel info # Select the log format JkLogStampFormat "[%a %b %d %H:%M:%S %Y] " # JkOptions indicate to send SSL KEY SIZE, JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories # JkRequestLogFormat set the request format JkRequestLogFormat "%w %V %T" # Send everything for context /examples to worker named worker1 (ajp13) JkMount /h3270 local JkMount /h3270/* local 3

4 Edite o arquivo /etc/libapache-mod-jk/worker.properties e atualize os caminhos do java e do tomcat: workers.tomcat_home=/usr/local/tomcat workers.java_home=/usr/local/java Reinicie o Apache: /etc/init.d/apache restart Verifique se funcionou, abrindo em algum browser o endereço: Criptografia com o h Conexão segura com o terminal IBM O servidor h3270 utiliza a ferramenta s3270 para conectar ao terminal IBM. A versão disponibilizada para download desta ferramenta, na página do h3270 não é a versão mais recente que suporta conexões criptografadas com o terminal IBM. Portanto, para utilizar o h3270 com suporte a conexões criptografadas, siga os seguintes passos: 1. Faça a instalação do h3270 seguindo o procedimento de instalação da seção?? deste documento. 2. Instale a ferramenta s3270 (a versão desta ferramenta deve ser igual ou maior que ): aptitude install s Verifique a localização do arquivo binário do s3270: whereis s3270 * provavelmente o s3270 será encontrado em /usr/bin/s Copie o arquivo binário do s3270 para o diretório de ferramentas do h3270: cp -f /usr/bin/s3270 /usr/local/tomcat/webapps/h3270/web-inf/bin/ 5. Finalizado este procedimento, agora o servidor h3270 está habilitado para conectar ao terminal IBM com suporte à criptografia. Este é o esquema de utilização do h3270 com suporte à criptografia na conexão entre o servidor e o terminal IBM: 4

5 Verifique se funcionou, abrindo em algum browser o endereço: No campo Host:, utilize um endereço de terminal IBM com criptografia dessa forma: L:<terminal-IBM-com-SSL>: Conexão segura dos browsers com o h3270 A configuração padrão do servidor web (apache), não é uma conexão segura naturalmente. Para torná-la segura existem diversas maneiras. Nesta documentação abordamos um método bem simples de utilização de chaves SSL para criptografar a conexão. Siga o procedimento a seguir para fazer isto: 1. Primeiramente, criaremos as chaves SSL do servidor web: (a) Mude para o diretório onde serão armazenadas as chaves: cd /etc/apache (b) Criação da chave e da requisição: openssl req -new > cert.csr * digite uma senha de pelo menos 6 letras. (c) Removendo a senha da chave (opcional): openssl rsa -in privkey.pem -out cert.key * a senha é a mesma do passo anterior. (d) Convertendo a requisição em um certificado assinado: openssl x509 -in cert.csr -out cert.cert -req -signkey cert.key -days 365 ** preencha os passos de acordo com a empresa responsável pelo certificado. 2. Depois de criadas as chaves e certificados, é necessário alterar a configuração do Apache para utilizá-los: Insira as seguintes linhas no arquivo /etc/apache/http.conf: 5

6 <IfModule mod_ssl.c> Listen 80 Listen 443 </IfModule> <VirtualHost _default_:443> DocumentRoot /var/www/ SSLEngine on SSLCertificateFile /var/tmp/chaves/new.cert.cert SSLCertificateKeyFile /var/tmp/chaves/new.cert.key SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown </VirtualHost> O esquema a seguir demonstra a etapa da conexão que estamos inserindo criptografia: Verifique se funcionou, abrindo em algum browser o endereço: Será exibido o certificado SSL do servidor para download no browser do cliente. 3 Utilização do h3270 Para abrir o servidor h3270 sem criptografia, acesse o endereço: Caso tenha disponível um terminal IBM, coloque o endereço deste terminal no campo Host:, da seguinte forma: L:<terminal-IBM-com-SSL>:2301. Caso tenha configurado a criptografia na comunicação entre os browsers e o servidor h3270, acesse o h3270 no seguinte endereço: OBS: 6

7 Este endereço pode ser acessado por browsers tanto no Linux como no Windows. Se não for possível acessar de uma vez este endereço, verifique a configuração de proxy do browser. 4 Referências ˆ Página do projeto h

8 A Configurações adicionais do servidor h3270 A.1 Renderizando páginas O h3270 possui um mecanismo para transformar aplicações do terminal baseadas em texto, em páginas com aparência de aplicação web (com imagens, links e objetos HTML). A idéia principal desse mecanismo é: criar um template HTML para uma ou mais telas de terminal. Um template diz como uma tela particular (ou conjunto de telas) pode aparecer em HTML. Cada template possui três partes: um aceitador de padrões (accept pattern), um verificador de padrões (match pattern), um corpo HTML (HTML body). ˆ Um aceitador de padrões (accept pattern), é uma expressão regular que decide se este template pode ser aplicado a uma tela específica do terminal conectado. É aplicado se o padrão for o mesmo da representação textual da tela. ˆ Um verificador de padrões (match pattern), é uma expressão regular usada para capturar informações importantes da tela do terminal. O texto capturado, pode ser utilizado no corpo HTML posteriormente. ˆ Corpo HTML, é uma página HTML normal que pode conter marcas especiais como #1, #2, #3... Estas marcas indicam onde o texto capturado pelo passo anterior (match pattern), pode ser adicionado na página. A estrutura do arquivo de template, é: <!-- accept --> Padr~oes para verificaç~ao da tela. <!-- match --> Capturar informaç~oes importantes na tela do terminal. <html> </html> Corpo HTML. Quando o h3270 é inciado, a renderização de páginas é iniciada e são lidos todos os arquivos de template no diretório WEB-INF/templates. Os arquivos de template tem extensão.html. Quando uma página é acessada, as seções accept pattern dos templates são testadas e a primeira que casar os padrões é selecionada para renderizar a página 1. 1 Exemplos de arquivos de template podem ser encontrados no diretório de templates do h

9 A.2 Descrição das seções do arquivo template ˆ A seção accept pattern é basicamente uma expressão regular, que é aplicada na tela do terminal. O padrão só precisa casar em alguma posição da tela do terminal, não necessariamente toda a tela. Campos de entrada das telas dos terminais são marcados pelos caractéres: "{" e "}". ˆ A seção match pattern é aplicada à tela depois que a comparação feita na seção anterior (accept pattern) tiver sucesso. O padrão desta seção não precisa casar com toda a tela do terminal, mas podem acontecer erros se o padrão não casar com toda a tela, depois de ser aceito na seção accept pattern. Com algumas diretivas, é possível criar grupos de captura para capturar textos da tela do terminal para depois inserí-los no corpo HTML. Os grupos de captura, são criados por expressões regulares entre parênteses. Se precisar capturar um campo de entrada de dados, basta usar um grupo de captura. O campo de entrada de dados, como foi dito antes, é limitado pelos caractéres: "{" e "}". Um exemplo de expressão regular para capturar um campo de entrada é: "(\{.*?\})". ˆ Na seção corpo HTML, é criada uma nova tela para ser exibida no lugar da tela do terminal original. Para inserir os textos capturados na seção anterior (match pattern), indique na posição correspondente o número do grupo capturado: #1, #2, #3,... 9

10 B Comparação entre as ferramentas de acesso ao mainframe IBM (3270) Esta seção possui um quadro comparativo entre as ferramentas disponíveis para acesso ao mainframe IBM (3270) na CEF. B.1 Ferramentas analisadas: 1. MyExtra 2. x h3270 B.2 Requisitos comparados: Esta seção descreve o critério utilizado em cada ítem de avaliação das ferramentas. Dividimos os itens utilizados para a análise das ferramentas em duas categorias, veja a seguir: 1. Quantitativos ˆ Custo da ferramenta - custo necessário para aquisição e uso da ferramenta. ˆ Licença de uso - tipo de licença de utilização (ex.: GPL, comercial, freeware, shareware). ˆ Suporte - onde pode se obter suporte técnico. ˆ Referência - endereço web para referências. ˆ Sistema Operacional - os sistemas operacionais em que a ferramenta pode ser utilizada. ˆ Memória utilizada - quantidade de memória RAM necessária. ˆ Espaço necessário - espaço em HD utilizado pela ferramenta. 2. Qualitativos ˆ Idioma Padrão - idioma padrão da ferramenta. ˆ Possibilidade de Tradução - facilidade de tradução da ferramenta para outro idioma. ˆ Criptografia - possibilidade de utilização de criptografia com a ferramenta. ˆ Mouse para direcionamento do cursor - possibiliade de utilização do mouse para movimentação do cursor na tela. ˆ Impressão de múltiplas telas - possibilidade de impressão de várias telas do sistema simultâneamente. ˆ Personalização das opções - possibilidade de implementação de novas funcionalidades à ferramenta, como: adicionar novos botões ou novos menus. ˆ Personalização da aparência - possibilidade de alteração e customização da aparência das telas da ferramenta. 10

11 B.3 Quadro comparativo Requisito MyExtra x3270 h3270 Custo da ferramenta n.d. gratuito gratuito Licença de uso comercial GPL GPL Suporte Técnico contrato listas de discussões listas de discussões Referência n.d. Sistema Operacional windows Linux, Mac OS X, Windows, Linux, Solaris e Cygwin Mac OS X, Solaris Memória Utilizada 8MB 0,4MB 2,6MB (nos clientes) e 0,1MB (por conexão ao servidor) Espaço Necessário 50MB 0,5MB 0MB nos clientes (necessário um browser) e 1,4MB no servidor (necessário Tomcat) Idioma Padrão português inglês inglês Possibiliadade necessário comprar alterações em apenas alterações em apenas de Tradução 1 arquivo 1 arquivo Criptografia SSL SSL SSL Mouse para direcio- sim sim sim namento do cursor Impressão de sim sim não (depende múltiplas telas do browser) Personalização não sim sim das opções (código fechado) Personalização da não não sim (é possível acrescentar aparência imagens à tela da ferramenta) Tabela 1: Requisitos x ferramentas B.4 Análise final Analisando o quadro comparativo da seção anterior e baseando em testes de usabilidade das ferramentas apresentadas, podemos verificar que a ferramenta h3270 apresenta-se como uma boa solução para o acesso ao terminal IBM Principalmente pelo fato de ser um software gratuito, poder ser utilizado nos sistemas operacionais: windows e linux e por não ter a necessidade de ser instalado nas estações. Porém, o fato de ser utilizada através de um browser restringe um pouco seu uso. A impressão de múltiplas telas fica condicionada ao browser e pelo menos até este momento não é conhecida nenhuma funcionalidade deste tipo para os browsers atuais. Como para os usuários da CEF essa funcionalidade é fundamental, devido ao grande dinamismo do trabalho e o elevado número de páginas que precisam ser impressas pelos funcionários da Caixa, a implantação do h3270 fica condicionada à implementação desta funcionalidade. 11

12 C Créditos Documento Instalação e uso do H3270 Direitos Autorais Reservados (c) Universidade Federal de Minas Gerais Departamento de Ciência da Computação Laboratório de Software Livre: Zeniel Juliano Neves Chaves - zeniel@dcc.ufmg.br Esta documentação é livre; você pode redistribuí-la e/ou modificá-la sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation; tanto na sua versão 2, como qualquer versão posterior (a seu critério). A distribuição desta documentação é feita na expectativa de que ela seja útil, porém, sem nenhuma garantia; nem mesmo a garantia implícita de comerciabilidade ou adequação a uma finalidade específica. Consulte a Licença Pública Geral do GNU para mais detalhes