IBM 32-bit SDK e Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.2

Guia do Usuário de Instalação e Configuração


Informações de Copyright

Nota: Antes de utilizar estas informações e o produto que elas suportam, certifique-se de ler as informações gerais em Avisos.

Esta edição do Guia do Usuário se aplica ao IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 1.4.2 e ao IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.2, e a todos os releases e modificações subseqüentes, até que seja indicado de outra forma em novas edições.

(c) Copyright Sun Microsystems, Inc. 1997, 2003, 901 San Antonio Rd., Palo Alto, CA 94303 USA. Todos os direitos reservados.

(c) Copyright International Business Machines Corporation, 1999, 2004. Todos os direitos reservados.

Direitos Restritos para Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation.

Prefácio

Este Guia do Usuário fornece informações sobre a instalação e a configuração do IBM(R) 32-bit SDK for Windows(R), Java(TM) 2 Technology Edition, Version 1.4.2 e do IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.2.

O SDK é suportado nos seguintes produtos:

As alterações técnicas para este Guia do Usuário 1.4.2, com exceção das alterações menores ou evidentes, como a atualização de "1.4.1" para "1.4.2", estão indicadas em vermelho ao visualizar o HTML ou em uma cópia impressa colorida e por barras verticais à esquerda das alterações.

Índice

Informações de Copyright
Prefácio
Antes de Instalar
Instalação (Interativa) Assistida
Juntando Pacotes Divididos
Instalando os Pacotes
Instalando os pacotes instaláveis SDK e Runtime Environment
Instalando o Runtime Environment como a Java Virtual Machine do Sistema
Instalando o Java Communications API
Instalação Não-assistida
Ativando o IBM Accessibility Bridge
Desinstalação
Desinstalando o Java Communications API
Desinstalando o Web Start
Após a Instalação
Obtendo o Número de Compilação e Versão IBM
Desativando o Suporte de Acessibilidade Java
O Compilador JIT (Just-In-Time)
Executando um Aplicativo Java
Informações para Usuários de Idiomas Europeus
Algum Comentário sobre este Guia do Usuário?
Avisos
Marcas Comerciais

Antes de Instalar

Antes de instalar o SDK ou o pacote Runtime Environment, você deve fazer o download do pacote de instalação pertinente.

Você pode fazer o download de um pacote maior simples ou de vários pacotes menores. Se você escolher a última opção, também será necessário fazer o download do utilitário Merge, para combinar as partes em um único arquivo.

Certifique-se de fazer o download de todos os pacotes para o mesmo diretório. Os pacotes e seus nomes de arquivo são listados em Instalação (Interativa) Assistida; não altere os nomes dos arquivos dos pacotes.

Antes de iniciar a instalação, certifique-se de que há espaço suficiente no diretório C:\WINDOWS\TEMP para uso durante a instalação. A quantidade de espaço temporário necessária no diretório TEMP durante a instalação é:

Se não existir espaço temporário suficiente, o programa de instalação gerará um erro e interromperá a instalação. Se você realmente tiver espaço temporário suficiente mas ainda visualizar esta mensagem, verifique se os pacotes que está tentando instalar foram transferidos completamente por download. Para fazer isto, compare os tamanhos dos arquivos de seus pacotes com os tamanhos dos arquivos mostrados nas páginas da Web utilizadas para download dos pacotes.

Instalação (Interativa) Assistida

Os pacotes que você pode instalar são:

Além disso, existe outro pacote que pode ser instalado:

Esse pacote é fornecido como um arquivo zip. Consulte a seção Instalando o Java Communications API para obter as instruções de instalação.

Outros pacotes são fornecidos como arquivos zip:

Juntando Pacotes Divididos

Se você transferir por download os pacotes dividos, será necessário utilizar o utilitário Merge para juntá-los novamente:

Para mesclar os arquivos manualmente, em um prompt de comandos, digite:

