Instalación y utilización

Esta sección trata los temas siguientes:

Instalación de ODA for Manugistics

Para instalar ODA for Manugistics, utilice el programa de instalación de IBM WebSphere Business Integration Adapter for Manugistics. Siga las instrucciones contenidas en el manual System Installation Guide for UNIX o el manual System Installation Guide for Windows. Cuando finaliza la instalación, los archivos siguientes están instalados en el directorio del sistema donde instaló el producto:

Nota:
A menos que se indique otra cosa, el presente documento utiliza barras inclinadas invertidas (\) como convenio para representar las vías de acceso de directorios. Para las instalaciones en UNIX, utilice barras inclinadas (/) en lugar de barras inclinadas invertidas. Todas las vías de acceso del producto están referidas al directorio donde está instalado el producto en el sistema.

Antes de utilizar ODA for Manugistics

Antes de poder ejecutar ODA for Manugistics, debe seguir estos pasos:

  1. Instale el controlador JDBC apropiado. Siga las instrucciones contenidas en el manual System Installation Guide for UNIX o el manual System Installation Guide for Windows.
    Importante:
    ODA for Manugistics se puede conectar a una base de datos cualquiera utilizando un controlador JDBC que sea compatible con JDBC 2.0 o posterior.
  2. Debido a que ODA for Manugistics crea nombres de objetos comerciales y nombres de atributos a partir de los nombres de las correspondientes tablas y columnas de bases de datos, y debido a que esos nombres deben estar especificados utilizando ISO Latin-1, compruebe que los componentes de base de datos apropiados tengan nombres expresados mediante Latin-1. Si no es así, tiene las opciones siguientes:
  3. Abra en la modalidad de edición el shell de UNIX o el archivo de proceso por lotes de Windows y configure los valores descritos en la Tabla 12.
    Tabla 12. Variables de configuración del shell y del archivo de proceso por lotes
    Variable Explicación Ejemplo
    AGENTNAME
    Nombre del ODA

    UNIX: AGENTNAME=ManugisticsODA

    Windows: set AGENTNAME=ManugisticsODA

    AGENT
    Nombre del archivo jar del ODA

    UNIX: AGENT=$CROSSWORLDS/ODA/Manugistics/ BIA_ManugisticsODA.jar

    Windows: set AGENT= %CROSSWORLDS%\ODA\Manugistics\ BIA_ManugisticsODA.jar

    DRIVERPATH
    Vía de acceso de la biblioteca del controlador JDBC; ODA for Manugistics utiliza las clases de controlador para establecer una conexión con una base de datos especificada.

    UNIX: DRIVERPATH=$CROSSWORLDS/lib/ \ xwutil.jar:$CROSSWORLDS/lib/ \ xwbase.jar:$CROSSWORLDS/lib/ \ xwsqlserver.jar:$CROSSWORLDS/lib/ \ spy/lib/spy.jar

    Windows: set DRIVERPATH=%CROSSWORLDS%\ / lib\xwutil.jar;%CROSSWORLDS%\lib\ / xwbase.jar;%CROSSWORLDS%\lib\ / xwsqlserver.jar;%CROSSWORLDS%\lib\ / spy\lib\spy.jar

    DRIVERLIB
    Vía de acceso de las bibliotecas nativas utilizadas por el controlador JDBC

    UNIX:DRIVERLIB=$CROSSWORLDS/lib/db2jdbc.so

    Windows: DRIVERLIB=%CROSSWORLDS%\bin\db2jdbc.dll

Después de instalar el controlador JDBC y definir valores de configuración en el shell o archivo de proceso por lotes, debe seguir los pasos siguientes para crear objetos comerciales:

  1. Inicie el ODA.
  2. Inicie el Diseñador de objetos comerciales.
  3. En el Diseñador de objetos comerciales, siga el proceso necesario para configurar y ejecutar el ODA.

Este proceso consta de seis pasos, que se describen con detalle en las secciones siguientes.

Inicio de ODA for Manugistics

Puede iniciar ODA for Manugistics con el script de inicio correspondiente al sistema operativo que utilice.

UNIX:

start_ManugisticsODA.sh

Windows:

start_ManugisticsODA.bat

Puede configurar y ejecutar ODA for Manugistics utilizando el Diseñador de objetos comerciales. El Diseñador de objetos comerciales localiza cada ODA de acuerdo con el nombre especificado en la variable AGENTNAME de cada script o archivo de proceso por lotes. El nombre de ODA por omisión para este conector es ManugisticsODA.

Ejecución de varias instancias de ODA for Manugistics

Es recomendable que cambie el nombre del ODA cuando ejecute varias instancias de él. Para crear instancias adicionales de ODA for Manugistics con un nombre exclusivo:

Si ejecuta instancias de ODA en máquinas diferentes, es recomendable que a cada nombre de ODA anteponga como prefijo el nombre de la máquina de sistema principal.

La Figura 6 muestra la ventana del Diseñador de objetos comerciales desde la que selecciona el ODA para ejecutar.

Utilización de archivos de mensajes error y de rastreo

Los archivos de mensajes de error y de rastreo (el archivo por omisión es BIA_ManugisticsODAAgent.txt) están situados en \ODA\messages\, dentro del directorio del producto. Estos archivos utilizan el convenio de denominación siguiente:

nombreAgenteAgent.txt

Si crea varias instancias del script o archivo de proceso por lotes de ODA y proporciona un nombre exclusivo para cada ODA representado, puede disponer de un archivo de mensajes para cada instancia de ODA. Como alternativa, puede tener varios ODA con nombres diferentes que utilizan el mismo archivo de mensajes. Existen dos maneras de especificar un archivo de mensajes válido:

Importante:
Si no especifica correctamente el nombre del archivo de mensajes cuando configura el ODA, el ODA se ejecutará sin emitir mensajes. Para obtener más información sobre la especificación del nombre del archivo de mensajes, consulte Configurar propiedades de inicialización.

Durante el proceso de configuración, debe especificar:

La Tabla 13 describe estos valores.

Tabla 13. Niveles de rastreo
Nivel de rastreo Descripción
0 Registra todos los errores
1 Rastrea todos los mensajes entrantes y salientes emitidos para el método
2 Rastrea las propiedades de ODA y sus valores
3 Rastrea los nombres de todos los objetos comerciales
4 Rastrea detalles de todas las hebras iniciadas
5 * Indica los valores de inicialización del ODA para todas las propiedades de éste
* Rastrea un estado detallado de cada hebra iniciada por ODA for Manugistics
* Rastrea el vuelco de la definición de objeto comercial

Para obtener información sobre dónde configurar estos valores, consulte Configurar propiedades de inicialización.

Copyright IBM Corp. 1997, 2004