NetWorker : Utilisation de l’utilitaire de ligne de commande nsradmin pour gérer les ressources NetWorker

Summary: nsradmin est un utilitaire de ligne de commande fourni par le logiciel NetWorker. nsradmin permet de modifier la base de données de ressources (nsrdb) et la base de données client/de sécurité (nsrladb) du serveur NetWorker. Cet article de la base de connaissances fournit une vue d’ensemble des fonctionnalités et des cas d’utilisation de nsradmin. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Présentation

Les ressources NetWorker se trouvent dans deux dossiers principaux :
    /nsr/res/nsrdb/ : uniquement disponible sur les serveurs NetWorker. Il s’agit de la base de données de ressources du serveur NetWorker.
    /nsr/res/nsrladb/ : disponible sur tous les systèmes NetWorker. Contient des configurations de sécurité (certificat homologue, etc.).

Remarque : Sur les systèmes d’exploitation Windows, le chemin par défaut pour nsrdb et nsrladb est «C:\Program Files\EMC NetWorker\nsr\res. »

nsradmin Permet de modifier, de créer ou de supprimer des ressources des bases de données nsrdb et nsrladb. Afin de garantir la sécurité et d’éviter toute altération indésirable, vous devez utiliser une invite de commande root ou administrateur. Si l’utilisateur système n’est pas autorisé à utiliser root ou l’invite de commande Admin, le message nsrlogin peut être utilisée. nsrlogin s’authentifie à l’aide de comptes configurés (locaux ou externes) dans le service d’authentification NetWorker. nsrlogin Émet un jeton basé sur le temps qui permet à l’utilisateur (s’il y est autorisé) d’apporter des modifications via nsradmin et utilisez d’autres commandes NetWorker avec élévation de privilèges :

  • Compte d’utilisateur local : nsrlogin -u username
  • Authentification externe (AD/LDAP) : nsrlogin -t tenant_name -d domain_name -u user_name
  • Déconnexion : nsrlogout

Accès nsradmin

Pour répertorier tous les attributs d’une ressource NetWorker spécifique, comme un client.

Vous pouvez utiliser l’outil en ligne ou hors ligne, mais si vous modifiez nsrdb ou nsrladb offline, vous devez redémarrer le service NetWorker pour les appliquer.

En ligne :  nsradmin interagit avec les processus NetWorker s’exécutant sur un serveur en ligne afin d’afficher ou de modifier les attributs des ressources.
nsradmin
En ligne (nsrladb) : Par défaut, si aucune balise supplémentaire n’est spécifiée, nsradmin Tente d’ouvrir une connexion à la base de données NSRDB. Pour accéder à nsrladb, vous devez spécifier le processus client (nsrexec).
nsradmin -p nsrexecd
Hors ligne :  nsradmin pointe vers la base de données de ressources pertinente afin d’afficher ou de modifier les attributs de la ressource.
nsradmin -d /path_to/nsrdb
Distant : Vous devez utiliser la commande -s Basculer sur Exécuter nsradmin sur un système NetWorker distant pour se connecter à nsradmin sur un autre système NetWorker sur le réseau. 
nsradmin -s remote_networker_system [-p nsrexecd]

Fichier d’entrée : Prend les commandes d’entrée à partir d’un fichier plutôt qu’à partir de l’entrée standard. Dans ce mode, l’invite interactive n’est pas imprimée.

nsradmin -i file
D’autres fonctions et opérations sont détaillées dans le nsradmin du NetWorker Command Reference Guide, disponible via : https://www.dell.com/support/product-details/product/networker/docs

Consignation

Les modifications apportées à nsrdb qui sont effectuées via nsradmin sont connectés au NetWorker Server /nsr/logs/rap.log (par défaut : C:\Program Files\EMC NetWorker\nsr\logs\rap.log sur les systèmes d’exploitation Windows)
 

L’utilisation de la commande nsradmin

nsradmin modes

nsradmin Peut être utilisé dans deux modes :

  • Mode commande (par défaut) et mode visuel ; Le mode commande est la méthode la plus couramment utilisée pour afficher et exploiter nsradmin. Aucune option supplémentaire n’est requise pour utiliser ce mode.
  • Le mode visuel fournit une interface de ligne de commande plein écran qui peut être utilisée pour afficher et gérer les ressources NetWorker. Cette méthode peut être utile lorsque des ressources ou des attributs spécifiques : les valeurs ne sont pas connues ; Cependant, il est limité dans les opérations de traitement par lots. Pour passer en mode visuel, saisissez visual à l' nsradmin prompt:
[root@nsr ~]# nsradmin
NetWorker administration program.
Use the "help" command for help, "visual" for full-screen mode.
nsradmin> visual
Remarque : Cet article de la base de connaissances fournit uniquement des instructions pour le mode commande.

 

Types de ressources NetWorker

Pour obtenir la liste des types de ressources connus. Entrée type à l' nsradmin prompt. Exemple tiré d’un serveur NetWorker :

nsradmin> type
                 Known types: NSR, NSR auditlog, NSR client, NSR client fix,
                              NSR cloneconfig, NSR Data Domain, NSR device,
                              NSR directive, NSR hypervisor, NSR label,
                              NSR license, NSR lockbox,
                              NSR NAS discovery task, NSR notification,
                              NSR policy, NSR pool, NSR Protection Group,
                              NSR Protection Policy, NSR recover, NSR Rule,
                              NSR savesets count, NSR SCG, NSR schedule,
                              NSR service, NSR stage, NSR Storage Node,
                              NSR task, NSR usergroup, NSR VMware proxy,
                              NSR vproxy log aggregate;

