Notas de Instalação do WebSphereTM Development Tools for iSeries V5.1

Estas notas de instalação se aplicam ao WebSphere Development Tools for iSeries V5.1. Esta versão foi projetada para ser instalada apenas em uma estação de trabalho PC com um dos sistema operacionais Windows listados abaixo. Esta versão do WebSphere Development Tools for iSeries está disponível apenas em CD e DVD.

O documento README contém as informações sobre os pré-requisitos, sobre as limitações do produtos e sobre as informações não incluídas na documentação.

O documento Notas do Release descreve componentes de produtos, necessidades de sistema detalhadas e cenários de migração, assim como as Notas de Release do VisualAge(R) for Java(TM) Versão 3.5.3 Enterprise Toolkit for AS/400(R).

Índice

Notas de Instalação

Notas sobre todos os Sistemas Operacionais Windows

Notas Gerais

VisualAge for Java for iSeries 3.5.3 está no CD disco 5 e pode ser instalado antes ou depois do restante do produto. Sugerimos instalar o VisualAge for Java primeiro, para que você tenha a opção de instalar o Enterprise Tookit for AS/400 (que requer o VisualAge for Java) com o restante do produto. Reinicialize a estação de trabalho após instalar o VisualAge for Java.

Um breve descrição do processo de instalação:

  1. Certifique-se de que sua estação de trabalho atenda aos requisitos descritos nas Notas do Release.
  2. Instale o VisualAge for Java for iSeries 3.5.3 (opcional) a partir do CD disco 5. Se for questionado sobre a instalação do Distributed Debugger, responda Não.
  3. Instale o WebSphere Development Tools for iSeries V5.1.
  4. Reiniciar a estação de trabalho.
  5. Após a instalação e a reinicialização, você terá a opção de iniciar o Assistente de Configuração do Host e do Servidor para configurar conexões com os servidores iSeries e para verificar se os servidores têm os License Program Products e Program temporary Fixes (PTFs) necessários.

Quando for perguntado se deseja reiniciar a máquina durante a instalação, clique em Sim, exceto após a instalação do MS JVM ou do S2JDK da IBM (se necessário).

O WebSphere Studio instala software que não tem uma assinatura digital da Microsoft. Quando a caixa de diálogo Assinatura Digital Não Encontrada perguntar " Deseja continuar a instalação?", clique em Sim.

O WebSphere Development Tools for iSeries V5.1 não pode ser instalado no Windows 95.

Suporte a Idiomas

O produto instala um idioma, de acordo com o locale do usuário. Se você alterar o locale após concluir a instalação, os componentes do produto e as telas de ajuda poderão não exibir o idioma correto. Para alterar os idiomas, desinstale completamente o produto, conforme descrito na seção Como desinstalar, altere o locale e, em seguida, instale o produto novamente.

Para exibir o Distributed Debugger em espanhol, certifique-se de que o locale de sua máquina esteja definido para espanhol (Tipo Tradicional) ou espanhol (Espanha) antes de instalar o produto.

Instalação Personalizada

A instalação personalizada permite a seleção dos componentes fornecidos por este produto. Alguns componentes devem ser selecionados, dependendo de outras seleções. A tabela abaixo mostra quais componentes têm dependências. As opções obrigatórias são selecionadas automaticamente. Por exemplo, se você selecionar WebFacing Tool, então CODE e AS/400 Toolbox for Java também são selecionados.
Este componenterequer estes componentes
A base para o WebSphere Development Tools sempre é instalada
VisualAge RPG
AS/400 Toolbox for Java
CODEAS/400 Toolbox for Java
Ferramenta WebFacingCODE
AS/400 Toolbox for Java
Enterprise Toolkit for AS/400VisualAge for Java for iSeries 3.5 ou posterior (instalado separadamente)
WebSphere Studio for iSeries
Distributed Debugger e NetQuestion são sempre instalados.
O NetQuestion fornece os recursos de pesquisa do sistema de ajuda.
O Distributed Debugger, que inclui Object Level Trace, pode depurar Java interpretado e compilado, assim como outras linguagens compiladas, como C++.

Programas Adicionais

