Instalación de adaptadores

Siga las instrucciones de una de las secciones siguientes para instalar un adaptador cuando se lo indique la información general sobre procedimientos contenida en el Visión general de la instalación:

Observe que en las plataformas UNIX, los nombres de archivo se deben especificar distinguiendo entre minúsculas y mayúsculas. Si cambia el tipo de letra (mayúscula o minúscula) en un nombre de archivo cualquiera, el adaptador fallará durante el arranque y registrará un error. Si recibe un error al intentar iniciar el adaptador, compruebe los nombres de archivo de los archivos XSD contenidos en el depósito del Configurador de conectores. La extensión de los archivos XSD debe ser .xsd, escrito en minúsculas. Por ejemplo, el nombre de archivo Customer.XSD hará que el adaptador falle. En este caso, debe cambiar el nombre del archivo para que sea Customer.xsd.

Instalación de adaptadores utilizando el programa de instalación gráfico

Realice lo siguiente para instalar un adaptador utilizando el programa de instalación gráfico:

  1. Invoque el programa de instalación del adaptador utilizado, tal como se describe en Invocación del programa de instalación gráfico de WBIA.
  2. En el indicador de selección del idioma, seleccione el idioma deseado en el menú desplegable y pulse OK.
  3. En la pantalla de Bienvenida, pulse Siguiente.
    Nota:
    Si utiliza el mandato java -jar setup.jar para iniciar el programa de instalación, éste necesita Java Runtime Environment (JRE) versión 1.4 o superior. Si no se cumple esta condición, el programa de instalación muestra un mensaje de error, que le indica que instale JRE 1.4 o versión superior y luego reinicie el programa de instalación. Pulse Cancelar e instale o actualice el JRE.
  4. Cuando aparezca la pantalla de aceptación de la licencia de IBM, pulse Acepto los términos del acuerdo de licencia y luego pulse OK.
    Nota:
    En este momento el programa de instalación examina el sistema del usuario para comprobar si está instalado determinado software necesario. Si falta un elemento de software necesario, el programa de instalación muestra una pantalla que informa al usuario de ese hecho. Se indica al usuario que debe instalar ese elemento de software o que debe entrar en el directorio donde reside ese software para que la instalación del adaptador pueda continuar. Instale el software necesario o vaya hasta la ubicación donde reside ese software y reinicie el programa de instalación de WebSphere Business Integration Adapters.
  5. La pantalla del directorio del producto le permite especificar dónde instalar los adaptadores. El programa de instalación del adaptador intentará localizar el lugar dónde instalar Adapter Framework; si encuentra el lugar, esta vía de instalación se mostrará por omisión. Si el programa no encuentra la ubicación de instalación, se muestran las ubicaciones por omisión siguientes: para Windows: C:\IBM\WebSphereAdapters, y para UNIX: /opt/IBM/WebSphereAdapters.

    Puede especificar un directorio diferente, pero debe contener una instalación de una versión compatible de Adapter Framework.

    Para obtener información sobre la instalación de Adapter Framework, consulte Instalación de Adapter Framework. Para obtener más información acerca de la instalación de WebSphere InterChange Server, consulte

    En la pantalla del directorio del producto, ejecute una de las tareas siguientes:

  6. La pantalla de resumen lista los componentes que se instalarán, el directorio del producto especificado y la cantidad de espacio de disco necesario. Lea la información para verificarla y luego pulse Siguiente.
  7. En la pantalla del nombre del intermediario, realice una de las tareas siguientes, de acuerdo con el intermediario de integración utilizado:
  8. Si está instalando en un sistema Windows, el programa de instalación muestra una pantalla de selección de carpetas del programa. En el campo Grupo de programas, escriba el nombre del grupo de programas en el que desee crear accesos directos para los adaptadores, o acepte el grupo de programas por omisión y luego pulse Siguiente.
  9. Cuando el programa de instalación finalice satisfactoriamente, pulse Finalizar.

