Comandos de implementación de definición de BAM (modelo de observación)
Los comandos de implementación de la utilidad de administración de BAM le permiten aplicar, modificar y quitar definiciones.
deploy-all: implementa una definición de BAM.
update-all: Novedades una definición de BAM.
remove-all: quita una definición de BAM.
update-livedataworkbook: Novedades la información de conexión de la base de datos en un libro de datos activo.
regenerate-livedataworkbook: regenera el libro de datos dinámicos en el servidor.
Nota
Puede habilitar el seguimiento en cualquier comando de la utilidad BM incluyendo el modificador de parámetro -Trace:on|off . Al utilizar el conmutador Trace, se invalidan las opciones de seguimiento del archivo de configuración. El conmutador puede utilizarse junto con cualquier comando normal de BM.
Nota
En un sistema que admita el Control de cuentas de usuario (UAC), es posible que deba ejecutar la herramienta con privilegios administrativos.
Comando deploy-all
Uso
bm.exe deploy-all -DefinitionFile:<def file>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| DefinitionFile:<def file> | Ruta y nombre del archivo que contiene las definiciones que se van a implementar. |
| Server:<server> | Opcional: nombre del servidor en el que se van a implementar las definiciones. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que se van a implementar las definiciones. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Implementa todos los artefactos desde el archivo XML especificado de definición de BAM al servidor y a la base de datos especificados. El archivo puede ser un archivo de texto que contenga el XML de definición de BAM o un libro de Excel de BAM. El archivo de definición debe incluir sólo artefactos nuevos. Si el archivo contiene artefactos que ya se han implementado, la implementación no funcionará e informará de un error.
Consideraciones para implementar definiciones de BAM
Cuando implementa suscripciones de alerta, los Id. de usuario de los suscriptores se deben especificar en formato dominio\usuario.
El servicio de coordinador de transacciones distribuidas (DTC) debe ejecutarse en el equipo en el que se emite el comando deploy-all .
Cuando implementa una definición, la utilidad de administración de BAM sólo admite 14 niveles de dimensión en la vista Agregación en tiempo real (ATR). Implementar niveles adicionales da genera errores de implementación.
Si define varias vistas que utilizan diferentes configuraciones de idioma e implementan su solución en un servidor que utiliza un lenguaje único, las vistas no se podrán implementar. Este escenario sólo se admite en caso de que no tenga agregaciones programadas que requieran OLAP como parte de la definición de BAM.
La utilidad de administración de BAM le limita a 49 vistas de actividad implementada cuando se habilitan las alertas BAM. El número de vistas de actividad se calcula como el sumatorio de 1 a N de la vista (n) multiplicado por el número de actividades primarias. Por ejemplo, si implementa una vista que se esté basada en dos actividades, obtiene dos vistas de actividad. Si implementa dos vistas, una que abarque dos actividades y otra que esté basada en una actividad única, tiene 3 vistas de actividad.
La utilidad de administración de BAM bloquea la implementación de las definiciones de BAM, que tienen varios informes de tabla dinámica que se definen en la misma combinación de nombre del cubo y de ATR. Bm.exe finalizará la implementación y mostrará el error siguiente:
Implementación de la vista... ERROR: Error en la implementación de BAM.
Sólo una vista de tabla dinámica puede definirse en una ATR y un cubo dados.
La lista siguiente de nombres se reserva y generará un error al implementar la definición:
RecordID
Identificador de actividad
IsVisible
IsComplete
LastModified
Nota
Si bm.exe encuentra un error durante la implementación, la implementación finaliza y se deshacen los cambios en las vistas y en las actividades. Los cambios a cubo OLAP no se deshacen ya que OLAP no admite implementación transaccional.
Nota
Las definiciones de BAM creadas en un equipo que utiliza una configuración regional no se pueden implementar en un equipo configurado con una configuración regional diferente. Por ejemplo, una definición de BAM generada con una versión de idioma inglés de Microsoft Excel en un equipo configurado con una configuración regional en inglés no se puede implementar en un equipo configurado en japonés que utiliza la configuración regional en japonés.
Ejemplos
bm.exe deploy-all -DefinitionFile:MyDef.xml
bm.exe deploy-all -DefinitionFile:MyWorkbook.xls -Server:machine1
Comando update-all
Uso
bm.exe update-all -DefinitionFile:<def file>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| DefinitionFile:<def file> | Ruta y nombre del archivo que contiene las definiciones desde el que se va a realizar la actualización. |
| Server:<server> | Opcional: el nombre del servidor en el que se van a implementar las actualizaciones de definición. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que se van a implementar las actualizaciones de definición. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Actualiza ciertos artefactos del XML de definición de BAM. El archivo puede ser un archivo de texto que contenga el XML de definición de BAM o un libro de Excel de BAM. La actualización no elimina artefactos que no se describen en el archivo actual de definición. Puede agregar puntos nuevos de comprobación a actividades, pero no puede quitar puntos de control de actividades implementadas. La actualización no puede ni cambiar el nombre de los puntos de control ni modificar sus propiedades.
Una vez implementada una actividad, las acciones que puede realizar sobre ella están restringidas. Específicamente, no puede eliminar elementos de una actividad a menos que esté dispuesto a que su administrador anule la implementación de toda la actividad de BAM y sus conjuntos de vista y los vuelva a implementar. Esto puede provocar una interrupción de la visibilidad y pérdidas de datos a menos que el administrador haga una copia de seguridad de los datos y los restaure.
Nota
No puede usar este comando para agregar actividades nuevas a una vista existente. Para agregar una vista a una actividad, debe crear una nueva vista que incluya la actividad nueva. Puede anular la implementación de la vista antigua, pero sea consciente de que perderá su historial de datos OLAP.
Ejemplos
bm.exe update-all -DefinitionFile:MyDef.xml
bm.exe update-all -DefinitionFile:MyWorkbook.xls -Server:machine1
comando remove-all
Uso
bm.exe remove-all DefinitionFile:<def file> [ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| DefinitionFile:<def file> | Ruta y nombre del archivo que contiene las definiciones que se van a quitar. |
| Server:<server> | Opcional: nombre del servidor del que se quitarán las definiciones. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: nombre de la base de datos de la que se quitarán las definiciones. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Quita todos los artefactos especificados en el archivo XML de definición de BAM. El archivo puede ser un archivo de texto que contenga el XML de definición de BAM o un libro de Excel de BAM. La definición de cada artefacto debe coincidir exactamente con la definición original que se utilizó para implementación.
Ejemplos
bm.exe remove-all -DefinitionFile:MyDef.xml
bm.exe remove-all -DefinitionFile:MyWorkbook.xls -Server:machine1
Comando update-livedataworkbook
Uso
bm.exe update-livedataworkbook -Name:<livedata workbook name>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| Name:<livedata workbook> | El nombre del libro de trabajo dinámico existente que se debe actualizar. |
| Server:<server> | Opcional: el nombre del servidor en el que reside el libro. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que reside el libro. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Actualiza la información de conexión de la base de datos de importación principal de BAM del libro de trabajo de datos activos de BAM especificado.
Nota
Al configurar una nueva cadena de conexión, debe reiniciar el servicio de TDDS para asegurarse de que éste reconoce el cambio. Para obtener más información sobre el servicio TDDS, consulte Procedimientos almacenados del servicio Bam Event Bus.
Ejemplos
bm.exe update-livedataworkbook -Name:SalesManager_Live.xls
bm.exe update-livedataworkbook -Name:SalesManager_Live.xls -Server:SalesSrv
Comando regenerate-livedataworkbook
Uso
bm.exe regenerar-livedataworkbook -WorkbookName:<livedata workbook name>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| WorkbookName:<nombre del archivo del libro livedata> | Nombre del libro de trabajo que se va a actualizar. |
| Server:<server> | Opcional: el nombre del servidor en el que reside el libro. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que reside el libro. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Genera un libro de trabajo de datos activos de BAM, pero no implementa el libro de trabajo.
Ejemplos
bm.exe regenerate-livedataworkbook -WorkbookName:SalesManager_Live.xls
bm.exe regenerate-livedataworkbook -WorkbookName:SM_Live.xls -Server:S1