Smarts IP: What is a Smarts IP Field Certification?; How do I load a Smarts IP Field Certification?

Products

• VMware

Environment

VMware Smart Assurance - SMARTS

Resolution

What is a Smarts IP Field Certification?
How do I load a Smarts IP Field Certification?
 

Smarts IP Field Certifications are unofficial certifications that will give your environment basic functionality for the device.

IMPORTANT! Smarts IP Field Certifications are not guaranteed to allow your device to be discovered correctly.

Loading a Smarts IP Field Certification
To load a Smarts IP Field Certification, do the following:

1. Check for the existence of an oid2type_Field.conf file in the following location:
   
   IP/smarts/local/conf/discovery
   
    
2. Do the following depending on what you found in the preceding step:
    
3. • oid2type_Field.conf file exists in the local folder:  If an oid2type_Field.conf file already exists in the IP/smarts/local/conf/discovery directory, do the following:
   • 1. Append the Field Certification information obtained from EMC Support for Smarts into the oid2type_Field.conf file. To do this, cut and paste the information provided at the end of the file and save the file.  
     2. Please make sure that the field cert has the following line:     CERTIFICATION = TEMPLATE  as this denotes a field certification.  
     3. Go to the next step.
        
         
   • oid2type_Field.conf file does not exist in the local folder:  If an oid2type_Field.conf file does not exist in the IP/smarts/local/conf/discovery directory, 
   • 1. Use sm_edit command from the BASEDIR/IP/smarts/bin  
     2. sm_edit ../conf/discovery/oid2type_Field.conf  
     3. Append the Field Certification information obtained from EMC Support for Smarts into the oid2type_Field.conf file. To do this, cut and paste the information provided at the end of the file and save the file.  
     4. Please make sure that the field cert has the following line:     CERTIFICATION = TEMPLATE  as this denotes a field certification. 
     5. This will create an updated copy of the oid2type_Field.conf in the local/conf/discovery folder.
4. Run the following command from the IP/smarts/bin directory to reload the updated oid2type_Field.conf for the IP domain to use:  
   1. sm_tpmgr -s <AM_domain> --reloadoid
5. Check the server log file for any errors.
6. Roll the log file, with the dmctl -s <IP Server Name> exec roll_log 
7. Delete and rediscover the device.
8. The device discovered now should reflect the certification that you used to update the oid2type_Field.conf provided that there were no typos or errors  introduced in the oid2type_Field.conf. file  
9. If the device still shows as a Node, check the SYSOID of the device that was deleted and discovered and compare that with the SYSOID in the field cert that was provided, if the same then review the log for errors and confirm that the oid2type_Field.conf file was changed or updated correctly.

Additional Information

It is necessary to understand that field certification is an attempt to provide device discovery the environment basic functionality.  However, it is a good idea, and possibly a great practice to consistently check for a certification team confirmed device certification.  Sometime a certification team confirmed certificate content can differ from a field certification.  This can cause the discovery of instances and objects to be different.


Please note: the only file that should be used to add new, or modify existing certifications is the oid2type_Field.conf file in the local/conf/discovery folder.  

DO NOT modify any of the base files that are installed in the BaseDir/IP/smarts/conf/discovery folder.  This action is not supported by DELL EMC.

There was an instance where a customer had copied all of the files in this BaseDir/IP/smarts/conf/discovery directory to the local/conf/discovery directory, edited a variety of base and local files. 

1. The result was a number of devices that failed to discover properly,
2. Multiple errors reported in the logs
3. And the local  oid2type_Field.conf to become unusable
4. Severely impacted the customer production environment and resulted in the customer having to install a clean install of Smarts IP in order to compare what had been changed in the broken installation. 

The one additional note:  the sm_tpmgr -s <AM_domain> --reloadoid command is primarily designed to compare the base files and reload the oid2type_Field.conf