17.33 resetnid.vbs (resetting the host ID)
This section describes the resetnid.vbs command, which resets the unique ID (host ID) which is generated by the agent in order to distinguish devices from each other.
Functionality
A host ID is automatically created when an agent is installed.
If you install an agent by using the disk copy functionality, the host ID must be reset on the copy-source computer prior to the copy so that a new host ID will be created on the copy-destination computer. The host ID for the agent can be reset by executing the resetnid.vbs command on the copy-source computer. As the old ID is reset, a new host ID is created when the agent is installed, and the computer will be able to be identified with a unique ID.
- Tip
-
If you duplicate an agent-installed virtual environment such as a VMWare environment, execute the resetnid.vbs command.
- Important
-
When you manage shared VDI-based virtual computers, you cannot reset host IDs by using the resetnid.vbs command.
- Tip
-
If you install an agent via a disk copy without executing the resetnid.vbs command, the copy-destination computer is defined as an identical device to the copy-source computer. In such cases, because two or more computers are identical, execute the resetnid.vbs command on those computers and go to the Settings module, Discovery, and then Managed Nodes to delete the device information for the computers.
When the resetnid.vbs command is executed on a computer that was once identified by JP1/IT Desktop Management 2, the host IDs assigned to the computer before and after the command execution are both registered to JP1/IT Desktop Management 2. Accordingly, two instances of the device information are displayed per computer. However, you can update the view by deleting both device information instances in the Settings module by selecting Discovery, and then Managed Nodes. After this operation, only the latest device information will be displayed.
- Important
-
Do not execute the resetnid.vbs command on a device on which the network monitor is installed.
If you execute the resetnid.vbs on the device on which the network monitor is installed, 2 instances of the device information appear per computer. To resolve this problem, you need to perform the following: Temporarily disable the network monitor. After that, in the Settings module, select Discovery and then Managed Nodes, and then temporarily delete both device information stances.
Execute this command on a computer on which the agent is already installed.
To display return codes, execute Cscript.exe with the /wait option specified for the Windows start command, as described in the example below.
Format
resetnid.vbs∆/nodeid [∆/i |∆/s]
Argument
- /nodeid
-
Always specify this argument. If this argument is omitted, the command cannot be executed.
- /i
-
Displays, on the user's computer, the dialog box for selecting whether to execute the command and the dialog box for displaying execution results. Even when you omit this argument, the dialog box is displayed.
- /s
-
Executes the command without displaying a dialog box. For the execution result of the command, check the return value.
Storage location
agent-installation-folder\bin\
Notes
When the resetnid.vbs command is executed, the time required to create a new host ID is equal to the shortest of the intervals specified for the items shown below. These items are defined under Timing of communication with the higher system in the Basic settings view for the agent configuration.
-
Monitoring Interval (Security) (min)
-
Monitoring Interval (Others) (min)
-
Interval specified for the polling settings
Return value
The following table shows the return values of the resetnid.vbs command.
|
Return value |
Description |
|---|---|
|
0 |
The command finished normally. |
|
10001 |
Command execution was canceled on the user's computer. |
|
10011 |
The argument syntax is incorrect. |
|
10051 |
You do not have permission to execute the command. |
|
10101 |
Failed to reset the host ID. |
|
10150 |
Failed to reset the host ID. |
Example
The following example shows how to use this command to reset the host ID when the agent installation folder is C:\Program Files\Hitachi\jp1itdma:
cd "C:\Program Files\Hitachi\jp1itdma\bin"
start /wait Cscript.exe resetnid.vbs /nodeid
echo %errorlevel%
Related Topics: