Utilidad configTool

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

Cuándo se utiliza configTool

Puede que desee utilizar configTool por los motivos siguientes.

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

Para registrar (importar las propiedades de configuración para) productos de 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 los valores de configuración para hacer una copia de seguridad o importarlos en una instalación diferente de IBM® EMM.

Para suprimir las categorías que no tienen el enlace Suprimir categoría. Para ello, utilice configTool para exportar la configuración y, a continuación suprima manualmente el XML que crea la categoría y utilice 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 para 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]

Permite suprimir 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 propiedades. Puede obtenerlos en la página Configuración, seleccionando la categoría o propiedad que desee y observando la ruta que aparece entre paréntesis en el panel derecho. 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.

Con este comando solo se pueden suprimir categorías y propiedades de una aplicación, no las aplicaciones completas. Utilice el comando -u para anular 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 especifica si estos nodos no se incluyen en el archivo XML que especifica.

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

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

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

Puede añadir categorías en cualquier nivel por debajo del 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 las categorías y propiedades. Puede obtenerlos en la página Configuración, seleccionando la categoría o propiedad y observando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta en la jerarquía de propiedades de configuración utilizando 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 un 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 puede utilizar la opción -o para forzar una sobrescritura.

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

Permite 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 se pueden obtener en la página Configuración, seleccionando la categoría o propiedad que desee y observando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta en la jerarquía de propiedades de configuración utilizando 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 del archivo no contiene un separador (/ en UNIX™, / o \ en Windows™), configTool graba el archivo en el directorio tools/bin bajo 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 las actualizaciones manuales, para importar las propiedades de configuración. Si ha aplicado un fixpack que contiene una propiedad de configuración nueva y luego actualiza, importando un archivo de configuración como parte de un proceso de actualización manual, puede sustituir los valores que se han establecido al aplicar el fixpack. El comando -vp asegura que la importación no sustituya los valores de configuración establecidos anteriormente.

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

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

-r nombreProducto -f archivoRegistro

Permite 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 puede utilizar la opción -o par forzar una sobrescritura. El parámetro nombreProducto debe ser uno de los nombres listados previamente.

Tenga en cuenta lo siguiente.

Cuando se utiliza el comando -r, el archivo de registro debe tener <application> como primera etiqueta en el XML.

Se pueden proporcionar otros archivos con el producto que se pueden 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 la etiqueta <application> como primera etiqueta puede utilizarse con el comando -r.

El archivo de registro para Marketing Platform se denomina 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 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 otros productos distintos de Marketing Platform, utilice configTool con el comando -r y -o para sobrescribir las propiedades existentes.

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

Nombres de productos para el registro y la anulación el 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 nombreProducto

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

Opciones

-o

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

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

Ejemplos

Importe los valores de configuración de un archivo denominado Product_config.xml al directorio conf bajo 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 proporcionadas a la partición predeterminada de Campaign, partition1. En el ejemplo se supone que se ha situado la plantilla de origen de datos de Oracle, OracleTemplate.xml, en el directorio tools/bin bajo la instalación de Marketing Platform.

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

Exporte 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 existente de Campaign (completa con entradas de origen de datos), guardarla en un archivo denominado partitionTemplate.xml y almacenarla en el directorio predeterminado tools/bin bajo la instalación de Marketing Platform.

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

Registra manualmente una aplicación denominada nombreProducto, utilizando un archivo denominado app_config.xml en el directorio predeterminado tools/bin en la instalación de Marketing Platform y le fuerza a 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