El programa de utilidad configTool

Las propiedades y valores en la página Configuración se almacenan en las tablas del sistema. Puede utilizar la utilidad configTool para importar y exportar valores de configuración de y a las tablas del sistema.

Cuándo se debe utilizar configTool

Es posible que desee utilizar configTool para lo siguiente:

Para importar plantillas de origen de datos y partición proporcionadas con Campaign, que a continuación puede modificar y duplicar utilizando la página Configuración.

Para registrar (importar las propiedades de configuración) productos de IBM® EMM, si el instalador del producto no puede añadir automáticamente las propiedades a la base de datos.

Para exportar una versión XML de los valores de configuración para la copia de seguridad o para importarla en otra instalación de IBM® EMM.

Para suprimir categorías que no tengan el enlace Suprimir categoría. Para hacer esto, utiliza configTool para exportar la configuración, y después suprime manualmente el XML que crea la categoría y utiliza configTool para importar el XML editado.

Esta utilidad modifica las tablas usm_configuration y usm_configuration_values en la base de datos de la tabla del sistema de Marketing Platform, que contiene las propiedades de configuración y sus valores. Para obtener los mejores resultados, cree copias de seguridad de estas tablas, o exporte las configuraciones existentes mediante configTool y realice copia de seguridad del archivo resultante de forma que pueda restaurar la configuración si comete un error al utilizar configTool para la importación.

Sintaxis

configTool -d -p "rutaElemento" [-o]

configTool -i -p "rutaElemento padre" -f archivoImportación [-o]

configTool -x -p "rutaElemento" -f archivoExportación

configTool -vp -p "rutaElemento" -f archivoImportación [-d]

configTool -r nombreProducto -f archivoRegistro [-o] configTool -u nombreProducto

Comandos

-d -p "rutaElemento" [o]

Suprimir las propiedades de configuración y sus valores, especificando una ruta en la jerarquía de propiedades de configuración.

La ruta del elemento debe utilizar los nombres internos de las categorías y las propiedades. Para obtenerlos vaya a la página Configuración, seleccione la propiedad o categoría necesaria, y compruebe la ruta que se muestra entre paréntesis en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de configuración utilizando el carácter | y coloque la ruta entre comillas dobles.

Tenga en cuenta lo siguiente:

Solo se pueden suprimir mediante este comando las categorías y propiedades de dentro de una aplicación, no aplicaciones completas. Para anular el registro de una aplicación completa, utilice el comando -u.

Para suprimir categorías que no tengan el enlace Suprimir categoría en la página Configuración, utilice la opción -o.

Cuando se utiliza -d con el comando -vp, configTool suprime los nodos hijo de la ruta que especifique si estos nodos no se incluyen en el archivo XML que especifique.

-i -p "rutaElementoPadre" -f archivoImportación [o]

Importar propiedades de configuración y sus valores desde un archivo XML especificado.

Para importar, debe especificar una ruta hasta el elemento padre bajo la que desea importar las categorías. La utilidad configTool importa las propiedades en la categoría que especifique en la ruta.

Puede añadir categorías a cualquier nivel por debajo del nivel superior, pero no puede añadir una categoría al mismo nivel que la categoría superior.

La ruta del elemento padre debe utilizar los nombres internos de categorías y propiedades. Para obtenerlos vaya a la página Configuración, seleccione la propiedad o categoría necesaria, y compruebe la ruta que se muestra entre paréntesis en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de configuración utilizando el carácter | y coloque la ruta entre comillas dobles.

Se puede especificar una ubicación para el archivo de importación relativa al directorio tools/bin o especificar una ruta de directorio completa. Si especifica una ruta relativa o no especifica ninguna ruta, configTool primero busca el archivo relativo al directorio tools/bin.

De forma predeterminada, este comando no sobrescribe una categoría existente, pero se puede utilizar la opción -o para forzar esta acción.

-x -p "rutaElemento" -f archivoParaExportar

Exportar propiedades de configuración y sus valores a un archivo XML con un nombre especificado.

Puede exportar todas las propiedades de configuración o limitar la exportación a una categoría específica especificando una ruta en la jerarquía de propiedades de configuración.

La ruta del elemento debe utilizar los nombres internos de las categorías y propiedades, que puede obtener yendo a la página Configuración, seleccionando la categoría o propiedad que desea y mirando la ruta que se muestra entre paréntesis en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de configuración utilizando el carácter | y coloque la ruta entre comillas dobles.

Se puede especificar una ubicación para el archivo de exportación relativa al directorio actual o especificar una ruta de directorio completa. Si la especificación de archivo no contiene un separador (/ en UNIX™, / o \ en Windows™), configTool graba el archivo en el directorio tools/bin de la instalación de Marketing Platform. Si no indica la extensión xml, configTool la añade.

-vp -p "rutaElemento" -f archivoImportación [-d]

