UUID's for Nodes in NMIS is now fully integrated and just work, especially when using the GUI or the tools to maintain nodes, you will not need to worry about them.
Problems with UUID's
Error Message: the improbable has happened
You might see an error message like this:
The most likely thing to have occurred is that someone cloned/copied the node YINYANG and called it FOOBAR, changed other settings but not the UUID.
To fix this problem, just delete the UUID from the newly added node and NMIS will automatically create a new UUID and update the system automatically.
NMIS version 8.3.19G or greater.
The perl library Data::UUID to be installed.
Unix Shell access to the NMIS server and suitable Unix privileges to edit the NMIS configuration files, usually a member of the group "nmis" or the root user.
Some NMIS users require a Unique Identifier for each node, so Opmantek has added this for those users who require it. To have NMIS add a UUID for each node, you can enable this to be added and exported as required. This capability uses Custom Tables to have NMIS add a UUID when adding a node.
A UUID might be useful or required when integrating NMIS with third party applications like HP Service Manager, or when using NMIS as your source of truth for integration with a CMDB or other database system.
A new module has been added in NMIS 8.3.19G called NMIS::UUID, this is required to support UUID's.
Adding UUID Support
Modify the file /usr/local/nmis8/conf/Table-Nodes.nmis and add the following code.
In context these changes look like this:
Not adding UUID when node added
You can use the configuration uuid_add_with_node set to true to enable a UUID to be added or disable it with false to allow the other methods to maintain the UUID.
Including the UUID in the Export
The sample script /usr/local/nmis8/admin/export_nodes.pl has been modified to include the UUID in the export. You can review this code to see how it is added. This code also uses the method createNodeUUID to create UUID's which might be missing from the nodes file.
Adding and Auditing UUID for Nodes
A script has been included /usr/local/nmis8/admin/uuid_update_nodes.pl which will add any missing UUID's as well as maintain/update the file /usr/local/nmis8/conf/UUID.nmis which is a two way index for determining the UUID of devices and visa versa. The error below was introducted intentionally.