Comandos de base de datos

Los comandos de base de datos de la utilidad de administración de BAM le permiten trabajar con las bases de datos de BAM:

  • setup-databases: crea las bases de datos específicas de BAM.

  • migrate-sql: Migra las bases de datos de BAM desde:

    • Microsoft SQL Server 2000 a Microsoft SQL Server 2008

    • Microsoft SQL Server 2005 a Microsoft SQL Server 2008

  • enable-reference: habilita una referencia a una base de datos de importación principal distribuida de BAM.

  • get-references: obtiene una lista de referencias a las bases de datos de importación principal distribuidas de BAM.

  • disable-reference: deshabilita una referencia a una base de datos de importación principal de BAM.

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.

setup-databases (comando)

Uso

bm.exe setup-databases-ConfigFile:configuration file>[ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ]<

Parámetros

Parámetro Descripción
Archivo ConfigFile:<configuration> El archivo de configuración de BAM desde el que se va a crear la base de datos.
NSUser:<notifications service user name> Opcional: el identificador de usuario de un usuario de servicios de notificaciones con permisos para crear bases de datos.
NSUserPassword Opcional: la contraseña del usuario de servicios de notificaciones especificado.

Crea las bases de datos descritas en el archivo de configuración (importación principal de BAM, esquema de estrella de BAM, análisis de BAM y alertas) si todavía no existen. Una vez que se cree las bases de datos, el comando crea las tablas de metadatos de BAM asociadas y los procedimientos almacenados.

Los parámetros NSUser y NSUserPassword son necesarios si está configurando alertas BAM. Si no se especifica el NSUserPassword en la línea de comandos, bm.exe le pide la contraseña.

Nota

Después de completar el comando, puede tener una excepción del AlertModule en el registro de seguimiento en cuenta:

"La cuenta especificada es el propietario de la base de datos. El propietario de la base de datos tiene siempre acceso a la vista y no se puede agregar ni quitar de la vista."

Asimismo, es posible que vea una advertencia en el evento de NotificationServices#19001.

Si no se informó de ningún error durante la ejecución del comando, puede pasar estos avisos por alto con seguridad.

Importante

Si ejecuta un comando setup-database mediante un archivo de configuración de BAM que no contiene una sección de alertas y si ya ha configurado alertas BAM, bm.exe sobrescribirá la configuración de tal manera que ya no funcionarán las alertas.

Para configurar las bases de datos de BAM, deberá tener permisos de administrador en el servidor Microsoft SQL Server en que residen las bases de datos BAMPrimaryImport, BAMStarSchema y BAMArchive. Para configurar las bases de datos de servicios de notificación de SQL, deberá tener permisos de administrador y ser miembro del grupo local de administradores, así como ser miembro de otros grupos adicionales de administradores que se hayan configurado, como el grupo de administradores de BTS.

Ejemplos

bm.exe setup-databases -ConfigFile:BamConfiguration.xml  
bm.exe setup-databases -ConfigFile:cfg.xml -NSUser:domain\user1  

migrate-sql (comando)

Uso

bm.exe migrate-sql -From:sql2000 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:<server> ][ -Database:<database> ]

O bien

bm.exe migrate-sql -From:sql2005 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:<server> ][ -Database:<database> ]

Parámetros

Parámetro Descripción
From: sql2000 Especifica que está convirtiendo desde una base de datos de Microsoft SQL Server 2000.
To:sql2008 Especifica que va a convertir en una base de datos de Microsoft SQL Server 2008.
From: sql2005 Especifica que va a realizar la conversión de una base de datos de Microsoft SQL Server 2005.
To:sql2008 Especifica que va a convertir en una base de datos de Microsoft SQL Server 2008.
NSUser:<notifications service user name> Opcional: el identificador de usuario de un usuario de Notifications Services con permisos para crear bases de datos.
NSUserPassword Opcional: la contraseña del usuario de Notifications Services especificado.
Server:<server> Opcional: el nombre del servidor en el que residirá la base de datos convertida. El servidor debe estar en el mismo dominio que el equipo que hospeda la base de datos de Microsoft SQL Server 2008. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost.
Base de datos:<base de datos> Opcional: a continuación, nombre de la base de datos convertida. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport.

