Puede utilizar la información de WebSphere ESB fuera de línea (sin acceder a Internet), utilizando un centro de información basado en Eclipse instalado localmente con los conectores de la documentación de WebSphere ESB.
También puede utilizar Adobe Acrobat Reader con los documentos en formato PDF de WebSphere ESB.
Antes de empezar
Los documentos en formato PDF y los conectores de la documentación de WebSphere ESB se proporcionan en la web. Por lo tanto, para poder descargar estos archivos es necesario acceder temporalmente a Internet.
Después de descargar los archivos que desea, puede utilizar la documentación sin estar conectado a Internet.
Por qué y cuándo se efectúa esta tarea
Si desea utilizar la información de
WebSphere ESB fuera de línea (sin necesitar acceder a la web), descargue los conectores de la documentación de
WebSphere ESB para utilizarla en un
centro de información local o descargue los documentos de formato PDF de
WebSphere ESB para utilizarlos con una copia local de Adobe Acrobat Reader.
Este tema describe cómo utilizar el
sistema de ayuda de IBM Eclipse que se proporciona con WebSphere ESB.
En otro caso, puede utilizar los conectores de la documentación de WebSphere ESB en otro centro de información basado en Eclipse, para integrar la información dentro del centro de información existente.
Si desea utilizar los documentos en formato PDF de
WebSphere ESB, consulte
Documentos en formato PDF de WebSphere ESB.
Pasos para realizar esta tarea
- Instale el sistema de ayuda de IBM Eclipse.
Para obtener más información sobre la instalación
del sistema de ayuda de IBM Eclipse, consulte el archivo readme que se proporciona con el paquete de instalación en el directorio IEHS del CD2.
Para instalar el sistema de ayuda de IBM Eclipse, lleve a cabo los siguientes subpasos:
- Inserte el CD2 en la unidad.
- Extraiga el contenido del paquete de instalación en el sistema conservando la estructura de directorios. Por ejemplo, en Windows, utilice el siguiente mandato para extraer el sistema de ayuda en el directorio C:\ibm_help:
unzip IBM-Help-Win32.zip -d C:\
El directorio iehs_install\ibm_help contiene el sistema de ayuda de IBM Eclipse y su JRE incorporado, donde iehs_install hace referencia al directorio
en el que se ha extraído el contenido del paquete de instalación del sistema de ayuda.
- Descargue los conectores de la documentación del producto.
Los conectores de la documentación de WebSphere ESB están disponibles como archivo ZIP en la página web http://www.ibm.com/software/integration/wsesb/library/infocenter/.
- Descargue el archivo ZIP de la documentación en una ubicación adecuada. En función de la velocidad de conexión, el archivo puede tardar más de 20 minutos en descargarse.
- Extraiga el contenido del archivo ZIP en el directorio iehs_install\ibm_help\eclipse\plugins, conservando la estructura de directorios.
En el directorio iehs_install\ibm_help\eclipse\plugins, debe ver varios directorios de conectores para la documentación del producto, incluido los siguientes:
- com.ibm.websphere.wesb.doc_6.0.1
- El principal conector de la documentación de WebSphere ESB.
Este conector debe hacer que aparezca la entrada WebSphere ESB en la navegación del sistema de ayuda.
- com.ibm.websphere.nd.doc_6.0.2
- El conector de documentación de IBM WebSphere Application Server Network Deployment,
que se ha incorporado en WebSphere ESB.
- com.ibm.websphere.wscc.doc
- El conector de documentación de IBM Web Services Client para C++.
- com.ibm.websphere.xms.doc
- IBM Message Service Client para C/C++ y Message Service Client para .NET.
Si no ve estos directorios, compruebe que haya extraído correctamente el contenido del archivo ZIP.
- Inicie el sistema de ayuda de IBM Eclipse
Puede iniciar el sistema de ayuda de
IBM Eclipse ejecutando los archivos de script en el directorio iehs_install\ibm_help.
Los archivos de script que se proporcionan con el sistema de ayuda utilizan el JRE incorporado para iniciar el sistema de ayuda.
Si no desea utilizar el JRE incorporado, debe instalar el JRE versión 1.4.2 o posterior y, a continuación, modificar los scripts de inicio y detención para que utilicen ese JRE.
Puede iniciar el sistema de ayuda de IBM Eclipse en dos modalidades:
- Modalidad autónoma
- Cuando se utiliza la modalidad autónoma, el sistema de ayuda de IBM Eclipse inicia automáticamente un navegador web para mostrar el contenido de la ayuda. Al ejecutarse en modalidad autónoma, el contenido de la ayuda sólo está disponible para los usuarios del sistema específico. Los menús y el contenido de la ayuda aparecen en el entorno local del sistema.
- Modalidad de centro de información
- Cuando se utiliza la modalidad de centro de información, el sistema de ayuda de IBM Eclipse inicia una aplicación web en el puerto definido por el usuario (el puerto predeterminado es 8888) y hace que el contenido de la ayuda esté disponible para todos los navegadores web que tengan conectividad de red con ese sistema.
Los menús y las páginas de la ayuda aparecen en el entorno local del navegador web del usuario.
Se proporcionan scripts de ejemplo para iniciar y detener el sistema de ayuda en cada modalidad. Después de haber iniciado el sistema de ayuda de IBM Eclipse, éste sigue ejecutándose incluso después de que se cierren todos los navegadores web activos. Debe detener de forma explícita el sistema de ayuda de IBM Eclipse con el script de detención adecuado.
Puede personalizar los archivos de script
con opciones que se ajusten a necesidades concretas. Para obtener más información sobre las opciones disponibles, consulte el archivo readme del sistema de ayuda.
Opción |
Descripción |
Modalidad autónoma |
En el directorio iehs_install\ibm_help, ejecute el archivo
IC_start.bat o IC_start.sh. Aparece la ventana de línea de mandatos para el sistema de archivos.
Para ver el contenido de la ayuda, abra un navegador web, entre la dirección URL
http://nombre_servidor:puerto/help,
donde nombre_servidor es el nombre de sistema principal o la dirección IP del sistema en el que está instalado el sistema de ayuda de IBM Eclipse.
|
Modalidad de centro de información |
- En el directorio iehs_install\ibm_help, ejecute el archivo
help_start.bat o help_start.sh. Aparece la ventana de línea de mandatos para el sistema de archivos.
- Si en el sistema operativo se ha establecido un navegador predeterminado, el sistema de ayuda abre automáticamente un navegador web con el contenido de la ayuda.
|
- Verifique que la documentación del producto se visualice de la forma esperada.
Si ha extraído correctamente el archivo ZIP de la documentación, pero el sistema de ayuda sigue sin visualizarse en el idioma nacional esperado o no muestra los temas de ayuda correctos, puede llevar a cabo varias comprobaciones. Por ejemplo, añada osgi.checkConfiguration=true al archivo de configuración iehs_install\ibm_help\configuration\config.ini.
Este valor hará que el sistema localice y configure nuevos paquetes de idiomas nacionales.
Para obtener más información sobre la resolución de problemas con el sistema de ayuda de
IBM Eclipse, consulte el archivo readme que se proporciona con el paquete de instalación.
Qué hacer a continuación
Puede descargar conectores de documentación adicionales desde IBM u otros proveedores y utilizarlos en el mismo sistema de ayuda para crear un centro de información más exhaustivo.