eMessage proporciona varios scripts que se utilizan para administrar las funciones de eMessage.
Puede utilizar los programas de utilidad que se describen en esta sección para diversas funciones de inicio y administración. Además de los programas de utilidad utilizados con IBM Marketing Platform, IBM eMessage utiliza también programas de utilidad específicas para eMessage y se utilizan únicamente para gestionar componentes de eMessage.
Para obtener más información sobre otros programas de utilidad disponibles para su instalación de IBM EMM, consulte la publicación IBM Marketing Platform, Guía
del administrador.
El script RLU
Utilice el script RLU para comprobar el estado del Cargador de listas de destinatarios (RLU).
Nota: No puede utilizar este script para iniciar ni detener el RLU. Utilice este script solo para comprobar el estado de la conexión entre la RLU y IBM EMM Hosted Services.
El script RLU es el directorio de inicio de IBM EMM en eMessage > bin. El directorio de eMessage es un subdirectorio en el directorio de Campaign. En entornos UNIX o Linux, ejecute el script como rlu.sh.
En Windows, ejecute el script desde la línea de comandos como rlu.bat.
Sintaxis
rlu -c | --check [-h]
Comandos
-c, --check
Compruebe que el RLU está correctamente configurado y que está conectado a IBM EMM Hosted Services.
Opciones
-h, --help
Mostrar la sintaxis del script
Ejemplo
En un entorno Linux, determine si la RLU está conectada a IBM EMM Hosted Services.
rlu.sh --check
En función del estado del sistema, la salida de este comando puede tener este aspecto:
Configuring Data Source [systemTables]... Testing configuration for partition partition1 Testing connectivity for partition partition1 Testing user accessibility for partition partition1 Succeeded. List uploader config and connectivity test succeeded for partition partition1
Tareas relacionadas:
“Probar la carga a IBM EMM Hosted Services” en la página 39
El script RCT
Utilice el script RCT para ejecutar o detener el Rastreador de respuestas y contactos (RCT) o para determinar si se puede conectar correctamente al entorno de envío de correos hospedado que se encuentra en IBM EMM Hosted Services. Este script se encuentra en el directorio bin de la instalación de eMessage. El directorio de eMessage es un subdirectorio en el directorio de Campaign. En entornos UNIX o Linux, ejecute el script como rct.sh.
En Windows, ejecute el script desde el indicador de comandos como rct.bat.
Sintaxis
rct [ start | stop | check ]
Comandos
start Iniciar el RCT stop Detener el RCTOpciones
checkCompruebe la capacidad de la RCT para conectarse a IBM EMM Hosted Services.
Ejemplos
v Para iniciar el RCT en Windows. rct.bat start
v Para detener el RCT en Windows. rct.bat stop
rct.sh check
Si el RCT puede conectarse satisfactoriamente a IBM EMM Hosted Services, la salida de este comando puede aparecer como se indica a continuación.
C:/Unica/emessage/bin>rct check
Probando configuración y conectividad para partición partition1
Satisfactorio | Partición: partition1 - ID de cuenta de servicios alojados: asm_admin
Tareas relacionadas:
“Adición del Rastreador de respuestas y contactos (RCT) como servicio” en la página 35
“Probar la descarga desde IBM EMM Hosted Services” en la página 39
El script MKService_rct
Puede utilizar este script para añadir o eliminar el Rastreador de respuestas y contactos (RCT) como servicio. Si se añade el RCT como servicio, se reinicia el RCT cada vez que reinicie el sistema operativo de la máquina donde se ha instalado el RCT. Si se elimina el RCT como servicio, se impide que se reinicie
automáticamente.
Este script se encuentra en el directorio bin de la instalación de eMessage. En entornos UNIX o Linux, ejecute MKService_rct.sh. con un usuario que tenga permisos de usuario raíz o que tenga permisos suficientes para crear procesos de daemon.
En Windows, ejecute el script desde el indicador de comandos como MKService_rct.bat.
Sintaxis
MKService_rct -install MKService_rct -removeComandos
-installAñadir el RCT como servicio
-remove
Eliminar el servicio RCT
Ejemplos
v Para añadir el RCT como servicio de Windows. MKService_rct.bat -install
v Para eliminar el servicio RCT en UNIX o Linux. MKService_rct.sh -remove
Conceptos relacionados:
Tareas relacionadas:
“Adición del Rastreador de respuestas y contactos (RCT) como servicio” en la página 35
La utilidad configTool
Las propiedades y valores de la página Configuración se almacenan en las tablas del sistema de Marketing Platform. La utilidad configTool importa y exporta los valores de configuración a y desde las tablas del sistema Marketing Platform.
Cuándo se utiliza configTool
Es posible que desee utilizar configTool por los siguientes motivos.
v Para importar plantillas de origen de datos y partición proporcionadas con Campaign, que a continuación se pueden modificar y duplicar utilizando la página de configuración.
v 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.
v 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. v Para suprimir las categorías que no tienen el enlace Suprimir categoría. Puede
hacerlo utilizando configTool para exportar la configuración y, a continuación, suprimiendo manualmente el XML que crea la categoría y utilizando configTool para importar el archivo XML editado.
Importante: Esta utilidad modifica las tablas usm_configuration y
usm_configuration_valuesen la base de datos de la tabla del sistema Marketing Platform, que contienen las propiedades de configuración y sus valores. Para que los resultados sean óptimos, cree copias de seguridad de estas tablas o exporte las configuraciones existentes utilizando configTool y realice una copia de seguridad del archivo resultante de manera que pueda restaurar la configuración en caso de cometer un error al utilizar configTool para importar.
Nombres de productos válidos
La utilidad configTool utiliza nombres de productos como parámetros con los comandos que registran y anulan el registro de productos, tal como se describe más adelante en esta sección. Con el release 8.0.0 de IBM EMM, muchos nombres de producto han cambiado. No obstante, los nombres que reconoce configTool no han cambiado. Los nombres de producto válidos para ser utilizados con
configToolse listan a continuación, junto con los nombres actuales de los productos.
Nombre del producto Nombre usado en configTool
Marketing Platform Manager
Campaign Campaign
Distributed Marketing Collaborate
eMessage emessage
Nombre del producto Nombre usado en configTool
Contact Optimization Optimize Marketing Operations Plan
CustomerInsight Insight
Digital Analytics for On Premises NetInsight
PredictiveInsight Model
Leads Leads
Sintaxis
configTool -d -p "rutaElemento" [-o]
configTool -i -p "rutaElemento padre" -f archivoImportación [-o]
configTool -x -p "rutaElemento" -f archivoParaExportar
configTool -r nombreProducto -f archivoRegistro [-o]
configTool -u nombreProducto
Comandos
-d -p "rutaElemento"
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, que puede obtener en la página Configuración, seleccionando la categoría o propiedad que desea 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.
v Con este comando sólo se pueden suprimir las categorías y propiedades dentro de una aplicación, no las aplicaciones completas. Utilice el comando -u para anular el registro de una aplicación entera.
v Para suprimir categorías que no tienen el enlace Suprimir categoría en el panel Configuración, utilice la opción -o.
-i -p "rutaElementoPadre" -f archivoImportación
Permite importar propiedades de configuración y sus valores desde un archivo XML especificado.
Para importar, especifique una ruta al elemento padre debajo del cual desea importar las categorías. La utilidad configTool importa propiedades bajo 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 las categorías y propiedades, que puede obtener yendo a la página Configuración, seleccionando la categoría o propiedad deseada y consultando 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 la ubicación de un archivo de importación en relación 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 una sobrescritura.
-x -p "rutaElemento" -f archivoParaExportar
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 puede obtener en la página Configuración, seleccionando la categoría o propiedad que desea 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. Se puede especificar una ubicación del archivo de exportación relativa al directorio actual o una ruta de directorio completa. Si la especificación del archivo no
contiene ningún separador (/ en Unix, / o \ en Windows), configTool graba el archivo en el directorio tools/bin debajo de la instalación de Marketing Platform. Si no se proporciona la extensión xml, configTool la añade.
-r nombreProducto -f archivoRegistro
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 par forzar una sobrescritura. El parámetro nombreProducto debe ser uno de los que se listan arriba.
Tenga en cuenta lo siguiente.
v Cuando utilice la opción -r, el archivo de registro debe tener <application> como primera etiqueta en el XML.
Con el producto se pueden proporcionar otros archivos que se pueden utilizar para insertar propiedades de configuración en la base de datos de Marketing Platform. Para estos archivos, utilice la opción -i. Sólo puede utilizarse con la opción -r el archivo que tiene la etiqueta <application> como primera etiqueta. v El archivo de registro para la Marketing Platform se denomina
Manager_config.xmly la primera etiqueta es <Suite>. Para registrar este archivo en una instalación nueva, utilice la utilidad populateDb o vuelva a ejecutar el instalador de Marketing Platform, como se describe en la IBM Marketing
v Después de la instalación inicial, para volver a registrar productos que no sean Marketing Platform, utilice configTool con la opción -r y -o para sobrescribir las propiedades existentes.
-u nombreProducto
Anular registro de una aplicación especificada con nombreProducto . No es
necesario incluir una ruta para la categoría del producto; el nombre de producto es suficiente. El parámetro nombreProducto debe ser uno de los que se listan arriba. Esto elimina todas las propiedades y los valores de configuración del producto.
Opciones
-o
Cuando se utiliza con -i o -r, sobrescribe una categoría o registro de producto (nodo) existente.
Si se utiliza con -d, le permite suprimir una categoría (nodo) que no tiene el enlace
Suprimir categoríaen la página Configuración.
Ejemplos
v Importar valores de configuración de un archivo denominado
Product_config.xmlque se encuentra en el directorio conf, bajo la instalación de Marketing Platform.
configTool -i -p "Affinium" -f Product_config.xml
v Importar una de las plantillas suministradas de origen de datos de Campaign en la partición predeterminada de Campaign, partición1. 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
v Exportar todos los valores de configuración a un archivo denominado myConfig.xmlsituado en el directorio D:\backups.
configTool -x -f D:\backups\myConfig.xml
v 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
v Registrar manualmente una aplicación llamada productName, utilizando un archivo denominado app_config.xml ubicado en el directorio predeterminado tools/binbajo la instalación de Marketing Platform, y forzar para que se sobrescriba un registro existente de esta aplicación.
configTool -r productName -f app_config.xml -o
v Anular el registro de una aplicación denominada productName. configTool -u productName
Para hacer copia de seguridad de los valores de
configuración
Para hacer una copia de seguridad de los valores de configuración de eMessage y Campaign, utilice el programa de utilidad configTool para exportar una copia de los valores de configuración actuales de IBM Marketing Platform a un archivo.
Acerca de esta tarea
Para obtener información detallada sobre cómo utilizar el programa de utilidad configTool, incluyendo la explicación de la sintaxis y los parámetros, consulte “La utilidad configTool” en la página 60.
Al realizar la copia de seguridad con configTool se exportan todos los valores actuales de las propiedades de la categoría emessage de la configuración. Cuando lleve a cabo la copia de seguridad, especifique un nombre de archivo para el archivo .xml exportado y anote la ubicación donde lo guarda.
Por ejemplo, En Windows:
configTool.bat -x -p “emessage” -f emessageProperties.xml
En UNIX o Linux:
configTool.sh -x -p “emessage” -f emessageProperties.xml
De forma predeterminada, el archivo .xml se exporta al directorio
Capítulo 8. Acerca de la resolución de problemas en
eMessage
IBM eMessage proporciona varias herramientas y técnicas que puede utilizar para investigar problemas relacionados con sus instalaciones de Campaign y eMessage.
Archivos de registro de eMessage
IBM EMM proporciona varios archivos de registro que puede revisar para supervisar la instalación de eMessage e investigar los problemas.
Archivo de registro de eMessage
Este registro contiene los siguientes tipos de información sobre la información descargada desde IBM EMM Hosted Services.
v información general de envío de correos v ID de instancia de envío de correos v datos de pulsaciones en enlaces v datos de correo electrónico rebotado
Ubicado en el directorio logs en la instalación de eMessage.
Archivos temporales de eMessage
Este directorio contiene los datos que se cargan.
Ubicado en el directorio temp de la instalación de eMessage.
Archivos de registro de Campaign
Puede revisar los archivos de registro de las siguientes ubicaciones para obtener información relacionada con la actividad relacionada con el envío de correos en Campaign.
v Campaign\partitions\<partitionN>\logs
Diversos archivos de registro relacionados con ejecuciones de diagramas de flujo, incluyendo entradas de registro de cualquier proceso de eMessage contenido en el diagrama de flujo.
v Campaign\logs
Este directorio contiene campaignweb.log, que contiene información sobre la actividad de carga realizada por el Cargador de listas de destinatario.
Utilización de log4j con eMessage
eMessage utiliza el programa de utilidad log4j de Apache para registrar información de configuración, depuración y errores relacionada con el RCT (Rastreador de respuestas y contactos) y el RLU (Cargador de listas de destinatarios).
Para obtener información sobre cómo cambiar la configuración del registro del sistema, consulte:
v Comentarios en el archivo log4j.properties.
v Documentación de log4j en el sitio web de Apache: http://logging.apache.org/ log4j/1.2/manual.html
Utilizar log4j con el Cargador de listas de destinatarios
Cuando ejecuta el programa de utilidad RLU (Cargador de listas de destinatarios) desde la línea de comandos, éste utiliza la configuración predeterminada del registrador. Para cambiar esta configuración, modifique el archivo
emsg_rlu_log4j.properties. En el directorio conf del directorio de instalación de eMessage, copie example_emsg_log4j.properties en emsg_rlu_log4j.properties. Modifique emsg_rlu_log4j.properties como indican los comentarios que encontrará dentro del archivo.
Cuando el RLU se invoca automáticamente desde un diagrama de flujo, utiliza el registro de la aplicación web de Campaign, que está configurado en
campaign_log4j.properties, en el directorio de instalación de Campaign.
Utilizar log4j con el Rastreador de respuestas y contactos
Cuando ejecuta el programa de utilidad RCT (Rastreador de respuestas y contactos), éste utiliza la configuración predeterminada del registrador. Para cambiar esta configuración, modifique el archivo emsg_rct_log4j.properties. En el directorio conf del directorio de instalación de eMessage, copie
example_emsg_log4j.propertiesen emsg_rct_log4j.properties. Modifique emsg_rct_log4j.properties como indican los comentarios que encontrará dentro del archivo.
Capítulo 9. Gestión del acceso a las características de
mensajería
Los usuarios de eMessage requieren acceso a las características de envío de correos en IBM eMessage y IBM Campaign para realizar campañas de marketing por correo electrónico. Campaign y eMessage utilizan funciones de seguridad que proporciona IBM Marketing Platform para controlar el acceso a objetos y características en ambas aplicaciones.
La gestión del acceso a las características de envío de correos requiere la
actualización de las propiedades de configuración de Campaign y eMessage y de los cambios en usuarios y grupos. Debe contar con permisos en IBM Marketing Platform y Campaign para realizar los cambios de configuración necesarios. También debe estar familiarizado con la forma de configurar roles y permisos en Marketing Platform y de políticas en Campaign.
Para obtener más información sobre cómo gestionar el acceso de los usuarios a las características de eMessage yCampaign, consulte los apartados de la Guía del
administrador de IBM Marketing Platform sobre la gestión de la seguridad en IBM
Marketing Platform y en Campaign.
Asignación de roles y políticas para el acceso a la mensajería
Los usuarios de marketing acceden a las características de envío de correos en función de los permisos asignados a un usuario de IBM EMM. La combinación de permisos que están asociadas con los roles del el usuario de eMessage y Campaign determina la posibilidad del usuario de acceder a las funciones de envío de
correos.
Todos los usuarios que requieren acceso a las funciones de envío de correo
electrónico debe tener asignado un rol de eMessage. También se debe asignar roles y permisos al usuario en Campaign. El rol de eMessage controla el acceso a funciones de correo y a interfaces fuera de Campaign, como el Creador de Documentos de eMessage. Los roles de Campaign aplican permisos de forma selectiva para características e interfaces específicas a las que se tiene acceso a través de la pestaña de envío de correos en Campaign.
Conceptos relacionados:
“Asignación de permisos de mensajería para eMessage” en la página 68
Asignación de permisos de campaña
Campaign controla el acceso de los usuarios a las características de envío de correos habilitando o inhabilitando permisos específicos definidos en los roles asignados a un usuario o grupo. Estos roles están asociados a una o más políticas de seguridad. Puede asignar varios roles, cada uno de ellos con diferentes
combinaciones de permisos.
Campaign define los siguientes permisos de envío de correos.
v Ver envíos de correos: el usuario puede abrir la pestaña de envío de correos,