IBM Rational Application Developer para Windows e Linux, Versão 6.0 : Guia de Instalação


Índice

Capítulo 1. Introdução

Capítulo 2. Requisitos de Instalação do Rational Application Developer

  • Requisitos de Hardware
  • Requisitos de Software
  • Sistemas Operacionais
  • Outros Requisitos de Software
  • Capítulo 3. IBM Rational Software Development Platform

    Capítulo 4. Instalando e Desinstalando o Rational Application Developer para Windows

  • Questões de Migração, Upgrade e Coexistência
  • Instalando a partir do CD-ROM
  • Instalando a partir de Imagens Eletrônicas
  • Criando uma Imagem de Instalação da Rede
  • Chamando uma Instalação Silenciosa
  • Configurando as Imagens Locais
  • Instalando Silenciosamente os Recursos Padrão no Diretório Padrão
  • Instalando Silenciosamente em um Diretório Diferente
  • Instalando Silenciosamente Recursos Adicionais do Rational Application Developer
  • Iniciando o Rational Application Developer
  • Desinstalando o Rational Application Developer
  • Desinstalando Silenciosamente o Rational Application Developer
  • Problemas e Limitações Conhecidos
  • Recuperando-se de uma Instalação Malsucedida
  • O WebSphere Application Server V6.0 Integrated Test Environment Falha ao Ser Instalado
  • Falha ao Desinstalar o WebSphere Application Server V6.0 Integrated Test Environment no Windows Server 2003
  • Cancelar a Instalação de um Produto Instalado por Mesclagem e, em seguida, Tentar a Instalação Novamente Pode Não Instalar o Produto Corretamente.
  • Capítulo 5. Instalando e Desinstalando o Rational Application Developer para Linux

  • Questões de Migração, Upgrade e Coexistência
  • Instalando a partir do CD-ROM
  • Instalando a partir de Imagens Eletrônicas
  • Criando uma Imagem de Instalação da Rede
  • Chamando uma Instalação Silenciosa
  • Configurando as Imagens Locais
  • Instalando Silenciosamente os Recursos Padrão no Diretório Padrão
  • Instalando Silenciosamente em um Diretório Diferente
  • Instalando Silenciosamente Recursos Adicionais do Rational Application Developer
  • Aumentando o Número de Manipulações de Arquivos Disponíveis
  • Iniciando o Rational Application Developer
  • Desinstalando o Rational Application Developer
  • Desinstalando Silenciosamente o Rational Application Developer
  • Problemas e Limitações Conhecidos
  • Limitações do Disco
  • O WebSphere Application Server V6.0 Integrated Test Environment Falha ao Ser Instalado
  • Cancelar a Instalação de um Produto Instalado por Mesclagem e, em seguida, Tentar a Instalação Novamente Pode Não Instalar o Produto Corretamente.
  • Capítulo 6. Instalando o Agent Controller

  • Pré-requisitos de Hardware
  • Plataformas Suportadas
  • JVMs Suportados
  • Localizando os Arquivos de Instalação
  • Instalando o Agent Controller em uma Estação de Trabalho (AIX, HP-UX, Linux, Windows, Solaris)
  • Desinstalando Versões Anteriores do Agent Controller
  • Instalando o Agent Controller
  • Instalando o Agent Controller de Forma Silenciosa
  • Iniciando e Parando o Agent Controller em uma Estação de Trabalho do Windows
  • Iniciando e Parando o Agent Controller em uma Estação de Trabalho Não- Windows
  • Desinstalando o Agent Controller em uma Estação de Trabalho do Windows
  • Desinstalando o Agent Controller de uma Estação de Trabalho Não- Windows
  • Instalando o Agent Controller no OS/400 (iSeries)
  • Desinstalando Versões Anteriores do Agent Controller
  • Instalando o Agent Controller
  • Iniciando e Parando o Agent Controller no OS/400 (iSeries)
  • Desinstalando o Agent Controller no OS/400 (iSeries)
  • Instalando o Agent Controller no OS/390 (z/OS)
  • Desinstalando Versões Anteriores do Agent Controller
  • Instalando o Agent Controller
  • Iniciando e Parando o Agent Controller no OS/390 (z/OS)
  • Desinstalando o Agent Controller no OS/390 (z/OS)
  • Utilizando o Recurso de Segurança do Agent Controller
  • Problemas e Limitações Conhecidos
  • O Agent Controller Pode Não Iniciar em Plataformas Não-Windows
  • Outros Erros Durante a Instalação e a Desinstalação
  • Capítulo 7. Configurando o Rational Application Developer para Funcionar em um Ambiente de Equipe

  • Software Suportado
  • IBM Rational ClearCase
  • IBM Rational ClearQuest
  • Instalando o Rational ClearCase LT
  • Efetuando Download do Rational ClearCase LT
  • Localizando as Notas sobre o Release e Instruções de Instalação
  • Instalando o Rational ClearCase LT
  • Configurando a Licença do Rational ClearCase LT
  • Utilizando o Rational ClearCase com o Rational Application Developer
  • Corrigindo Tipos de Elementos de Diagramas Pré-existentes
  • Desinstalando o Rational ClearCase LT
  • Capítulo 8. Instalando o WebSphere Application Server 5.x como um Ambiente de Teste Integrado

    Capítulo 9. Instalando o Suporte ao Sistema de Mensagens e Enfileiramento para os Ambientes de Teste do WebSphere Versão 5.x

  • Instalando e Desinstalando o Suporte ao Sistema de Mensagens e Enfileiramento no Windows
  • Instalando a partir do CD-ROM
  • Desinstalando o Suporte a Sistema de Mensagens e Enfileiramento
  • Instalando e Desinstalando o Suporte ao Sistema de Mensagens e Enfileiramento no Linux
  • Instalando o Suporte a Sistema de Mensagens e Enfileiramento
  • Desinstalando o Suporte a Sistema de Mensagens e Enfileiramento
  • Capítulo 10. Instalando o WebSphere Portal Test Environment Versão 5.0

    Capítulo 11. Instalando o WebSphere Portal Test Environment Versão 5.1

    Capítulo 12. Instalando o Crystal Enterprise

    Capítulo 13. Instalando Atualizações

    Capítulo 14. Copyright e Avisos


    Capítulo 1. Introdução

    Esse guia de instalação fornece instruções para instalação e desinstalação do Rational Application Developer, recursos opcionais e produtos adicionais fornecidos com o Rational Application Developer.

    Consulte o Guia de Migração para obter informações sobre como migrar do WebSphere Studio.

    Consulte o arquivo leia-me para obter informações sobre os problemas e as limitações do produto.

    Consulte http://www.ibm.com/developerworks/rational para obter a documentação atualizada e informações sobre resolução de problemas.


    Capítulo 2. Requisitos de Instalação do Rational Application Developer


    Requisitos de Hardware

    O hardware a seguir deve ser instalado antes do Rational Application Developer:


    Requisitos de Software

    Sistemas Operacionais

    O software a seguir deve ser instalado antes do Rational Application Developer:

    Outros Requisitos de Software


    Capítulo 3. IBM Rational Software Development Platform

    O IBM Rational Software Development Platform é um ambiente de desenvolvimento comum compartilhado pelos seguintes produtos:

    Se você instalar algum desses produtos, o Rational Software Development Platform é automaticamente instalado como parte do produto. Se você possui mais de um desses produtos instalados, a plataforma de desenvolvimento será instalada apenas uma vez. Todos esses produtos têm a mesma interface com o usuário, chamada workbench e cada produto inclui funcionalidade no workbench através da contribuição de plug-ins. Um plug-in é um módulo do software que inclui a função em um programa ou aplicativo existente.

    Ativando Produtos de Software Rational Instalados Juntos no Windows

    Quando você abrir o menu Iniciar, o menu de nível superior, independentemente de qual produto foi instalado, sempre será IBM Rational.

    Dependendo de quantos produtos foram instalados, você terá uma ou mais subpastas (um para cada produto) disponível no menu de nível superior. Se, por exemplo, você tiver o Rational Functional Tester e o Rational Application Developer instalados, existirá uma subpasta para cada um deles. Essas subpastas conterão links para informações específicas do produto (como arquivos leia-me), bem como um ponto de ativação para a interface com o usuário. O ponto de ativação terá o nome do produto (como Rational Application Developer), mas ativará realmente a interface com o usuário comum.

    Você também pode ativar a interface com o usuário comum, clicando na opção Rational Software Development Platform, sob o menu IBM Rational.

    Ativando Produtos de Software Rational Instalados Juntos no Linux

    Quando você está trabalhando no Red Hat Enterprise Linux, os pontos de ativação do produto estão localizados no menu principal em Programação. O ponto de ativação com o nome do produto (como Rational Application Developer) e o ponto de ativação do Rational Software Development Platform ativarão a interface com o usuário comum. Para localizar informações específicas do produto (por exemplo, arquivos leia-me), navegue para o diretório específico do produto (como rad_prod para Rational Application Developer) no qual você instalou o Rational Software Development Platform.

    Quando você está trabalhando no SLES (SuSE Linux Enterprise Server), os pontos de ativação do produto estão localizados no menu principal no IBM Rational. O ponto de ativação com o nome do produto (como Rational Application Developer) e o ponto de ativação do Rational Software Development Platform ativarão a interface com o usuário comum. Para localizar informações específicas do produto (por exemplo, arquivos leia-me), navegue para o diretório específico do produto (como diretório rad_prod para Rational Application Developer) no qual você instalou o Rational Software Development Platform.

    Migração e Coexistência

    O gráfico a seguir ilustra o que ocorre quando você tenta instalar mais de um produto, comum para o Rational Software Development Platform, na mesma máquina. (No gráfico a seguir, o eixo vertical representa produtos já instalados, enquanto o eixo horizontal representa produtos que você está tentando instalar):

    Tentar Instalar Rational Software Modeler Rational Web Developer Rational Application Developer Rational Software Architect Rational Functional Tester Rational Performance Tester
    Rational Software Modeler N/D Compartilhar Compartilhar Fazer Upgrade Compartilhar Compartilhar
    Rational Web Developer Compartilhar N/D Fazer Upgrade Fazer Upgrade Compartilhar Compartilhar
    Rational Application Developer Compartilhar Bloquear N/D Fazer Upgrade Compartilhar Compartilhar
    Rational Software Architect Bloquear Bloquear Bloquear N/D Compartilhar Compartilhar
    Rational Functional Tester Compartilhar Compartilhar Compartilhar Compartilhar N/D Compartilhar
    Rational Performance Tester Compartilhar Compartilhar Compartilhar Compartilhar Compartilhar N/D

    Definições:

    Desinstalação

    Nota:
    A interface com o usuário será instalada no diretório de instalação do primeiro produto com base no Rational Software Development Platform que você instalar. Ela não é reinstalada com nenhum outro produto, desta forma, se você fizer upgrade do primeiro produto, não será necessário remover o primeiro diretório de instalação após a conclusão do upgrade, pois ele ainda contém o conteúdo da interface com o usuário.

    Capítulo 4. Instalando e Desinstalando o Rational Application Developer para Windows

    Esta seção contém informações sobre a instalação do Rational Application Developer no Windows. É possível instalar o Rational Application Developer a partir do CD-ROM ou de imagens eletrônicas transferidas por download. Um assistente de instalação é fornecido, mas você também pode instalar o Rational Application Developer a partir de um prompt de comandos ou executar uma instalação silenciosa, conforme esboçado posteriormente nesta documentação.

    O programa de instalação também pode ser executado em um modo de console interativo, que pode ser mais adequado para pessoas com necessidades de acessibilidade. A opção de linha de comandos do Modo de Acessibilidade:

    -accessibility

    torna o assistente de modo do console de tempo de execução mais simples e fácil para programas de leitor de tela. Para executar em modo de console, execute este comando no diretório \setup do primeiro CD de instalação do Rational Application Developer:

    setup.exe -is:javaconsole -log @NONE -accessibility
    

    Siga os prompts para concluir a instalação. Observe que a opção -is:javaconsole é crítica ao especificar a opção -accessibility . Se você não especificar essa opção, o programa de instalação será interrompido. A opção -log @NONE desativa o log para eliminar as informações de log que estão sendo listadas na janela do prompt de comandos. Caso ocorra algum problema durante a instalação, é possível que você deseje eliminar esta opção para coletar informações de log.


    Questões de Migração, Upgrade e Coexistência

    Não é possível migrar do WebSphere Studio Site Developer ou do WebSphere Studio Application Developer v4.x.x. ou 5.0.x para o Rational Application Developer. O Rational Application Developer pode, no entanto, coexistir com um desses produtos. Se desejar, você poderá migrar manualmente os espaços de trabalho, artefatos e projetos do Rational ClearCase, Clear Case LT e CVS para o Rational Application Developer

    É possível migrar do WebSphere Studio 5.1.x para o Rational Application Developer ou você pode optar por coexistir. Consulte o Guia de Migração para Rational Application Developer obter informações adicionais de migração.

    Consulte Capítulo 3, "IBM Rational Software Development Platform" para obter informações adicionais sobre o IBM Rational Software Development Platform e a coexistência entre os produtos com base nessa plataforma de desenvolvimento.

    Se você tiver uma versão anterior do Agent Controller ou de qualquer outro software derivado do Hyades Data Collection Engine, pare-o, desinstale-o e limpe os arquivos remanescentes antes de instalar esta versão do Agent Controller. Para obter informações adicionais, consulte Capítulo 6, "Instalando o Agent Controller"


    Instalando a partir do CD-ROM

    Antes de instalar o produto, verifique o seguinte:

    Para instalar o Rational Application Developer a partir do primeiro CD de instalação do produto, siga estas etapas:

    1. Leia "Questões de Migração, Upgrade e Coexistência" antes de iniciar o procedimento de instalação.
    2. Assegure-se de que o ID do usuário que está sendo utilizado não contenha caracteres de byte duplo.
    3. Insira o CD na unidade de CD.
    4. Se a execução automática estiver ativada em seu sistema, o programa da barra de lançamento da instalação é aberto automaticamente. Se a execução automática estiver desativada em seu sistema, execute launchpad.exe na raiz do primeiro CD de instalação para exibir a janela Rational Application Developer Launchpad de Instalação.

      Dicas:

    5. A partir da barra de lançamento de instalação do Rational Application Developer, selecione Instalar o IBM Rational Application Developer V6.0.
    6. Aguarde o assistente de instalação abrir e, em seguida, clique em Next (Avançar) para continuar a instalação.
    7. Siga as instruções na tela para as tarefas, tais como, leitura do contrato de licença e especificação do diretório de instalação de destino.
    8. Na janela Recursos, você pode selecionar os recursos do Rational Application Developer que você gostaria de instalar. É possível retornar ao assistente de instalação e instalar os recursos opcionais posteriormente.
      1. Por padrão, o programa de instalação instala o Integrated Development Environment e o WebSphere Application Server, Versão 6.0, opcional como o ambiente de tempo de execução para teste.
      2. Se desejar instalar a interface com o usuário e a documentação para idiomas nacionais suportados diferentes do inglês, selecione para instalar o Language Pack. Por padrão, este recurso não é selecionado se o locale de seu sistema for do idioma inglês. Ele será selecionado se o locale de seu sistema for um dos outros idiomas nacionais suportados.

        Os idiomas nacionais suportados são português do Brasil, francês, alemão, italiano, japonês, coreano, chinês simplificado, espanhol e chinês tradicional.

        Nota: Se você optar por instalar o recurso Language Pack opcional e, em seguida, cancelar a instalação enquanto os arquivos estão sendo copiados, instalações subseqüentes mostrarão algumas anomalias. Em uma instalação subseqüente, o recurso Language Pack mostrará um status (instalado) no painel Recurso, mesmo que os arquivos que compõem o pacote de idiomas não estejam instalados. Você pode selecionar para reinstalar o recurso Language Pack e os arquivos adequados serão copiados para seu disco. Nesta situação, ao final da instalação você pode receber uma mensagem indicando que Ocorreram um ou mais erros durante a substituição dos arquivos. Você pode ignorar seguramente essa mensagem de erro.

      3. Por padrão, o recurso EGL (Enterprise Generation Language) não é instalado. O EGL é uma linguagem poderosa de alto nível para criar aplicativos de negócios complexos. Ele manipula as complexidades das tecnologias subjacentes (como o acesso ao banco de dados, as filas de mensagens e o J2EE) para que os desenvolvedores de aplicativos possam se concentrar em sua lógica de negócios. Para instalar o plug-in do EGL, selecione a caixa de opções EGL (Enterprise Generation Language).
      4. Por padrão, o recurso Portal Tools não é instalado. Para instalar o recurso Portal Tools, selecione a caixa de opções Portal Tools.
      5. Por padrão, os exemplos para o desenvolvimento do plug-in Eclipse não são instalados. Esses exemplos são para desenvolvedores que queiram estender o workbench, criando suas próprias ferramentas de plug-in. Para instalar os exemplos para o desenvolvimento do plug-in Eclipse, selecione a caixa de opções Examples for Eclipse Plug-In Development (Exemplos do Eclipse Plug-In Development).
    9. Clique em Next (Avançar) para exibir informações de resumo da instalação do Rational Application Developer.

      Nota:
      O requisito de espaço em disco mostrado é o número total de bytes necessários para todos os arquivos. O espaço em disco real necessário pode ser consideravelmente maior. Particularmente, se seu disco estiver formatado como FAT32, os diversos arquivos menores poderão utilizar o espaço em disco de forma ineficiente devido à estrutura de bloco de disco que o FAT32 utiliza.
    10. Clique em Next (Avançar) para instalar o Rational Application Developer.
    11. Se receber um aviso sobre um problema com o registro da licença no final da instalação, siga estas etapas:
      1. Vá para o subdiretório \logs no seu diretório de instalação.
      2. Abra license.log com um editor de texto.
      3. Se license.log contiver uma das linhas seguintes:
        486604803  O pedido de licença expirou
        486604805 As datas de início para todas as licenças ainda não ocorreram
        
        assegure que o relógio do sistema esteja definido corretamente e, em seguida, inicie o Rational Application Developer.
    12. O programa de instalação demora um pouco para configurar o ambiente de desenvolvimento e inicializar o Eclipse. Eventualmente, você verá uma mensagem confirmando a conclusão da instalação. Clique em Next (Avançar) para concluir a instalação.
    13. A próxima tela fornecerá a opção para ativar a instalação do Agent Controller. Antes de utilizar os recursos de gerenciamento de perfis, análise de tempo de execução e log do Rational Application Developer, você deve instalar o Agent Controller. Consulte Capítulo 6, "Instalando o Agent Controller" para obter detalhes. Desmarque a opção se você não desejar instalar o Agent Controller neste momento.

      A tela também contém uma mensagem recomendando a você para verificar atualizações para seus recursos instalados, utilizando o Rational Product Updater. (Consulte Capítulo 13, "Instalando Atualizações" para obter informações adicionais). Clique em Finish (Concluir) para fechar a janela de instalação.

    14. Se você planeja desenvolver aplicativos que serão executados em outros servidores de aplicativos, poderá selecionar, opcionalmente, a instalação de ambientes de teste de tempo de execução adicionais com o Rational Application Developer.Para obter informações adicionais, consulte Capítulo 8, "Instalando o WebSphere Application Server 5.x como um Ambiente de Teste Integrado"
    15. Antes de poder utilizar a definição de perfis, a análise do tempo de execução e os recursos de log do Rational Application Developer para coletar dados remotamente, você deve instalar o Agent Controller no host local e no remoto. Consulte Capítulo 6, "Instalando o Agent Controller" para obter detalhes.
    16. Se você desejar testar aplicativos de sistema de mensagens e de serviços da Web no WebSphere Application Server Versão 6.0, o suporte para o fornecedor de sistema de mensagens padrão fica automaticamente disponível e o suporte a clientes e servidores do sistema de mensagens incorporado não deve ser instalado. Entretanto, se você desejar utilizar o ambiente de teste do WebSphere Versão 5.x, deverá instalar separadamente o recurso de cliente e servidor do sistema de mensagens incorporado. Para obter informações adicionais, consulte Capítulo 9, "Instalando o Suporte ao Sistema de Mensagens e Enfileiramento para os Ambientes de Teste do WebSphere Versão 5.x".

      Importante: Se MQSeries já estiver instalado, não instale o cliente e o servidor de sistema de mensagens e enfileiramento, como se fossem um subconjunto das funções MQSeries.

    17. Se planeja utilizar o Rational ClearCase como seu sistema SCM (Software Configuration Management), poderá instalar o recurso Rational ClearCase LT agora ou mais tarde. Para obter informações adicionais sobre o Rational ClearCase, consulte o Capítulo 7, "Configurando o Rational Application Developer para Funcionar em um Ambiente de Equipe".
    18. Se você planeja instalar o Portal Test Environment V5.0, isso poderá ser feito depois de ter instalado o Rational Application Developer. Para obter informações adicionais, consulte Capítulo 10, "Instalando o WebSphere Portal Test Environment Versão 5.0".
    19. Crystal Enterprise é uma infra-estrutura para acesso e relatório de dados desenvolvida para integrar-se com investimentos de dados, da Web e de aplicativos existentes. É baseado no Crystal Reports. O Rational Application Developer inclui o Crystal Enterprise Embedded Edition e o Crystal Enterprise Professional Edition, o qual é um superconjunto da Embedded Edition. Para obter informações adicionais sobre como instalá-los, consulte Capítulo 12, "Instalando o Crystal Enterprise".

    Nota:

    Instalando a partir de Imagens Eletrônicas

    Consulte o arquivo leia-me do produto para obter uma descrição das imagens eletrônicas que precisam ser transferidas por download.

    Antes de instalar o produto, verifique o seguinte:

    Para fazer download e criar a imagem de instalação eletrônica:

    1. Faça download de todas as partes requeridas e das partes opcionais desejadas no mesmo diretório temporário. Se alguma parte opcional for necessária posteriormente, faça download das partes opcionais adicionais e reexecute a ferramenta de extração antes de tentar a instalação.
      Nota:
      Quando fizer upgrade do produto Rational Software Development Platform para outro, utilizando as imagens eletrônicas, assegure-se de fazer download e extrair o mesmo conjunto de imagens para o novo produto que fez download e extraiu para o produto original. Os mesmos componentes instalados no produto original serão instalados automaticamente no produto atualizado.

      Por exemplo, se o Pacote de Idiomas foi instalado originalmente, quando fizer upgrade precisará fazer o seu download e extrai-lo para a nova imagem de instalação do produto.

    2. Ative o arquivo extractor.exe localizado no diretório temporário. Esta ação inicia o assistente que cria a imagem de instalação.
    3. Siga as instruções do assistente para especificar onde deseja criar a imagem e quais recursos deseja incluir.
    4. Depois da imagem ser criada, se quiser instalar o produto imediatamente, clique em Finish (Concluir). Como alternativa, você pode limpar a caixa de opções Start the installation wizard (Iniciar o Assistente para Instalação) e executar o programa de instalação posteriormente, ativando disk1\launchpad.exe a partir do diretório onde a imagem de instalação foi criada.
    5. Siga as instruções descritas na seção "Instalando a partir do CD-ROM".

    Criando uma Imagem de Instalação da Rede

    Você pode colocar uma cópia da imagem de instalação em uma unidade de rede para que os usuários possam fazer a instalação por uma rede.

    Para executar o programa de instalação a partir de uma unidade de rede, você deve trabalhar com uma imagem eletrônica transferida por download do Rational Application Developer ou copiar o conteúdo dos CDs, conforme descrito a seguir.

    Você precisa de aproximadamente 6 GB de espaço em disco para armazenar o conteúdo do CD no disco. Para copiar os arquivos a partir dos CDs:

    1. Insira o primeiro CD de instalação do Rational Application Developer em sua unidade de CD.
    2. Crie um diretório temporário em uma unidade de rede na qual você deseja armazenar a imagem (por exemplo, network_drive:\install_image).
    3. No diretório temporário, crie um subdiretório denominado disk1. Esse subdiretório deve se chamar disk1 e deve estar em letras minúsculas.
    4. Copie todos os arquivos e diretórios no primeiro CD de instalação para o subdiretório disk1 no diretório temporário.
    5. Repita as etapas 3 e 4 para copiar o conteúdo dos outros dois CDs para subdiretórios chamados disk2 e disk3.

    Esses são todo os arquivos da instalação principal. Se quiser os arquivos de instalação para qualquer um dos recursos opcionais:

    1. Controlador do Agente
    2. Servidor e cliente do sistema de mensagens incorporado
    3. Rational ClearCase LT
    4. Ambientes de teste do WebSphere V5.x
    5. WebSphere Portal test environment V5.0
    6. Crystal Enterprise V10 Professional Edition
    7. Crystal Enterprise V10 Embedded Edition

    copie o conteúdo dos CDs apropriados para o diretório temporário.

    Notas:


    Chamando uma Instalação Silenciosa

    O programa de instalação do Rational Application Developer pode ser executado silenciosamente se você não desejar interagir com o assistente de instalação.

    Configurando as Imagens Locais

    Antes de instalar silenciosamente o Rational Application Developer, você deverá configurar as imagens locais:

    1. Leia "Questões de Migração, Upgrade e Coexistência" antes de iniciar o procedimento de instalação.
    2. Assegure-se de que o ID do usuário que está sendo utilizado não contenha caracteres de byte duplo.
    3. Crie uma imagem de instalação local ou de rede, conforme descrito em "Criando uma Imagem de Instalação da Rede". Se você desejar instalar apenas o Rational Application Developer, precisará copiar apenas as informações dos três primeiros CDs.

    Instalando Silenciosamente os Recursos Padrão no Diretório Padrão

    Os recursos a seguir são instalados por padrão ao instalar silenciosamente o Rational Application Developer:

    Para instalar o Rational Application Developer silenciosamente apenas com os recursos selecionados padrão para o diretório padrão system_drive:\Program Files\IBM\Rational\SDP\6.0 :

    1. Copie as imagens, conforme descrito em "Configurando as Imagens Locais", se ainda não tiver feito isso.
    2. Na linha de comandos, altere para o diretório \disk1\setup no diretório temporário (por exemplo, network_drive:\install_image\disk1\setup) que você criou em uma seção anterior.
    3. Execute o seguinte comando:
      setup.exe -silent 
      
    4. A conclusão da instalação silenciosa do Rational Application Developer pode demorar um pouco.Para determinar a conclusão da instalação, você pode monitorar o diretório \logs no diretório de instalação padrão periodicamente. Se o arquivo license.log aparecer, a instalação silenciosa foi concluída.

    Instalando Silenciosamente em um Diretório Diferente

    Alterando o parâmetro installLocation, é possível instalar o Rational Application Developer em um diretório diferente. Por exemplo, se quiser que "d:\my softdev" seja o diretório de instalação, siga as mesmas etapas que acabam de ser descritas, mas execute o seguinte comando:

    setup.exe -silent -P installLocation="d:\my softdev"
    

    (Neste exemplo, são instalados apenas os recursos padrão).

    Instalando Silenciosamente Recursos Adicionais do Rational Application Developer

    O Rational Application Developer fornece um arquivo de resposta de amostra que instala silenciosamente todos os recursos padrão. Esse arquivo de resposta chama-se responsefile.txt e está localizado no diretório \disk1\util. Se você deseja alterar o arquivo de resposta para instalar outros recursos, recomenda-se que se faça primeiro uma cópia de backup do responsefile.txt.

    É possível atualizar o arquivo de resposta para instalar um ou mais recursos opcionais do Rational Application Developer. A tabela a seguir mostra as opções do arquivo de resposta e suas entradas correspondentes no arquivo de resposta.

    Tabela 1. Lista de Opções do Arquivo de Resposta.

    Recurso Entrada do Arquivo de Resposta
    Diretório de Instalação do Produto installLocation
    WebSphere Application Server Versão 6.0 feature_was6_win32.active
    Language Pack feature_lang_pack_rad_win32.active
    EGL (Enterprise Generation Language) feature_egl_win32.active
    Portal Tools feature_portal_win32.active
    Exemplos do Eclipse Plug-in Development feature_examples_win32.active

    Para instalar silenciosamente qualquer um dos recursos opcionais:

    1. Copie responsefile.txt em um novo arquivo, por exemplo myresponsefile.txt.
    2. Edite sua cópia do arquivo de resposta.
    3. Localize a linha que contém o nome do recurso de instalação mostrado na tabela anterior. Por exemplo, se quiser instalar os exemplos para desenvolvimento do plug-in Eclipse, localize a seguinte linha no arquivo de resposta:# -P feature_examples_win32.active=<value>.
    4. Faça as seguintes alterações nesta linha:
      1. Remova # na primeira coluna.
      2. Altere <valor> para true.

      Neste exemplo, essa linha seria alterada para:

         -P feature_examples_win32.active=true
      
    5. Salve as alterações.
    6. Copie as imagens, conforme descrito em "Configurando as Imagens Locais", se ainda não tiver feito isso.
    7. Na linha de comandos, altere para o diretório \disk1\setup no diretório temporário (por exemplo, network_drive:\install_image\disk1\setup) que você criou em uma seção anterior.
    8. Quando executar um arquivo de resposta, adicione o parâmetro -options e o nome completo dele como demonstrado a seguir:
      setup.exe -silent -options "Your_directory\myresponsefile.txt"
      

      em que Your_directory é o nome completo do diretório onde seu arquivo de resposta reside.

      Nota:
      Para verificar se o arquivo de resposta está sendo utilizado, execute primeiro esse comando (isto é, antes de executar uma instalação silenciosa) se a opção -silent e verifique se suas configurações estão sendo registradas no assistente de instalação. Se não estiverem, há um problema com as configurações do arquivo de resposta ou da sintaxe de comando.
    9. A conclusão da instalação silenciosa do Rational Application Developer pode demorar um pouco.Para determinar a conclusão da instalação, você pode monitorar o subdiretório \logs em seu diretório de instalação periodicamente. Se o arquivo license.log aparecer, a instalação silenciosa foi concluída.

    Iniciando o Rational Application Developer

    Para iniciar o Rational Application Developer:

    1. Selecione Iniciar > Programas > IBM Rational >IBM Rational Application Developer 6.0 > Rational Application Developer.Você também pode selecionar Iniciar > Programa > IBM Rational > Rational Software Development Platform para iniciar o produto.
    2. Na primeira vez que você iniciar o Rational Application Developer, uma caixa de diálogo será aberta com o diretório workspace padrão já especificado. Por padrão, seu trabalho é armazenado em um diretório denominado workspace, localizado em C:\Documentos e Configurações\youruserid\IBM\rationalsdp6.0. Se você desejar salvar seu trabalho em outro lugar, poderá alterar o nome e o local do espaço de trabalho.
    3. Por padrão, a caixa de opções Use this as the default and do not ask again (Utilizar este como padrão e não perguntar novamente) está desmarcada. Se você mantiver o valor padrão, uma caixa de diálogo será aberta toda vez que o Rational Application Developer for iniciado, permitindo comutar espaços de trabalho. Você poderá manter esse valor padrão se, por exemplo, optar por manter diferentes espaços de trabalho para diferentes projetos.

      Dica: Se a caixa de opções Utilizar como padrão e não perguntar novamente estiver selecionada, a caixa de diálogo não abrirá novamente e o Rational Application Developer será iniciado utilizando o espaço de trabalho da sessão anterior.Você poderá alterar o valor padrão depois de iniciar o produto na página Window (Janela) > Preferences (Preferências) > Workbench > Startup and Shutdown (Inicialização e Encerramento).

    4. Clique em OK. Haverá um atraso ocasional durante a criação da estrutura da área de trabalho.

    O workbench primeiro abre várias páginas de boas-vindas que fornecem uma visão geral do produto e informações sobre o que há de novo, além de links para tutoriais, amostras e recursos da Web externos. Utilize algum tempo para explorar essas opções. Observe também as fontes de informações disponíveis no menu Help (Ajuda).


    Desinstalando o Rational Application Developer

    Para desinstalar o Rational Application Developer:

    1. Feche o Rational Application Developer.
    2. Abra o Painel de Controle, em seguida, abra a janela Adicionar ou Remover Programas. Selecione IBM Rational Application Developer 6.0 e clique em Change/Remove (Alterar/Remover) para desinstalar.
    3. Todos os arquivos em quaisquer diretórios de plug-ins ou de recursos são automaticamente excluídos, inclusive dados do usuário e plug-ins de terceiros que residam em algum desses diretórios. O diretório do espaço de trabalho, que contém seu trabalho, não é excluído. Alguns outros diretórios permanecem:

    Se você tentar desinstalar parcialmente um ou mais dos recursos obrigatórios do Rational Application Developer, você receberá uma mensagem de erro semelhante a esta:

    Seleção inválida: Impossível desinstalar ide_required: raiz não está configurada para desinstalar
    

    Para solucionar esse problema, selecione a caixa de opções Product Uninstallation (Desinstalação do Produto). O painel de desinstalação será reinicializado para que você possa desinstalar completamente o Rational Application Developer ou limpar a seleção de recursos que não deseja desinstalar.

    Desinstalando Silenciosamente o Rational Application Developer

    Para fazer uma desinstalação silenciosa do Rational Application Developer a partir de um prompt de comandos, vá para o diretório de instalação e digite:

    rad_prod\_uninst\uninstall.exe -silent
    

    Problemas e Limitações Conhecidos

    Esta seção abrange problemas e limitações conhecidas com a instalação e desinstalação do Windows do Rational Application Developer. Consulte o arquivo leia-me ou a ajuda on-line para obter informações sobre problemas e limitações que afetem a utilização real do produto.

    Recuperando-se de uma Instalação Malsucedida

    Se a instalação falhar, você deverá remover qualquer arquivo do Rational Application Developer que tenha sido instalado. Se o diretório no qual você pretendia instalar o Rational Application Developer estiver vazio, o processo de instalação já removeu todos os arquivos que estavam instalados e você pode excluir o diretório vazio.

    O WebSphere Application Server V6.0 Integrated Test Environment Falha ao Ser Instalado

    Se você selecionou para instalar o WebSphere Application Server V6.0 Integrated Test Environment ao instalar o Rational Application Developer e a instalação falhar, aparecerá a seguinte mensagem:

    A instalação do WebSphere Application Server V6.0 Integrated Test Environment falhou.
    O IBM Rational Software Development Platform ainda será executado, mas o WebSphere Application Server V6.0 Integrated Test Environment poderá não estar disponível.
    

    Para obter informações sobre resolução de problemas da instalação do WebSphere Application Server V6.0, consulte o http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html.

    Observe que, por padrão, o WebSphere Application Server V6.0 Integrated Test Environment é instalado no subdiretório \runtimes\base_v6 no qual o Rational Application Developer está instalado.

    Falha ao Desinstalar o WebSphere Application Server V6.0 Integrated Test Environment no Windows Server 2003

    No Windows Server 2003, se o Servidor de Terminais estiver instalado e configurado, o WebSphere Application Server V6.0 Integrated Test Environment não poderá ser removido quando você desinstalar o Rational Application Developer. Para removê-lo, execute o seguinte comando a partir do diretório em que instalou o produto (por exemplo, C:\Arquivos de Programas\IBM\Rational\SDP\6.0):

    \runtimes\base_v6\_uninst\uninstall.exe -silent
    

    Cancelar a Instalação de um Produto Instalado por Mesclagem e, em seguida, Tentar a Instalação Novamente Pode Não Instalar o Produto Corretamente.

    Se você cancelar uma instalação após o início da cópia dos arquivos no sistema, e estiver instalando na mesma máquina em que já existir um outro produto Software Development Platform, a instalação subseqüente do produto pode falhar. Você pode não receber erros, mas o produto recém-instalado pode não ser utilizável. Os menus esperados da ajuda e do produto podem não estar presentes mesmo se o item de menu Iniciar para o produto estiver presente. Dentro do produto, você pode ver alguns plug-ins registrados, mas o novo produto não estará disponível.

    Se ocorrerem problemas após o cancelamento de uma instalação por mesclagem, você precisa executar um dos seguintes cursos de ação dependendo de sua situação:

    1. Se você cancelou a instalação antes do início da cópia dos arquivos, pode reiniciar a instalação sem seguir quaisquer soluções alternativas descritas a seguir.
    2. A solução alternativa para isso depende de onde você está no processo de instalação. Se você não iniciou a instalação pela segunda vez, então pode editar o arquivo na lista a seguir que seja apropriado para seu sistema:

      Remova qualquer coisa após o sinal de igual (= ) que tenha o código de 3 letras do produto de instalação. Esses códigos são os seguintes:

      Depois de ter editado o arquivo, reinicie, instale e não cancele a instalação após o início da cópia dos arquivos.

    3. Se você concluiu a instalação do produto, será necessário executar a desinstalação e, em seguida, reinstalar sem cancelar a instalação após o início da cópia dos arquivos.

    Capítulo 5. Instalando e Desinstalando o Rational Application Developer para Linux

    Esta seção contém informações sobre como instalar o Rational Application Developer no Linux. É possível instalar o Rational Application Developer a partir do CD-ROM ou de imagens eletrônicas transferidas por download. Um assistente de instalação é fornecido, mas você também pode instalar o Rational Application Developer a partir de um prompt de comandos ou executar uma instalação silenciosa, conforme descrito posteriormente desta documentação.

    Nota sobre a Instalação:

    Importante -- antes de trabalhar com este produto:


    Questões de Migração, Upgrade e Coexistência

    É possível migrar do WebSphere Studio v5.1.x para o Rational Application Developer ou você pode optar por coexistir com o Rational Application Developer. Consulte o Guia de Migração para Rational Application Developer obter informações adicionais de migração.

    Não é possível migrar do WebSphere Studio Site Developer ou do WebSphere Studio Application Developer, v4.x.x. ou 5.0.x para o Rational Application Developer. O Rational Application Developer pode, no entanto, coexistir com qualquer um desses produtos. Caso queira, você poderá migrar manualmente os espaços de trabalho, artefatos e projetos do Rational ClearCase, Clear Case LT e CVS para o Rational Application Developer.

    Consulte Capítulo 3, "IBM Rational Software Development Platform" para obter informações adicionais sobre o IBM Rational Software Development Platform e a coexistência entre os produtos com base nessa plataforma de desenvolvimento.

    Se você tiver uma versão anterior do Agent Controller ou de qualquer outro software derivado do Hyades Data Collection Engine, pare-o, desinstale-o e limpe os arquivos remanescentes antes de instalar esta versão do Agent Controller. Para obter informações adicionais, consulte Capítulo 6, "Instalando o Agent Controller".


    Instalando a partir do CD-ROM

    Antes de instalar o produto, verifique se:

    Para instalar o Rational Application Developer a partir do CD de instalação do produto, siga estas etapas:

    1. Leia "Questões de Migração, Upgrade e Coexistência" antes de iniciar o procedimento de instalação.
    2. Efetue login como usuário root.
    3. Inicie uma sessão de terminal.
    4. Digite umask 0022, para que o produto possa ser utilizado por usuários diferentes do root.
    5. Insira o CD na unidade de CD.

      Durante a instalação, será necessário inserir o próximo CD. Se você não puder abrir o CD-ROM para inserir o próximo CD, verifique se:

      Se ainda encontrar problemas para inserir o próximo CD, siga estas etapas:

      1. Se o programa de instalação ainda estiver em execução, clique em Cancel (Cancelar).
      2. Efetue login como usuário root.
      3. Caso ainda não esteja instalado em sua máquina, instale o pacote psmisc RPM que está disponível no CD de distribuição do Linux.
      4. Inicie o programa de instalação.
      5. Se ainda tiver problemas, digite /sbin/fuser CD_device a partir de outro terminal para exibir o processo utilizando o CD-ROM.
      6. Para obter detalhes do processo, digite: ps <id_do_processo>
    6. Se o CD-ROM não estiver montado, faça a montagem digitando:
      mount CD_device
      
    7. Digite: CD_device/launchpad.bin para exibir a janela Rational Application Developer Launchpad de Instalação.

      Dicas:

    8. A partir da barra de lançamento de instalação do Rational Application Developer, selecione Instalar o IBM Rational Application Developer v6.0.
    9. Aguarde o assistente de instalação abrir e, em seguida, clique em Next (Avançar) para continuar a instalação.
    10. Siga as instruções na tela para as tarefas, tais como, leitura do contrato de licença e especificação do diretório de instalação de destino.
    11. Na janela Recursos, você pode selecionar os recursos do Rational Application Developer que você gostaria de instalar.
      1. Por padrão, o programa de instalação instala o Integrated Development Environment e o WebSphere Application Server, Versão 6.0, opcional como o ambiente de tempo de execução para teste.
      2. Se desejar instalar a interface com o usuário e a documentação para idiomas nacionais suportados diferentes do inglês, selecione para instalar o Language Pack. Por padrão, este recurso não é selecionado se o locale de seu sistema for do idioma inglês. Ele será selecionado se o locale de seu sistema for um dos outros idiomas nacionais suportados.

        Os idiomas nacionais suportados são português do Brasil, francês, alemão, italiano, japonês, coreano, chinês simplificado, espanhol e chinês tradicional.

        Nota: Se você optar por instalar o recurso Language Pack opcional e, em seguida, cancelar a instalação enquanto os arquivos estão sendo copiados, instalações subseqüentes mostrarão algumas anomalias. Em uma instalação subseqüente, o recurso Language Pack mostrará um status instalado no painel Recurso, mesmo que os arquivos que compõem o pacote de idiomas não estejam instalados. Você pode selecionar para reinstalar o recurso Language Pack e os arquivos adequados serão copiados para seu disco. Nessa situação, você pode receber uma mensagem ao final da instalação que informa que Um ou mais erros ocorreram durante a substituição de arquivos. Você pode ignorar seguramente essa mensagem de erro.

      3. Por padrão, o recurso EGL (Enterprise Generation Language) não é instalado. O EGL é uma linguagem poderosa de alto nível para criar aplicativos de negócios complexos. Ele manipula as complexidades das tecnologias subjacentes (como o acesso ao banco de dados, as filas de mensagens e o J2EE) para que os desenvolvedores de aplicativos possam se concentrar em sua lógica de negócios. Para instalar o plug-in do EGL, selecione a caixa de opções EGL (Enterprise Generation Language).
      4. Por padrão, o recurso Portal Tools não é instalado. Para instalar o recurso Portal Tools, selecione a caixa de opções Portal Tools.
      5. Por padrão, os exemplos para o desenvolvimento do plug-in Eclipse não são instalados. Esses exemplos são para desenvolvedores que queiram estender o workbench, criando suas próprias ferramentas de plug-in. Para instalar os exemplos para o desenvolvimento do plug-in Eclipse, selecione a caixa de opções Examples for Eclipse Plug-In Development (Exemplos do Eclipse Plug-In Development).
    12. Clique em Next (Avançar) para exibir informações de resumo da instalação do Rational Application Developer.
    13. Clique em Next (Avançar) para continuar a instalação do Rational Application Developer.
    14. Quando for solicitado o próximo CD, siga as etapas a seguir:
      1. Para abrir o CD-ROM, digite: eject CD_device
      2. Insira o próximo CD no CD-ROM.
      3. Se a montagem automática não estiver ativada, monte o CD-ROM digitando: mount CD_device
      4. Clique em OK para continuar com a instalação.
    15. Se receber um aviso sobre um problema com o registro da licença no final da instalação, siga estas etapas:
      1. Vá para o subdiretório /logs de seu diretório de instalação.
      2. Abra o license.log com um editor de texto.
      3. Se license.log contiver uma das linhas seguintes:
        486604803  O pedido de licença expirou
        486604805  As datas de início para todas as licenças ainda não ocorreram
        
        Certifique-se de que o clock do seu sistema esteja corretamente definido e inicie o Rational Application Developer.
    16. Quando o Rational Application Developer for instalado, clique em Next (Avançar) para concluir a instalação.
    17. A próxima tela fornecerá a opção para ativar a instalação do Agent Controller. Antes de utilizar os recursos de gerenciamento de perfis, análise de tempo de execução e log do Rational Application Developer, você deve instalar o Agent Controller. Consulte Capítulo 6, "Instalando o Agent Controller" para obter detalhes. Desmarque a opção se você não desejar instalar o Agent Controller neste momento.

      A tela também contém uma mensagem recomendando a você para verificar atualizações para seus recursos instalados, utilizando o Rational Product Updater. (Consulte Capítulo 13, "Instalando Atualizações" para obter informações adicionais). Clique em Finish (Concluir) para fechar a janela de instalação.

    18. Se você planeja desenvolver aplicativos que serão executados em outros servidores de aplicativos, poderá selecionar, opcionalmente, a instalação de ambientes de teste de tempo de execução adicionais com o Rational Application Developer.Para obter informações adicionais, consulte Capítulo 8, "Instalando o WebSphere Application Server 5.x como um Ambiente de Teste Integrado"
    19. Antes de poder utilizar a definição de perfis, a análise do tempo de execução e os recursos de log do Rational Application Developer para coletar dados remotamente, você deve instalar o Agent Controller no host local e no remoto. Consulte Capítulo 6, "Instalando o Agent Controller" para obter detalhes.
    20. Se você desejar testar aplicativos de sistema de mensagens e de serviços da Web no WebSphere Application Server Versão 6.0, o suporte para o fornecedor de sistema de mensagens padrão fica automaticamente disponível e o suporte a clientes e servidores do sistema de mensagens incorporado não deve ser instalado. Entretanto, se você desejar utilizar o ambiente de teste do WebSphere Versão 5.x, deverá instalar separadamente o recurso de cliente e servidor do sistema de mensagens incorporado. Para obter informações adicionais, consulte Capítulo 9, "Instalando o Suporte ao Sistema de Mensagens e Enfileiramento para os Ambientes de Teste do WebSphere Versão 5.x".

      Importante: Se MQSeries já estiver instalado, não instale o cliente e o servidor de sistema de mensagens e enfileiramento, como se fossem um subconjunto das funções MQSeries.

    21. Se planeja utilizar o Rational ClearCase como seu sistema SCM (Software Configuration Management), poderá instalar o recurso Rational ClearCase LT agora ou mais tarde. Para obter informações adicionais sobre o Rational ClearCase, consulte o Capítulo 7, "Configurando o Rational Application Developer para Funcionar em um Ambiente de Equipe".
    22. Crystal Enterprise é uma infra-estrutura para acesso e relatório de dados desenvolvida para integrar-se com investimentos de dados, da Web e de aplicativos existentes. É baseado no Crystal Reports. Para obter informações adicionais sobre como instalá-lo, consulte Capítulo 12, "Instalando o Crystal Enterprise".

    Nota:

    Instalando a partir de Imagens Eletrônicas

    Consulte o arquivo leia-me do produto para obter uma descrição das imagens eletrônicas que precisam ser transferidas por download.

    Antes de instalar o produto, verifique o seguinte:

    Para fazer download e criar a imagem de instalação eletrônica:

    1. Faça download de todas as partes requeridas e das partes opcionais desejadas no mesmo diretório temporário. Se alguma parte opcional for necessária posteriormente, faça download das partes opcionais adicionais e reexecute a ferramenta de extração antes de tentar a instalação.
      Nota:
      Quando fizer upgrade do produto Rational Software Development Platform para outro, utilizando as imagens eletrônicas, assegure-se de fazer download e extrair o mesmo conjunto de imagens para o novo produto que fez download e extraiu para o produto original. Os mesmos componentes instalados no produto original serão instalados automaticamente no produto atualizado.

      Por exemplo, se o Pacote de Idiomas foi instalado originalmente, quando fizer upgrade precisará fazer o seu download e extrai-lo para a nova imagem de instalação do produto.

    2. Modifique as permissões no arquivo extractor.bin localizado nesse diretório temporário, digitando:
      chmod +x extractor.bin
      
    3. Execute o arquivo, digitando ./extractor.bin
    4. Siga as instruções do assistente para especificar onde deseja criar a imagem e quais recursos deseja incluir.
    5. Depois da imagem ser criada, se quiser instalar o produto imediatamente, clique em Finish (Concluir). Como alternativa, você pode limpar a caixa de opções Start the installation wizard (Iniciar o Assistente de Instalação) e executar o programa de instalação posteriormente, ativando disk1/launchpad.bin a partir do diretório onde a imagem de instalação foi criada.
    6. Siga as instruções descritas na seção "Instalando a partir do CD-ROM".

    Criando uma Imagem de Instalação da Rede

    Você pode colocar uma cópia da imagem de instalação em uma unidade de rede para que os usuários possam fazer a instalação pela rede.

    Para executar o programa de instalação a partir de uma unidade de rede, você deve trabalhar com uma imagem eletrônica transferida por download do Rational Application Developer ou copiar o conteúdo dos CDs, conforme descrito a seguir.

    Você precisa de aproximadamente 6 GB de espaço em disco para armazenar o conteúdo do CD no disco. Para copiar os arquivos a partir dos CDs:

    1. Efetue login como usuário root.
    2. Crie um diretório (por exemplo, install_image) em uma unidade de rede na qual você deseja armazenar a imagem.
    3. Insira o primeiro CD de instalação do Rational Application Developer em sua unidade de CD.
    4. No diretório temporário, crie um subdiretório denominado disk1. Esse subdiretório deve se chamar disk1 e deve estar em letras minúsculas.
    5. Copie todos os arquivos e diretórios no primeiro CD de instalação para o subdiretório disk1 no diretório temporário.
    6. Repita as etapas 3, 4 e 5 para copiar o conteúdo dos outros dois CDs para os subdiretórios denominados disk2 e disk3.

    Esses são todo os arquivos da instalação principal. Se quiser os arquivos de instalação para qualquer um dos seguintes recursos opcionais:

    1. Controlador do Agente
    2. Servidor e cliente do sistema de mensagens incorporado
    3. Rational ClearCase LT
    4. Ambientes de teste do WebSphere V5.x
    5. WebSphere Portal test environment V5.0
    6. Crystal Enterprise V10 Professional Edition
    7. Crystal Enterprise V10 Embedded Edition

    copie o conteúdo dos CDs apropriados para o diretório temporário.

    Nota:
    Se sua máquina entrar no modo em espera durante uma instalação a partir de uma imagem de instalação de rede, a instalação pode falhar.

    Chamando uma Instalação Silenciosa

    O programa de instalação do Rational Application Developer pode ser executado silenciosamente se você não desejar interagir com o assistente de instalação.

    Configurando as Imagens Locais

    Antes de instalar silenciosamente o Rational Application Developer, você deverá copiar as imagens locais:

    1. Leia "Questões de Migração, Upgrade e Coexistência" antes de iniciar o procedimento de instalação.
    2. Crie uma imagem de instalação local ou de rede, conforme descrito em "Criando uma Imagem de Instalação da Rede". Se você desejar instalar apenas o Rational Application Developer, precisará copiar apenas as informações dos três primeiros CDs.

    Instalando Silenciosamente os Recursos Padrão no Diretório Padrão

    Os recursos a seguir são instalados por padrão ao instalar silenciosamente o Rational Application Developer:

    Para instalar o Rational Application Developer silenciosamente apenas com os recursos selecionados padrão no diretório padrão /opt/IBM/Rational/SDP/6.0:

    1. Efetue login como usuário root.
    2. Copie as imagens, conforme descrito em "Configurando as Imagens Locais", se ainda não tiver feito isso.
    3. A partir da linha de comandos, altere para o diretório /disk1/setup no diretório temporário (por exemplo, /tmp/install_image/disk1/setup) que você criou na seção anterior.
    4. Execute o seguinte comando:
      ./setup.bin -silent 
      
    5. A conclusão da instalação silenciosa do Rational Application Developer pode demorar um pouco. Para determinar a conclusão da instalação, você pode monitorar o subdiretório /logs em seu diretório de instalação periodicamente. Se o arquivo license.log aparecer, a instalação silenciosa foi concluída.

    Instalando Silenciosamente em um Diretório Diferente

    Alterando o parâmetro installLocation, você pode instalar o Rational Application Developer em um diretório diferente. Por exemplo, se quiser que "/my_softdev" seja o diretório de instalação, siga as mesmas etapas que acabam de ser descritas, mas execute o seguinte comando:

    ./setup.bin -silent -P installLocation="/my_softdev"
    

    Neste exemplo, somente os recursos padrão são instalados.

    Instalando Silenciosamente Recursos Adicionais do Rational Application Developer

    O Rational Application Developer fornece um arquivo de resposta de amostra. Esse arquivo de resposta chama-se responsefile.txt e está localizado no diretório /disk1/util. Se você deseja alterar o arquivo de resposta para instalar outros recursos, recomenda-se que se faça primeiro uma cópia de backup do responsefile.txt.

    É possível atualizar o arquivo de resposta para instalar um ou mais recursos opcionais do Rational Application Developer. A tabela a seguir mostra as opções do arquivo de resposta e suas entradas correspondentes no arquivo de resposta.

    Tabela 2. Lista de Opções do Arquivo de Resposta.

    Recurso Entrada do Arquivo de Resposta
    Diretório de Instalação do Produto installLocation
    WebSphere Application Server Versão 6.0 feature_was6_linux.active
    Language Pack feature_lang_pack_rad_linux.active
    EGL (Enterprise Generation Language) feature_egl_linux.active
    Portal Tools feature_portal_linux.active
    Exemplos do Eclipse Plug-in Development feature_examples_linux.active

    Para instalar silenciosamente qualquer um dos recursos opcionais:

    1. Copie responsefile.txt em um novo arquivo, por exemplo myresponsefile.txt.
    2. Edite sua cópia do arquivo de resposta.
    3. Localize a linha que contém o nome do recurso de instalação mostrado na tabela anterior. Por exemplo, se desejasse instalar os exemplos para o desenvolvimento de plug-ins Eclipse, você localizaria a seguinte linha no arquivo de resposta:

      # -P feature_examples_linux.active=<valor>

    4. Faça as seguintes alterações nesta linha:
      1. Remova # na primeira coluna.
      2. Altere <valor> para true.

      Neste exemplo, essa linha seria alterada para:

         -P feature_examples_linux.active=true
      
    5. Salve as alterações.
    6. Efetue login como usuário root.
    7. Copie as imagens, conforme descrito em "Configurando as Imagens Locais", se ainda não tiver feito isso.
    8. A partir da linha de comandos, altere para o diretório /disk1/setup no diretório temporário (por exemplo, /tmp/install_image/disk1/setup) que você criou na seção anterior.
    9. Quando executar um arquivo de resposta, adicione o parâmetro -options e o nome completo dele conforme mostrado no exemplo a seguir:
      ./setup.bin -silent -options "Your_directory/myresponsefile.txt"
      

      em que Your_directory é o nome completo do diretório onde seu arquivo de resposta reside.

      Nota:
      Para verificar se o arquivo de resposta está sendo utilizado, execute primeiro esse comando (isto é, antes de executar uma instalação silenciosa) se a opção -silent e verifique se suas configurações estão sendo registradas no assistente de instalação. Se não estiverem, há um problema com as configurações do arquivo de resposta ou da sintaxe de comando.
    10. A conclusão da instalação silenciosa do Rational Application Developer pode demorar um pouco. Para determinar a conclusão da instalação, você pode monitorar o subdiretório /logs em seu diretório de instalação periodicamente. Se o arquivo license.log aparecer, a instalação silenciosa foi concluída.

    Aumentando o Número de Manipulações de Arquivos Disponíveis

    Antes de trabalhar com o produto, é recomendável que os usuários peçam ao administrador do sistema para aumentar o número de manipulações de arquivo para usuários do Rational Application Developer acima do limite padrão de 1024 manipulações de arquivo por processo.

    Tome cuidado quando utilizar as etapas a seguir para aumentar seus descritores de arquivo no Linux. Se as instruções não forem seguidas corretamente, a máquina não inicializará apropriadamente. Preferivelmente, peça ao administrador do sistema para fazer isso para você.

    Para aumentar seus descritores de arquivo:

    1. Efetue login como root. Se você não tiver acesso root, precisará obtê-lo antes de continuar.
    2. Altere para o diretório etc.
    3. Utilize o editor vi para editar o arquivo initscript no diretório etc. Se esse arquivo não existir, digite vi initscript para criá-lo.
      Nota:
      Se você decidir aumentar o número de manipulações de arquivo, NÃO deixe um arquivo initscript vazio na máquina, caso contrário a máquina não será inicializada na próxima vez.
    4. Na primeira linha, digite ulimit -n 4096 (a chave aqui é o número significativamente maior que 1024, o padrão na maioria das máquinas Linux). Cuidado: não defina para um valor muito alto, pois isso impactar seriamente o desempenho em todo o sistema.
    5. Na segunda linha, digite eval exec "$4".
    6. Salve e feche o arquivo depois de certificar-se de que a etapas 4 e 5 foram concluídas.
      Nota:
      Assegure-se de que você tenha seguido as etapas corretamente, caso contrário isso fará com que a máquina não seja inicializada.
    7. (Opcional) Restrinja os usuários ou grupos, modificando o arquivo limits.conf no diretório etc/security. O SLES (SuSE Linux Enterprise Server) Versão 9 e o Red Hat Enterprise Linux Versão 3.0 possuem esse arquivo por padrão. Se por alguma razão você não tiver esse arquivo, poderá considerar um número mais moderado na etapa 4 acima (como 2048). Isso precisa ser feito para que a maioria dos usuários tenham um limite razoavelmente baixo sobre o número de arquivos abertos permitidos por processo. Se você utilizou um número relativamente baixo na etapa 4, é menos importante fazer isso. Entretanto, se você optar por definir um número alto na etapa 4, não fazer isso poderá impactar seriamente o desempenho da máquina.

      Segue um arquivo limits.conf de amostra que restringe todos os usuários e, subseqüentemente, define limites diferentes para outros. Esta amostra supõe que você utilizou 8192 na etapa 4 acima.
      * soft nofile 1024
      * hard nofile 2048
      root soft nofile 4096
      root hard nofile 8192
      user1 soft nofile 2048
      user1 hard nofile 2048

      Observe que o * no exemplo acima é utilizado para definir primeiro os limites para todos os usuários. Esses limites são mais baixos que os seguintes. O usuário root possui um número mais alto de descritores permitidos abertos, enquanto o user1 está entre os dois. Leia e compreenda a documentação fornecida no arquivo limits.conf antes de fazer suas modificações.

    Para obter informações adicionais sobre o comando ulimit, consulte a man page para ulimit.


    Iniciando o Rational Application Developer

    Para iniciar o Rational Application Developer, siga estas etapas:

    1. Para iniciar o Rational Application Developer a partir de uma linha de comandos, vá para o diretório de instalação e execute o comando: ./rationalsdp.bin.
    2. Se você estiver trabalhando no Gnome (que é o padrão do Red Hat), o atalho do produto estará no menu principal sob Programming > Rational Software Development Platform. Se você estiver trabalhando no KDE (que é o padrão do SuSE), o atalho do produto será IBM Rational > Rational Software Development Platform.
    3. A primeira vez que você iniciar o Rational Application Developer, uma caixa de diálogo será aberta com o diretório de espaço de trabalho padrão já especificado. Por padrão, seu trabalho é armazenado em um diretório denominado workspace, localizado no diretório $HOME/IBM/rationalsdp6.0.
    4. Por padrão, a caixa de opções Use this as the default and do not ask again (Utilizar este como padrão e não perguntar novamente) está desmarcada. Se você mantiver o valor padrão, uma caixa de diálogo será aberta toda vez que o Rational Application Developer for iniciado, permitindo comutar espaços de trabalho. Você poderá manter esse valor padrão se, por exemplo, optar por manter diferentes espaços de trabalho para diferentes projetos.

      Dica: Se a caixa de opções Utilizar como padrão e não perguntar novamente estiver selecionada, a caixa de diálogo não abrirá novamente e o Rational Application Developer será iniciado utilizando o espaço de trabalho da sessão anterior. Você poderá alterar o valor padrão depois de iniciar o produto na página Window (Janela) > Preferences (Preferências) > Workbench > Startup and Shutdown (Inicialização e Encerramento).

    O workbench primeiro abre várias páginas de boas-vindas que fornecem uma visão geral do produto e informações sobre o que há de novo, além de links para tutoriais, amostras e recursos da Web externos. Utilize algum tempo para explorar essas opções. Observe também as fontes de informações disponíveis no menu Help (Ajuda).


    Desinstalando o Rational Application Developer

    Para desinstalar o Rational Application Developer no Linux, siga estas etapas:

    1. Efetue login como root.
    2. Vá para o subdiretório rad_prod/_uninst/ do diretório de instalação.
    3. Desinstale o Rational Application Developer digitando este comando: ./uninstall.bin. Se você estiver trabalhando em um gerenciador de arquivos, poderá clicar no arquivo para ativar o desinstalador.
    4. Todos os arquivos ou recursos em quaisquer diretórios de plug-ins ou de recursos são automaticamente excluídos, inclusive dados do usuário e plug-ins de terceiros que residam em algum desses diretórios. O diretório do espaço de trabalho, que contém seu trabalho, não é excluído. Alguns outros diretórios permanecem:

    Se você tentar desinstalar parcialmente um ou mais dos recursos obrigatórios do Rational Application Developer, você receberá uma mensagem de erro semelhante a esta:

    Seleção inválida: Impossível desinstalar ide_required: raiz não está configurada para desinstalar
    

    Para solucionar esse problema, selecione a caixa de opções Product Uninstallation (Desinstalação do Produto). O painel de desinstalação será reinicializado para que você possa desinstalar completamente o Rational Application Developer ou limpar a seleção de recursos que não deseja desinstalar.

    Desinstalando Silenciosamente o Rational Application Developer

    Para fazer uma desinstalação silenciosa do Rational Application Developer a partir de um prompt de comandos, vá para o diretório de instalação e digite:

    rad_prod\_uninst\uninstall.bin -silent
    

    Problemas e Limitações Conhecidos

    Esta seção abrange os problemas e limitações conhecidos com a instalação e desinstalação no Linux do Rational Application Developer. Consulte o arquivo leia-me para obter informações sobre problemas e limitações que afetem a utilização real do produto.

    Limitações do Disco

    O WebSphere Application Server V6.0 Integrated Test Environment Falha ao Ser Instalado

    Se você selecionou para instalar o WebSphere Application Server V6.0 Integrated Test Environment ao instalar o Rational Application Developer e a instalação falhar, aparecerá a seguinte mensagem:

    A instalação do WebSphere Application Server V6.0 Integrated Test Environment falhou.
    O IBM Rational Software Development Platform ainda será executado, mas o WebSphere Application Server V6.0 Integrated Test Environment poderá não estar disponível.
    

    Para obter informações sobre resolução de problemas da instalação do WebSphere Application Server V6.0, consulte o http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html.

    Observe que, por padrão, o WebSphere Application Server V6.0 Integrated Test Environment é instalado no subdiretório /runtimes/base_v6 no qual o Rational Application Developer está instalado.

    Cancelar a Instalação de um Produto Instalado por Mesclagem e, em seguida, Tentar a Instalação Novamente Pode Não Instalar o Produto Corretamente.

    Consulte o "Cancelar a Instalação de um Produto Instalado por Mesclagem e, em seguida, Tentar a Instalação Novamente Pode Não Instalar o Produto Corretamente.".


    Capítulo 6. Instalando o Agent Controller

    O Agent Controller é um daemon que permite que os aplicativos clientes sejam ativados e gerenciem aplicativos local ou remoto e fornece informações sobre como executar aplicativos para outros aplicativos. Você deve instalá-lo separadamente antes de poder utilizar as seguintes ferramentas:

    Notas:


    Pré-requisitos de Hardware


    Plataformas Suportadas

    Nota para Linux: O recurso Hyades Data Collection Engine do Agent Controller é compilado utilizando a biblioteca compartilhada libstdc++-libc6.2-2.so.3. Certifique-se de que essa biblioteca compartilhada exista no diretório /usr/lib. Se não existir, você terá que instalar o RPM package compat-libstdc++ fornecido com a mídia de instalação do sistema operacional.

    O Agent Controller foi testado nas seguintes plataformas:

    O Agent Controller não foi testado nas seguintes plataformas, mas espera-se que seja executado nestas:

    O Agent Controller não está disponível nas seguintes plataformas:


    JVMs Suportados

    Em geral, o Agent Controller funciona com a JVM versão 1.4 e superior. Seguem as versões de JVM (Java -fullversion) nas quais o Agent Controller foi testado:


    Localizando os Arquivos de Instalação

    Os arquivos de instalação do Agent Controller estão localizados no disco do software opcional, nos diretórios listados a seguir:


    Instalando o Agent Controller em uma Estação de Trabalho (AIX, HP-UX, Linux, Windows, Solaris)

    Desinstalando Versões Anteriores do Agent Controller

    Se você tiver uma versão anterior do Agent Controller ou de qualquer outro software derivado do Hyades Data Collection Engine, pare-o, desinstale-o e limpe os arquivos remanescentes antes de instalar esta versão do Agent Controller. Os seguintes arquivos podem ser deixados após a desinstalação:

    Windows:

    %RASERVER_HOME%\*.* (diretório onde o Agent Controller é instalado)
    %SystemRoot%\system32\piAgent.dll (Windows' system32 directory)
    %SystemRoot%\system32\LogAgent.dll
    %SystemRoot%\system32\hcbnd.dll
    %SystemRoot%\system32\hcclco.dll
    %SystemRoot%\system32\hccldt.dll
    %SystemRoot%\system32\hccls.dll
    %SystemRoot%\system32\hcclserc.dll
    %SystemRoot%\system32\hcclsert.dll
    %SystemRoot%\system32\hcclsm.dll
    %SystemRoot%\system32\hcjbnd.dll
    %SystemRoot%\system32\hclaunch.dll
    %SystemRoot%\system32\hcthread.dll
    %SystemRoot%\system32\piAgent.dll
    %SystemRoot%\system32\rac.dll
    %SystemRoot%\system32\sysperf.dll
    

    Linux, AIX, HP-UX, Solaris:

    $RASERVER_HOME/* (diretório onde o Agent Controller é instalado)
    /usr/lib/libpiAgent.so (ou .sl no HP-UX)
    /usr/lib/libLogAgent.so
    /usr/lib/libhcbnd.so
    /usr/lib/libhcclco.so
    /usr/lib/libhccldt.so
    /usr/lib/libhccls.so
    /usr/lib/libhcclserc.so
    /usr/lib/libhcclsert.so
    /usr/lib/libhcclsm.so
    /usr/lib/libhcjbnd.so
    /usr/lib/libhclaunch.so
    /usr/lib/libhcthread.so
    

    Instalando o Agent Controller

    1. Efetue login como Administrator (ou root).
    2. Passe para o diretório da mídia de instalação para a plataforma apropriada.
    3. Execute o programa setup.exe. Para plataformas não- Windows, execute setup.bin.
    4. Clique em Next (Avançar) na tela de Boas-vindas para continuar.
    5. Feche todas as plataformas Eclipse antes de continuar com a instalação. Clique em Next (Avançar) para continuar.
    6. Leia o acordo de licença.
    7. Selecione Approve (Aprovar) e clique em Next (Avançar) para continuar.
    8. Você será informado que qualquer Agent Controller existente será removido. Clique em Next (Avançar) para continuar.
    9. Especifique o caminho no qual o Agent Controller deve ser instalado e clique em Next (Avançar) para continuar.
    10. Selecione os recursos do Agent Controller que você gostaria de instalar:

      Clique em Next (Avançar) para continuar.

    11. Especifique o caminho do programa executável java.exe ou java do JRE (Java Run-time Environment) que o Agent Controller deverá utilizar. O JRE digitado aqui será utilizado pelo Agent Controller para ativar aplicativos Java. Portanto, você pode desejar alterar o caminho JRE previamente preenchido pelo programa instalador.
      Nota:
      O JRE fornecido nesse momento será utilizado para executar o Agent Controller e para que o Agent Controller ative aplicativos Java. No entanto, você pode configurar o Agent Controller posteriormente para utilizar um JRE separado para cada uma dessas funções. Para obter detalhes, consulte o tópico de ajuda do Agent Controller Configurando Aplicativos a Serem Ativados pelo Agent Controller.
    12. Opcional: Especifique os caminhos do IBM WebSphere Application Server versão 5.0 (apenas Windows) e 5.1 se "Suporte Remoto para WebSphere Application Server" foi selecionado.
    13. Especifique quais hosts podem acessar o Agent Controller. As opções são:

      Clique em Next (Avançar) para continuar.

    14. Se a Segurança tiver sido selecionada na etapa 9 acima: Escolha a configuração de segurança.

      Clique em Next (Avançar) para continuar.

    15. Clique em Next (Avançar) na tela de resumo para continuar.
    16. Clique em Finish (Concluir) depois que a transferência do arquivo for concluída.

    Instalando o Agent Controller de Forma Silenciosa

    Você pode executar o processo de instalação silenciosamente utilizando os seguintes parâmetros com o comando de configuração:


    Parâmetro Descrição
    Parâmetros Requeridos  
    -silent
    
    informa o instalador para que execute silenciosamente
    -P installLocation
    
    especifica o caminho da instalação
    -W javaHome_win.path
    
    (Windows) especifica o caminho completo do executável java.exe
    -W javaHome_unix.path
    
    (não-Windows) especifica o caminho completo do executável java
    -W hostList.type
    
    especificar como os clientes podem se conectar ao Agent Controller (ALL, LOCAL, CUSTOM)
    • ALL: permitir qualquer cliente
    • LOCAL: permitir apenas host local
    • CUSTOM: permitir uma lista de clientes (também requer o parâmetro -W hostList.hosts)
    -W security.type
    
    especifica se a segurança deve ser ativada (true, false)
    • true: ativa a segurança (também requer o parâmetro opcional "-W security.users")
    • false: desativa a segurança
       
    Parâmetros Opcionais  
    -W wasHome_win.was510path
    
    (Windows) especifica o local de instalação do IBM WebSphere Application Server 5.1
    -W wasHome_unix.was510path
    
    (não-Windows) especifica o local de instalação do IBM WebSphere Application Server 5.1
    -W wasHome_win.was500path
    
    (Windows) especifica o local de instalação do IBM WebSphere Application Server 5.0
    -W wasHome_unix.was500path
    
    (não-Windows) especifica o local de instalação do IBM WebSphere Application Server 5.0
    -W hostList.hosts
    
    especifica os nomes de host do cliente, separados por vírgulas (se hostList.type="CUSTOM")
    -W security.users
    
    especificar quais usuários podem se conectar ao Agent Controller (se security.type = "true")
    -P hyadesdc_ibm_runtimeAnalysis_feature.active=false
    
    especifica para não instalar o recurso de Análise de Tempo de Execução (por padrão, ele é instalado durante a instalação silenciosa)
    Nota:
    Se estiver instalando o Agent Controller de forma silenciosa através de uma conexão não segura, utilize o parâmetro security.type.="false".

    Exemplo do Windows:

    setup.exe
      -silent
    -P installLocation="D:\IBM\AgentController"
    -W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
    -W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
    -W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
    -W hostList.type="CUSTOM"
    -W hostList.hosts="host1,host2"
    -W security.type="true"
    -W security.users="user1,user2"
     
    

    Exemplo Não-Windows:

    setup.bin
      -silent
      -P installLocation="/opt/IBM/AgentController"
      -W javaHome_unix.path="/opt/java1.4.1/jre/bin/java"
      -W wasHome_unix.was510path="/opt/WebSphere5.1/AppServer"
      -W wasHome_unix.was500path="/opt/WebSphere5.1/AppServer"
    -W hostList.type="CUSTOM"
    -W hostList.hosts="host1,host2"
    -W security.type="true"
    -W security.users="user1,user2"
     
    

    Utilizando um Arquivo de Resposta

    Você pode criar um arquivo de resposta (por exemplo, setup.rsp) para armazenar todos os parâmetros acima, em vez de especificá-los na linha de comandos:

    # Start of response file
    -P installLocation="D:\IBM\AgentController"
    -W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
    -W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
    -W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
    -W hostList.type="CUSTOM"
    -W hostList.hosts="host1,host2"
    -W security.type="true"
    -W security.users="user1,user2"
    # End of response file
    

    Para instalar utilizando o arquivo de resposta:

    Windows: setup.exe -silent -options d:\temp\setup.rsp

    Não-Windows: setup.bin -silent -options /tmp/setup.rsp

    Iniciando e Parando o Agent Controller em uma Estação de Trabalho do Windows

    Iniciando e Parando o Agent Controller em uma Estação de Trabalho Não- Windows

    Desinstalando o Agent Controller em uma Estação de Trabalho do Windows

    Desinstalando o Agent Controller de uma Estação de Trabalho Não- Windows

    1. Execute o programa uninstall.bin a partir do diretório _uninst do local da instalação (por exemplo, /opt/IBM/AgentController/_uninst).
    2. Siga a instrução na tela para concluir a desinstalação.
    3. Para executar uma desinstalação silenciosa, utilize o comando uninstall.bin -silent.

    Instalando o Agent Controller no OS/400 (iSeries)

    Desinstalando Versões Anteriores do Agent Controller

    Se você tiver uma versão anterior do Agent Controller ou de qualquer software derivado do Hyades Data Collection Engine, pare-o e desinstale-o antes de instalar esta versão.

    Instalando o Agent Controller

    1. No host iSeries, crie uma biblioteca denominada HYADESDC e uma outra biblioteca denominada IBMRAC:
      CRTLIB HYADESDC
      CRTLIB IBMRAC
      
    2. No host iSeries, na biblioteca HYADESDC, crie um arquivo de salvamento vazio denominado HYADESDC.SAVF:
      CRTSAVF HYADESDC/HYADESDC
      
    3. No host iSeries, na biblioteca IBMRAC, crie um arquivo de salvamento vazio denominado IBMRAC.SAVF:
      CRTSAVF IBMRAC/IBMRAC
      
    4. No host iSeries, na biblioteca IBMRAC, crie um arquivo de salvamento vazio denominado IBMRTA.SAVF:
      CRTSAVF IBMRAC/IBMRTA
      
    5. Utilize o FTP para incluir o arquivo IBMRAC.SAVF do CD de instalação na biblioteca IBMRAC, localizada no host iSeries, utilizando a transferência de modo BINARY.
    6. Utilize o FTP para incluir o arquivo HYADESDC.SAVF do CD de instalação na biblioteca HYADESDC localizada no host iSeries utilizando a transferência de modo BINARY.
    7. Utilize o FTP para incluir o arquivo IBMRTA.SAVF do CD de instalação na biblioteca IBMRAC localizada no host iSeries utilizando a transferência de modo BINARY.
    8. Restaure o arquivo de salvamento HYADESDC.SAVF localizado no host iSeries para a biblioteca HYADESDC, digitando:

      RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
      
    9. Restaure o arquivo de salvamento IBMRAC.SAVF localizado no host iSeries para a biblioteca IBMRAC, digitando:

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
      
    10. Restaure o arquivo de salvamento IBMRTA.SAVF localizado no host iSeries para a biblioteca IBMRAC, digitando:

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRTA)
      
    11. Inicie o QShell e crie, no IFS (Integrated File System), o diretório /opt/hyadesdc.
    12. Restaure o arquivo de salvamento HYADESIFS.SAVF em HYADESDC para o diretório IFS /opt/hyadesdc. Por exemplo:

      RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
      
    13. Restaure o arquivo de salvamento IBMRACIFS.SAVF no IBMRAC para o diretório /opt/hyadesdc do IFS. Por exemplo, digite o seguinte comando em uma linha:

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
      
    14. Restaure o arquivo de gravação IBMRTAIFS.SAVF do IBMRAC no diretório /opt/hyadesdc do IFS. Por exemplo, digite o seguinte comando em uma linha:

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRTAIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
      
    15. Depois de ter instalado o Agent Controller, vá para o diretório bin do local da instalação /opt/hyades/bin e execute o script de configuração digitando:

      ./SetConfig.sh
      
    16. Siga o prompt na tela para configurar o Agent Controller.

    Iniciando e Parando o Agent Controller no OS/400 (iSeries)

    1. Para iniciar o Agent Controller, inclua o HYADESDC e as bibliotecas IBMRAC na lista de bibliotecas:
      ADDLIBLE HYADESDC
      ADDLIBLE IBMRAC
      
    2. Submeta o job RAStart, digitando:

      SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
      
    3. Para parar o Agent Controller, termine o job RAStart, digitando:

      ENDJOB JOB(RASTART)
      

    Desinstalando o Agent Controller no OS/400 (iSeries)

    1. Remova a biblioteca HYADESDC e IBMRAC.
    2. Remova o diretório IFS /opt/hyadesdc (incluindo todos os subdiretórios e arquivos).

    Instalando o Agent Controller no OS/390 (z/OS)

    Desinstalando Versões Anteriores do Agent Controller

    Se você tiver uma versão anterior do Agent Controller ou de qualquer software derivado do Hyades Data Collection Engine, pare-o e desinstale-o antes de instalar esta versão.

    Instalando o Agent Controller

    1. Em um shell do UNIX(R) System Services, vá para o diretório no qual deseja instalar o Agent Controller. É recomendável instalá-lo no diretório /usr/lpp/.
    2. Transfira as imagens de instalação ibmrac.os390.pax e ibmrta.os390.pax para o diretório de instalação.
    3. Emita o seguinte comando para extrair os arquivos do Agent Controller:

      pax -ppx -rf ibmrac.os390.pax
      
    4. Altere o diretório para o diretório de instalação /usr/lpp/IBM/AgentController e digite o comando a seguir para extrair as extensões de análise de tempo de execução:

      pax -ppx -rf ../../ibmrta.os390.pax
      
    5. Vá para o diretório bin da instalação /usr/lpp/IBM/AgentController/bin e execute o script makelinks digitando:

      ./createLinks.sh
      
    6. Faça com que o programa de arquivos de objetos compartilhados do Agent Controller seja controlado, emitindo os comandos a seguir em um shell de Serviços do Sistema UNIX:

      extattr +p /usr/lpp/IBM/AgentController/lib/*.so
       
      
      extattr +p /usr/lpp/IBM/AgentController/plugins/com.ibm.rational.pd.probekit/lib/*.so
      
    7. Depois de ter instalado o Agent Controller, vá para o diretório bin do local da instalação /usr/lpp/IBM/AgentController/bin e execute o script de configuração digitando:

      ./SetConfig.sh
      
    8. Siga o prompt na tela para configurar o Agent Controller.

    Uso do Canal de Dados no z/OS:

    Para definir um grande dataChannelSize no arquivo serviceconfig.xml, poderá ser necessário aumentar a definição de tamanho máximo do segmento de memória compartilhada na máquina. Para isso, aumente o valor IPCSHMMPAGES no membro BPXPRMxx parmlib. Esse valor é o número máximo de páginas de 4 K que o canal de dados pode ter. Por exemplo, para definir dataChannelSize para 32 M, defina IPCSHMMPAGES com um valor maior que 8192.

    Para que o Agent Controller possa se comunicar com vários agentes simultaneamente, você deve definir o valor de IPCSHMNSEGS no membro BPXPRMxx parmlib para um valor apropriado. Esse valor especifica o número máximo de segmentos de memória compartilhada conectados para cada espaço de endereçamento. O valor padrão é 10, portanto, você deve aumentá-lo para 50.

    Para obter informações adicionais sobre os canais de dados utilizados pelo Agent Controller, consulte as informações da ajuda on-line do Agent Controller.

    Para obter informações adicionais sobre membros BPXPRMXX parmlib do z/OS e como atualizá-los, consulte o IBM z/OS MVS(TM) Initialization and Tuning Reference.

    Iniciando e Parando o Agent Controller no OS/390 (z/OS)

    Nota: O RAServer requer que os diretórios do JRE que contêm bibliotecas executáveis como libjvm.so sejam incluídos na variável de ambiente LIBPATH. Por exemplo, se você estiver utilizando o IBM JRE 1.4.1, a variável LIBPATH será definida conforme a seguir:

    export LIBPATH=/usr/lpp/java/IBM/J1.4/bin/classic:/usr/lpp/java/IBM/J1.4/bin:$LIBPATH
    

    Desinstalando o Agent Controller no OS/390 (z/OS)


    Utilizando o Recurso de Segurança do Agent Controller

    A lista a seguir contém dicas e sugestões para uso do recurso de segurança do Agent Controller em todas as plataformas:


    Problemas e Limitações Conhecidos

    Esta seção aborda problemas e limitações conhecidos relacionados à instalação e desinstalação do Agent Controller. Exceto onde indicado de outra forma, as seguintes informações se aplicam a todos os sistemas operacionais que são suportados pelo Agent Controller.

    O Agent Controller Pode Não Iniciar em Plataformas Não-Windows

    O Agent Controller pode não iniciar em plataformas não-Windows com a seguinte mensagem:

    RAServer failed to start.
    

    Este defeito geralmente é causado quando a porta 10002 do TCP/IP não está livre. Por padrão, o Agent Controller atende nessa porta. Outro processo em execução no sistema poderia estar utilizando essa porta quando o Agent Controller foi iniciado ou, talvez, o Agent Controller tenha sido parado e reiniciado antes da porta poder ser liberada.

    Se o Agent Controller falhar na inicialização, você poderá iniciá-lo da seguinte maneira:

    Outros Erros Durante a Instalação e a Desinstalação

    Se encontrar erros durante a instalação ou desinstalação, isto pode ter ocorrido porque os arquivos objeto do Agent Controller foram carregados por processos em execução. Para assegurar-se de que os arquivos objeto possam ser modificados, proceda da seguinte forma:

    1. Encerre o Rational Application Developer.
    2. Encerre todos os processos java.exe que contenham o Java Profiling Agent ou o J2EE Request Profiler.

    Capítulo 7. Configurando o Rational Application Developer para Funcionar em um Ambiente de Equipe

    Por padrão, um plug-in Rational ClearCase SCM Adapter é automaticamente instalado com o Rational Application Developer para suportar a utilização do Rational ClearCase como seu sistema SCM (Software Configuration Management). Para obter informações adicionais sobre o Rational ClearCase, consulte o endereço www.ibm.com/software/awdtools/clearcase/.

    Os plug-ins do CVS (Concurrent Versions System) são instalados automaticamente com o Rational Application Developer para suportarem o uso do CVS como o sistema SCM. A versão mais recente do servidor CVS está disponível em www.cvshome.org. Não é necessário instalar um cliente do CVS para utilizá-lo, apenas um servidor CVS. Para obter mais informações sobre instalação e utilização do CVS, consulte a ajuda on-line para equipes.

    O adaptador Rational ClearCase SCM e os plug-ins CVS devem ser ativados antes que possam ser utilizados. Para ativar os plug-ins:

    1. A partir do menu Rational Application Developer, selecione Window (Janela)>Preferences (Preferências).
    2. Na página Preferences (Preferências) em Workbench, clique em Recursos.
    3. Na janela Recursos, vá para Team (Equipe) e clique na caixa de opções dos adaptadores que deseja ativar.
    4. Clique em Apply (Aplicar) e, em seguida, em OK.

    Os plug-ins também podem ser ativados ao compartilhar um projeto, selecionando o fornecedor de repositório de equipe desejado.

    Nem o cliente ou o servidor Rational ClearCase nem o servidor CVS é instalado automaticamente. Eles precisam ser instalados separadamente do Rational Application Developer.

    Para obter informações sobre a instalação do cliente ClearCase LT, consulte "Instalando o Rational ClearCase LT".

    Para trabalhar com oRational Application Developer com outros sistemas SCM disponíveis, será necessário um adaptador específico para o produto SCM. Os adaptadores SCM geralmente são fornecidos pelo fornecedor do produto SCM. A IBM não endossa ou garante o uso de outros adaptadores SCM. Para obter suporte ou informações adicionais sobre os adaptadores para outros produtos SCM, entre em contato diretamente com o fornecedor do produto.


    Software Suportado

    IBM Rational ClearCase

    O adaptador Rational ClearCase SCM requer o ClearCase v2002 ou posterior (ClearCase completo ou ClearCase LT) com pelo menos com a correção mínima requerida, conforme listado nas tabelas a seguir:


    Tabela 3. Windows

    Versão do ClearCase e Correção Mínima Requerida
    IBM Rational ClearCase v2002.05.00 e p2002.05.00.NT-32
    IBM Rational ClearCase LT v2002.05.00 e clearcase_lt_p2002.05.00.NT-11
    IBM Rational ClearCase v2003.06.13
    IBM Rational ClearCase LT v2003.06.13

    Tabela 4. Linux

    Versão do ClearCase e Correção Mínima Requerida
    IBM Rational ClearCase v2002.05.00 e clearcase_p2002.05.00-38
    IBM Rational ClearCase LTv2002.05.00 e clearcase_lt_p2002.05.00-17
    IBM Rational ClearCase v2003.06.00 e clearcase_p2003.06.00-11
    IBM Rational ClearCase LT v2003.06.00 e clearcase_lt_p2003.06.00-6

    Atenção: Depois de instalar o Rational ClearCase (ou o ClearCase LT) e o Rational Application Developer, você deve assegurar que os ambientes do cliente e do servidor ClearCase sejam atualizados com a correção mais recente apropriada. As correções são obrigatórias para fornecer suporte apropriado para comparar e mesclar diagramas UML (Unified Modeling Language). Ao trabalhar com o Rational Application Developer, se você não atualizar o Rational ClearCase (ou o ClearCase LT) com a correção mais recente apropriada, poderá ocorrer corrupção do modelo ao comparar e mesclar arquivos do diagrama UML.

    Para obter releases e correções do Rational ClearCase, vá para www.ibm.com/software/awdtools/clearcase/support/index.html ou ligue para o IBM Rational Support no telefone 1-800-IBM-SERV (1-800-426-7378).

    IBM Rational ClearQuest

    O Rational Application Developer suporta a seguinte versão do Rational ClearQuest:

    O Rational ClearQuest é um sistema altamente flexível de monitoração de defeitos e alterações que organiza e automatiza os processos envolvidos ao submeter, designar, rastrear, testar e liberar controles de mudanças. Para obter informações adicionais sobre o Rational ClearQuest, vá para www.ibm.com/software/awdtools/clearquest/. O Rational ClearQuest Client para Eclipse fornece integração total entre o ClearQuest e a plataforma Eclipse, incluindo a Rational Software Development Platform.

    Para utilizar o Rational ClearQuest Client para Eclipse, você deve primeiro:

    Informações sobre como fazer download do Rational ClearQuest Client para Eclipse podem ser localizadas em www.ibm.com/support/docview.wss?uid=swg24007802. Consulte o arquivo Leia-me, que está disponível nesse URL, para obter instruções completas sobre a instalação.


    Instalando o Rational ClearCase LT

    Efetuando Download do Rational ClearCase LT

    O Rational ClearCase LT é uma ferramenta de gerenciamento de configuração para equipes de projeto pequenas. O ClearCase LT faz parte da família de produtos IBM Rational ClearCase, utilizada tanto para equipes de trabalho de projetos de pequeno porte como para empresas distribuídas e globais.

    O produto IBM Rational Software Development Platform adquirido dá direito a uma licença gratuita do Rational ClearCase LT.

    Se você não possui a mídia do produto ClearCase LT você deve fazer download e instalar a última versão suportada do ClearCase LT.

    Se você já possui a mídia do produto ClearCase LT v2002.05 ou ClearCase LT v2003.06, deverá fazer download e instalar as correções mais recentes do ClearCase LT para oferecer suporte à integração do ClearCase LT com o produto IBM Rational Software Development Platform.

    Para obter instruções sobre como obter a versão suportada mais recente do ClearCase LT e as correções obrigatórias mais recentes com suporte ao IBM Rational Software Development Platform, vá para IBM Rational Support, Technote número 1188585: www.ibm.com/support/docview.wss?uid=swg21188585. Ou, vá para www.ibm.com e digite 1188585 no quadro Search.

    Localizando as Notas sobre o Release e Instruções de Instalação

    Antes de instalar o Rational ClearCase LT, recomenda-se que você leia as notas sobre release e a documentação de instalação fornecida com o produto. Esta documentação está disponível on-line no IBM Publications Center no endereço www.ibm.com/shop/publications/order. Você também pode consultar www.ibm.com/software/rational/support/documentation/. Para abrir arquivos PDF do Acrobat, você deve ter o software Adobe Reader instalado, o qual pode ser transferido por download no endereço www.adobe.com/products/acrobat/readstep2.html.

    Para Windows. Faça download do IBM Rational ClearCase LT Release Notes for Windows e do Rational Software Desktop Products Installation Guide e Rational Software Server Products Installation Guide for Windows mais recentes a partir do IBM Publications Center, da seguinte forma:

    1. Selecione seu país/região na página de boas-vindas do Publications Center.
    2. Clique no link "Search for Publications". A página Quick Publications Center search é aberta.
    3. Para fazer download do Rational Software Desktop Products Installation Guide for Windows, Versão 2003.06.13:
      1. Digite S126-5304-01 no campo "Publication number" e pressione Enter.
      2. Na página resultante, escolha seu método preferido para fazer download do documento.
    4. Para fazer download do Rational Software Server Products Installation Guide for Windows, Versão 2003.06.13:
      1. Digite S126-5300-01 no campo "Publication number" e pressione Enter.
      2. Na página resultante, escolha seu método preferido para fazer download do documento.
    5. Para fazer download do Rational ClearCase LT Release Notes for Windows:
      1. Digite GI11-4669-03 no campo "Publication number" e pressione Enter.
      2. Na página resultante, escolha seu método preferido para fazer download do documento.

    Para Linux. Faça download do Rational ClearCase LT Release Notes e Rational ClearCase LT Installation Guide for Linux mais recentes no IBM Publications Center, da seguinte forma:

    1. Selecione seu país/região na página de boas-vindas do Publications Center.
    2. Clique no link "Search for Publications". A página Quick Publications Center search é aberta.
    3. Para fazer download do ClearCase LT Installation Guide para a Versão 2003.06.00 e posterior, edição UNIX:
      1. Digite S126-5310-00 no campo "Publication number" e pressione Enter.
      2. Na página resultante, escolha seu método preferido para fazer download do documento.
    4. Para fazer download do Rational ClearCase LT Release Notes for UNIX:
      1. Digite GI11-6232-00 no campo "Publication number" e pressione Enter.
      2. Na página resultante, escolha seu método preferido para fazer download do documento.

    Instalando o Rational ClearCase LT

    As instruções de instalação nesta seção servem para ajudá-lo a instalar o código do cliente e do servidor para Rational ClearCase LT. Consulte as instruções de instalação completas localizadas no Rational ClearCase LT Installation Guide quando instalar o produto.

    Para informar-se sobre as alterações na versão mais recente do Rational ClearCase LT, consulte o Rational ClearCase LT Release Notes. As instruções sobre a localização das notas sobre release para Windows e Linux podem ser localizadas acima.

    Se você estiver instalando o ClearCase LT em um sistema japonês, consulte a seção "Guidelines for Using ClearCase on Japanese Systems" no Rational ClearCase LT Release Notes.

    Instalando o Rational ClearCase LT no Windows

    1. Consulte o Guia de Instalação de Produtos do Desktop do ClearCase LT para obter detalhes sobre como se preparar para instalar o produto.
    2. No diretório raiz da imagem de instalação transferida por download, execute setup.exe.
    3. O Assistente de Configuração do Rational será aberto. Clique em Next (Avançar) para continuar.
    4. Na tela Seleção de Produtos, selecione Rational ClearCase LT.
    5. Escolha um dos seguintes métodos de implementação para instalação e configuração: Consulte o Guia de Instalação de Produtos do Desktop para informar-se sobre como selecionar um tipo de implementação.
    6. Para implementação corporativa:
      1. Siga as instruções na caixa de diálogo, para concluir o processo de configuração.
      2. Selecione Concluído, quando você tiver concluído todas as etapas de configuração.
    7. Para instalação de desktop a partir da imagem do CD:
      1. Selecione a instalação do software cliente e servidor ou apenas do software cliente. Clique em Next (Avançar) para continuar.
      2. O assistente Configuração é aberto. Clique em Next (Avançar) para continuar.
      3. Na próxima tela, haverá uma mensagem indicando "Há alguns avisos específicos de produtos para essa instalação: PARE! Antes de continuar com essa instalação, escolha todos os aplicativos e desative o software de antivírus."Conforme instruído, consulte o URL fornecido na mensagem de aviso (http://ibm.com/support/docview.wss?rs=203&context=SW000&q1=1135295&uid=swg21135295 ) antes de continuar com o processo de instalação. Leia o documento e adote todas as etapas necessárias para prevenir a provável corrupção do sistema, antes de continuar com a instalação. Clique em Next (Avançar) para continuar.
    8. Siga as instruções na tela para concluir o processo de configuração. Por padrão, o Rational ClearCase LT é instalado no diretório system_drive:\Program Files\Rational\. Selecione Concluído, quando você tiver concluído as etapas de configuração.
    9. Selecione Install (Instalar) para iniciar a instalação.

    Instalando o Rational ClearCase LT no Linux

    O ClearCase LT não suporta atualmente os códigos dos idiomas Unicode e você deve configurar explicitamente o código do idioma para uma configuração não-Unicode, para que o ClearCase LT funcione corretamente. O Red Hat Enterprise Linux 3.0 e o SLES (SuSE Linux Enterprise Server) Versão 9 configuram o código do idioma, por padrão, para Unicode (en_US.UTF-8 para instalações EUA) e também podem fazer isso para instalações internacionais. Se você estiver executando o ClearCase em uma dessas plataformas, poderá alterar a configuração do código do idioma da seguinte forma:

    Para instalar o Rational ClearCase LT Versão 2003.06.00 no Linux:

    1. Efetue login como usuário root, digitando: su
    2. No diretório no qual você fez download do Rational ClearCase LT, extraia o conteúdo do arquivo de download do ClearCase LT para uma área de release, da seguinte forma:
      1. Digite o comando mkdir /usr/ccase_lt_rls para criar o diretório de área de release. Observe que as instruções a seguir supõem que você utilizou /usr/ccase_lt_rls como o diretório de release. Se você especificou um nome diferente, precisará utilizá-lo no lugar de /usr/ccase_lt_rls.
      2. Execute o comando uncompress <nome_do_arquivo_cclt.Z> em que <nome_do_arquivo_cclt.Z> é o nome do arquivo tar compactado de download do ClearCase LT. O arquivo resultante terá a extensão .tar em vez de .tar.Z. Por exemplo, se o arquivo for nomeado C54UANA.tar.Z, o comando uncompress C54UANA.tar.Z produz um arquivo denominado C54UANA.tar.
      3. Expanda o arquivo tar no diretório de área de release, digitando o comando tar xvf <nome_do_arquivo_cclt> -C /usr/ccase_lt_rls em que <nome_do_arquivo_cclt> é o nome do arquivo tar descompactado do ClearCase LT.
      Nota:
      Os arquivos extraídos incluem a documentação do produto. Consulte o Release Notes e o ClearCase LT Installation Guide antes de continuar o processo de instalação.
      Para obter uma explicação da finalidade de uma área de release, consulte o ClearCase LT Installation Guide.
    3. Prepare sua área de release, executando site_prep e siga as instruções:
      cd /usr/ccase_lt_rls/rational_clearcase_lt/rhat_x86/clearcase/install
      ./site_prep

    4. Insira os valores para os avisos, de acordo com seus requisitos. Quando solicitado para fornecer o host de licença do ClearCase LT, especifique o nome do host de sua máquina. Consulte o Rational ClearCase LT Installation Guide para obter detalhes adicionais sobre como executar o site_prep.
    5. Instale o ClearCase executando install_release e siga as instruções:


      ./install_release
      Insira os valores para os avisos, de acordo com seus requisitos. A seguir está um exemplo de uma instalação do ClearCase LT Client no SLES (SuSE Linux Enterprise Server) Versão 9.

      1. Escolha "Instalação Local".
      2. Aceite o contrato de licença.
      3. Escolha "Instalação Padrão"
      4. Escolha "3. Instalação do ClearCase LT Client".
      5. Quando o programa install_release for encerrado, ele fornecerá uma mensagem informando que foi concluído sem erros. A mensagem também fornece o local e o nome do arquivo de log.
      Consulte o Rational ClearCase LT Installation Guide para obter detalhes adicionais sobre como executar o install_release.
    6. Inclua o executável ClearCase em seu caminho de procura.

      Por exemplo, se estiver utilizando um shell Bourne, você pode executar o seguinte comando para modificar o caminho:
      PATH=${PATH}:/opt/rational/clearcase/bin
      export PATH

      Consulte o Guia de Instalação para obter instruções detalhadas e para obter informações adicionais sobre a personalização do ambiente do host cliente para ClearCase LT.

    7. Se ainda não tiver instalado o Rational Application Developer, faça agora.
    8. Para verificar se o ClearCase foi instalado corretamente, execute o seguinte comando a partir de um ID de usuário diferente de root. Se o comando for bem sucedido, o host conseguirá adquirir uma licença do ClearCase LT. Se for retornada uma mensagem de erro, consulte a documentação do ClearCase LT.
      cleartool hostinfo -long
    9. Inicie o Rational Development Platform e certifique-se de que você possa conectar-se ao ClearCase.
    Nota:
    Por padrão, a área de release é o local para os arquivos de instalação extraídos, que incluem os arquivos para o programa de desinstalação. Se você excluir esse diretório, você não poderá executar o programa de desinstalação.

    Configurando a Licença do Rational ClearCase LT

    Quando o Rational Application Developer estiver instalado no mesmo computador que o Rational ClearCase LT, não será necessário configurar a licença do Rational ClearCase LT. No entanto, se você instalar o Rational ClearCase LT sem o Rational Application Developer, precisará configurar a Licença do ClearCase LT. Para obter detalhes sobre como configurar o licenciamento, consulte o ClearCase LT Installation Guide.

    A licença do Rational ClearCase LT incluída no Rational Application Developer não inclui uma licença para a interface Web do Rational ClearCase. Se você quiser utilizar a interface da Web do Rational ClearCase, será preciso adquirir as licenças adicionais do Rational ClearCase ou ClearCase LT a partir do software IBM Rational. Para obter informações adicionais sobre como obter licenças, entre em contato com o IBM Rational Support no telefone 1-800-IBM-SERV (1-800-426-7378).


    Utilizando o Rational ClearCase com o Rational Application Developer

    Para obter informações sobre como utilizar Rational ClearCase, consulte a ajuda on-line do ClearCase.


    Corrigindo Tipos de Elementos de Diagramas Pré-existentes

    Se arquivos de diagrama tiverem registrado entrada em VOBs (Versioned Object Bases) no ambiente do ClearCase antes de corrigir ou configurar o ambiente conforme descrito acima, execute o seguinte comando para alterar o tipo de arquivo dos elementos no VOB para que possam ser mesclados corretamente:

    cleartool find . -name *.emx -exec "cleartool chtype -force xtools2 %CLEARCASE_PN%"
    

    Desinstalando o Rational ClearCase LT

    Para Windows. Para desinstalar o Rational ClearCase LT no Windows:

    1. Feche o Rational Application Developer.
    2. Abra o Painel de Controle, em seguida, abra a janela Adicionar ou Remover Programas. Selecione Rational ClearCase LT e clique em Change/Remove (Alterar/Remover) para desinstalar.
    3. Siga as instruções do assistente para desinstalar o produto.

    Para Linux. Para desinstalar o Rational ClearCase LT no Linux:

    1. Efetue login como usuário root, digitando: su
    2. Execute install_release a partir do diretório da área de release. Por exemplo, se a área de release estiver localizada no diretório /usr/ccase_lt_rls, digite:
       cd /usr/ccase_lt_rls/rhat_x86/clearcase/install
      ./install_release
      
    3. Selecione Desinstalação Local para remover o software do computador local.

    Capítulo 8. Instalando o WebSphere Application Server 5.x como um Ambiente de Teste Integrado

    Por padrão, o WebSphere Application Server 6.0 é instalado automaticamente com o Rational Application Developer. Se você planeja desenvolver aplicativos que ainda são executados nos servidores de aplicativos 5.x, como opção, é possível instalar ambientes de teste do tempo de execução adicionais.

    Você deve ter o Rational Application Developer instalado antes de poder instalar o ambiente de teste de tempo de execução adicional.

    Você tem a opção de instalar os seguintes ambientes de teste integrados:

    Para instalar um ou mais ambientes de teste integrados de nível anterior, siga estas etapas:

    1. Na barra de lançamento do Rational Application Developer, clique em Instalar o Ambiente de Teste do WebSphere V5.x (Instalar o Ambiente de Teste do WebSphere V5.x). O instalador de Ambientes de Teste Integrados do IBM Rational 5.x é aberto.
    2. Clique em Next (Avançar).
    3. Aceite o acordo de licença e clique em Next (Avançar).
    4. Selecione os ambientes de teste integrados que deseja instalar. Clique em Next (Avançar).
    5. Reveja as informações de resumo e clique em Next (Avançar) para iniciar a instalação. Essa instalação de resumo incluirá o local dos ambientes de teste sendo instalados.
    6. Clique em Finish (Concluir) para sair do instalador quando a instalação for concluída.
    Nota:
    Se você instalar o recurso de suporte ao sistema de mensagens incorporado e enfileiramento, os ambientes de teste do WebSphere versão 5.x não devem ser desinstalados antes da desinstalação do sistema de mensagens incorporado e do recurso de enfileiramento.



    Para desinstalar os ambientes de teste da versão 5.x no Windows, siga estas etapas:

    1. Abra o Painel de Controle.
    2. Clique em Adicionar ou Remover Programas.
    3. Clique em IBM Rational 5.x Legacy Integrated Test Environments e clique em Change/Remove (Alterar/Remover).
    4. O desinstalador de Ambientes de Teste do IBM Rational 5.x é aberto. Clique em Next (Avançar).
    5. Selecione os ambientes de teste que deseja desinstalar e clique em Next (Avançar).
    6. Reveja as informações de resumo e clique em Next (Avançar).
    7. Clique em Finish (Concluir) para sair do desinstalador quando os ambientes de teste tiverem sido desinstalados.


    Para Linux
    Para desinstalar os ambientes de teste legado no Linux, siga estas etapas:

    1. Efetue login como root.
    2. Vá para o subdiretório lte_prod/_uninst em seu diretório de instalação.
    3. Desinstale os ambientes de teste da versão 5.x, digitando este comando: ./uninstall.bin. Se você estiver trabalhando em um gerenciador de arquivos, poderá clicar no arquivo para ativar o desinstalador.
    4. O desinstalador de Ambientes de Teste do IBM Rational 5.x é aberto. Clique em Next (Avançar).
    5. Selecione os ambientes de teste que deseja desinstalar e clique em Next (Avançar).
    6. Reveja as informações de resumo e clique em Next (Avançar).
    7. Clique em Finish (Concluir) para sair do desinstalador quando os ambientes de teste tiverem sido desinstalados.

    Capítulo 9. Instalando o Suporte ao Sistema de Mensagens e Enfileiramento para os Ambientes de Teste do WebSphere Versão 5.x

    Importante: você deve instalar os ambientes de teste do Rational Application Developer e do WebSphere versão 5.x antes de instalar o recurso de suporte ao sistema de mensagens e enfileiramento.

    Não será necessário instalar esse recurso se uma das seguintes condições for verdadeira:

    Se você desejar testar seus aplicativos JMS nos ambientes de teste do WebSphere versão 5.x (esses ambientes de teste de unidade estão incluídos no Rational Application Developer) utilizando o sistema de mensagens incorporado, deve instalar a função adicional de sistema de mensagens que está incluída nesse produto. Esse é o mesmo recurso de sistema de mensagens incorporado que é fornecido com o IBM WebSphere V5.x Application Server. O recurso de sistema de mensagens incorporado só precisará ser instalado a partir do Rational Application Developer ou do WebSphere Application Server V5.x. Instalar as duas versões fará com que a instalação posterior sobrescreva a anterior.

    É necessário, no mínimo, 200 MB de espaço em disco para instalar com êxito o recurso de sistema de mensagens e de filas.


    Instalando e Desinstalando o Suporte ao Sistema de Mensagens e Enfileiramento no Windows

    Ao instalar o suporte de sistema de mensagens e enfileiramento a partir do CD de instalação do Rational Application Developer, o WebSphere MQ e o WebSphere Messaging Publish and Subscribe são instalados.

    Limitações:

    Embora o suporte ao sistema de mensagens e enfileiramento não tenha sido instalado, você pode receber a mensagem "Embedded Messaging Client only has been installed" (Apenas o Cliente de Mensagens Integrado foi instalado) no início do servidor. Essa mensagem se refere ao código de cliente incorporado do MQ Simulator para Java Developers e não ao código de suporte ao sistema de mensagens e enfileiramento. A mensagem pode ser ignorada sem problemas.

    Instalando a partir do CD-ROM

    Para instalar o recurso de sistema de mensagens incorporado para ser utilizado com os ambientes de teste do WebSphere versão 5.x:

    1. Pare o Rational Application Developer, se ele tiver sido iniciado.
    2. Insira o CD de instalação do Rational Application Developer.
    3. Se a execução automática estiver desativada em seu sistema, execute launchpad.exe na raiz do CD de instalação.
    4. Selecione Install embedded messaging client and server (Instalar cliente e servidor do sistema de mensagens incorporado) na janela Installation Launchpad (Launchpad de Instalação) e siga as instruções da tela. A instalação não continuará se um ambiente de tempo de execução de teste da versão 5.x não tiver sido instalado.

      O diretório de instalação de destino padrão é system_drive:\Arquivos de Programas\IBM\WebSphere MQ\ (em que system_drive é a unidade de disco rígido em que o Windows está instalado).

    5. Quando o suporte a sistema de mensagens e enfileiramento for instalado, clique em Finish (Concluir) para fechar a janela de instalação.
    6. Para verificar uma instalação bem-sucedida:

    Chamando uma Instalação Silenciosa

    Para instalar o recurso de sistema de mensagens embutido silenciosamente:

    1. Pare o Rational Application Developer, se ele tiver sido iniciado.
    2. Insira o CD de instalação do cliente do sistema de mensagens incorporado.
    3. No diretório IBM_Embedded_MQ do CD de instalação para suporte ao sistema de filas e de mensagens, digite o seguinte comando em uma linha:
      java -cp setup.jar -Dis.media.home="<cd_rom>\IBM_Embedded_MQ\setup"
       -Dis.external.home="<cd_rom>\IBM_Embedded_MQ" run -silent
      

      em que cd_rom é a letra da unidade do CD-ROM. E pressione Enter.

      Nota:
      Ao executar uma instalação silenciosa do suporte ao sistema de mensagens e enfileiramento para Windows, o programa de instalação não informa quando ela é concluída. Para corrigir esse problema, digite a linha de comandos:
       RA_installdir\runtimes\base_v5\java\bin\java -cp setup.jar 
      

      ou

       RA_installdir\runtimes\base_v51\java\bin\java -cp setup.jar
      

      em que RA_installdir é o diretório de instalação do Rational Application Developer

    4. Para verificar uma instalação bem-sucedida:

    Desinstalando o Suporte a Sistema de Mensagens e Enfileiramento

    Restrição: os ambientes de teste do WebSphere versão 5.x devem estar presentes e não ser desinstalados antes da desinstalação do recurso de sistema de mensagens incorporado e enfileiramento. A desinstalação do recurso de sistema de mensagens e enfileiramento embutido removerá todos os dados de usuário do MQ.

    Para desinstalar o recurso de mensagens embutido:

    1. Pare o Rational Application Developer, se ele tiver sido iniciado.
    2. Na janela Adicionar ou Remover Programas, selecione embedded messaging client and server (cliente e servidor do sistema de mensagens incorporado) e, em seguida, clique em Remover.
    3. Siga as instruções da tela para remover o recurso de sistema de mensagens embutido.

    Instalando e Desinstalando o Suporte ao Sistema de Mensagens e Enfileiramento no Linux

    Ao instalar o suporte de sistema de mensagens e enfileiramento a partir do CD de instalação do Rational Application Developer, o WebSphere MQ e o WebSphere Messaging Publish and Subscribe são instalados.

    Limitações:

    Embora o suporte ao sistema de mensagens e enfileiramento não tenha sido instalado, você pode receber a mensagem "Embedded Messaging Client only has been installed" (Apenas o Cliente de Mensagens Integrado foi instalado) no início do servidor. Essa mensagem se refere ao código de cliente incorporado do MQ Simulator para Java Developers e não ao código de suporte ao sistema de mensagens e enfileiramento. A mensagem pode ser ignorada sem problemas.

    Instalando o Suporte a Sistema de Mensagens e Enfileiramento

    Se você for instalar o suporte a sistema de mensagens e enfileiramento em sua máquina pela primeira vez, configure os grupos de usuários conforme descrito na próxima seção.

    Configurando os Grupos de Usuários

    Antes de instalar o suporte de sistema de mensagens e enfileiramento pela primeira vez, é necessário criar dois grupos de usuários (mqm e mqbrkrs), adicionar o usuário padrão a cada grupo e, em seguida, adicionar a raiz a cada grupo:

    1. Efetue login como usuário root.
    2. Em uma janela do terminal, digite o seguinte comando para criar o grupo de usuários mqm:
      groupadd mqm
      
    3. Crie o grupo de usuários mqbrkrs:
      groupadd mqbrkrs
      
    4. Crie um ID de usuário mqm com o grupo padrão mqm:
      useradd mqm -g mqm
      
    5. Crie um ID de usuário mqbrkrs com o grupo padrão mqbrkrs:
      useradd mqbrkrs -g mqbrkrs
      
    6. Adicione o usuário root e os usuários non-root que vão executar os aplicativos JMS aos grupos de usuários mqm e mqbrkrs:
      1. Edite o arquivo /etc/group.
      2. Localize a linha do grupo mqm. (Por exemplo, mqm:x:101:mqm. Essa linha pode ser um pouco diferente em seu arquivo etc/group). Edite essa linha incluindo uma extensão 'root'. Nesse exemplo, seria mqm:x:101:mqm,root.
      3. Localize a linha do grupo mqbrkrs. Por exemplo, mqbrkrs:x:102:mqm.Essa linha pode ser um pouco diferente em seu arquivo etc/group. Edite essa linha incluindo uma extensão 'root'. Neste exemplo, seria mqbrkrs:x:102:mqm,root.
      4. Feche o arquivo e salve as alterações
      5. Efetue logoff.

    Instalando o Recurso de Sistema de Mensagens Embutido

    Para instalar o recurso de sistema de mensagens embutido:

    1. Efetue login como usuário root.
    2. Pare o Rational Application Developer, se ele tiver sido iniciado.
    3. Insira o CD de instalação do Rational Application Developer no CD-ROM.
    4. Se o CD-ROM não estiver montado, faça a montagem digitando:
      mount CD_device
      

      em que CD_device, por padrão, é /cdrom no SuSE e /mnt/cdrom no Red Hat.

    5. Para exibir a janela Launchpad de Instalação, digite:
      CD_device/launchpad.bin
      
    6. Selecione Install embedded messaging client and server (Instalar cliente e servidor do sistema de mensagens incorporado).
    7. Será solicitada a inserção do CD de instalação do Rational Application Developer para o cliente e o servidor de mensagens incorporadas.
    8. Siga as instruções na tela. O diretório de instalação de destino padrão é /opt/IBM/WebSphereMQ.
    9. Quando o suporte a sistema de mensagens e enfileiramento for instalado, clique em Finish (Concluir) para fechar a janela de instalação.
    10. Para verificar uma instalação bem-sucedida:

    Chamando uma Instalação Silenciosa

    Para instalar o recurso de sistema de mensagens embutido silenciosamente:

    1. Pare o Rational Application Developer, se ele tiver sido iniciado.
    2. Se você estiver instalando o suporte ao sistema de mensagens e enfileiramento para os ambientes de teste do V5.x pela primeira vez, conclua as etapas descritas em "Configurando os Grupos de Usuários".
    3. Insira o CD de instalação do Rational Application Developer.
    4. A partir do diretório IBM_Embedded_MQ do CD de instalação do cliente do sistema de mensagens incorporado, digite o seguinte comando em uma linha:
      ./setup.bin -silent 
      
    5. Para verificar uma instalação bem-sucedida:

    Desinstalando o Suporte a Sistema de Mensagens e Enfileiramento

    Restrição: os ambientes de teste do WebSphere versão 5.x devem estar presentes e não ser desinstalados antes da desinstalação do recurso de sistema de mensagens incorporado e enfileiramento. A desinstalação do recurso de sistema de mensagens e enfileiramento embutido removerá todos os dados de usuário do MQ.

    Para desinstalar o recurso de mensagens e enfileiramento:

    1. Efetue login como usuário root.
    2. Vá para o diretório de instalação (por exemplo, /opt/IBM/WebSphereMQ).
    3. Tipo:
      ./_uninst/uninstaller.bin
      

    Se a desinstalação do suporte ao sistema de mensagens e enfileiramento falhar, verifique o arquivo de log (/tmp/EmbeddedMQ.log).


    Capítulo 10. Instalando o WebSphere Portal Test Environment Versão 5.0

    O WebSphere Portal Test Environment permite testar aplicativos de portal a partir do workbench. Ele está disponível somente no Windows.

    Você deve ter o seguinte hardware instalado antes de instalar o WebSphere Portal Test Environment:

    Todos os outros requisitos são iguais aos mencionados anteriormente para o Rational Application Developer.

    Para instalar o ambiente de teste do portal, siga estas etapas:

    1. Se você instalou o WebSphere Application Server, WebSphere Portal, WebSphere Application Server Integrated Test Environment ou WebSphere Portal Integrated Test Environment, assegure-se de que todos eles estejam parados e assegure-se de parar quaisquer servidores HTTP. Caso contrário, a instalação pode falhar.
    2. A partir da barra de lançamento de instalação do Rational Application Developer, clique em Instalar o WebSphere Portal V5.0 Test Environment. O instalador do WebSphere Portal Test Environment é aberto.
    3. Clique em Next (Avançar).
    4. Aceite o acordo de licença e clique em Next (Avançar).
    5. O ambiente de teste do portal é instalado automaticamente no diretório de instalação do Rational Application Developer. Clique em Next (Avançar).
    6. Clique em Finish (Concluir) para sair do assistente quando a instalação do ambiente de teste do portal for concluída.

    Utilizando o Banco de Dados DB2 ou Oracle como o Repositório de Configuração do WebSphere Portal

    Por padrão, o WebSphere Portal V5.0 Test Environment instala e utiliza o banco de dados Cloudscape para armazenar informações sobre identidades do usuário, credenciais e permissão para acessar recursos do portal. Cloudscape é um banco de dados Java interno do WebSphere Portal que está bem adaptado aos ambientes básicos do portal.

    Para instalar e configurar um banco de dados DB2 ou Oracle, consulte o WebSphere Portal Versão 5.0.2 InfoCenter em www.ibm.com/websphere/portal/library. Você pode localizar as instruções no WebSphere Portal Versão 5.0.2 InfoCenter em Instalando > Banco de Dados. Antes de iniciar as etapas para configurar o WebSphere Portal com o DB2 ou Oracle, observe que você precisará alterar o diretório para o subdiretório \runtimes\portal_base_v5\config do diretório no qual o Rational Application Developer está instalado e executar o seguinte comando:

     WPSconfig.bat wpcpconfigure
    

    Observe que ao consultar as instruções de configuração no InfoCenter, <raiz_do_wp> no InfoCenter corresponde ao subdiretório \runtimes\portal_v50 do diretório no qual o Rational Application Developer está instalado e <raiz_do_was> corresponde ao subdiretório \runtimes\portal_base_v5 do diretório no qual o Rational Application Developer está instalado. Para verificar a conexão com o banco de dados, você criará o WebSphere Portal 5.0 Test Environment e iniciará o servidor, em vez de seguir as etapas descritas no InfoCenter.

    Desinstalando o WebSphere Portal Test Environment 5.0

    Para desinstalar, siga estas etapas:

    1. Abra o Painel de Controle.
    2. Clique em Adicionar ou Remover Programas.
    3. Selecione WebSphere Portal V5.0 Test Environment e clique no botão Change/Remove (Alterar/Remover).
    4. Siga as instruções da tela para desinstalar o ambiente de teste do portal.

    Em alguns casos, como uma instalação interrompida, o desinstalador pode não estar concluído e funcional. Nesses casos, utilize o seguinte procedimento para concluir a desinstalação manualmente:

    1. Chame o regedit.exe em um prompt de comandos para editar o registro do sistema Windows.

      Manipule o Registro com cuidado: Você pode cometer um erro facilmente ao utilizar o editor do regedit.exe para visualizar e editar o conteúdo do registro. O editor não o adverte dos erros de edição, que podem ser extremamente perigosos. Um registro danificado pode prejudicar seu sistema a ponto de sua única opção ser a de reinstalar o sistema operacional Windows.

      1. Expanda e selecione a chave HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Portal Server\5.0.0.0.
      2. Clique em Edit (Editar) > Delete (Excluir) na barra de menus para excluir a chave.
      3. Clique em Yes (Sim) quando solicitado para confirmar a exclusão da chave.
      4. Clique em Registry (Registro) > Exit (Sair) na barra de menus, quando concluído.
    2. Exclua os seguintes diretórios, inclusive os subdiretórios, do diretório <diretório_de_instalação_do_rational>\runtimes:
      1. portal_base_v5
      2. portal_v50

      em que <diretório_de_instalação_do_rational> é o diretório no qual você instalou o Rational Application Developer.


    Capítulo 11. Instalando o WebSphere Portal Test Environment Versão 5.1

    O Portal Test Environment permite testar aplicativos do portal a partir do workbench. A versão 5.1 fornece nova funcionalidade sobre a versão 5.0 e é suportada em todos os ambientes Windows suportados pelo Rational Application Developer. Também é suportada no Red Hat Enterprise Linux Workstation, Versão 3.0.

    Nota:
    O WebSphere Application Sever 5.1 é instalado automaticamente com o WebSphere Portal Test Environment versão 5.1.

    Você deve ter o seguinte hardware instalado antes de instalar o WebSphere Portal Test Environment:

    Todos os outros requisitos são iguais aos mencionados anteriormente para o Rational Application Developer.

    Instalando a partir do CD-ROM

    Você deve ter o Rational Application Developer instalado antes de poder instalar o ambiente de teste do portal. É recomendável parar o Rational Application Developer antes de iniciar a instalação do ambiente de teste do portal.

    Para instalar o WebSphere Portal Test Environment 5.1, siga estas etapas:

    1. Se você instalou o WebSphere Application Server, WebSphere Portal, WebSphere Application Server Integrated Test Environment ou WebSphere Portal Integrated Test Environment, assegure-se de que todos eles estejam parados e assegure-se de parar quaisquer servidores HTTP. Caso contrário, a instalação pode falhar.
    2. Insira o CD de configuração do WebSphere Portal 5.1. (O Portal Test Environment não pode ser instalado a partir da barra de lançamento de instalação do Rational Application Developer).
    3. Em sistemas Windows, o programa de instalação deverá ser ativado automaticamente. Se não for, execute o arquivo install.bat a partir da raiz do CD de instalação. Em sistemas Linux, execute o install.sh a partir da raiz do CD de instalação.
    4. Selecione o idioma em que você deseja executar o programa de instalação e clique em OK para continuar
    5. Leia as informações na Página de Boas-vindas do programa de instalação e clique em Next (Avançar).
    6. Aceite o acordo de licença e clique em Next (Avançar)
    7. Selecione o botão de opções Test Environment (Ambiente de Teste) e clique em Next (Avançar).
      Nota:
      Dependendo de sua plataforma, você poderá receber uma mensagem de erro indicando que a verificação de pré-requisito do sistema operacional falhou. Isso ocorre porque alguns sistemas operacionais (por exemplo, Red Hat Enterprise Linux Workstation Versão 3.0) são suportados apenas no ambiente de teste do portal. Você pode ignorar seguramente essa mensagem -- clique em OK para continuar com a instalação.
    8. Aceite o diretório de instalação padrão para o WebSphere Application Server V5.1 ou procure e selecione um novo e clique em Next (Avançar). O diretório de instalação padrão é C:\Program Files\Portal51UTE\AppServer para Windows e opt/Portal51UTE/AppServer para Linux. A menos que você não tenha espaço suficiente, recomenda-se o diretório de instalação padrão.
    9. Aceite o diretório de instalação padrão para o Portal Test Environment ou procure e selecione um novo e clique em Next (Avançar). O diretório de instalação padrão é C:\Program Files\Portal51UTE\PortalServer para Windows e opt/Portal51UTE/PortalServer para Linux. A menos que você não tenha espaço suficiente, recomenda-se o diretório de instalação padrão.
    10. Especifique o ID do usuário e a senha que você deseja utilizar com o Portal Test Environment. Clique em Next (Avançar).
    11. Reveja as informações na tela de resumo e clique em Next (Avançar)
    12. Quando solicitado, insira o CD apropriado do WebSphere Portal 5.1 e especifique o local de sua unidade.
    13. Quando a instalação estiver concluída, clique em Finish (Concluir) para fechar o programa de instalação.

    Notas:

    Consulte "Configurando o WebSphere Portal Test Environment V5.1" no arquivo de ajuda on-line para obter informações sobre como configurar o Portal Test Environment 5.1 para que funcione com o Rational Application Developer.

    Instalando a partir de Imagens Eletrônicas

    Para facilitar a instalação do software, crie o diretório apropriado e, em seguida, faça download e extraia o conteúdo de cada arquivo nesse diretório.

    Nota:
    Você deve fazer download, extrair e executar as imagens na mesma plataforma suportada pela imagem. Por exemplo, se o título de uma imagem listar apenas Windows, você poderá fazer download, extrair e executar essa imagem apenas em um sistema Windows.

    As seguintes imagens de CD são requeridas para o WebSphere Portal Test Environment versão 5.1:

    Execute as seguintes etapas para criar os diretórios apropriados e fazer download dos arquivos:

    1. Crie um diretório para cada imagem que você fará download .

      Crie novos diretórios dentro de um diretório comum na mesma máquina e nomeie os novos diretórios de acordo com o identificador de disco correspondente que é fornecido no título, precedido pelos caracteres cd. Por exemplo, cdSetup, cd1-1, cd1-2 e assim por diante.

    2. Faça download de cada imagem e extraia o conteúdo.

      Faça download de cada imagem em seu próprio diretório. As etapas mostradas a seguir fornecem instruções sobre como fazer download e extrair uma imagem específica. Estas etapas utilizam a seguinte imagem como exemplo:
      WebSphere Portal V5.1 - Setup Manager para Windows e Linux (Configuração) para português do Brasil, francês, alemão, inglês internacional, italiano, Japonês, coreano, chinês simplificado, espanhol, chinês tradicional


      Nome do Arquivo C7003ML.zip

      Para fazer download e extrair o conteúdo dessa imagem, execute as seguintes etapas:

      1. Crie um diretório denominado cdSetup.
      2. Faça download do C7003ML.zip para o diretório cdSetup.
      3. Extraia os arquivos de C7003ML.zip para o diretório cdSetup.
    3. Quando você estiver pronto para instalar as imagens extraídas, consulte a seção "Instalando a partir do CD-ROM" acima.

    Utilizando o Banco de Dados DB2 ou Oracle como o Repositório de Configuração do WebSphere Portal

    Por padrão, o WebSphere Portal V5.1 Test Environment instala e utiliza o banco de dados Cloudscape para armazenar informações sobre identidades do usuário, credenciais e permissões para acessar recursos do portal. Cloudscape é um banco de dados Java interno do WebSphere Portal que está bem adaptado aos ambientes básicos do portal.

    Para instalar e configurar um banco de dados DB2 ou Oracle, consulte o WebSphere Portal V5.1 InfoCenter em www.ibm.com/websphere/portal/library. Você pode localizar as instruções no WebSphere Portal versão 5.1 InfoCenter em Configurando > Banco de Dados. Observe que ao consultar as instruções de configuração no InfoCenter, <raiz_do_wp> no InfoCenter corresponde ao diretório de instalação do WebSphere Portal 5.1 Test Environment e <raiz_do_was> no InfoCenter corresponde ao configuração do WebSphere Application Server V5.1 (consulte acima os locais padrão). Além disso, para verificar a conexão com o banco de dados, você criará o WebSphere Portal 5.1 Test Environment e iniciará o servidor, em vez de seguir as etapas no InfoCenter.

    Configurando o WebSphere Portal Test Environment Versão 5.1

    Você precisa configurar o Portal Test Environment 5.1 para que funcione com o Rational Application Developer, da seguinte forma:

    1. Inicie o Rational Application Developer.
    2. Na barra de menus, selecione Window (Janela) > Preferences (Preferências) > Server (Servidor) > Installed Runtimes (Tempos de Execução Instalados). Aparece a página Ambientes de Tempo de Execução do Servidor Instalados.
    3. Selecione o stub do WebSphere Portal v5.1 e selecione Edit (Editar). Aparece a página Edit (Editar) Tempo de Execução do Servidor.
    4. Altere o nome para WebSphere Portal v5.1 e especifique o Local do WebSphere Portal e o Local do WebSphere Application Server. (Por exemplo, C:\Program Files\Portal51UTE\PortalServer e C:\Program Files\Portal51UTE\AppServer respectivamente).
    5. Clique em Finish (Concluir) e clique em OK.

    Desinstalando o Portal Test Environment V5.1

    Para desinstalar o Portal Test Environment, siga estas etapas:

    1. Vá para o diretório no qual você instalou o Portal Test Environment.
    2. Vá para o subdiretório PortalServer\uninstall e execute o aplicativo uninstall.
    3. Siga as instruções na tela.

    Em alguns casos, como uma instalação interrompida, o desinstalador pode não estar concluído e funcional. Nesses casos, você precisará concluir a desinstalação manualmente. Consulte o WebSphere Portal V5.1 InfoCenter para obter detalhes sobre como desinstalar manualmente o WebSphere Portal Test Environment versão 5.1.


    Capítulo 12. Instalando o Crystal Enterprise

    Crystal Enterprise é uma arquitetura comum para entrega de acesso de dados, de relatório e de informações. É desenvolvido para integrar-se perfeitamente com investimentos de dados, da Web e de aplicativos existentes. Baseado no Crystal Reports, o Crystal Enterprise é uma solução efetiva para obter informações em escala para milhares de usuários.

    O Crystal Enterprise Embedded Edition inclui um servidor de relatórios on-demand para aplicativos da Web e é ideal para relatórios incorporados em um único aplicativo departamental. Ele está disponível apenas para Windows.

    O Crystal Enterprise Professional Edition é uma plataforma centralizada para gerenciamento e distribuição de relatórios complexos e interativos com segurança, através da Web ou integrada a aplicativos do portal da intranet, extranet, Internet e associados. O Professional Edition inclui todas as funções do Embedded Edition e está disponível para Windows e Linux.

    Para obter uma comparação mais detalhada do Crystal Enterprise Embedded e Professional Editions, consulte www.businessobjects.com/global/pdf/products/reporting/crystalenterprise/ce10_editions.pdf. (Para abrir os arquivos PDF do Acrobat, você deve ter o software Adobe Reader instalado, o qual pode ser transferido por download no endereço www.adobe.com/products/acrobat/readstep2.html). Para obter informações adicionais sobre o Crystal Enterprise em geral, consulte www.businessobjects.com/products/reporting/crystalenterprise/default.asp.

    Como um conjunto integrado para entrega de relatório, análise e informações, o Crystal Enterprise oferece uma solução para aumentar a produtividade do usuário final e reduzir os esforços administrativos.

    Instalando o Crystal Enterprise V10 Embedded Edition

    Para instalar o Crystal Enterprise V10 Embedded Edition, siga estas etapas:

    1. Insira o disco do Crystal Enterprise V10 Embedded Edition.
    2. Na barra de lançamento de instalação do Rational Application Developer, clique em Instalar o Crystal Enterprise V10 Embedded Edition. O instalador do Crystal Enterprise é aberto.
    3. Clique em Next (Avançar). Aceite o acordo de licença e clique em Next (Avançar) novamente.
    4. Você pode selecionar uma instalação Full (Completa) ou uma instalação Custom (Personalizada).
      1. A instalação padrão é uma instalação Full (Completa). Essa é a opção recomendada e instala todos os componentes padrão no seguinte local: C:\Program Files\Crystal Decisions.
      2. Se você quiser personalizar qualquer coisa sobre a instalação, como por exemplo o local, selecione o botão de opções Personalizar e clique em Next (Avançar). Personalize suas opções conforme desejado. Para obter informações adicionais sobre as opções de instalação personalizada, consulte o arquivo install.pdf na subpasta en/docs no CD Crystal Enterprise V10 Embedded Edition.
    5. Clique em Next (Avançar) para continuar e, em seguida, clique em Next (Avançar) novamente para iniciar a instalação.
    6. Quando a instalação for concluída, clique em Next (Avançar) para registrar o Crystal Enterprise ou em Register Later (Registrar Mais Tarde) para registrar o produto mais tarde.
    7. Clique em Finish (Concluir) para sair do assistente de instalação.

    Você também pode instalar o Crystal Enterprise V10 Embedded Edition em japonês. Execute setup.exe no subdiretório jp, para ativar o assistente de instalação e siga as mesmas instruções como listado acima.

    Desinstalando o Crystal Enterprise V10 Embedded Edition

    Para desinstalar o Crystal Enterprise (edição em inglês ou em japonês), siga estas etapas:

    1. Abra o Painel de Controle.
    2. Clique em Adicionar ou Remover Programas.
    3. Selecione o Crystal Enterprise 10 Embedded e clique no botão Remover.

    O Crystal Enterprise será removido de seu sistema.

    Instalando o Crystal Enterprise V10 Professional Edition

    Para Windows. Para instalar o Crystal Enterprise V10 Professional Edition no Windows, siga estas etapas:

    1. Insira o disco do Crystal Enterprise V10 Professional Edition para Windows.
    2. Na barra de lançamento de instalação do Rational Application Developer, clique em Instalar o Crystal Enterprise V10 Professional Edition. O instalador do Crystal Enterprise é aberto.
    3. Clique em Next (Avançar). Aceite o acordo de licença e clique em Next (Avançar).
    4. Você pode aceitar o diretório de instalação padrão ou Procurar um novo. Clique em Next (Avançar).
    5. Há três tipos de instalações diferentes disponíveis: New (Nova), Expand (Expandir) e Custom (Personalizar).
      1. A opção padrão é uma instalação New (Nova). Essa opção instalará um novo Crystal Enterprise System.
      2. Se você desejar expandir um Crystal Enterprise System existente, selecione o botão de opções Expand (Expandir) e clique em Next (Avançar). Você pode digitar o Existing CMS Name (Nome do CMS Existente) (em que CMS é o Crystal Management Server) e selecionar os servidores que deseja incluir em seu Crystal Enterprise System. Para obter informações adicionais sobre como expandir um sistema Crystal Enterprise existente, consulte o arquivo docs\install.pdf no CD do Crystal Enterprise V10 Professional Edition.

      Se você quiser personalizar quais recursos de aplicativos serão instalados, selecione o botão de opções Personalizar e clique em Next (Avançar). Selecionar os recursos que você deseja instalar. Para obter informações adicionais sobre instalações personalizadas, consulte o arquivo docs\install.pdf no CD do Crystal Enterprise V10 Professional Edition.

    6. Clique em Next (Avançar) para continuar.
    7. Se você não tiver um servidor da Web compatível instalado, receberá uma mensagem de aviso. Clique em Next (Avançar) para continuar.
    8. Se você selecionou uma instalação Nova e o programa de configuração detectar um MSDE (Microsoft Data Engine) ou SQL Server, uma caixa de diálogo Autenticação do Microsoft SQL Server será aberta. É necessário fornecer o ID e a senha correspondentes à conta do banco de dados configurada para o CMS (Crystal Management Server). Do contrário, se o programa de configuração não detectar um banco de dados MSDE ou SQL Server existente, a caixa de diálogo Configuração de Segurança do MSDE será aberta. É necessário fornecer um ID e uma senha para a conta do administrador SQL padrão que será instalada juntamente com o MSDE. Para obter informações adicionais sobre o CMS (Crystal Management Server) ou MSDE (Microsoft Data Engine), consulte o arquivo docs\install.pdf no CD do Crystal Enterprise V10 Professional Edition. Clique em Next (Avançar) para continuar e, em seguida, clique em Next (Avançar) novamente para iniciar a instalação.
    9. Se você selecionou para expandir um Crystal Enterprise System existente e se preferir incluir um CMS adicional, o diálogo Informações do Banco de Dados CMS será aberto. Especifique o tipo de conexão com o banco de dados que o CMS deve utilizar para conectar-se ao banco de dados CMS existente. Clique em Next (Avançar) para continuar e, em seguida, clique em Next (Avançar) novamente para iniciar a instalação.
    10. Se você selecionou uma instalação Custom (Personalizada), o diálogo Cluster do CMS será aberto. A menos que você queira agrupar em cluster esse novo sistema com um sistema existente, selecione No (Não) e clique em Next (Avançar) para continuar. Se o programa de configuração detectar um MSDE (Microsoft Data Engine) ou SQL Server, uma caixa de diálogo Autenticação do Microsoft SQL Server será aberta. É necessário fornecer o ID e a senha correspondentes à conta do banco de dados configurada para o CMS (Crystal Management Server). Do contrário, se o programa de configuração não detectar um banco de dados MSDE ou SQL Server existente, a caixa de diálogo Configuração de Segurança do MSDE será aberta. É necessário fornecer um ID e uma senha para a conta do administrador SQL padrão que será instalada juntamente com o MSDE. Para obter informações adicionais sobre o CMS (Crystal Management Server) ou MSDE (Microsoft Data Engine), consulte o arquivo docs\install.pdf no CD do Crystal Enterprise V10 Professional Edition. Clique em Next (Avançar) para continuar e, em seguida, clique em Next (Avançar) novamente para iniciar a instalação.
    11. Você será solicitado a reinicializar sua máquina durante a instalação.
    12. Quando a instalação for concluída, clique em Next (Avançar) para registrar o Crystal Enterprise ou em Register Later (Registrar Mais Tarde) para registrar o produto mais tarde.
    13. Clique em Finish (Concluir) para sair do assistente de instalação.

    Você também pode instalar o Crystal Enterprise V10 Professional Edition em japonês. Vá para o diretório raiz no CD Crystal Enterprise V10 Professional Edition Japanese on Windows e execute o setup.exe para ativar o assistente de instalação. Siga as mesmas instruções listadas anteriormente, entretanto, você deve ativar o assistente de instalação em japonês diretamente do CD Crystal Enterprise V10 Professional Edition Japanese on Windows.

    Para Linux. Para instalar o Crystal Enterprise V10 Professional Edition no Linux, siga estas etapas:

    1. Insira o disco do Crystal Enterprise V10 Professional Edition para Linux e monte o CD-ROM.
    2. Abra o arquivo install.html localizado no diretório raiz do disco de instalação. Esse arquivo contém instruções completas para instalar o Crystal Enterprise V10 Professional Edition no Linux. Você precisará consultar as instruções nesse arquivo para preparar o sistema e executar o processo de instalação. Também deverá revisar a seção "Instalação" do arquivo release.htm, que está localizado no diretório raiz do disco de instalação, antes de instalar o produto.
    3. Revise a seção "Configurando o Sistema Linux" do arquivo install.html e desempenhe todas as ações necessárias antes de continuar com a execução do script de instalação.
    4. Desative qualquer software de antivírus antes de instalar o produto.
    5. Siga as instruções "Executando o Script de Instalação" no arquivo install.html para concluir o processo de instalação. Elas descrevem o procedimento para uma instalação do usuário.

      Notas:

      1. Nas instruções "Executando o Script de Instalação", você foi instruído a copiar o arquivo licensetext (incluído com sua distribuição do produto) e os arquivos que contêm os binários do Crystal Enterprise (com a extensão .gz) em seu diretório HOME. Esses arquivos estão localizados no diretório linux_x86 do disco de instalação.

      2. Em "Executando o Script de Instalação", há uma etapa que indica que você deve digitar o código-chave de ativação do produto. Essa etapa pode ser ignorada.
    6. Quando o script de instalação for concluído, você deverá implementar o desktop da Web do Crystal Enterprise e os Launchpads do Crystal Enterprise. Consulte a seção "Implementando o Desktop da Web do Crystal Enterprise" no arquivo install.html.
    7. Para obter informações sobre como implementar o WCS (Web Component Adapter), incluindo informações sobre como implementar vários WCAs, consulte a seção "Implementando o Web Component Adapter" do arquivo install.html.
    8. Ative seu software de antivírus, caso o tenha desativado antes de começar a instalação.

    Você também pode instalar o Crystal Enterprise V10 Professional Edition em japonês. Siga as mesmas instruções listadas anteriormente utilizando a versão em japonês do CD Crystal Enterprise V10 Professional Edition Japanese on Linux.

    Desinstalando o Crystal Enterprise V10 Professional Edition

    Para desinstalar o Crystal Enterprise no Windows (edição em inglês ou japonês), siga estas etapas:

    1. Abra o Painel de Controle.
    2. Clique em Adicionar ou Remover Programas.
    3. Selecione Crystal Enterprise 10 e clique e no botão Remover.

    O Crystal Enterprise será removido do computador.

    Para desinstalar o Crystal Enterprise no Linux (edição em inglês ou japonês), siga estas etapas:

    1. Execute o script uninstallCE.sh que se encontra no diretório crystal de instalação. Esse script exclui todos os arquivos instalados durante sua instalação original do Crystal Enterprise

    Capítulo 13. Instalando Atualizações

    O Rational Product Updater é uma ferramenta que mantém controle de todos os produtos de desenvolvimento de software Rational instalados no sistema e que procura e instala atualizações de produtos e novos recursos opcionais.

    O Product Updater é instalado automaticamente em conjunto com o primeiro produto de desenvolvimento de software da Rational instalado. Todos os produtos de desenvolvimento de software Rational subseqüentes que você instalar serão automaticamente registrados com essa ferramenta. Para esses produtos, você pode procurar e instalar automaticamente os seguintes tipos de atualizações:

    Quaisquer dependências entre as atualizações são automaticamente aplicadas. O Product Updater permite gerenciar atualizações para todos os produtos de software de desenvolvimento Rational a partir de um único local. Ele mesmo se atualizará.

    O Product Updater também permite executar estas tarefas:

    Consulte o sistema de ajuda do Product Updater para obter informações sobre a utilização da ferramenta, que pode ser acessada da seguinte maneira:

    1. Para ativar o Product Updater, no Rational Application Developer, selecione Help (Ajuda) > Software Updates (Atualizações de Software) > IBM Rational Product Updater.
    2. No Product Updater, selecione Help (Ajuda) > Help Contents (Conteúdo da Ajuda).

    Capítulo 14. Copyright e Avisos

    Consulte Copyright e Avisos