Nota:
Si el intermediario de integración utilizado es ICS y está instalado en un sistema remoto, debe trasladar los archivos de configuración del adaptador al sistema ICS. De esta manera, el Configurador de conectores del sistema ICS remoto puede acceder a los archivos de configuración del adaptador. Para localizar los archivos de configuración del adaptador, consulte la tabla de la estructura de archivos instalados en la guía de usuario del adaptador. Normalmente el nombre del archivo de configuración es <nombre de adaptador>ConnectorTemplate. A continuación, traslade este archivo al directorio de la instancia del Configurador de conectores que ejecutará en el sistema principal ICS. Para obtener más información sobre la estructura de archivos instalados de ICS y el Configurador de conectores, consulte la Guía de instalación del sistema correspondiente a la plataforma utilizada. Si no está utilizando un intermediario de integración ICS o si el intermediario ICS reside en la misma máquina que el adaptador, no es necesario que transfiera los archivos de configuración del adaptador.

Instalación de adaptadores de forma desatendida en sistemas Windows

Realice lo siguiente para ejecutar una instalación desatendida de un adaptador en sistemas Windows:

  1. Prepare un archivo de respuestas para instalar el adaptador, tal como se describe en Preparación del archivo de respuestas de la instalación, utilizando las opciones deseadas que aparezcan listadas en la Tabla 3.
    Tabla 3. Opciones de la instalación desatendida de adaptadores para sistemas Windows
    Nombre de opción Valores de opción
    -W destination.path

    Establezca esta opción en la vía de acceso del directorio donde se debe instalar el producto WebSphere Business Integration Adapters. Por ejemplo,

    -W destination.path="C:\IBM\WebSphereAdapters"

    La vía de instalación no puede contener espacios en blanco. La ubicación de instalación debe contener una versión compatible del Adapter Framework.

    -W inputServer.name

    Si el intermediario utilizado es IBM WebSphere InterChange Server, especifique un nombre válido de servidor InterChange. Este nombre debe cumplir los criterios siguientes: 1. Menos de 80 caracteres. 2. No debe contener espacios en blanco. 3. Debe comenzar con un carácter alfabético inglés (a-z, A-Z). 4. Debe contener solamente caracteres alfabéticos ingleses y caracteres numéricos.

    Si no está utilizando WebSphere Interchange Server como intermediario, inhabilite esta opción.

    -W inputShortcuts.folder

    Establezca esta opción en el nombre del grupo de programas que creó para el producto de WBIA, por ejemplo IBM WebSphere Business Integration Adapters.

    -W inputServer.adapterService

    Establezca esta opción en yes si desea registrar el adaptador como servicio de Windows. Establezca esta opción en no si no desea registrar el adaptador como servicio de Windows.

    -G createDirectoryResponse= Establezca el valor de esta opción (yes o no) para especificar si se debe crear el directorio de destino si no existe ya.
    -G replaceExistingResponse

    Establezca esta opción en yesToAll o yes para sustituir todos los archivos encontrados en el sistema cuyo nombre sea igual al nombre de los archivos copiados por el programa de instalación.

    Establezca esta opción en noToAll o no para no sustituir ninguno de los archivos encontrados en el sistema cuyo nombre sea igual al nombre de los archivos copiados por el programa de instalación.

    -G replaceNewerResponses

    Establezca esta opción en yesToAll o yes para sustituir todos los archivos encontrados en el sistema que sean más nuevos que los archivos copiados por el programa de instalación.

    Establezca esta opción en noToAll o no para no sustituir ninguno de los archivos encontrados en el sistema que sean más nuevos que los archivos copiados por el programa de instalación.

    -G removeExistingResponse

    Esta opción especifica si se debe eliminar un archivo de respuestas que existe en el sistema. Observe que esta opción es para el proceso de desinstalación solamente. Establezca esta opción en yestoall o yes para eliminar los archivos de respuestas existentes. Establezca esta opción en notoall o no para conservar los archivos existentes en el sistema.

    -G removeModifiedResponse

    Esta opción especifica si se debe eliminar un archivo de respuestas que se ha modificado desde la última vez que se instaló. Observe que esta opción es para el proceso de desinstalación solamente. Establezca esta opción en yestoall o yes para eliminar los archivos de respuestas que se hayan modificado. Establezca esta opción en notoall o no para conservar los archivos modificados existentes en el sistema.

  2. Realice la instalación desatendida tal como se describe en Ejecución de la instalación desatendida, utilizando el archivo de respuestas preparado en el paso 1.