Migra la infraestructura de BAM de Microsoft SQL Server 2000 o Microsoft SQL Server 2005 a Microsoft SQL Server 2008. Use este comando después de actualizar el servidor de bases de datos y el servidor de análisis de Microsoft SQL Server 2000 o Microsoft SQL Server 2005 a Microsoft SQL Server 2008.

Los parámetros NSUser y NSUserPassword son necesarios si ha configurado alertas BAM. Si no se especifica el NSUserPassword en la línea de comandos, bm.exe le pide la contraseña.

Para migrar las bases de datos de servicios de notificación de SQL Server, deberá tener permisos de administrador y ser miembro del grupo local de administradores, así como ser miembro de otros grupos adicionales de administradores que se hayan configurado, como el grupo de administradores de BTS.

Nota

Si recibe el mensaje de error "ERROR: No se puede iniciar el servicio NS$BAMAlerts en el equipo "<nombre> del equipo". El servicio no respondió a tiempo a la solicitud de inicio o de control.", intente reiniciar el servicio de forma manual. Si SQL Server está muy ocupado durante una migración, es posible que no se reinicie el servicio.

Nota

Para ejecutar el comando migrate-sql en el equipo en el que se encuentran instalados los servicios de notificación, tendrá que ser miembro del grupo local de administradores de ese equipo.

Ejemplos

bm.exe migrate-sql -From:sql2000 -To:sql2008 -NSUser:domain\user1  
bm.exe migrate-sql -From:sql2000 -To:sql2008 -Server:MyServer -Database:db1  
bm.exe migrate-sql -From:sql2005 -To:sql2008 -NSUser:domain\user1  
bm.exe migrate-sql -From:sql2005 -To:sql2008 -Server:MyServer -Database:db1  

enable-reference (comando)

Uso

bm.exe enable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]

Parámetros

Parámetro Descripción
TargetServer:<target server> Nombre del servidor para el que se habilita la referencia. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe.
Base de datos TargetDatabase:<target> Nombre de la base de datos para la que se habilita la referencia.
Server:<server> Opcional: el nombre del servidor que tendrá una referencia habilitada para el servidor de destino y la base de datos. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost.
Base de datos:<base de datos> Opcional: el nombre de la base de datos que tendrá una referencia habilitada para el servidor de destino y la base de datos. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport.

Habilita una referencia a otra base de datos distribuida de importación principal de BAM. Permite suscripciones desde la base de datos actual a los metadatos de la actividad y vista en la base de datos de importación principal de BAM. Se utiliza para habilitar la exploración de las actividades distribuidas.

Puede especificar el servidor de destino como una instancia de SQL Server, por ejemplo 'mymachine2\myinstance'.

Ejemplos

bm.exe enable-reference -TargetServer:MySrv -TargetDatabase:BamPrimaryImport  
bm.exe enable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1  

get-references (comando)

Uso

bm.exe get-references [ -Server:<server> ][ -Database:<database> ]

Parámetros

Parámetro Descripción
Server:<server> Opcional: nombre del servidor en el que se va a obtener una lista de referencias. 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 en la que se va a obtener una lista de referencias. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport.

Enumera las referencias habilitadas en el equipo en el que se ejecuta el comando.

Ejemplos

bm.exe get-references  
bm.exe get-references -Server:MyServer -Database:MyPrimaryImport  

Comando disable-reference

Uso

bm.exe disable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]

Parámetros

Parámetro Descripción
TargetServer:<servidor de destino> Nombre del servidor desde el que se deshabilitan las referencias. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe.
TargetDatabase:<base de datos de destino> Nombre de la base de datos desde la que se deshabilitan las referencias.
Server:<server> Opcional: el nombre del servidor en el que se van a deshabilitar las referencias al servidor de destino y a la base de datos. 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 deshabilitar las referencias al servidor de destino y a la base de datos. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport.

Deshabilita una referencia a otra base de datos de importación principal de BAM distribuida en el servidor de destino.

Puede especificar el servidor de destino como una instancia de SQL Server, por ejemplo 'mymachine2\myinstance'.

Ejemplos

bm.exe disable-reference -TargetServer:MySrv -TargetDatabase:BamPI  
bm.exe disable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1  

Consulte también

Utilidad de administración de BAM