Existem programas adicionais que talvez tenham de ser instalados, dependendo das suas seleções e daquilo que você já instalou em sua máquina. O assistente de instalação solicita um programa quando necessário.
Programa Incluído
com o produto
Reinicialização
necessária
Tipo de InstalaçãoComentários
MS JVM Sim Não Interativa - lançado a partir da instalação Precisa ser instalado para o Studio DTCs para funcionar corretamente, mas não precisa ser o JVM do sistema.
Um Java Development Kit J2SDK 1.2.2 da IBM Sim Não Interativa - lançado a partir da instalação Obrigatório para que todas as funções do CODE/400, do VARPG e do WebFacing Tool possam ser utilizadas. Consulte também o arquivo README Notas sobre o JDK.
JDK da Sun Não Não Instalação Manual Versão 1.2.x
Navegador da Web compatível com quadros Netscape Communicator Não, obtenha
com o fornecedor
Não Instalação Manual da versão 4.7 ou posterior Obrigatório se nenhum outro navegador for instalado
Microsoft Internet Explorer Não, obtenha
com o fornecedor
Sim Instalação manual da versão 4.0 ou posterior Obrigatório para algumas funções principais do Studio. Não é obrigatório se o Studio não estiver instalado. Versão 5.0 é requerido para WebFacing Tool e outros componentes. Para obter detalhes, consulte Necessidades de Software das Notas do Release.
Outras Não, obtenha
com o fornecedor
Depende do produto Instalação manual. A versão depende do produto. Outros navegadores não são suportados.

Notas de instalação sobre o Windows 98

Para assegurar que todos os componentes serão instalados e serão executados corretamente, faça a seguinte alteração:

Se você receber uma mensagem de erro indicando que o NetQuestion não pode ser instalado, o motivo é que a instrução PATH no arquivo autoexec.bat está com mais de 200 caracteres. Reduza a instrução PATH para corrigir este problema.

Quando o NetQuestion é desinstalado (desinstalando qualquer produto IBM que o utilize), o NetQuestion não remove sua entrada da instrução PATH. Desinstalações repetidas podem resultar em a instrução exceder de 200 caracteres. Reduza a instrução PATH para corrigir este problema.

Notas da Instalação sobre o Windows NT e o Windows 2000

Devido a uma alteração do Instalador da Microsoft na utilização de variáveis de ambiente no Windows NT e 2000, siga estas regras:

Observe que um Administrador precisa desinstalar o produto também.

Notas de Instalação sobre o Windows ME

Para assegurar que todos os componentes serão instalados e serão executados corretamente, faça a seguinte alteração:

  1. Utilize o Windows Explorer para localizar o arquivo command.com
  2. Clique com o botão direito para exibir uma lista suspensa
  3. Clique com o botão esquerdo em Propriedades para exibir a janela Propriedades de command.com
  4. Clique na guia Memória
  5. Altere o conteúdo da caixa Ambiente inicial para 32000
  6. Clique em OK
  7. Reinicialize a estação de trabalho antes de instalar o produto

Quando o NetQuestion é desinstalado (desinstalando qualquer produto IBM que o utilize), o NetQuestion não remove sua entrada da variável de sistema PATH. Desinstalações repetidas podem resultar em a cadeia da variável exceder de 200 caracteres. Reduza o PATH para corrigir este problema.


Como instalar a partir de um CD-ROM

Há cinco CD-ROMs. Os discos de 1 a 4 contêm o WebSphere Development Tools for iSeries. O Disco 5 contém o VisualAge for Java for iSeries 3.5.3. Após fechar a unidade de CD-ROM, aguarde o indicador da unidade se apagar antes de clicar em OK.

  1. (Opcional) Instale o VisualAge for Java for iSeries 3.5.3
    1. Insira o disco 5 na unidade de CD-ROM
    2. Se a instalação não iniciar automaticamente:
      1. Clique em Iniciar e em Executar
      2. Digite X:setup, onde X é a letra da unidade de CD-ROM
      3. Pressione Enter
    3. Siga as instruções de instalação.
    4. Reiniciar a estação de trabalho.
  2. Instale o WebSphere Development Tools for iSeries.
    1. Insira o disco 1 na unidade de CD-ROM
    2. Se a instalação não iniciar automaticamente:
      1. Clique em Iniciar e em Executar
      2. Digite X:setup, onde X é a letra da unidade de CD-ROM
      3. Pressione Enter
    3. Siga as instruções de instalação do WebSphere Development Tools for iSeries.
    4. Reiniciar a estação de trabalho.

