Instalación de WebSphere Partner Gateway

Cuando haya cumplido todos los requisitos previos observados en los apartados anteriores, estará listo para ejecutar los asistentes de instalación del Cargador de base de datos y WebSphere Partner Gateway. Estos asistentes se pueden ejecutar directamente o por medio del programa de inicio. Consulte el apartado Programa de inicio para obtener más información.

Nota:
El archivo tar de imagen de producto electrónico AIX no se puede desarchivar satisfactoriamente utilizando el programa tar predeterminado disponible en AIX ya que la imagen tiene longitudes de vía de acceso de más de 100 caracteres. Sin embargo, IBM distribuye un programa tar que desarchivará satisfactoriamente el archivo tar de imagen de producto electrónico de AIX. Este programa tar está disponible en AIX Toolbox para aplicaciones Linux en la ubicación siguiente:
http://www-1.ibm.com/servers/aix/products/aixos/linux/download.html

Variable de entorno DISPLAY

Los asistentes de instalación del Cargador de base de datos y del concentrador utilizan el sistema X-Windows en UNIX para mostrar la interfaz gráfica de usuario. El sistema X-Windows requiere que se exporte la variable de entorno DISPLAY al entorno del sistema. Las líneas siguientes establecen la variable de entorno DISPLAY para la dirección IP desde un shell Bourne:

DISPLAY=IP_Address:0.0

export DISPLAY

Utilice la sintaxis adecuada para su shell para establecer la variable de entorno DISPLAY.

Nota:
Compruebe que la variable de entorno del sistema DISPLAY y el sistema X-Windows estén configurados correctamente, ejecutando un programa cliente X como xclock desde la línea de mandatos. Si el cliente xclock se muestra en la ventana del Servidor X (local o remoto), los asistentes se deberían mostrar correctamente.

Programa de inicio

WebSphere Partner Gateway proporciona un programa de inicio para proporcionar acceso directo a la Visión general del producto, el archivo Léame, la documentación del producto, el Cargador de base de datos y el Programa de instalación de WebSphere Partner Gateway. De forma alternativa, puede arrancar el cargador de base de datos y los programas de instalación por medio de los programas setup*.* que se proporcionan. Consulte los apartados Creación de base de datos e Instalación de los componentes mediante el asistente de instalación.

Nota:
Algunas opciones del programa de inicio requieren que se haya instalado un navegador en la vía de acceso del sistema y esté disponible.

El archivo ejecutable del programa de inicio está ubicado en:

{CD_ROM/MEDIA DIR}/LaunchPad.sh

Creación de base de datos

WebSphere Partner Gateway incluye un asistente de instalación para configurar las tablas de la base de datos. Este asistente, el Cargador de base de datos, reúne información con la que crear y completar las tablas. De forma alternativa, puede guardar los archivos SQL que utiliza para crear las tablas. Así pues, podrá utilizar los archivos SQL para crear y completar las tablas. La ejecución de los archivos SQL manualmente le permite revisar las tablas de la base de datos antes de rellenarlas.

Antes de empezar, verifique que el servidor de la base de datos esté correctamente instalado y configurado, y se esté ejecutando.

DBLoader se puede ejecutar en una máquina que no tiene la base de datos actual. Oracle/DB2 deben estar instalados en esta máquina, pero la base de datos real puede estar en otra máquina. DBA debe efectuar algunos cambios en la configuración para esto, que probablemente quedan fuera del ámbito de esta guía. Primero, cree la base de datos en una máquina remota. A continuación, configure una base de datos remota con oracle/db2 en la máquina donde se instalará dbloader, especificando en qué máquina se está ejecutando, qué puerto utiliza, etc. Cuando haya realizado esta configuración, se puede ejecutar DBLoader como si la base de datos fuera local. Oracle/DB2 se encargará automáticamente del resto. Todos los mandatos de sql contra esta base de datos irán a la máquina correcta para el proceso. SQL se puede ejecutar automáticamente.

