Networker: How to use the nsrclientfix tool

Summary: The nsrclientfix command is used to detect client ID corruption as well as client IDs eligible for purging in the media database. It can also merge clients together in both the resource database and the media database. This article is to explains how to run it manually with some additional details to take care. ...

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.
Check out other resources

Instructions

1. Configure the hosts file with the main IP + main FQDN + main shortname + secondary FQDN + secondary shortname
2. Configure Client alias in that order cleaning any further IP.
3. Run the nsclientfix tool:
     #nsrclientfix -a - -p > clientfix.txt 2>&1
 
     #more clientfix.txt
     client1.domain.com, client                     <-- Clients in the same line will be merged.

     #nsrclientfix -u clientfix.txt
     Merging the following clients into 'client1.domain.com': client1
     Merging the resource database for client 'client1.domain.com'.
     Merging the media database for client 'client1.domain.com'.
     The merging is complete for client 'client1.domain.com'.
     
     #nsrclientfix -a - -p > client_bad.txt 2>&1

     #more client_bad.txt
     client2.domain.com                             <-- Clients alone in the line will be purged.

     #nsrclientfix -u client_bad.txt
     Purging the client 'client2.domain.com'.
     Purging the resource database of client 'client2.domain.com'.
     Purging the media database of client 'client2.domain.com'.
     Removing any index backups related to client 'client2.domain.com' in the media database.
     Successfully purged client 'client2.domain.com'.
4. Clean the host file deleting the additional names maintaining only the merged name (fqdn and short name)
5. Run nsrck -L6 <client_name>  to reconstruct the Client index.

Additional Information

Note1: Take care to always set a single space (Space or Tab) between IP, fqdn and short name in etc/hosts file.
Note2: In some cases where the client have two different IP and NICs, it will need to be set in different lines in etc/hosts and it could be still showing to merge at the nsrclientfix tool even it was already merged.

Reference: https://support.emc.com/docu85858_NetWorker-9.2.x-Command-Reference-Guide.pdf#page=325

Affected Products

NetWorker

Products

NetWorker
Article Properties
Article Number: 000013736
Article Type: How To
Last Modified: 31 May 2021
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.