Este comando se utiliza principalmente en actualizaciones manuales, para importar propiedades de configuración. Si ha aplicado un fixpack que contiene una nueva propiedad de configuración y a continuación actualiza, la importación de un archivo de configuración como parte de un proceso de actualización manual puede alterar temporalmente los valores que se han establecido al aplicar el fixpack. El comando -vp garantiza que la importación no altera temporalmente los valores de configuración establecidos anteriormente.

Tras utilizar la utilidad configTool con la opción -vp, debe reiniciar el servidor de aplicaciones web en el que está desplegado Marketing Platform para que se apliquen los cambios.

Cuando se utiliza -d con el comando -vp, configTool suprime los nodos hijo de la ruta que especifique si estos nodos no se incluyen en el archivo XML que especifique.

-r nombreProducto -f archivoRegistro

Registrar la aplicación. La ubicación del archivo de registro puede ser relativa al directorio tools/bin o puede ser una ruta completa. De forma predeterminada, este comando no sobrescribe una configuración existente, pero se puede utilizar la opción -o para forzar esta acción. El parámetro nombreProducto debe ser uno de los nombres que figuran en la lista anterior.

Tenga en cuenta lo siguiente:

Cuando se utiliza el comando -r, el archivo de registro debe tener <application> como primer código del XML.

Se pueden proporcionar otros archivos con el producto, que puede utilizar para insertar propiedades de configuración en la base de datos de Marketing Platform. Para estos archivos, utilice el comando -i. Solo el archivo que tiene el código <application> como primer código se puede utilizar con el comando -r.

El archivo de registro de Marketing Platform se denomina Manager_config.xml, y el primer código es <Suite>. Para registrar este archivo en una nueva instalación, utilice la utilidad populateDb o vuelva a ejecutar el instalador de Marketing Platform tal como se describe en la publicación IBM® Marketing Platform Guía de instalación.

Después de la instalación inicial, para volver a registrar productos que no sean Marketing Platform, utilice configTool con los comandos -r y -o para sobrescribir las propiedades existentes.

La utilidad configTool utiliza nombres de producto como parámetros con los comandos para registrar y anular el registro de los productos. Con el release 8.5.0 de IBM® EMM, muchos nombres de producto han cambiado. Sin embargo, los nombres que reconoce configTool no han cambiado. A continuación se listan los nombres de producto válidos para utilizar con configTool, junto con los nombres actuales de los productos.

Nombres de producto para el registro y la anulación del registro de configTool
Nombre de producto	Nombre utilizado en configTool
Marketing Platform	Manager
Campaign	Campaign
Distributed Marketing	Collaborate
eMessage	emessage
Interact	interact
Contact Optimization	Optimize
Marketing Operations	Plan
CustomerInsight	Insight
Digital Analytics for On Premises	NetInsight
Opportunity Detection	Detect
Leads	Leads
Interaction History	InteractionHistory
Attribution Modeler	AttributionModeler
IBM® SPSS® Modeler Advantage Enterprise Marketing Management Edition	SPSS
Digital Analytics	Coremetrics

-u nombreProducto

Anula el registro de una aplicación especificada por nombreProducto. No es necesario incluir la ruta a la categoría del producto; el nombre del producto es suficiente y necesario. El proceso elimina todas las propiedades y valores de configuración del producto.

Opciones

-o

Cuando se utiliza con -i o -r, sobrescribe un registro de producto o categoría (nodo) existente.

Cuando se utiliza con -d, se puede suprimir una categoría (nodo) que no tenga el enlace Suprimir categoría en la página Configuración.

Ejemplos

Importar valores de configuración de un archivo denominado Product_config.xml en el directorio conf de la instalación de Marketing Platform.

configTool -i -p "Affinium" -f Product_config.xml

Importar una de las plantillas de origen de datos de Campaign suministradas en la partición de Campaign predeterminada, partition1. En el ejemplo se da por supuesto que la plantilla de origen de datos de Oracle, OracleTemplate.xml, se encuentra en el directorio tools/bin bajo la instalación de Marketing Platform.

configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml

Exportar todos los valores de configuración a un archivo denominado myConfig.xml en el directorio D:\backups.

configTool -x -f D:\backups\myConfig.xml

Exportar una partición de Campaign existente (completa con entradas de origen de datos), guardarla en un archivo denominado partitionTemplate.xml, y almacenarlo en el directorio predeterminado tools/bin, bajo la instalación de Marketing Platform.

configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml

Registrar manualmente una aplicación denominada nombreProducto utilizando un archivo denominado app_config.xml en el directorio tools/bin predeterminado de la instalación de Marketing Platform y forzar que sobrescriba un registro existente de esta aplicación.

configTool -r nombreProducto -f app_config.xml -o

Anular el registro de una aplicación denominada nombreProducto.

configTool -u nombreProducto