La utilidad configTool

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

Cuándo utilizar configTool

Puede usar configTool para los siguientes fines:

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

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

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

Para suprimir las categorías que no tengan el enlace Suprimir categoría. Puede hacer esto utilizando configTool para exportar su configuración, y después 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 de 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 una copia de estas tablas, o exporte sus configuraciones existentes utilizando configTool y una copia de seguridad del archivo resultante, de forma que pueda restaurar su configuración si comete un error al utilizar configTool para la importación.

Sintaxis

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

configTool -i -p "ruta_elemento_padre" -f archivo_importación [-o]

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

configTool -vp -p "ruta_elemento" -f archivo_importación [-d]

configTool -r nombre_producto -f archivo_registro [-o] configTool -u nombre_producto

Mandatos

-d -p "ruta_elemento" [o]

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

La ruta del elemento debe utilizar los nombres internos de las categorías y propiedades. Puede obtenerlos accediendo a la página Configuración, seleccionando la categoría o propiedad que desee, y mirando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta en la jerarquía de propiedades de configuración mediante el carácter |, y coloque la ruta entre comillas dobles.

Tenga en cuenta lo siguiente.

Mediante este mandato sólo se pueden suprimir las categorías y propiedades que hay dentro de una aplicación, no aplicaciones completas. Utilice el mandato -u para anular el registro de una aplicación completa.

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

Cuando se utiliza -d con el mandato -vp, configTool suprime los nodos hijo que haya en la ruta que especifique, si estos nodos no están incluidos en el archivo XML que especifique.

-i -p "ruta_elemento_padre" -f archivo_importación [o]

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

Para poder importar, especifique una ruta al elemento padre bajo el cual desee importar las categorías. La utilidad configTool importa las propiedades bajo la categoría que haya especificado en la ruta.

Puede añadir categorías en cualquier nivel inferior al nivel más alto, pero no 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 accediendo a la página Configuración, seleccionando la categoría o propiedad necesaria, y mirando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta en la jerarquía de propiedades de configuración mediante el carácter |, y coloque la ruta entre comillas dobles.

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

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

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

Permite exportar las propiedades de configuración y sus ajustes 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 concreta, especificando una ruta en la jerarquía de la propiedad de la configuración.

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

Puede especificar la ubicación de un archivo de exportación relativo 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, bajo la instalación de Marketing Platform. Si no proporciona la extensión xml, configTool la añade.

-vp -p "ruta_elemento" -f archivo_importación [-d]

Este mandato se utiliza, principalmente, en las actualizaciones manuales, para importar las propiedades de la configuración. Si ha aplicado un fixpack que contiene una propiedad de configuración nueva y, a continuación, lleva a cabo la actualización, 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 hayan establecido en el momento en que se haya aplicado el fixpack. El mandato -vp garantiza que la importación no altere temporalmente los valores de configuración establecidos anteriormente.

Después de usar la utilidad configTool con la opción -vp, deberá reiniciar el servidor de aplicaciones web en el que haya desplegado Marketing Platform, para que se apliquen los cambios efectuados.

Cuando se utiliza -d con el mandato -vp, configTool suprime los nodos hijo que haya en la ruta que especifique, si estos nodos no están incluidos en el archivo XML que especifique.

-r nombre_producto -f archivo_registro

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 mandato no sobrescribe una configuración existente, pero puede utilizar la opción -o para forzar que se sobrescriba. El parámetro nombre_producto debe ser uno de los nombres que figuran en la lista anterior.

Tenga en cuenta lo siguiente.

Cuando utilice el mandato -r, el archivo de registro deberá tener <application> como el primer código en el XML.

Con el producto pueden proporcionarse otros archivos que puede utilizar para insertar las propiedades de configuración en la base de datos de Marketing Platform. Para estos archivos, utilice el mandato -i. Sólo el archivo que tenga el código <application> como primer código se podrá utilizar con el mandato -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 instalación nueva, use la utilidad populateDb , o vuelva a ejecutar el instalador de Marketing Platform, tal como se describe en la publicación IBM® Marketing Platform Installation Guide.

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

La utilidad configTool utiliza los nombres de producto como parámetros con los mandatos que registran y anulan registros de productos. Con el release 8.5.0 de IBM® EMM, muchos nombres de producto han cambiado. No obstante, los nombres que configTool reconoce, no han cambiado. A continuación figuran los nombres de producto válidos que se pueden usar 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 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

Permite registrar una aplicación que se especificado mediante nombre_producto. No es necesario que incluya una ruta para la categoría del producto; es suficiente con el nombre de producto, y éste es necesario. Este proceso elimina todas las propiedades y los valores de configuración del producto.

Opciones

-o

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

Cuando se utiliza con -d, 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, 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 en la partición predeterminada de Campaign, partition1. En el ejemplo se presupone que ha colocado la plantilla de origen de datos Oracle, OracleTemplate.xml, en el directorio tools/bin, bajo la instalación de Marketing Platform.

configTool -i -p "Affinium|Campaign|particiones|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 almacenarla en el directorio tools/bin predeterminado, bajo la instalación de Marketing Platform.

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

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

configTool -r nombre_producto -f app_config.xml -o

Anular el registro de una aplicación denominada nombre_producto.

configTool -u nombre_producto