En el procedimiento siguiente se describe cómo configurar la base de datos utilizando la GUI del Cargador de base de datos. También puede instalar el Cargador de base de datos sin utilizar la GUI. Consulte el apartado Instalación de los componentes mediante la línea de mandatos para obtener más información.

Nota:
Compruebe la documentación de DB2 para obtener los requisitos específicos del sistema operativo, como valores de configuración o versiones de producto necesarias.

Para configurar las tablas de la base de datos:

  1. Inicie sesión como usuario raíz.

    El Cargador de base de datos requiere privilegios de administrador para ejecutar automáticamente la propiedad SQL de crear o modificar los directorios de los espacios de tabla.

  2. Desde el directorio Cargador de base de datos, lance el ejecutable de configuración que figura en la Tabla 9, que es específica de la plataforma:

    cd DBLoader

    Tabla 9. Ejecutables específicos de la plataforma para el programa de instalación
    Plataforma Ejecutable

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSunOS

    El asistente del Cargador de base de datos se inicia y muestra la ventana de bienvenida. Pulse Siguiente.

  3. Lea el Acuerdo de licencia de software en la ventana del mismo nombre. Si está de acuerdo con los términos del acuerdo, pulse Acepto los términos del acuerdo de licencia. Pulse Siguiente.
  4. En la ventana Nombre de directorio, escriba la vía de acceso y el nombre de directorio que utilizará el Cargador de base de datos cuando la configure. IBM recomienda crear una nueva ubicación para el directorio, o seleccionar una vacía. En los nombres de directorio no deberían incorporarse espacios o caracteres especiales.

    Seleccione una ubicación con suficiente espacio para su base de datos y los datos de la aplicación se almacenarán allí. Pulse Siguiente.

    Nota:
    Cuando examine los directorios para seleccionar uno, especifique un "." en el campo Especifique nombre de archivo después de seleccionar la vía de acceso que desee para la instalación. Si no especifica un ".", la ventana Seleccione un directorio no le devolverá a la ventana desde la que se inició.
  5. En la ventana de selección del tipo de base de datos, seleccione el servidor de la base de datos que desea utilizar para WebSphere Partner Gateway. Puede seleccionar DB2 8.2 u Oracle 9i 9.2.0.4 o posterior. Pulse Siguiente.
  6. En la ventana de información de la base de datos, escriba la siguiente información de la base de datos y, a continuación, haga clic en Siguiente cuando haya acabado.

    DB2:

    Si ha seleccionado DB2, aparece la ventana Información sobre la base de datos DB2. Especifique la información siguiente de la base de datos DB2:

    Oracle:

    1. Si ha seleccionado Oracle, aparece la ventana Información sobre la base de datos Oracle. Especifique la siguiente información sobre la base de datos Oracle:
      • ID de inicio de sesión de administrador
      • Contraseña de administrador
      • SID de Oracle
      • Inicio de sesión de propietario de Esquema
      • Contraseña de propietario de Esquema
    2. Aparece la ventana de la ubicación padre de Oracle. Escriba o pulse Examinar para entrar la ubicación del directorio padre de Oracle. Consulte la Figura 2.

      Figura 2. Ventana de ubicación del directorio padre de Oracle
  7. En la ventana de ubicación de la base de datos, la Figura 3 para DB2 y la Figura 4 para Oracle, escriba la vía de acceso completa para la ubicación de la base de datos y cada uno de sus espacios de tablas en el servidor de la base de datos. Por ejemplo, la vía de acceso del directorio de la base de datos DB2 tendría este aspecto: DB2Home/IBM/bcgdbloader/tables.
    Nota:
    Cuando examine los directorios para seleccionar uno, especifique un "." en el campo Especifique nombre de archivo después de seleccionar la vía de acceso que desee para la instalación. Si no especifica un ".", la ventana Seleccione un directorio no le devolverá a la ventana desde la que se inició.
    Si se modifica alguno de estos valores, deben existir antes de que se ejecuten los archivos SQL. De no existir, se deben crear manualmente.

    Una vez haya especificado la información necesaria, pulse Siguiente.

    Nota:
    Seleccione una ubicación del sistema de archivos con espacio suficiente para alojar la base de datos y todos los datos de la aplicación. El tamaño de la base de datos aumentará cuando se ejecute WebSphere Partner Gateway.

    DB2

    Figura 3. Ventana Ubicación de la base de datos DB2

    Oracle

    Figura 4. Ventana Ubicación de la base de datos Oracle
  8. En la ventana Configuración de componentes, la Figura 5, escriba la información de inicio de sesión para los componentes de WebSphere Partner Gateway y la ubicación de los archivos compartidos comunes. Pulse en Siguiente cuando haya finalizado.

    En los campos Nombre de usuario y Contraseña de la Consola de comunidad, el Gestor de documentos y el Receptor, escriba el nombre y la contraseña del usuario de cada componente. Si utiliza DB2, estos usuarios se crearon cuando se configuró el servidor.

    En el campo Nombre de grupo, escriba el nombre del grupo que contiene los usuarios de WebSphere Partner Gateway.

    Figura 5. Ventana Configuración de componentes
  9. Desde la ventana Punto de montaje para la información compartida, escriba la ubicación de los archivos compartidos comunes utilizados por los componentes principales de WebSphere Partner Gateway.
    Notas:
    1. Si está instalando WebSphere Partner Gateway en varias máquinas, la carpeta común compartida debe utilizar los mismos puntos de montaje y estructura de directorios en todas las máquinas.
    2. Cuando examine los directorios para seleccionar uno, especifique un "." en el campo Especifique nombre de archivo después de seleccionar la vía de acceso que desee para la instalación. Si no especifica un ".", la ventana Seleccione un directorio no le devolverá a la ventana desde la que se inició.
  10. El asistente mostrará una ventana en la que se puede seleccionar si el Cargador de base de datos sólo crea archivos SQL o los crea y los ejecuta. Consulte la Figura 6.

    Cuando el Cargador de base de datos ejecuta los archivos SQL realiza lo siguiente:

    Puesto que el Cargador de base de datos reinicia la instancia de DB2 como parte de su rutina, desconecte las aplicaciones que estén utilizando la instancia de DB2 donde esté configurando la base de datos de WebSphere Partner Gateway.

    Si desea que el Cargador de base de datos ejecute los archivos, marque el recuadro de selección Ejecutar los archivos SQL. Pulse Siguiente.

    Figura 6. Ejecute la ventana de archivos SQL
  11. Confirme la ubicación de la instalación del cargador de base de datos. Pulse Siguiente.
  12. Pulse Finalizar cuando esté activado.
  13. Si está ejecutando SQL manualmente, consulte el archivo de instrucciones Instructions.txt del subdirectorio bcgdbloader/scripts (instalado por el asistente de instalación del Cargador de base de datos) para tener más información.

    Cuando haya configurado la base de datos de WebSphere Partner Gateway, estará listo para instalar los componentes de WebSphere Partner Gateway.

    En el apartado siguiente se describe cómo instalar los componentes utilizando la GUI del asistente de InstallShield. Puede instalar los componentes sin utilizar la GUI. Consulte el apartado Instalación de los componentes mediante la línea de mandatos para obtener más información.

