Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Dell NetWorker 19.9 Administration Guide

Hostname changes

NetWorker considers each unique client name as a separate client. NetWorker assigns each unique client name in the datazone a unique identifier called client ID. NetWorker stores the client ID for each client in the media database.

The NetWorker software has a built-in mechanism to prevent the nsrd daemon from starting on the NetWorker server if the startup process detects a change in the name of the NetWorker server. For example, when you change the hostname of the NetWorker server or modify the aliases order in the hosts file.

A message similar to the following appears in the daemon.raw file:

NetWorker is unable to continue its startup sequence due to a server hostname change to hostname. Please verify that the server's hostname and its aliases are properly represented in the local host database (eg. /etc/hosts) and DNS.
This mechanism prevents the NetWorker software from assigning a new client ID to the NetWorker server, which is based on the new hostname. To resolve this issue, verify that the hostname of NetWorker server is same as in NSRLA RAP resource, and hostname resolution of the NetWorker server is working.
NOTE:
  • You cannot rename the existing client in the current NetWorker releases.
  • In case the client name is incorrect, you can delete the client (if there is no backup or clone save sets), then add new client with the required name.
  • The client name should be valid and network reachable.
  • Hostname for NetWorker server cannot be changed.

The "Networking and Connectivity" chapter provides more information.

If the startup process did not detect the hostname change, NetWorker assigns the NetWorker server a new client ID, which can impact NetWorker operations. Use the nsrclientfix command to analyze the media database and identify client ID inconsistencies. To resolve client ID issues, use the nsrclientfix command to merge information about multiple clients in the media database and resource database into one client resource with the original client ID. The following KB articles on the Online Support website provide more information about using the nsrclientfix command:

  • For NetWorker Server client ID issues: 000185727
  • For NetWorker Client client ID issues: 000193911

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\