Comandi di database
I comandi di database dell'utilità di gestione BAM consentono di lavorare con i database BAM:
setup-database: crea i database specifici di BAM.
migrate-sql: esegue la migrazione dei database BAM da:
Microsoft SQL Server 2000 a Microsoft SQL Server 2008
Microsoft SQL Server 2005 a Microsoft SQL Server 2008
enable-reference: abilita un riferimento a un database di importazione primaria BAM distribuito.
get-references: ottiene un elenco di riferimenti ai database di importazione primaria BAM distribuiti.
disable-reference: disabilita un riferimento a un database di importazione primaria BAM.
Nota
È possibile abilitare la traccia in qualsiasi comando di utilità BM includendo l'opzione -Trace:on|off . Tramite l'opzione Trace viene eseguito l'override delle impostazioni di traccia nel file di configurazione. Questa opzione può essere utilizzata in combinazione con qualsiasi comando BM comune.
Nota
In un sistema che supporta il controllo dell'account utente, potrebbe essere necessario eseguire lo strumento con i privilegi amministrativi.
Utilizzo
bm.exe setup-databases-ConfigFile:configuration file>[ -NSUser:notifications service user name> ][ -NSUserPassword<:<<notifications service user password> ]
Parametri
Parametro | Descrizione |
---|---|
File configFile:<configuration> | File di configurazione BAM da cui creare il database. |
Nome utente del servizio NSUser:<notifications> | Facoltativo: ID utente di un utente del servizio notifiche con autorizzazioni per creare database. |
NSUserPassword | Facoltativo: password per l'utente dei servizi di notifica specificati. |
Consente di creare i database descritti nel file di configurazione (importazione primaria BAM, schema a stella BAM, archiviazione BAM, analisi BAM e avvisi), se non esistono già. Dopo che i database sono stati creati, vengono create le tabelle di metadati BAM e le stored procedure ad essi associate.
I parametri NSUser e NSUserPassword sono obbligatori se si impostano gli avvisi BAM. Se nella riga di comando si omette NSUserPassword, bm.exe richiede di specificare la password.
Nota
Al termine del comando, si può notare un'eccezione generata da AlertModule nel registro analisi:
"L'account specificato è il proprietario del database. Il proprietario del database può accedere sempre alla visualizzazione e non può essere aggiunto o rimosso dalla visualizzazione."
È inoltre possibile notare un avviso nell'evento di NotificationServices numero 19001.
Se durante l'esecuzione del comando non sono stati segnalati errori, è possibile ignorare questi avvisi.
Importante
Se si esegue un comando setup-database utilizzando un file di configurazione BAM che non contiene una sezione per gli avvisi e sono già stati configurati gli avvisi BAM, bm.exe sovrascriverà la configurazione e gli avvisi non funzioneranno più.
Per impostare i database BAM è necessario disporre delle autorizzazioni di amministratore nel computer Microsoft SQL Server che ospita i database BAMPrimaryImport, BAMStarSchema e BAMArchive. Per impostare i database di SQL Notification Services, è necessario disporre delle autorizzazioni di amministratore ed essere membro del gruppo degli amministratori locali, nonché di uno degli altri gruppi amministrativi che sono stati configurati, ad esempio il gruppo degli amministratori BTS.
esempi
bm.exe setup-databases -ConfigFile:BamConfiguration.xml
bm.exe setup-databases -ConfigFile:cfg.xml -NSUser:domain\user1
Utilizzo
bm.exe migrate-sql -From:sql2000 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword<:notifications service user password> ][ -Server:<server> ][ -Database:database<> ]
oppure
bm.exe migrate-sql -From:sql2005 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword<:notifications service user password> ][ -Server:server> ][ -Database:<database<> ]
Parametri
Parametro | Descrizione |
---|---|
Da: sql2000 | Consente di specificare che si desidera effettuare la conversione da un database di Microsoft SQL Server 2000. |
To:sql2008 | Specifica che si sta convertendo in un database di Microsoft SQL Server 2008. |
Da: sql2005 | Specifica che si sta convertendo da un database di Microsoft SQL Server 2005. |
To:sql2008 | Specifica che si sta convertendo in un database di Microsoft SQL Server 2008. |
Nome utente del servizio NSUser:<notifications> | Facoltativo: ID utente di un utente di Servizi notifiche con autorizzazioni per creare database. |
NSUserPassword | Facoltativo: password per l'utente di Servizi notifiche specificato. |
Server:<server> | Facoltativo: nome del server in cui risiederà il database convertito. Il server deve trovarsi nello stesso dominio del computer che ospita il database di Microsoft SQL Server 2008. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
Database:<database> | Facoltativo: quindi nome del database convertito. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Esegue la migrazione dell'infrastruttura BAM da Microsoft SQL Server 2000 o Microsoft SQL Server 2005 a Microsoft SQL Server 2008. Usare questo comando dopo aver aggiornato il server di database e il server di analisi da Microsoft SQL Server 2000 o Microsoft SQL Server 2005 a Microsoft SQL Server 2008.
I parametri NSUser e NSUserPassword sono obbligatori se sono configurati gli avvisi BAM. Se nella riga di comando si omette NSUserPassword, bm.exe richiede di specificare la password.
Per migrare i database di SQL Server Notification Services, è necessario disporre delle autorizzazioni di amministratore ed essere membro del gruppo di amministratori locali, nonché di uno degli altri gruppi amministrativi che sono stati configurati, ad esempio il gruppo di amministratori BTS.
Nota
Se viene visualizzato il messaggio di errore "ERROR: Impossibile avviare il servizio NS$BAMAlerts nel computer '<nome> computer'. Il servizio non ha risposto in tempo utile alla richiesta di avvio o di controllo.", provare a riavviare manualmente il servizio. Se SQL Server è estremamente occupato durante una migrazione, è possibile che il servizio non venga riavviato.
Nota
Per eseguire il comando migrate-sql sul computer in cui è installato Notification Services, è necessario appartenere al gruppo di di amministratori locali di tale computer.
esempi
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
Utilizzo
bm.exe enable-reference -TargetServer:target server -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database<> ]>
Parametri
Parametro | Descrizione |
---|---|
TargetServer:<target server> | Nome del server per cui è attivato il riferimento. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. |
TargetDatabase:<database di destinazione> | Nome del database per cui è attivato il riferimento. |
Server:<server> | Facoltativo: nome del server che avrà un riferimento abilitato per il server di destinazione e il database. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
Database:<database> | Facoltativo: nome del database che avrà un riferimento abilitato per il server di destinazione e il database. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Attiva un riferimento a un altro database di importazione primaria BAM distribuito. Ciò consente di sottoscrivere dal database corrente i metadati delle visualizzazioni e delle attività del database di importazione primaria BAM. Viene utilizzato per consentire di spostarsi tra le attività distribuite.
È possibile specificare il server di destinazione come istanza di SQL Server, ad esempio 'mymachine2\myinstance'.
esempi
bm.exe enable-reference -TargetServer:MySrv -TargetDatabase:BamPrimaryImport
bm.exe enable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1
Utilizzo
bm.exe get-references [ -Server:<server> ][ -Database:<database> ]
Parametri
Parametro | Descrizione |
---|---|
Server:<server> | Facoltativo: nome del server in cui ottenere un elenco di riferimenti. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
Database:<database> | Facoltativo: nome del database in cui ottenere un elenco di riferimenti. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di visualizzare un elenco dei riferimenti attivati nel computer in cui viene eseguito il comando.
esempi
bm.exe get-references
bm.exe get-references -Server:MyServer -Database:MyPrimaryImport
Utilizzo
bm.exe disable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]
Parametri
Parametro | Descrizione |
---|---|
TargetServer:<server di destinazione> | Nome del server in cui disattivare i riferimenti. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. |
TargetDatabase:<database di destinazione> | Nome del database in cui disattivare i riferimenti. |
Server:<server> | Facoltativo: nome del server in cui devono essere disabilitati i riferimenti al server di destinazione e al database. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
Database:<database> | Facoltativo: nome del database in cui devono essere disabilitati i riferimenti al server di destinazione e al database. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di disattivare un riferimento a un altro database di importazione primaria BAM distribuito nel server di destinazione.
È possibile specificare il server di destinazione come istanza di SQL Server, ad esempio 'mymachine2\myinstance'.
esempi
bm.exe disable-reference -TargetServer:MySrv -TargetDatabase:BamPI
bm.exe disable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1