Instalación desatendida de adaptadores en sistemas UNIX y Linux

Realice lo siguiente para ejecutar una instalación desatendida de un adaptador en sistemas UNIX y Linux:

  1. Prepare un archivo de respuestas para instalar el adaptador, tal como se describe en Preparación del archivo de respuestas de la instalación, utilizando las opciones deseadas que aparezcan listadas en la Tabla 3.
    Tabla 4. Opciones de la instalación desatendida de adaptadores para sistemas UNIX y Linux
    Nombre de opción Valores de opción
    -W destination.path

    Establezca esta opción en la vía de acceso del directorio donde se debe instalar el producto WebSphere Business Integration Adapters. Por ejemplo,

    -W destination.path="C:\IBM\WebSphereAdapters"

    La vía de instalación no puede contener espacios en blanco. La ubicación de instalación debe contener una versión compatible del Adapter Framework.

    -W inputServer.name

    Si el intermediario utilizado es IBM WebSphere InterChange Server, especifique un nombre válido de servidor InterChange. Este nombre debe cumplir los criterios siguientes: 1. Menos de 80 caracteres. 2. No debe contener espacios en blanco. 3. Debe comenzar con un carácter alfabético inglés (a-z, A-Z). 4. Debe contener solamente caracteres alfabéticos ingleses y caracteres numéricos.

    Si no está utilizando WebSphere Interchange Server como intermediario, inhabilite esta opción.

    -G createDirectoryResponse= Establezca el valor de esta opción (yes o no) para especificar si se debe crear el directorio de destino si no existe ya.
    -G replaceExistingResponse

    Establezca esta opción en yesToAll o yes para sustituir todos los archivos encontrados en el sistema cuyo nombre sea igual al nombre de los archivos copiados por el programa de instalación.

    Establezca esta opción en noToAll o no para no sustituir ninguno de los archivos encontrados en el sistema cuyo nombre sea igual al nombre de los archivos copiados por el programa de instalación.

    -G replaceNewerResponses

    Establezca esta opción en yesToAll o yes para sustituir todos los archivos encontrados en el sistema que sean más nuevos que los archivos copiados por el programa de instalación.

    Establezca esta opción en noToAll o no para no sustituir ninguno de los archivos encontrados en el sistema que sean más nuevos que los archivos copiados por el programa de instalación.

    -G removeExistingResponse

    Esta opción especifica si se debe eliminar un archivo de respuestas que existe en el sistema. Observe que esta opción es para el proceso de desinstalación solamente. Establezca esta opción en yestoall o yes para eliminar los archivos de respuestas existentes. Establezca esta opción en notoall o no para conservar los archivos existentes en el sistema.

    -G removeModifiedResponse

    Esta opción especifica si se debe eliminar un archivo de respuestas que se ha modificado desde la última vez que se instaló. Observe que esta opción es para el proceso de desinstalación solamente. Establezca esta opción en yestoall o yes para eliminar los archivos de respuestas que se hayan modificado. Establezca esta opción en notoall o no para conservar los archivos modificados existentes en el sistema.

  2. Realice la instalación desatendida tal como se describe en Ejecución de la instalación desatendida, utilizando el archivo de respuestas preparado en el paso 1.

Registro de las selecciones de instalación

Puede registrar en un archivo las selecciones de instalación que ha realizado; para ello utiliza una opción especial al invocar el programa de instalación desde la línea de mandatos. Cuando finaliza la instalación, las selecciones de instalación que ha realizado se registran en el archivo que especificó en la línea de mandatos. Puede utilizar la información de instalación registrada en este archivo como registro de los valores instalación seleccionados y como archivo de respuestas para instalaciones desatendidas en otras máquinas.

Para crear este archivo, emita el mandato siguiente desde la línea de mandatos:

<ejecutable del iniciador de la instalación> -options-record <nombre_archivo>

Por ejemplo, escriba el mandato siguiente en una ventana de mandatos para registrar las selecciones de instalación de su adaptador en un sistema Windows:

setupwin32.exe -options-record C:\data\settings.txt

Copyright IBM Corp. 2003, 2005