Instalación de los componentes mediante el asistente de instalación

WebSphere Partner Gateway tiene tres componentes principales: Consola de comunidad, Receptor y Gestor de documentos. Los tres componentes comparten contenido común. Puede instalar los componentes y el contenido común en un solo servidor, instalar cada componente en un distinto separado o utilizar una combinación de ambas opciones. Se debe instalar una instancia de cada componente en un servidor, como mínimo. Consulte los apartados Planificación del entorno y Topologías, para obtener más información sobre cómo planificar la colocación de distintos componentes en varios servidores.

Nota:
Si está instalando WebSphere Partner Gateway en varias máquinas, la carpeta común compartida debe utilizar los mismos puntos de montaje y estructura de directorios en todas las máquinas.

Antes de empezar, asegúrese de que el software indicado como requisito previo esté instalado y configurado correctamente. Consulte la tabla de requisitos para todos los servidores de WebSphere Partner Gateway en Plataforma, hardware, y requisitos de software, para obtener los requisitos previos de software y Visión general de la instalación para obtener información sobre cómo configurar el software. También debe tener configurada la base de datos de WebSphere Partner Gateway. Para obtener información al respecto, consulte el apartado Creación de base de datos. Finalmente, el servidor de la base de datos y WebSphere MQ deben estar ejecutándose, incluidos el gestor de colas y el receptor.