copy /b ibm-java2-sdk-amd64-142.ex1 + ibm-java2-sdk-amd64-142.ex2 + ibm-java2-sdk-amd64-142.ex3 ... ibm-java2-sdk-amd64-142.exe

Lembre-se de especificar todos os nomes de arquivo.

Instalando os Pacotes

Para instalar os pacotes:

  1. Ative o ibm-java2-sdk-amd64-142.exe (para o SDK) ou ibm-java2-jre- amd64-142.exe (para o Runtime Environment somente).
  2. Siga as instruções do assistente de instalação.

Instalando os pacotes instaláveis SDK e Runtime Environment

Se você transferiu por download o pacote SDK instalável, as opções a seguir serão exibidas no assistente de instalação:

Se você selecionar o SDK, o Runtime Environment também será instalado. O Runtime Environment é instalado por padrão no diretório C:\Program Files\IBM\Java142\jre.

Instalando o Runtime Environment como a Java Virtual Machine do Sistema

Durante a instalação do Runtime Environment (como parte do pacote instalável SDK ou a partir do pacote instalável Runtime Environment), o programa pergunta se você deseja instalar o Runtime Environment como a JVM (Java Virtual Machine) do sistema. Se você o instalar como a JVM do sistema, o programa de instalação copia os arquivos java.exe e javaw.exe no diretório do sistema Windows. Se existir atualmente uma versão do java.exe ou javaw.exe no diretório do sistema Windows, será solicitado que você substitua a versão existente pela versão atual. A instalação destes arquivos no diretório do sistema Windows torna esse Runtime Environment a JVM padrão do sistema. Além disso, a chave de registro "Current Version" é definida para corresponder a esta instalação.

Nota:
A instalação do Runtime Environment como a JVM do sistema copia SOMENTE o java.exe e javaw.exe para o diretório de sistema do Windows. Nenhum outro executável (como javac.exe ou appletviewer.exe) é copiado.

Instalando o Java Communications API

Antes de instalar o pacote Java Communications API, instale o Runtime Environment, seja como parte do pacote SDK ou a partir do pacote Runtime Environment.

Para instalar o Java Communications API:

  1. Coloque o arquivo zip do Java Communications API, ibm-javacomm-n142p-win32-x86.zip, no diretório onde o Runtime Environment está instalado. Se você instalou no diretório padrão, este é o diretório C:\Program Files\IBM\Java142\.

  2. Descompacte o arquivo. Os seguintes arquivos são extraídos, conforme mostrado:

    Por exemplo, se você aceitou o diretório padrão para a instalação do Runtime Environment, o arquivo comm.jar está no diretório C:\Program Files\IBM\Java142\jre\lib\ext.

    Se o arquivo for descompactado em outro diretório, os arquivos serão colocados na mesma estrutura de diretório; porém C:\Program Files\IBM\Java142\ é substituído pelo diretório onde você descompactou o arquivo.

Instalação Não-assistida

Para concluir uma instalação não-assistida, é necessário concluir primeiro uma instalação assistida e criar um arquivo de resposta (setup.iss) que registra as opções feitas durante a instalação. Para funcionar adequadamente, o arquivo de resposta criado precisa estar adequado aos computadores em que será utilizado. Se necessário, crie vários arquivos de resposta para instalação de pacotes em computadores que tenham diferentes configurações.

Para criar um arquivo de resposta durante a execução da instalação, digite o seguinte em um prompt de comandos:

    ibm-java2-sdk-142 /r

ou

    ibm-java2-jre-142 /r

Dependendo de seu produto Windows, um arquivo de resposta (setup.iss) é criado no diretório C:\Windows ou C:\Winnt, em que C: é a unidade de inicialização.

A seguinte mensagem poderá ser exibida durante uma instalação interativa:

   Outro Java Runtime Environment está atualmente
   instalado como o System JVM. Selecione Sim para
   substituir esta versão ou Não para sair desta
   instalação.

Se esta mensagem for exibida, selecione Não e saia da instalação. Vá para o diretório do sistema Windows e exclua os seguintes dois arquivos:

