Instalando a Documentação do IBM WebSphere Business Integration Adapters, Versão 2.4

Este documento descreve como instalar a documentação do produto IBM WebSphere Business Integration Adapters, Versão 2.4 . Estas informações foram empacotadas como plug-ins de documentos do Eclipse, que você instala com o visualizador da documentação. Posteriormente, será necessário mover um pequeno conjunto de arquivos para um diretório específico do produto para ativar a ajuda contextual.

Sobre os Plug-ins dos Documentos

A documentação é empacotada como plug-ins de documentos do Eclipse e deve ser visualizada utilizando o IBM(R) WebSphere(R) Help System. O sistema de ajuda (ou visualizador) e o formato do plug-in dos documentos são baseados em uma abordagem de origem aberta desenvolvida pelo Projeto Eclipse (www.eclipse.org).  Os plug-ins dos documentos do produto IBM estão contidos em pastas que seguem uma convenção de nomenclatura consistente (com.ibm.xxx.doc).

Instalando os Plug-ins dos Documentos

Para visualizar a documentação do produto IBM no visualizador, é necessário instalar os plug-ins dos documentos novos ou atualizados na pasta eclipse\plugins do IBM WebSphere Help System.   O sistema de ajuda funciona com quaisquer informações empacotadas como um plug-in de documento do Eclipse, incluindo os plug-ins dos documentos do produto IBM.   As pastas do plug-in do produto IBM são identificadas facilmente, pois utilizam uma convenção de nomenclatura comum (com.ibm.xxx.doc).

Para instalar os plug-ins dos documentos, conclua as etapas a seguir:

  1. Assegure-se de que você já tenha instalado o IBM WebSphere Help System. Para obter detalhes, consulte Fazendo Download do IBM WebSphere Help System.
  2. Obtenha os plug-ins dos documentos. Por exemplo, é possível ir a uma página da Web dos produtos IBM para fazer download dos plug-ins dos documentos.
  3. Copie as pastas dos plug-ins dos documentos para a pasta eclipse\plugins do IBM WebSphere Help System. Lembre-se de que é necessário ser a pasta eclipse\plugins do IBM WebSphere Help System; é possível que existam pastas eclipse\plugins adicionais no seu sistema.   Por exemplo, se você instalou o sistema de ajuda em c:\WebSphere Help System, deveria copiar as pastas de plug-ins de documentos em : c:\WebSphere Help System\eclipse\plugins
  4. Para consultar o plug-in de documento incluído recentemente, inicie o visualizador (ou desligue-o e inicie-o novamente se estiver em execução).

Iniciando o Visualizador

Para iniciar o visualizador:

  1. Abra a pasta WebSphere Help System.
  2. Dê um clique duplo no arquivo WebSphere help start.bat.

Nota: É possível que demore alguns minutos para o sistema iniciar e os plug-ins dos documentos serem exibidos na primeira vez que você o fizer.

Desligando o Visualizador

Ao fechar o visualizador simplesmente fechando esta janela, os processos ainda estarão em execução no plano de fundo. Isso permite uma ativação mais rápida durante as sessões subseqüentes. No entanto, é necessário desligar esses processos ao instalar os plug-ins de documentos ou ao atualizar o sistema de ajuda com os novos plug-ins.  O encerramento do visualizador quando este não está em utilização também libera memória do sistema.  Ao desligar a máquina, todos os processos do sistema de ajuda são desligados.

Para desligar o visualizador:

  1. Abra a pasta WebSphere Help System.
  2. Dê um clique duplo no arquivo WebSphere help end.bat.

Movendo Plug-ins da Ajuda Contextual

Algumas das ferramentas baseadas no Eclipse, fornecidas com o produto, utilizam a ajuda contextual, que você pode acessar pressionando a tecla F1 na ferramenta. Essa ajuda contextual é separada do IBM WebSphere Help System e deve ser movida a uma localização específica de produto.

Para instalar a ajuda contextual, mova as seguintes pastas de plug-ins da pasta WebSphere Help System\eclipse\plugins para a pasta \plugins na qual você instalou o conjunto de ferramentas do IBM WebSphere Business Integration. Essa localização pode estar em uma instalação do IBM WebSphere Studio WorkBench ou em uma versão do IBM WebSphere Studio Application Developer, dependendo das opções feitas ao instalar o produto IBM WebSphere Business Integration Adapters. As pastas de plug-ins para mover o sistema de ajuda contextual são:

Escolha a versão da pasta apropriada para seu servidor intermediário. Selecione conforme a seguir:

Se seu servidor intermediário é o WebSphere Application Server, selecione as pastas com.ibm.btools.adaptermonitor.help e com.ibm.btools.csm.help a partir do diretório:

contextplugins/was/

Se seu servidor intermediário é o WebSphere message brokers (WebSphere MQ Integrator 2.1.0, WebSphere MQ Integrator Broker 2.1.0, ou WebSphere Business Integration Message Broker), selecione as pastas com.ibm.btools.adaptermonitor.help e com.ibm.btools.csm.help folders a partir do diretório:

contextplugins/wmb/

Se seu servidor intermediário é o WebSphere InterChange Server, não mova as pastas plug-in. Siga as instruções de instalação recebidas durante o download da documentação do WebSphere InterChange Server.

As pastas e os arquivos que estão sendo movidos sobrescreverão as pastas de mesmo nome, já existentes na localização de destino. Por exemplo, se você instalou o conjunto de ferramentas do WebSphere Business Integration na instalação do WebSphere Studio Application Developer Integration Edition, a localização para os arquivos da ajuda deve ter a seguinte aparência:

C:\ProgramFiles\IBM\WebSphereStudio\wstools\eclipse\plugins\com.ibm.btools.adaptermonitor.help C:\ProgramFiles\IBM\WebSphereStudio\wstools\eclipse\plugins\com.ibm.btools.csm.help

Se você tiver dificuldades em localizar a pasta de destino correta, faça uma pesquisa em um dos nomes das pastas de plug-ins; por exemplo, procure por com.ibm.btools.csm.help. Os arquivos nas pastas que estão sendo movidas sobrescreverão os arquivos existentes no diretório existente do produto. Por exemplo, ao cortar e colar os arquivos, você estará sobrescrevendo um plug-in com.ibm.btools.csm.help existente com o novo plug-in com.ibm.btools.csm.help que foi transferido por download.

(C) Copyright IBM Corporation 2003. Todos os Direitos Reservados.