Como instalar a partir de um DVD

  1. (Opcional) Instale o VisualAge for Java for iSeries 3.5.3
    1. Insira o disco 5 na unidade de DVD
    2. Se a instalação não iniciar automaticamente:
      1. Clique em Iniciar e em Executar
      2. Digite X:setup.exe, onde X é a letra da unidade de DVD
      3. Pressione Enter
    3. Siga as instruções de instalação.
    4. Reiniciar a estação de trabalho.
  2. Instale o WebSphere Development Tools for iSeries.
    1. Coloque o DVD na unidade de DVD.
    2. Se a instalação não iniciar automaticamente:
      1. Clique em Iniciar e em Executar
      2. Digite X:setup.exe, onde X é a letra da unidade de DVD
      3. Pressione Enter
    3. Siga as instruções de instalação do WebSphere Development Tools for iSeries.
    4. Reiniciar a estação de trabalho.

Como utilizar um arquivo de resposta

Um arquivo de resposta é um registro da localização e dos componentes de instalação que foram selecionados para uma instalação. Uma instalação em outra estação de trabalho que utilize um arquivo de resposta irá instalar o produto exatamente como a instalação que criou o arquivo de resposta o fez, sem telas nem diálogos. Consulte Nota abaixo para obter as exceções.

Para criar um arquivo de resposta, pressione o botão Criar Arquivo de Resposta, no assistente de Instalação. O caminho e nome padrão do arquivo de resposta é C:\Arquivos de programas\IBM\v5r1rspn.wdt. Você pode alterar o caminho e o nome do arquivo padrão.

Se você instalar utilizando um arquivo de resposta, outro arquivo de resposta não será criado. A utilização de um arquivo de resposta também significa que você aceitou o Contrato de Licença. Consulte a seção Informações Legais do documento README para obter a localização de seu Contrato de Licença.

Para usar o arquivo de resposta, digite o comando de instalação juntamente com os parâmetros, conforme mostrado neste exemplo:
setup -f "C:\Arquivos de programas\IBM\v5r1rspn.wdt", com a unidade e o caminho do arquivo de resposta entre aspas.

Se a instalação do arquivo de resposta terminar em erro, a mensagem de erro poderá ser encontrada no arquivo de log mais atual. Consulte Arquivo de Log na seção Resolução de Problemas.

Nota: A instalação que utilizar um arquivo de resposta não instalará o MS JVM nem o J2SDK da IBM, que são requeridos para vários componentes. Se esses programas ainda não estiverem instalados, então, instale-os manualmente antes de instalar o WebSphere Development Tools for iSeries. A MS JVM pode ser encontrada no disco 4 de CD ou DVD, no diretório \extras. Execute msjavx86.exe e reinicialize em seguida. Instale o IBM SDK 1.2.2 SR10a executando \extras\ibmsdk\install.exe e reinicialize em seguida.

Como colocar o produto em um servidor de rede local (LAN)

Um administrador ou usuário pode copiar todos os arquivos dos CDs ou do DVD para um servidor de rede local(LAN). Isto permite que o usuário instale a partir do servidor para uma estação de trabalho.

Para copiar de um CD para um servidor:

  1. Crie um diretório para armazenar arquivos do produto. São necessários pelo menos 1,3 GB.
  2. Insira o CD de instalação na unidade de CD-ROM. Certifique-se de que o programa de instalação não seja executado.
  3. Copie todos os arquivos do disco 1 para o diretório de armazenamento, através do seguinte comando:
    xcopy X:*.* y:\wdtimage /e /q em que X é a letra da unidade de CD-ROM e Y:\wdtimage é uma unidade e caminho de destino existentes.
  4. Copie todos os arquivos dos CDs 2 a 4 para o diretório de armazenamento, utilizando o comando acima.

Para copiar de um DVD para um servidor:

  1. Crie um diretório para armazenar arquivos do produto. São necessários pelo menos 1,3 GB.
  2. Insira o DVD de instalação na unidade de DVD-ROM. Certifique-se de que o programa de instalação não seja executado.
  3. Copie todos os arquivos do DVD para o diretório de armazenamento, através do seguinte comando:
    xcopy X:*.* y:\wdtimage /e /q em que X é a letra da unidade de DVD-ROM e Y:\wdtimage é uma unidade e caminho de destino existentes.

Como instalar a partir de um servidor de LAN para uma estação de trabalho

