Commandes de base de données
Les commandes de la base de données de l'utilitaire de gestion de l'analyse BAM vous permettent d'utiliser les bases de données BAM :
setup-databases : crée les bases de données spécifiques à BAM.
migrate-sql : migre vos bases de données BAM à partir de :
Microsoft SQL Server 2000 vers Microsoft SQL Server 2008
Microsoft SQL Server 2005 à Microsoft SQL Server 2008
enable-reference : active une référence à une base de données d’importation primaire BAM distribuée.
get-references : obtient une liste de références aux bases de données d’importation primaire BAM distribuées.
disable-reference : désactive une référence à une base de données d’importation principale BAM.
Notes
Vous pouvez activer le suivi sur n’importe quelle commande de l’utilitaire BM en incluant le commutateur de paramètre -Trace :on|off . L'utilisation du commutateur de suivi remplace les paramètres de suivi du fichier de configuration. Le commutateur peut être utilisé conjointement avec toute commande BAM classique.
Notes
Sur les systèmes qui prennent en charge le contrôle de compte d'utilisateur, vous devrez peut-être exécuter l'outil avec des privilèges d'administrateur.
Commande setup-databases
Utilisation
bm.exe setup-databases-ConfigFile :configuration file>[ -NSUser :<notifications service user name> ][ -NSUserPassword :<notifications service user password> ]<
Paramètres
| Paramètre | Description |
|---|---|
| ConfigFile :<fichier de configuration> | Fichier de configuration BAM à partir duquel créer la base de données. |
| NSUser :<notifications service user name> | Facultatif : ID utilisateur d’un utilisateur des services de notifications disposant des autorisations nécessaires pour créer des bases de données. |
| NSUserPassword | Facultatif : mot de passe de l’utilisateur des services de notifications spécifié. |
Crée les bases de données décrites dans le fichier de configuration (Importation principale BAM, Schémas en étoile BAM, Archives de l'analyse BAM, Analyse BAM et alertes) si elles n'existent pas déjà. Une fois les bases de données créées, la commande génère les procédures stockées et les tables de métadonnées BAM associées.
Les paramètres NSUser et NSUserPassword sont obligatoires si vous configurez des alertes BAM. Si NSUserPassword n'est pas spécifié sur la ligne de commande, bm.exe vous invite à entrer le mot de passe.
Notes
À l'issue de l'exécution de la commande, il est possible qu'une exception en provenance d'AlertModule figure dans le journal de suivi :
« Le compte spécifié correspond au propriétaire de la base de données. Celui-ci peut toujours accéder à la vue, il ne peut être ajouté à la vue ou supprimé de celle-ci. »
En outre, vous pouvez voir un avertissement dans l'événement provenant de NotificationServices#19001.
Si aucune erreur n'a été signalée lors de l'exécution de la commande, vous pouvez ignorer ces avertissements.
Important
Si vous exécutez une commande setup-database, avec un fichier de configuration BAM ne contenant pas de section d'alertes, et que vous avez déjà configuré des alertes BAM, bm.exe écrasera la configuration de sorte que les alertes ne fonctionneront plus.
Pour configurer les bases de données BAM, vous devez disposer des autorisations d'administrateur sur le serveur Microsoft SQL hébergeant les bases de données BAMPrimaryImport, BAMStarSchema et BAMArchive. Pour configurer les bases de données des services de notification SQL, vous devez disposer des autorisations d'administrateur et être membre du groupe des administrateurs locaux et de tout autre groupe d'administration ayant été configuré, par exemple le groupe des administrateurs BTS.
Exemples
bm.exe setup-databases -ConfigFile:BamConfiguration.xml
bm.exe setup-databases -ConfigFile:cfg.xml -NSUser:domain\user1
Commande migrate-sql
Utilisation
bm.exe migrate-sql -From :sql2000 -To :sql2008 [ -NSUser :<notifications service user name> ][ -NSUserPassword :<notifications service user password> ][ -Server :<server> ][ -Database :<database> ]
- Ou -
bm.exe migrate-sql -From :sql2005 -To :sql2008 [ -NSUser :<notifications service user name> ][ -NSUserPassword :<notifications service user password> ][ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| À partir de : sql2000 | Spécifie que vous convertissez des données d'une base de données Microsoft SQL Server 2000. |
| To:sql2008 | Spécifie que vous effectuez une conversion en base de données Microsoft SQL Server 2008. |
| À partir de : sql2005 | Spécifie que vous effectuez une conversion à partir d’une base de données Microsoft SQL Server 2005. |
| To:sql2008 | Spécifie que vous effectuez une conversion en base de données Microsoft SQL Server 2008. |
| NSUser :<notifications service user name> | Facultatif : ID utilisateur d’un utilisateur notifications Services disposant des autorisations nécessaires pour créer des bases de données. |
| NSUserPassword | Facultatif : mot de passe de l’utilisateur Notifications Services spécifié. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside la base de données convertie. Le serveur doit se trouver dans le même domaine que l’ordinateur hébergeant la base de données Microsoft SQL Server 2008. Si le nom du serveur n'est pas spécifié, bm.exe utilise le nom par défaut de l'hôte local. |
| Base de données :<base de données> | Facultatif : nom de la base de données convertie. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Migre l’infrastructure BAM de Microsoft SQL Server 2000 ou Microsoft SQL Server 2005 vers Microsoft SQL Server 2008. Utilisez cette commande après avoir mis à niveau votre serveur de base de données et votre serveur d’analyse de Microsoft SQL Server 2000 ou Microsoft SQL Server 2005 vers Microsoft SQL Server 2008.
Les paramètres NSUser et NSUserPassword sont requis si les alertes BAM sont configurées. Si NSUserPassword n'est pas spécifié sur la ligne de commande, bm.exe vous invite à entrer le mot de passe.
Pour faire migrer les bases de données des services de notification SQL Server, vous devez disposer des autorisations d'administrateur et être membre du groupe des administrateurs locaux et de tout autre groupe d'administration ayant été configuré, par exemple le groupe des administrateurs BTS.
Notes
Si vous recevez le message d’erreur « ERREUR : Impossible de démarrer le service NS$BAMAlerts sur le nom> de l’ordinateur ».< car le service n'a pas répondu à la demande de démarrage ou de contrôle en temps voulu s'affiche, essayez de redémarrer le service manuellement. Si le serveur SQL est très occupé pendant la migration, le service risque de ne pas redémarrer.
Notes
Pour exécuter la commande migrate-sql sur l'ordinateur sur lequel est installé Notification Services, vous devez être membre du groupe des administrateurs locaux de cet ordinateur.
Exemples
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
Commande enable-reference
Utilisation
bm.exe enable-reference -TargetServer :<target server> -TargetDatabase :<target database>[ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| TargetServer :<target server> | Nom du serveur sur lequel la référence est activée. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. |
| TargetDatabase :<target database> | Nom de la base de données sur laquelle la référence est activée. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel une référence est activée pour le serveur et la base de données cibles. Si le nom du serveur n'est pas spécifié, bm.exe utilise le nom par défaut de l'hôte local. |
| Base de données :<base de données> | Facultatif : nom de la base de données sur laquelle une référence est activée pour le serveur et la base de données cibles. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Active une référence vers une autre base de données d'importation principale BAM distribuée. Ceci autorise les abonnements de la base de données actuelle vers les métadonnées de vue et d'activité sur la base de données d'importation principale BAM cible. Utilisez cette fonctionnalité pour permettre la navigation entre les activités distribuées.
Vous pouvez spécifier le serveur cible en tant qu'instance du serveur SQL Server, par exemple 'mamachine2\moninstance'.
Exemples
bm.exe enable-reference -TargetServer:MySrv -TargetDatabase:BamPrimaryImport
bm.exe enable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1
Commande get-references
Utilisation
bm.exe get-references [ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel obtenir une liste de références. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. Si le nom du serveur n'est pas spécifié, bm.exe utilise le nom par défaut de l'hôte local. |
| Base de données :<base de données> | Facultatif : nom de la base de données sur laquelle obtenir une liste de références. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Répertorie les références activées sur l'ordinateur sur lequel la commande est exécutée.
Exemples
bm.exe get-references
bm.exe get-references -Server:MyServer -Database:MyPrimaryImport
Commande disable-reference
Utilisation
bm.exe disable-reference -TargetServer :<target server> -TargetDatabase :<target database>[ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| TargetServer :<target server> | Nom du serveur sur lequel désactiver les références. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. |
| TargetDatabase :<target database> | Nom de la base de données sur laquelle désactiver les références. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel les références au serveur et à la base de données cibles doivent être désactivées. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. Si le nom du serveur n'est pas spécifié, bm.exe utilise le nom par défaut de l'hôte local. |
| Base de données :<base de données> | Facultatif : nom de la base de données sur laquelle les références au serveur et à la base de données cibles doivent être désactivées. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Désactive une référence vers une autre base de données d'importation principale BAM distribuée sur le serveur cible.
Vous pouvez spécifier le serveur cible en tant qu'instance du serveur SQL Server, par exemple 'mamachine2\moninstance'.
Exemples
bm.exe disable-reference -TargetServer:MySrv -TargetDatabase:BamPI
bm.exe disable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1