Troubleshooting Imports of Configuration Files

When importing incremental sets of configuration files, NNMi abandons the import if mismatched configuration objects are encountered. Each configuration object has a set of Unique Identifier values that must match for incremental updates, or must not match any existing data before NNMi adds the configuration object to the database, see tables below.

If you receive an error message while trying to import configuration information, use the information below to figure out how to use the error message to determine what to change before creating another export file (thus, solving the problem).

 

Author Configuration Unique Identifiers

Configuration Item Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
Author = Author form	author = Unique Key attribute value	Yes

 

Communication Configuration Unique Identifiers

Attribute Name = NNMi Console Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
CommunicationRegion = Communication Region form	uuid	No	name = Name value ordering = Ordering value Caution SNMPv3 configuration settings cannot be exported because SNMPv3 data is encrypted based on the NNMi encryption key (generated during NNMi installation). Therefore, the SNMPv3 encrypted data cannot be imported into another installed version of NNMi because the encryption key is different.
UsmSettings = SNMPv3 Settings form	uuid	No	name = Unique Name value

 

Custom Correlation Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
CausalCorrelation = Causal Rule Form	uuid	No
GeneralizedCorrelation = Correlation Rule Form	uuid	No

 

Custom Poller Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
ComparisonMap = Comparison Map form	uuid	No	ordering = Ordering value
Policy = Custom Poller Policy form	uuid	No	The combination of these two: collection = Collection value ordering = Ordering value

 

Device Profile Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
DeviceCategory = Device Category form	key = Unique Key attribute	Yes
DeviceFamily = Device Family form	key = Unique Key attribute	Yes
DeviceProfile = Device Profile form	snmpObjectId = SNMP Object ID value	Yes
DeviceVendor = Device Vendor form	key = Unique Key attribute	Yes

 

Discovery Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
AutoDiscoveryRegion = Auto-Discovery Rule form	uuid	No	name = Name value ordering = Ordering value

 

Discovery Seed Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
DiscoverySeed = Discovery Seed form	host = Hostname (not case-sensitive) / IP Address value	Yes

 

Incident Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
MgmtEventConfig = Management Event Configuration form	uuid	No	name = Name value
SnmpTrapConfig = SNMP Trap Configuration form	uuid	No	iod = SNMP Object ID value name = Name value
PairwiseConfig = Pairwise Configuration form	uuid	No	name = Name value The combination of these two: firstIncidentName = First Incident Configuration value secondIncidentName = Second Incident Configuration value

 

Interface Groups Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
InterfaceGroup = Interface Group form	uuid	No	name = Name value

 

Interface Type Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
ifType	ifType attribute	Yes

 

Menus Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
Menu = UI Configuration > Menus form	key = Unique Key attribute	Yes

 

Menu Items Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
MenuItem = Menu Item form	key = Unique Key	Yes

 

MIB Expressions Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
MibExpression = MIB Expression Form	key = Unique Key	Yes

 

Monitoring Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
InterfaceSettings = Interface Settings form	uuid	No	ordering = Ordering value
NodeSettings = Node Settings form	uuid	No	ordering = Ordering value

 

Node Group Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
NodeGroup = Node Group form	uuid	No	name = Name value

 

Node Group Map Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
NodeGroupMapSettings = Node Group Map Settings Form	uuid	No

 

RAMS Server Configuration Unique Identifiers (NNMi Advanced, plus Route Analytics Management System (RAMS) for MPLS WAN)

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
RamsServer = RAMS Server Form	uuid	No

 

Security Groups Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
SecurityGroup = Security Group Form	uuid	No

 

Security Group Mappings Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
UserToSecurityGroup = Security Group Mappings Form	uuid	No

 

Node Group Status Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
NodeGroupStatusSettings = Node Group Status Settings Form	uuid	No

 

User Interface Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
UserInterfaceConfiguration = User Interface Configuration Form	uuid	No

 

User Accounts and Roles Configuration Unique Identifiers

Attribute Name	Primary Identifier	Editable Attribute?	Other Key Attributes that must be unique
Account = User Account form	uuid	No	name = Name value
UserGroup = User Group Form	name	yes
UserGroupMember = User Account Mapping Form	uuid	no