Los componentes comunes se deben instalar sólo una vez cuando no se utilice la topología consolidada.

Para instalar WebSphere Partner Gateway:

  1. Inicie la sesión como administrador raíz.

    El programa de instalación del concentrador requiere privilegio de administrador o raíz para la integración con el registro de software nativo.

  2. En el directorio del concentrador, lance el ejecutable de configuración que figura en la Tabla 10 que es específica de la plataforma.
    Tabla 10. Ejecutables específicos de la plataforma para el programa de instalación
    Plataforma Ejecutable

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSolaris

    El asistente se inicia y muestra la ventana de bienvenida. Pulse Siguiente.

  3. Lea el Acuerdo de licencia de software en la ventana del mismo nombre. Si está de acuerdo con los términos del acuerdo, pulse Acepto los términos del acuerdo de licencia. Pulse Siguiente.
  4. En la ventana Nombre de directorio, escriba la vía de acceso y el nombre del directorio que debe utilizar el asistente cuando instale WebSphere Partner Gateway. IBM recomienda crear una nueva ubicación para el directorio, o seleccionar una vacía. En los nombres de directorio no deberían incorporarse espacios o caracteres especiales. Pulse Siguiente.
    Nota:
    Cuando examine los directorios para seleccionar uno, especifique un "." en el campo Especifique nombre de archivo después de seleccionar la vía de acceso que desee para la instalación. Si no especifica un ".", la ventana Seleccione un directorio no le devolverá a la ventana desde la que se inició.
  5. En la ventana Selección de componentes, Figura 7, seleccione los componentes que desee instalar en el servidor. Puede seleccionar varios componentes. Pulse Siguiente.
    Figura 7. Ventana Selección de componentes

    El resto de este procedimiento presupone que está instalando todos los componentes. Si no los instala todos, algunas de las ventanas descritas en este procedimiento no se mostrarán.

  6. Especifique el nombre del host completo para la máquina en la que está realizando la instalación. Pulse Siguiente.
  7. Seleccione uno de los siguientes servidores de WebSphere Application Server para utilizarlo para alojar WebSphere Partner Gateway. Consulte la Figura 8. Pulse Siguiente:
  8. En la ventana Selección de servidor de la base de datos, Figura 9, seleccione el servidor de la base de datos que desea utilizar. Puede seleccionar DB2 8.2 u Oracle 9i 9.2.0.4 o posterior. Pulse Siguiente.
    Figura 9. Ventana Selección de base de datos
  9. Aparece la ventana Información de la base de datos. Si ha seleccionado DB2 como servidor de su base de datos, siga las instrucciones específicas de DB2 de este procedimiento. Si ha seleccionado Oracle como servidor de su base de datos, siga las instrucciones específicas de Oracle para este procedimiento.

    DB2

    Si ha seleccionado DB2, aparece la ventana Información sobre la base de datos DB2, Figura 10.

    Especifique el nombre del host del sistema en el que se ejecuta DB2, si no está instalado en el sistema actual, sustituyendo localhost por el nombre del sistema que contiene DB2.

    En el campo Puerto, escriba el número de puerto que está utilizando la instancia de DB2. Para averiguar qué puerto está utilizando la instancia de DB2 utilice o bien el Centro de control de DB2 (GUI) para determinar las propiedades, o bien escriba el siguiente mandato de configuración de DB2 en el indicador de mandatos: db2 get dbm cfg. La información de configuración DB2 queda guardada también por el Cargador de base de datos en el directorio temp/bcgdbloader/logs del sistema. El puerto tomado de forma predeterminada es 50000.

    En los campos de texto Nombre de propietario, Contraseña de propietario, Nombre de la base de datos y Nombre de esquema, escriba el nombre de propietario, su contraseña, el nombre la base de datos y el de la instancia, respectivamente. El Cargador de base de datos utiliza estos nombres para definir la base de datos. Consulte el apartado Creación de base de datos.

    Pulse Siguiente.

    Figura 10. ventana de información de DB2

    Oracle:

    Si ha seleccionado Oracle, aparece la ventana Información de la base de datos, consulte la Figura 11.

    Escriba la información necesaria sobre la base de datos Oracle. El puerto tomado de forma predeterminada es 1521.

    La vía de acceso completa y el nombre del controlador JDBC deben apuntar a la versión correcta del controlador de este sistema. El controlador se puede encontrar en el directorio de instalación de Oracle.

    También se puede descargar de http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html. En el apartado JDBC Driver Downloads, pulse Oracle xx Release x drivers. Asegúrese de seleccionar la versión del controlador que coincida con la versión xx de Oracle que esté ejecutando.

    Nota:
    Cuando examine los directorios para seleccionar uno, especifique un "." en el campo Especifique nombre de archivo después de seleccionar la vía de acceso que desee para la instalación. Si no especifica un ".", la ventana Seleccione un directorio no le devolverá a la ventana desde la que se inició.

    Pulse Siguiente.

    Figura 11. Ventana Información de la base de datos Oracle

    Aparecerá la ventana de confirmación de conexiones de base de datos. Consulte la Figura 12. Si la conexión se realiza correctamente, anote y confirme la información del recuento de Tablas, Vistas, Funciones y Procedimientos. Si no se puede realizar la conexión, revise la ventana de información para que le oriente, o consulte la documentación de la base de datos para resolver el código de error.

    Figura 12. Ventana de confirmación de conexiones de base de datos
  10. En la ventana Información del usuario, especifique el nombre de usuario, la contraseña y el nombre de grupo del administrador responsable de la instalación. Pulse Siguiente.
    Nota:
    Esta información debe coincidir con la información utilizada en la instalación del Cargador de base de datos.
  11. En la ventana del directorio de información común, especifique la ubicación de la información común que comparten los componentes. Pulse Siguiente.
    Nota:
    Cuando examine los directorios para seleccionar uno, especifique un "." en el campo Especifique nombre de archivo después de seleccionar la vía de acceso que desee para la instalación. Si no especifica un ".", la ventana Seleccione un directorio no le devolverá a la ventana desde la que se inició.
  12. En la ventana del servidor WebSphere MQ Server, Figura 13, escriba el nombre del host del sistema en el que se está ejecutando WebSphere MQ si no se ha instalado en el mismo sistema. Asegúrese de cambiar el nombre del gestor de colas si no se ha utilizado el nombre predeterminado.

    En el campo Nombre del host, si WebSphere MQ no está en el sistema actual, sustituya localhost con el nombre del sistema que contenga WebSphere MQ.

    En el campo Gestor de colas, sustituya el nombre predeterminado por el nombre utilizado al configurar WebSphere MQ (consulte el paso 2 en el apartado Configuración de WebSphere MQ).

    En el campo Puerto de receptor, escriba el puerto que está utilizando el receptor (consulte el apartado Configuración de WebSphere MQ). El puerto predeterminado es 9999.

    Pulse Siguiente.

    Figura 13. Ventana Servidor WebSphere MQ
  13. Si ha seleccionado instalar la Consola de comunidad, configúrela utilizando la ventana del mismo nombre. Consulte la Figura 14.

    En el campo Nombre de usuario, escriba el ID de usuario que utiliza el componente Consola de comunidad, para iniciar la base de datos.

    En el campo Contraseña, escriba la contraseña asociada al nombre de usuario. Asegúrese de que la contraseña sea correcta, pues la consola no funcionará con una contraseña incorrecta.

    En el campo Puerto HTTP, escriba el nombre del puerto en el que el componente recibe mensajes. La Consola de comunidad, el Receptor y el Gestor de documentos deben tener números de puerto únicos y deben estar disponibles en este sistema. El puerto predeterminado es 58080.

    En el campo Puerto HTTPS, escriba el nombre del puerto seguro en el que el componente recibe mensajes. La Consola de comunidad, el Receptor y el Gestor de documentos deben tener números de puerto únicos y deben estar disponibles en este sistema. El puerto predeterminado es 58443.

    Pulse Siguiente.

    Nota:
    Si la conexión de la base de datos falla, aparece la ventana de información de la base de datos. Revise la ventana de información para que le oriente o consulte la documentación de su base de datos para resolver el código de error.
    Figura 14. Ventana Configuración de la Consola de comunidad
  14. Si ha seleccionado los componentes Receptor o Gestor de documentos, configúrelos utilizando las ventanas de configuración correspondientes. Estas ventanas tienen los mismos campos que la ventana de configuración de la Consola de comunidad. Los tres componentes (Consola de comunidad, Receptor y Gestor de documentos) deben tener distintos puertos HTTP y HTTPS. Consulte las imágenes Figura 15 y Figura 16 de la página Figura 15.
    Nota:
    Si instala el Receptor y el Gestor de documentos en distintas máquinas, la del Receptor debe tener un nombre del host que pueda resolver la máquina del Gestor de documentos.
    Figura 15. Ventana Configuración del Receptor
    Figura 16. Ventana Configuración del Gestor de documentos
  15. En la ventana Configuración de RosettaNet, Figura 17, escriba la información de contacto para los mensajes de RosettaNet. Si no conoce los valores adecuados utilice los valores proporcionados de forma predeterminada. Esta información es necesaria si utiliza RosettaNet y se recomienda para todas las instalaciones.

    En el campo Nombre, escriba el nombre de la persona con la que se debe contactar si surgen problemas relacionados con RosettaNet.

    En los campos Número de teléfono y Número de fax, escriba los números de teléfono y fax de las personas de contacto de RosettaNet.

    En el campo Dirección de correo electrónico escriba la dirección de correo electrónico de la persona de contacto de RosettaNet.

    Pulse Siguiente.

    Figura 17. Ventana Configuración de RosettaNet
  16. En la pantalla Notificación de alerta, Figura 18, configure WebSphere Partner Gateway para que envíe alertas por correo electrónico. Estos valores son necesarios. Utilice los valores predeterminados si no conoce los valores adecuados.

    En el campo Relé SMTP, escriba el nombre del host de SMTP si no se está ejecutando en este sistema.

    En el campo Dirección de correo electrónico de origen, escriba la dirección de correo electrónico que WebSphere Partner Gateway utilizará para enviar correos.

    En el campo Dirección de correo electrónico de destino, escriba la dirección de correo electrónico de destino que utilizan los usuarios para responder a las notificaciones de alerta enviando un correo electrónico.

    Pulse Siguiente.

    Figura 18. Ventana Notificación de alerta
  17. En la ventana Resumen, revise la información que identifica los componentes que se instalarán. Si parte de la información es incorrecta pulse Anterior para volver a las ventanas anteriores. Si toda la información de la ventana de resumen es correcta, pulse Siguiente.
  18. El programa de instalación de WebSphere Partner Gateway instala y configura los componentes seleccionados. Cuando ha finalizado esta tarea, el programa de instalación habilita el botón Finalizar. Pulse Finalizar.

Repita este procedimiento en cada servidor en el que desee instalar componentes de WebSphere Partner Gateway. El contenido común se debe instalar sólo una vez, pues está disponible en todos los sistemas mediante el sistema de archivos compartidos.

Cuando haya instalado todos los componentes de WebSphere Partner Gateway, consulte el apartado Inicio de WebSphere Partner Gateway.

Copyright IBM Corp. 2003, 2005