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 utilizar configTool

Es posible que desee utilizar configTool por los siguientes motivos.

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 para las propiedades de configuración) productos IBM® EMM, si el instalador del producto no puede añadir las propiedades a la base de datos automáticamente.

Para exportar una versión XML de valores de configuración para hacer una copia de seguridad o para importar a una instalación diferente de IBM® EMM.

Para suprimir las categorías que no tienen el enlace Suprimir categoría. Para ello, puede utilizar configTool para exportar la configuración y, a continuación, suprimir manualmente el XML que crea la categoría y utilizar 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 utilizando configTool y haga copia de seguridad del archivo resultante de manera 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 "rutaElementoPadre" -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]

Suprima 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 de la jerarquía de propiedades de configuración con 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. Utilice el comando -u para eliminar el registro de una aplicación completa.

Para suprimir categorías que no tienen 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]

Importe las propiedades de configuración y sus valores de un archivo XML especificado.

Para importar, especifique una ruta al elemento padre debajo del cual 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 en cualquier nivel inferior al nivel superior, pero no puede añadir una categoría en el 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 de la jerarquía de propiedades de configuración con el carácter | y coloque la ruta entre comillas dobles.

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

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

-x -p "ruta_elemento" -f archivo_exportación

Exporte las 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 de la jerarquía de propiedades de configuración con el carácter | y coloque la ruta entre comillas dobles.

Puede especificar una ubicación de archivo de exportación relativa al directorio actual o puede 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 proporciona 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 nombre_producto -f archivo_registro

Registre 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 puede utilizar la opción -o para forzar dicha 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 para Marketing Platform se llama Manager_config.xml, y la primera etiqueta 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. Los nombres de producto válidos para ser utilizados con configTool se listan a continuación, con los nombres actuales de los productos.

Nombres de producto para el registro y la anulación del registro de configTool
Nombre del 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 nombre_producto

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

Exporte una partición Campaign existente (completa con las entradas de origen de datos), guárdela en un archivo llamado partitionTemplate.xml y almacénela en el directorio tools/bin predeterminado debajo de 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 product Name -f app_config.xml -o

Elimine el registro de una aplicación llamada productName.

configTool -u nombreProducto