Após ter excluído os arquivos, reinicie a instalação interativa, utilizando o comando mostrado no início desta seção.

No sistema em que for executar a instalação não-assistida, copie o arquivo de resposta setup.iss no diretório C:\Windows ou C:\Winnt. Depois de copiar o arquivo para o diretório correto, digite o seguinte em um prompt de comandos:

    ibm-java2-sdk-142 /s /f1c:\Windows\setup.iss /f2c:\setup.log
    ibm-java2-jre-142 /s /f1c:\Windows\setup.iss /f2c:\setup.log

Notas:

  1. No comando mostrado, utilize o diretório C:\Windows ou C:\Winnt dependendo do seu produto Windows.
  2. Não há espaços após /f1 ou /f2.
  3. O sinalizador /f1 especifica o nome e a localização do arquivo de resposta. O sinalizador /f2 especifica o nome e a localização do arquivo de log.

Se a instalação for bem sucedida, o arquivo de log conterá ResultCode=0.

Ativando o IBM Accessibility Bridge

O IBM Accessibility Bridge inclui quatro arquivos que são colocados nos diretórios apropriados durante a instalação padrão do JRE 1.4.2. Esses arquivos e seus diretórios são:

Tabela 1. Arquivos do IBM Accessibility Bridge.
Arquivo Diretório
JawBridge.jar jre\lib\ext
JawBridge.dll jre\bin
Accessibility.properties jre\lib
jaccess.jar jre\lib\ext

O IBM Accessibility Bridge é instalado mas, por padrão, fica desativado. Para ativá-lo, exclua o sinal de número do início da seguinte linha no arquivo Accessibility.properties:

#assistive_technologies=JawBridge

Este Web site informa sobre os Utilitários de Acessibilidade:

http://java.sun.com/products/jfc/accessibility.html

Desinstalação

Para desinstalar o SDK, caso o tenha instalado utilizando a instalação assistida ou não-assistida:

  1. Clique duas vezes em Meu Computador no desktop do Windows.
  2. Clique duas vezes em Painel de Controle.
  3. Clique duas vezes em Adicionar ou Remover Programas.
  4. Clique em IBM 32-bit SDK for Java 2 v1.4.2 na lista, e depois clique em Alterar/Remover.
  5. Clique em OK.

Este procedimento removerá todos os pacotes instalados com o programa Installer. Ele não remove o pacote Java Communications API ou quaisquer arquivos adicionais que foram extraídos dos pacotes zip.

Nota: Poderão ser exibidas mensagens de aviso notificando que nem todos os arquivos, entradas de registros, ou ambos foram removidos. Isso ocorre devido ao Windows acreditar que determinados arquivos ainda estão em uso; esses arquivos, entradas de registro, ou ambos, serão removidos durante a próxima reinicialização.

Quando várias instalações entre o IBM 32-bit SDK for Windows, v1.4.2 e versões anteriores são mantidas, se você desinstalar a versão 1.3.1 ou anterior enquanto uma versão 1.4.2 ainda está instalada no sistema, o desinstalador da 1.3.1 removerá as seguintes chaves de registro, e todas as subchaves, que são exigidas pela versão 1.4.2:

A solução é desinstalar a versão anterior do IBM 32-bit SDK for Windows, v1.4.2 antes de instalar a versão 1.4.2. A reinstalação da versão 1.4.2 também reinstalará as chaves de registro exigidas. Esta restrição foi corrigida para 1.4.2 e todos os releases subseqüentes.

Desinstalando o Java Communications API

Para desinstalar o pacote Java Communications API, exclua os seguintes arquivos do diretório em que o Runtime Environment foi instalado:

Por padrão, o Runtime Environment é instalado no diretório C:\Program Files\IBM\Java142\.

Desinstalando o Web Start

Ao desinstalar o Web Start, todos os ícones de desktop do Windows que foram criados para ícones dos quais foi feito o download através do Web Start não serão removidos.

