NetWorker: Redirected recover (initiated from NMC) failed while source client is offline

Summary: A NetWorker restore is attempted for a NetWorker client which is offline and cannot be powered on. The client was also deleted from the NetWorker resource database; however, it still has valid backups. The client was added back to NetWorker for restoring its data to another client. The restore user interface does not allow proceeding further, reporting "Unknown client operating system." It may also report network connection issues since the source client is offline. ...

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.

Symptoms

  • A redirected restore is being performed from the NetWorker Management Console (NMC) to restore files from one client (source) to an alternate client (destination).
  • The source client is offline and cannot be powered on; or no longer physically exists.
  • The client was deleted from NetWorker, but still has backups in the NetWorker server's media database. The needed save sets have been identified using the NMC Media->Save Sets function or using the NetWorker server mminfo command:
mminfo -avot -q client=CLIENT_NAME
  • The deleted source client was added back to NetWorker so that its save sets would be picked up in the restore UI.
  • When attempting to pull up backups from the offline source client, the following errors appear in the NMC:
    • No OS information is shown when selecting the source client.
    • Error: Dispatcher Timed Out.
    • Error: Connecting to host source-client-name failed: Dispatcher: Request timed out.
    • Unknown client operating system.
  • The Next button is unavailable.
Unknown client operating system error in NMC
Figure 1: "Unknown client operating system" error observed in the NetWorker Management Console recover wizard.

Cause

When performing a restore, the recovery wizard checks to ensure that the source and target OS are the same type; for example: "Windows NT Server on Intel" or "Linux." When the client was added back to NetWorker, the "New Client Properties" option was used since the client host is offline. There is no connection from the server to the client so it cannot update the "client OS type"

Resolution

Option 1:

Perform the recovery from the command-line. See the NetWorker Command Reference Guide for details on how to use the recover command: https://www.dell.com/support/home/product-support/product/networker/docs


Option 2:

1. Open the client properties from the NetWorker Management Console (NMC).
NOTE: If the offline client does not exist in the NetWorker server but has backups on the NetWorker server, add the client back using the "New Client Properties" option.


2. Ensure that the client is not in any Protection Groups. If Protection Groups are selected, clear them:

Protection group list selection in client properties general tab
Figure 2: "Protection group list" selection in the client properties general tab.

3. In the Globals (2 of 2) tab, select the client state drop-down and select retired:

Client state drop down in client properties Globals (2 of 2) tab
Figure 3: "Client state" drop-down in the client properties Globals (2 of 2) tab.

4. Open an Administrator PowerShell prompt or root shell on the NetWorker server. Use nsradmin in offline mode to update the "client os type." This is a read-only field and can only be modified in offline-mode. A service restart is required for the change to apply.

nsrdb default location:

Linux: /nsr/res/nsrdb
Windows: C:\Program Files\EMC NetWorker\nsr\res\nsrdb

A. Create a copy of the nsrdb in the /tmp directory:

Linux: 

cp -Rv /nsr/res/nsrdb /tmp/nsrdb_`date -I`

Windows: Use windows file explorer to create a copy of the nsrdb
PowerShell option:

PS C:\Users\Administrator> $date = Get-Date -Format yyyMMdd
PS C:\Users\Administrator> Copy-Item -Path "C:\Program Files\EMC NetWorker\nsr\res\nsrdb" -Destination "C:\tmp\nsrdb_$date" -Recurse -Verbose

B. Enter:

nsradmin -d "PATH_TO_NSRDB"

C. Enter:

option hidden

D. Enter:

. type: nsr client; name: client-name

E. Enter:

update client os type: OS-TYPE
NOTE: For Windows operating systems, set OS-TYPE to "Windows NT Server on Intel". For Linux systems, set OS-TYPE to "Linux"  
root@lnx-nwserv:~# nsradmin -d /nsr/res/nsrdb
NetWorker administration program.
Use the "help" command for help, "visual" for full-screen mode.
nsradmin> option hidden
Hidden display option turned on

Display options:
        Dynamic: Off;
        Hidden: On;
        Raw I18N: Off;
        Resource ID: Off;
        Regexp: Off;
nsradmin> . type: nsr client; name: win-client01.amer.lan
nsradmin> update client OS type: Windows NT Server on Intel
              client OS type: Windows NT Server on Intel;
Update? y
updated resource id 53.0.166.57.0.0.0.0.233.98.62.102.192.168.9.101(3)
nsradmin> q

F. Restart NetWorker services on the NetWorker server. 

WARNING: Restarting NetWorker services cancels any running backup, clone, or recover jobs. Only perform this step if no jobs are running or if its acceptable for the running jobs to be interrupted.

Linux:

systemctl restart networker

Windows (PowerShell):

net stop nsrd ; net start nsrd
NOTE: If any service startup issues are observed. Stop NetWorker services, rename the \nsr\res\nsrdb, and put the copy created in step 4A in its place, then start services again. See Option 1 for performing a command-line restore instead.


5. Connect to the NetWorker server from the NMC and open the client properties again. In the Info & Licensing tab the client OS type should reflect the settings applied in step 4:

Client OS type shown in client properties Info and Licensing tab.
Figure 4: "Client OS type" shown in the client properties "Info & Licensing" tab.

6. Initiate the recovery again from the Recover tab:

Issue no longer shown in recover ui
Figure 5: The Next option is no longer unavailable, and the Unknown client operating system error is gone. 

Affected Products

NetWorker Series
Article Properties
Article Number: 000203590
Article Type: Solution
Last Modified: 14 May 2024
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.