Opérations au sein de nsradmin sont les suivants :

         bind [query]
         create attrlist
         delete [query]
           edit [query]
           help [command]
          print [query] (set current query)
         server [name]
           show [attrlist]
          types
         update attrlist
         append attrlist
           quit
         visual [query]
         option [list]
          unset [list]
              . [query]
              ? [command]
           exit

Where:
        query ::= attrlist
        attrlist ::= attribute [; attribute]*
        attribute ::= name [: [value [, value]* ]

Interrogation des ressources NetWorker

Pour interroger une ressource NetWorker, saisissez la commande suivante à l’adresse nsradmin prompt:
nsradmin> print type:NetWorker_resource; attribute:value 
Tous les attributs de la ressource sont identifiés par la combinaison attribute : value renvoyée.
Par exemple, pour interroger tous les attributs d’une ressource Client NetWorker nommée Pluto, saisissez la commande suivante :
nsradmin> print type: NSR client; name: win-srvr01.amer.lan

Liste et filtrage nsradmin résultats

Pour répertorier des attributs spécifiques pour toutes les ressources client, saisissez la commande suivante à la page nsradmin prompt:
nsradmin> . type: NSR client; name: client_name 
nsradmin> show 
nsradmin> print

Pour répertorier tous les clients d’un groupe de protection particulier, saisissez la commande suivante à la page nsradmin prompt:

nsradmin> . type: nsr client; protection group list:Protection_Group_Name
nsradmin> show name 
nsradmin> print

Pour imprimer la liste de tous les clients enregistrés et de leurs systèmes d’exploitation, saisissez la commande suivante à la page nsradmin prompt:

nsradmin> . type: NSR client 
nsradmin> show name; OS 
nsradmin> print

Pour répertorier tous les appareils qui sont en mode maintenance, saisissez la commande suivante à la page nsradmin prompt:

nsradmin> show name
nsradmin> print type: NSR device; enabled: Service

Les options masquées peuvent être affichées en saisissant les éléments suivants avant d’interroger n’importe quel type de ressource :

nsradmin> option hidden

Pour réinitialiser les spécifications de requête définies en saisissant l’attribut show, saisissez show:

nsradmin> show

Mise à jour des ressources

Pour mettre à jour une ressource NetWorker, saisissez la commande suivante à l’adresse nsradmin prompt:
nsradmin>. type:NetWorker_resource; attribute:value 
nsradmin> update action; attribute1:value; attribute2:value
Vous pouvez mettre à jour plusieurs attributs d’une même ressource. Attribut : les combinaisons de valeurs sont séparées par un point-virgule ( ;). Par exemple, pour modifier la commande de sauvegarde et de saveset utilisée par un client :
nsradmin> . type: nsr client; name: win-srvr01.amer.local 
nsradmin> update save set:"MSSQL:DELL"; backup command:nsrsqlsv
Remarque : Spécifiez correctement les noms et les valeurs des attributs, y compris la casse appropriée pour les valeurs d’attribut. Si le nom et la valeur de l’attribut ne sont pas spécifiés correctement, l’attribut n’est pas mis à jour et aucun message d’erreur n’est fourni.

Suppression de ressources

ATTENTION : Assurez-vous de supprimer uniquement les ressources qui sont censées être supprimées. Les ressources NetWorker dotées de dépendances vous empêchent de les supprimer si la dépendance existe toujours. En outre, certaines ressources ne peuvent pas être supprimées lorsque les services NetWorker sont en cours d’exécution ou nsradmin online-mode est utilisé. Il est recommandé de créer une sauvegarde de /nsr/res/nsrdb (serveur) et /nsr/res/nsrladb (client) avant de modifier ces bases de données.

Pour supprimer une ressource, saisissez delete après avoir défini le type de ressource. par exemple:

nsradmin> . type: NetWorker_Resource; attribute:value
nsradmin> delete
les ressources NetWorker qui ont des dépendances ne parviennent pas à être supprimées. Vous êtes averti de ce qui a empêché la suppression.
Exemple :
nsradmin> delete type: nsr pool; name: DD_Bootstrap 
name: DD_Bootstrap; 
Delete? yes 
delete failed: Pool `DD_Bootstrap' cannot be deleted because it has active volumes in the media database.
Remarque : vous devez résoudre les dépendances en les mettant à jour ou en les supprimant. Dans certains cas, il peut être nécessaire d’utiliser nsradmin en mode hors ligne ; Toutefois, cette opération supprime une ressource, que les dépendances soient résolues ou non. Une fois les services redémarrés sur le serveur, la ressource supprimée n’apparaît plus.

Création de ressources

Pour créer une ressource, saisissez les éléments suivants :
nsradmin> create type: Networker_resource; name:resource_name; attribute1:value; attribute2:value 
create? yes

Additional Information

Affected Products

NetWorker

Products

NetWorker Series
Article Properties
Article Number: 000203325
Article Type: How To
Last Modified: 14 Feb 2025
Version:  11
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.