Após a Instalação

As seções a seguir fornecem informações básicas sobre a utilização do IBM 32-bit SDK for Windows, v1.4.2.

Obtendo o Número de Compilação e Versão IBM

Para obter o número de compilação e versão IBM, em um prompt de comandos, digite:

java -version

Desativando o Suporte de Acessibilidade Java

Você pode desativar ou ativar o suporte de Acessibilidade Java utilizando a variável de ambiente JAVA_ASSISTIVE. Para evitar que a JVM carregue o suporte de Acessibilidade Java, defina a variável de ambiente JAVA_ASSISTIVE para OFF. A desativação da variável de ambiente JAVA_ASSISTIVE é uma boa idéia se você estiver executando a JVM através do acesso de rede e não tiver nenhuma necessidade do suporte de Acessibilidade Java que a JVM carrega por padrão. A desativação da variável de ambiente JAVA_ASSISTIVE aumenta o desempenho de carregamento de aplicativos Java da JVM que não fornecem suporte de tecnologia assistida.

O Compilador JIT (Just-In-Time)

O compilador JIT (Just-In-Time) (jitc.dll) gera dinamicamente o código da máquina para seqüências de bytecode utilizadas com freqüência nos aplicativos e applets Java durante sua execução.

O SDK for Windows inclui o JIT (jitc.dll), que está ativado por padrão. É possível desativar o JIT para ajudar no isolamento de um problema com um aplicativo Java, um applet ou o próprio compilador.

Há duas maneiras de desativar o JIT:

Para ativar o JIT, em um prompt de comandos, digite:

    set JAVA_COMPILER=jitc

Para verificar se o JIT está ativado ou não, em um prompt de comandos, digite:

    java -version

Se o JIT estiver sendo utilizado, será exibida uma mensagem que inclui:

(JIT enabled: jitc)

Se o JIT não estiver sendo utilizado, será exibida uma mensagem que inclui:

(JIT disabled)

Executando um Aplicativo Java

Para executar um aplicativo Java, digite o seguinte em um prompt de comandos:

    java classname

em que classname é o nome do arquivo de classe Java (aplicativo Java) que você deseja executar.

Nota: Se você não instalar o Runtime Environment como a JVM do sistema, é necessário primeiro definir o caminho para incluir os diretórios apropriados. Para atualizar o caminho, digite o seguinte em um prompt de comandos:

    set path=javadir\bin;javadir\jre\bin

em que javadir é o diretório onde você instalou o Runtime Environment. Por padrão, este diretório é C:\Program Files\IBM\Java142\.

Se você estiver desenvolvendo aplicativos Java, consulte o Manual do Usuário SDK para obter informações mais detalhadas sobre a definição de PATH e CLASSPATH.

Informações para Usuários de Idiomas Europeus

No Windows, um processo tem duas páginas de códigos: a página de códigos Ansi (ou Windows) e a página de códigos OEM (ou DOS).

A janela de comandos normalmente utiliza a página de códigos OEM. O Java converte saída do console para a página de códigos da janela de comandos do qual o Java é iniciado. O comando javaw sempre utiliza a página de códigos Ansi. Você especifica a página de códigos para utilizar para a saída do console com a opção -Dconsole.encoding no comando java. Por exemplo, -Dconsole.encoding=Cp1252 faz com que todas as saídas do console estejam na página de códigos Windows Ansi Latin1 (1252).

Algum Comentário sobre este Guia do Usuário?

Caso tenha algum comentário sobre a utilidade, ou não, deste Guia do Usuário, gostaríamos de saber sua opinião por meio de um desses canais. Observe que esses canais não foram implementados para responder perguntas técnicas - os canais são apenas para comentários sobre a documentação. Envie seus comentários:

