Guide de référence des commandes NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
nbsqladm — configurez les instances de SQL Server pour une politique de sauvegarde intelligente de SQL Server
Synopsis
[-S master_server] -list_instances [instance_name] [-host name] [-active | -inactive] [-registered | -unregistered]
[-S master_server] -add_instance instance_name -host name [-instance_group name | -local_credentials | -user name -domain name] [-force]
[-S master_server] -register_instance instance_name [-host name] [-instance_group name | -local_credentials | -user name -domain name] [-force]
[-S master_server] -delete_instance instance_name [-host name]
[-S master_server] -modify_instance instance_name -host name [-instance_group name | -local_credentials | -user name -domain name] [-active | -inactive] [-force]
[-S master_server] -remove_from_instance_group instance_name [-instance_group name] [-host name]
[-S master_server] -initiate_availability_group_browse instance_name -host name
[-S master_server] -initiate_discovery
[-S master_server] -list_instance_groups [instance_group_name]
[-S master_server] -add_instance_group instance_group_name [-local_credentials | -user name -domain name]
[-S master_server] -delete_instance_group name
[-S master_server] -modify_instance_group name [-new_instance_group name] [[-local_credentials | -user name -domain name] [-validate]]
[-S master_server] -list_availability_groups [-ag_name name] [-cluster cluster_name] [-ag_id availability_group_ID]
[-S master_server] -add_availability_group -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} [-instance instance_name -host name]
[-S master_server] -delete_availability_group -ag_name name {-cluster cluster_name | -ag_id availability_group_ID}
[-S master_server] -list_replicas -ag_name name {-cluster cluster_name | -ag_id availability_group_ID}
[-S master_server] -add_replica -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} -instance instance_name -host name [-force]
[-S master_server] -delete_replica -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} -instance instance_name -host name
[-S master_server] -list_dbas
[-S master_server] -add_dba host_nameuser_name
[-S master_server] -delete_dba host_nameuser_name
[-S master_server] -auto_registration instance_group_name
[-S master_server] -disable_auto_registration
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/
On Windows systems, the directory path to this command is install_path\NetBackup\bin\
DESCRIPTION
La commande nbsqladm configure des instances SQL Server, des groupes d'instances et de disponibilité pour les utiliser avec une politique intelligente de SQL Server. Les groupes de disponibilité pris en charge incluent les groupes de base, avancés et avec échelle lecture. Vous pouvez également utiliser cette commande sur le serveur maître pour autoriser des administrateurs de base de données à utiliser nbsqladm sur un hôte spécifique.
Vous pouvez désactiver ou activer la commande nbsqladm avec l'option ENABLE_NBSQLADM dans le fichier bp.conf
ou dans le registre. Cette commande est activée par défaut. Pour désactiver la commande, utilisez ENABLE_NBSQLADM=0.
OPTIONS
- -add_availability_group -ag_name nom {-cluster nom_cluster | -ag_id ID_groupe_disponibilité} -instance nom_instance -host nom
Ajoutez un groupe de disponibilité au catalogue NetBackup. Vous pouvez ajouter uniquement le groupe de disponibilité et ajouter les instances ultérieurement. De cette façon, vous pouvez établir la topologie du groupe de disponibilité plus rapidement. Les groupes de disponibilité de base et avancés fournissent -cluster cluster_name, le nom du cluster WSFC (Windows Server Failover Clustering). Pour les groupes de disponibilité avec échelle lecture, fournissez -ag_id availability_group_ID.
Pour ajouter la topologie complète de l'AG, comprenant les instances, utilisez l'option -instance instance_name -host name.
- -add_dba nom_hôte nom_utilisateur
Autorise l'administrateur de base de données spécifié (user_name) à utiliser la commande nbsqladm sur un hôte spécifique (host_name). Peut être utilisée sur le serveur maître uniquement.
Si vous disposez de plusieurs cartes réseau, fournissez le nom d'interface privé de l'hôte SQL Server.
Pour un cluster SQL Server, autorisez le DBA sur chaque nœud du cluster. (N'autorisez pas de DBA à l'aide du nom virtuel du cluster SQL Server.) Pour -host name, fournissez l'un des noms de nœud dans le cluster SQL Server.
Pour un cluster SQL Server avec plusieurs cartes réseau, autorisez le DBA à l'aide du nom d'interface privé de chaque nœud du cluster SQL Server.
- -add_instance nom_instance -host nom [-instance_group name | -local_credentials | -user name -domain name] [-force]
Ajouter une instance au catalogue NetBackup. Pour ajouter une instance de groupe de disponibilité, utilisez l'option -add_replica.
- -add_instance_group nom_groupe_instances [-local_credentials | -user name -domain name]
Ajoute un groupe d'instances au catalogue NetBackup. Vous pouvez ajouter les informations d'authentification au groupe d'instances avec l'option -local_credentials ou -user name -domain name.
- -auto_registration nom_groupe_instances
Active l'enregistrement automatique pour le groupe d'instances spécifié. Les instances récemment découvertes sont automatiquement enregistrées avec les informations d'authentification de groupe et ajoutées au groupe d'instances spécifié. Si vous voulez que des instances précédemment découvertes soient incluses dans le groupe d'instances, vous devez ajouter ces instances manuellement. L'enregistrement automatique peut être activé pour un seul groupe d'instances.
- -add_replica -ag_name nom {-cluster nom_cluster | -ag_id ID_groupe_disponibilité} -instance nom_instance -host nom [-force]
Ajoutez une réplique d'un groupe de disponibilité au catalogue NetBackup. Utilisez cette option après avoir ajouté l'instance du groupe de disponibilité. Les groupes de disponibilité de base et avancés fournissent -cluster cluster_name, le nom du cluster WSFC (Windows Server Failover Clustering). Pour les groupes de disponibilité avec échelle lecture, fournissez -ag_id availability_group_ID.
- -delete_dba nom_hôte nom_utilisateur
Supprime l'autorisation d'utiliser la commande nbsqladm pour l'hôte spécifié (host_name) et l'administrateur de base de données (user_name). Peut être utilisée sur le serveur maître uniquement.
Si vous disposez de plusieurs cartes réseau, fournissez le nom d'interface privé de l'hôte SQL Server.
Pour un cluster SQL Server, supprimez l'autorisation du DBA sur chaque nœud du cluster. (Vous ne pouvez pas supprimer l'autorisation d'un DBA à l'aide du nom virtuel du cluster SQL Server.) Pour -host_name, fournissez l'un des noms de nœud dans le cluster SQL Server.
Pour un cluster SQL Server avec plusieurs cartes réseau, supprimez l'autorisation à l'aide du nom d'interface privé de chaque nœud du cluster SQL Server.
- -delete_availability_group -ag_name nom {-cluster nom_cluster | -ag_id ID_groupe_disponibilité}
Supprimez un groupe de disponibilité du catalogue NetBackup. Les groupes de disponibilité de base et avancés fournissent -cluster cluster_name, le nom du cluster WSFC (Windows Server Failover Clustering). Pour les groupes de disponibilité avec échelle lecture, fournissez -ag_id availability_group_ID.
- -delete_instance nom_instance [-host nom]
Supprimez une instance du catalogue NetBackup.
- -delete_instance_group nom
Supprimez un groupe d'instances.
- -delete_replica -ag_name nom {-cluster nom_cluster | -ag_id ID_groupe_disponibilité}
Supprimez une réplique d'un groupe de disponibilité du catalogue NetBackup. Les groupes de disponibilité de base et avancés fournissent -cluster cluster_name, le nom du cluster WSFC (Windows Server Failover Clustering). Pour les groupes de disponibilité avec échelle lecture, fournissez -ag_id availability_group_ID.
- -disable_auto_registration
Désactive l'enregistrement automatique de sorte que les instances récemment découvertes ne soient pas automatiquement enregistrées ni ajoutées à un groupe d'instances.
- -force
Force NetBackup à enregistrer l'instance ou l'instance de réplique et à ignorer la validation des informations d'authentification de l'instance. NetBackup pour SQL Server ne peut pas protéger les instances qui ne sont pas enregistrées ou qui ont des informations d'authentification non valides.
- -host name
Spécifie le nom de l'hôte où la base de données SQL Server réside.
Si vous disposez de plusieurs cartes réseau, fournissez le nom d'interface privé de l'hôte SQL Server. Pour un cluster SQL Server, pour le nom d'hôte, fournissez le nom virtuel du cluster SQL Server. Pour un cluster SQL Server avec plusieurs cartes réseau, fournissez le nom virtuel privé du cluster SQL Server.
- -instance nom_instance
Spécifie le nom de l'instance SQL Server.
- -instance_group nom
Spécifie le nom du groupe d'instance auquel vous voulez ajouter ou supprimer une instance.
Ou indique le groupe d'instances que vous voulez utiliser pour enregistrer une instance. Vous pouvez également enregistrer une instance avec les informations d'authentification de groupe d'instances ou les informations d'authentification spécifiques. Consultez également les options -local_credentials et -user name -domain name.
Les informations d'authentification doivent posséder certains privilèges de sécurité. Consultez le Guide de l'administrateur NetBackup for SQL Server.
- -initiate_availability_group_browse nom_instance -host nom
Lance la découverte d'un groupe de disponibilité avec échelle lecture. Tous les groupes de disponibilité associés à instance_name et l'hôte sont découverts.
- -initiate_discovery
Lancez le processus de découverte pour découvrir toutes les instances SQL Server qui ont été ajoutées à votre environnement depuis la dernière découverte.
- -list_availability_groups [-ag_name nom] [-cluster nom_cluster] [-ag_id ID_groupe_disponibilité]
Répertoriez les groupes de disponibilité SQL Server dans le catalogue NetBackup. Pour afficher un groupe de disponibilité avec un nom spécifique, utilisez -ag_name name. Pour répertorier un groupe de disponibilité de base ou avancé qui fait partie d'un cluster WSFC (Windows Server Failover Clustering), utilisez -cluster cluster_name. Pour répertorier les groupes de disponibilité avec échelle lecture, utilisez -ag_id availability_group_ID.
- -list_dbas
Affiche une liste de tous les administrateurs de base de données capables d'utiliser la commande nbsqladm. Peut être utilisée sur le serveur maître uniquement.
- -list_instances [nom_instance] [-host nom] [-active | -inactive] [-registered | -unregistered]
Répertorie toutes les instances SQL Server dans le catalogue NetBackup.
Utilisez instance_name ou -host name pour répertorier une instance spécifique. Utilisez -registered ou -unregistered pour répertorier les instances SQL Server enregistrées ou non enregistrées. Les options -active et -inactive permettent d'afficher les instances qui sont en activité pour NetBackup (disponible pour la sauvegarde) et les instances inactives.
- -list_instance_groups [nom_groupe_instances]
Répertoriez les groupes d'instances de SQL Server existants. Utilisez instance_group_name pour répertorier un groupe d'instances spécifique.
- -list_replicas -ag_name name {-cluster nom_cluster | -ag_id availability_group_ID}
Répertorie toutes les répliques de groupe de disponibilité dans le catalogue NetBackup. L'option -ag_name name indique le groupe de disponibilité. Pour répertorier les répliques d'un groupe de disponibilité de base ou avancé qui fait partie d'un cluster WSFC (Windows Server Failover Clustering), utilisez -cluster cluster_name. Pour les groupes de disponibilité avec échelle lecture, utilisez -ag_id availability_group_ID.
- -local_credentials
Indique que vous voulez enregistrer une instance avec les informations d'authentification qui ont été utilisées pour installer NetBackup. Vous pouvez également enregistrer une instance avec les informations d'authentification de groupe d'instances ou les informations d'authentification spécifiques. Consultez les options -instance_group name et -user name -domain name.
Les informations d'authentification doivent posséder certains privilèges de sécurité. Consultez le Guide de l'administrateur NetBackup for SQL Server.
Si elle est utilisée avec l'option -validate pour modifier un groupe d'instances, vous pouvez également valider les informations d'authentification pour chaque instance du groupe.
- -modify_instance nom_instance -host nom [-instance_group nom | -local_credentials | -user nom -domain nom] [-active | -inactive] [-force]
Modifie les attributs de l'instance spécifiée.
Utilisez -active pour rendre une instance que vous avez désactivée dans NetBackup disponible pour la sauvegarde. Vous pouvez également rendre une instance inactive dans NetBackup avec la commande -inactive. Par exemple, si l'instance est sous maintenance.
Les options de commande -new_instance et -new_host sont obsolètes. Pour modifier une instance ou un nom d'hôte, supprimez l'instance et utilisez l'option -add_instance pour la rajouter.
- -modify_instance_group [-new_instance_group nom] [[-local_credentials | -user nom -domain nom] [-validate]]
Modifiez les attributs du groupe d'instances spécifié.
-new_instance_group name modifie le nom du groupe d'instances. Utilisez -local_credentials ou -user name -domain name pour ajouter ou modifier les informations d'authentification pour le groupe d'instances. L'option -validate valide les informations d'authentification du groupe pour chaque instance du groupe. Cette option est utilisée avec -local_credentials ou -user name -domain name.
- -register_instance nom_instance [-instance_group nom | -local_credentials | -user nom -domain nom] [-force]
Informations d'authentification de registre pour une instance. Consultez la description pour -instance_group name, -local_credentials et -user name -domain name.
Pour un cluster SQL Server ou plusieurs cartes réseau, avant d'enregistrer une instance, assurez-vous que cette dernière comporte bien le nom d'hôte correct. Si vous disposez de plusieurs cartes réseau, le nom d'hôte est le nom d'interface privé de l'hôte SQL Server. Un cluster SQL Server ne nécessite qu'une seule entrée dans la gestion d'instance. Pour un cluster SQL Server avec plusieurs cartes réseau, le nom d'hôte est le nom virtuel privé du cluster SQL Server.
- -remove_from_instance_group nom_instance [-instance_group nom] [-host nom]
Supprime une instance d'un groupe d'instances.
- -S serveur_maître
Spécifie le serveur maître pour l'instance ou le groupe d'instances que vous voulez ajouter, modifier ou supprimer. Vous pouvez également l'utiliser pour indiquer le serveur maître sur lequel vous voulez effectuer une commande spécifique.
- -user nom -domain nom
Indique que vous voulez enregistrer une instance avec les informations d'authentification spécifiques que vous fournissez. Vous pouvez également enregistrer une instance avec les informations d'authentification de groupe d'instances ou les informations d'authentification locales. Consultez les options -instance_group name et -local_credentials.
Les informations d'authentification doivent posséder certains privilèges de sécurité. Consultez le Guide de l'administrateur NetBackup for SQL Server.
Si elle est utilisée avec l'option -validate pour modifier un groupe d'instances, vous pouvez également valider les informations d'authentification pour chaque instance du groupe.
EXEMPLES
Exemple 1 - Ajout d'informations d'authentification locales au groupe d'instances marketing sans valider les informations d'authentification.
nbsqladm -modify_instance_group marketing -local_credentials
Exemple 2 - Ajout d'informations d'authentification pour l'utilisateur adminuser dans le domaine corp au groupe d'instances marketing. Valide également les informations d'authentification de chaque instance du groupe.
nbsqladm -modify_instance_group marketing -user adminuser -domain corp -validate