Após o produto ter sido copiado para um servidor de rede local (consulte a seção Como colocar o produto em um servidor LAN), ele poderá ser instalado em uma estação de trabalho, a partir do servidor. A instalação deve ser feita na estação de trabalho.
  1. Abra uma janela de Prompt de Comandos na estação de trabalho.
  2. Digite um comando net use para conectar-se à unidade do servidor LAN em que o produto foi copiado. Certifique-se de que pelo menos 1,3 GB estejam disponíveis na estação de trabalho.
  3. Se um arquivo de destino não for utilizado, digite o comando X:\wdtimage\setup (em que X é a unidade do servidor da rede local) e siga as instruções da instalação.
    Se um arquivo de resposta for utilizado, digite o comando de instalação com os parâmetros mostrados neste exemplo:
    X:\wdtimage\setup -f "C:\Program Files\IBM\wdtrspn.wdt" em que a unidade e caminho do arquivo de resposta se encontram entre aspas.

Como colocar o produto em um servidor iSeries

Um administrador ou usuário pode copiar todos os arquivos dos CDs ou do DVD para um servidor iSeries. Isto permite que o usuário instale a partir do servidor iSeries para uma estação de trabalho.

Para copiar CDs ou DVD para um servidor iSeries, execute as etapas a seguir:

  1. No servidor iSeries
    1. Certifique-se de que o Netserver esteja em execução. Inicie sessão no sistema iSeries e digite STRTCPSVR *NETSVR na linha de comandos.
    2. Crie um diretório para armazenar arquivos do produto. São necessários pelo menos 1,3 GB.
    3. Na linha de comandos, digite md install, onde "install" é o nome do diretório de armazenamento.
  2. Mapeie uma unidade de rede para o servidor iSeries
    1. Na estação de trabalho, inicie o Explorer, selecionando:
      • Iniciar-->Programas-->Windows NT Explorer, para o Windows NT
      • Iniciar-->Programas-->Window Explorer, para o Windows 98
      • Iniciar-->Programas-->Acessórios-->Window Explorer, para o Windows 2000 e o Windows ME
    2. Na janela do Explorer, selecione o item Ferramentas-->Mapear unidade de rede, para tornar visível a janela Mapear unidade de rede.
    3. Na janela Mapear unidade de rede:
      • Selecione uma unidade disponível no campo Unidade (M neste exemplo) e especifique \\iSeriesname\root no campo Caminho (no Windows NT, no Windows 98, e no Windows ME) ou no campo Pasta, no Windows 2000. "iSeriesname" pode também ser o endereço TCPIP do servidor iSeries.
      • Selecione Reconectar no logon, se desejar reconectar-se a essa unidade na próxima vez que reinicializar a estação de trabalho.
      • Clique em OK ou em Concluir. A unidade de rede para o servidor iSeries agora deve ser M.
  3. Copie os arquivos para o servidor iSeries:
    1. Insira o CD 1 de instalação na unidade de CD-ROM. Certifique-se de que o arquivo setup.exe não seja executado.
    2. Copie todos os arquivos do CD disco 1 para o diretório de armazenamento com o seguinte comando: xcopy X: *.* m:\install /e /q em que X é a letra da unidade de CD-ROM e m:\install é a unidade e caminho de destino no servidor iSeries.
    3. Copie todos os arquivos dos CDs 2 a 4 para o diretório de armazenamento, utilizando o comando acima.

Como instalar de um servidor iSeries para uma estação de trabalho

Após o produto ter sido copiado para um servidor iSeries (consulte a seçãoComo colocar o produto em um servidor iSeries), ele poderá ser instalado em uma estação de trabalho, a partir do servidor. A instalação deve ser feita na estação de trabalho.

  1. Mapeie a unidade de rede para a unidade do iSeries na qual o produto foi copiado. Consulte a seção Mapear uma unidade de rede para o servidor iSeries. Certifique-se de que pelo menos 1,3 GB estejam disponíveis na estação de trabalho.
  2. Clique duas vezes no diretório m:\install
  3. Clique duas vezes em setup.
  4. Siga as instruções de instalação.

Como desinstalar a partir de uma estação de trabalho