Letras Miúdas. Ao mandar uma mensagem para a IBM, o Cliente concorda que todas as informações contidas em sua mensagem, incluindo dados sobre feedback, como perguntas, comentários, sugestões ou informações similares, serão classificadas como não-confidenciais; a IBM não possui nenhuma obrigação de qualquer tipo em relação a tais informações e poderá reproduzir, utilizar, divulgar e distribuir as informações a terceiros sem nenhuma limitação. A IBM poderá usar todas as idéias, conceitos, conhecimentos ou técnicas contidas em tais informações para o fim que desejar, incluindo, mas não se limitando a desenvolvimento, fabricação e marketing de produtos incorporando tais informações.

Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. A IBM pode não oferecer os produtos, serviços ou recursos discutidos neste documento em outros países. Consulte seu representante da IBM local para obter informações sobre os produtos e serviços atualmente disponíveis em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM ou quaisquer outros direitos da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM é de inteira responsabilidade do Cliente.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:

Para pedidos de licenças com relação a informações sobre DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos, por escrito, para:

O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local:

A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS DE MERCADO OU DE ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar ao Cliente.

Estas informações podem incluir imprecisões técnicas ou erros tipográficos. Periodicamente, são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode fazer aperfeiçoamentos e/ou alterações nos produtos e/ou programas descritos nesta publicação, a qualquer momento, sem aviso prévio.

Referências nestas informações a Web sites não-IBM são fornecidas apenas por conveniência e não representam de forma alguma um endosso a esses Web sites. Os materiais contidos nesses Web sites não fazem parte dos materiais deste produto IBM e a utilização desses Web sites é de responsabilidade do usuário.

A IBM pode utilizar ou distribuir qualquer informação fornecida, da forma que julgar apropriada, sem que isso incorra em qualquer obrigação para com o Cliente.

Licenciados deste programa que pretendam obter mais informações sobre o mesmo com o objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:

Tais informações podem estar disponíveis, sujeitas a termos e condições apropriados, incluindo, em alguns casos, o pagamento de uma taxa.

O programa licenciado descrito neste documento e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com Cliente IBM, Contrato de Licença de Programa Internacional IBM ou qualquer contrato equivalente.

Todos os dados de desempenho aqui descritos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido tomadas em sistemas em fase de desenvolvimento e não há garantia de que tais medidas sejam as mesmas nos sistemas normalmente disponíveis. Além disso, algumas medições podem ter sido estimadas através de extrapolação. Os resultados reais podem variar. Os usuários deste documento devem verificar os dados que se aplicam ao seu ambiente específico.

As informações referentes a produtos não-IBM foram obtidas junto a fornecedores desses produtos, anúncios publicados ou outras fontes publicamente disponíveis. A IBM não testou esses produtos e não pode confirmar a precisão de desempenho, compatibilidade nem qualquer outra reivindicação relacionada a produtos não-IBM. Dúvidas sobre os recursos dos produtos não-IBM devem ser encaminhadas aos fornecedores dos respectivos produtos.

Marcas Comerciais

IBM é uma marca comercial da International Business Machines Corporation nos Estados Unidos e/ou em outros países.

IBM é uma marca comercial da International Business Machines Corporation nos Estados Unidos e/ou em outros países.

Java e todas as marcas comerciais e logotipos baseados em Java são marcas comerciais ou marcas comerciais registradas da Sun Microsystems, Inc., nos Estados Unidos e/ou em outros países.

Microsoft, Windows, Windows NT e o logotipo do Windows são marcas comerciais da Microsoft Corporation nos Estados Unidos e/ou em outros países.

Intel, Intel Inside (logotipos), MMX e Pentium são marcas comerciais registradas da Intel Corporation nos Estados Unidos e/ou em outros países.

Outros nomes de empresas, produtos ou serviços podem ser marcas comerciais ou marcas de serviço de terceiros.

Este produto também é baseado em parte do trabalho do Projeto FreeType. Para obter mais informações sobre o Freetype, consulte http://www.freetype.org.

Este produto inclui software desenvolvido pela Apache Software Foundation http://www.apache.org/.