Para desinstalar totalmente o WebSphere Development Tools for iSeries, utilize Iniciar>Configurações>Painel de controle>Adicionar ou remover programas. Clique em IBM WDT400 V5R1M0 somente, em seguida, clique em Alterar/Remover no Windows 2000 e Adicionar/Remover em outros Sistemas Operacionais Windows para iniciar o assistente Modificar. Selecione o botão de opção Adicionar/remover. Não remova componentes individualmente através da exclusão de diretórios, porque isso não os remove corretamente. Sempre reinicialize a máquina após a desinstalação do produto.

No Windows NT e no Windows 2000, um usuário com autoridade de Administrador precisa desinstalar o produto.


Como adicionar ou remover componentes após a instalação

Para incluir ou remover componentes, utilize Iniciar>Configurações>Painel de controle>Adicionar/Remover Programas. Clique em IBM WDT400 V5R1M0 somente, em seguida, clique em Alterar/Remover no Windows 2000 e Adicionar/Remover em outros Sistemas Operacionais Windows para iniciar o assistente Modificar. Selecione o botão de opção Modificar produto para abrir o assistente de Modificação que permite selecionar componentes para inclusão ou remoção. Se você incluir componentes, irá precisar dos CD-ROMs, DVDs, unidade de rede local ou servidor iSeries de instalação originais. Sempre reinicialize a máquina após modificar o produto.

Quando a opção Modificar produto for selecionada, marcas de verificação controlam quais componentes são incluídos ou removidos. Inicialmente, os componentes que estão atualmente instalados são mostrados com marcas de verificação. Para incluir um componente que está faltando, certifique-se de que a caixa de opções esteja selecionada. Para remover um componente, desmarque sua caixa de opções. Ao terminar de selecionar, somente os componentes selecionados serão instalados, se necessário. Não remova uma marca de verificação se não quiser remover um componente que já esteja instalado.


Resolução de Problemas: Problemas e Soluções Alternativas

Se você tiver problemas com a instalação, verifique os pontos nas seguintes notas.
PontoComentários
Certifique-se de que a variável Path do ambiente não seja muito extensa. Isso é relevante para o Windows 98 e o ME. Consulte as notas de instalação do Windows 98 e do Windows ME.
Certifique-se de que você tenha espaço em disco temporário suficiente disponível. O processo de instalação utiliza espaço em disco nos diretórios especificados pelas variáveis de ambiente TEMP e TMP. Se uma mensagem "sem espaço temporário" ocorrer durante a instalação, altere as variáveis TEMP e TMP para que apontem para outra unidade que tenha espaço suficiente. A instalação pode exigir até 400 MB de armazenamento temporário. Reinicialize o Windows 98 e o ME para certificar-se de que a alteração tenha efeito.
Verifique as causas de uma longa instalação. Se a instalação não parecer estar progredindo:
  • As mensagens de instalação podem às vezes estar ocultas atrás de outras janelas e elas podem requerer uma resposta.
  • Se estiver instalando a partir de um servidor, determine se outras demandas do servidor estão deixando a instalação lenta.
Enterprise Toolkit for AS/400 não pode ser instalado sem o VisualAge for Java for iSeries. ET/400 requer o VAJava for iSeries. Instale o VAJava e depois o produto.
Se já tiver instalado o produto, inclua ET/400 com a opção Modificar da instalação descrita em Como incluir ou remover componentes após a instalação.
Todas as dependências do componente são descritas em Instalação Personalizada.
Se você clicar em Cancelar durante a instalação, então, determine quais componentes estão instalados. Se você clicar em Cancelar enquanto um componente estiver sendo instalado, então:
  • A instalação desse componente foi concluída, mas nenhum outro componente restante será instalado.
  • A Ajuda está incompleta e a navegação e pesquisa da ajuda não funcionam.
  • O IBM Distributed Debugger não está instalado.
Para instalar componentes que estão faltando, utilize o assistente Modificar descrito acima em Como incluir e remover componentes.
Se estiver removendo a instalação do VisualAge for Java for AS/400, que foi instalado quando o V4R5M1 foi instalado, uma mensagem de erro é gerada, em seguida, utilize o arquivo de limpeza. O arquivo de limpeza está no CD4 como \extras\cleanvaj.exe.
Verifique o arquivo de log da instalação. Cada instalação ou modificação do produto é registrada em um arquivo de log separado: C:\Program Files\IBM\V5R1_xxx.log, em que xxx é um número seqüencial de 001 em diante. Os arquivos de log têm informações sobre componentes instalados ou desinstalados e mensagens de erro. O arquivo de registro mais recente tem o número seqüencial mais alto.