Submit a ticketCall us

WebinarFREE IT Monitoring Webcast

Don’t miss out on our webcast, Essential IT Monitoring with SolarWinds ipMonitor, where we will show you how to keep an eye on your IT environment from one centralized, affordable, and lightweight monitoring tool: SolarWinds® ipMonitor®.

Register now.

Home > Success Center > Network Configuration Manager (NCM) > NCM - Knowledgebase Articles > Error: Unable to locate or error loading device template

Error: Unable to locate or error loading device template

Created by James Fahey, last modified by Melanie Boyd on Mar 07, 2018

Views: 1,560 Votes: 2 Revisions: 15

Updated March 7, 2018

Overview

This article describes the reasons NCM jobs would return the following error, and provides resolutions for each scenario:

Unable to locate or error loading device template.

Environment

  • NCM, all versions

Cause

This error is caused by one of the following situations.

Scenario #1: A device template is missing or incorrect

  • The device template format or command lines are incorrect.
  • In NCM 7.3.2 or earlier, the device template is missing or was not copied over after an application migration.

Scenario #2: Corrupted SCP encrypted data

If this is the cause, you will see the following additional symptoms:

  • The job doesn't work on a particular Polling Engine.
     
  • The SolarWinds.Orion.NCM.Security-SWJobEngineWorker2.log file contains the following error:

    STP SmartThreadPool Thread #0 ERROR SolarWinds.Orion.NCM.Security.CryptoHelperWrapper - Unable to decrypt encrypted text due to exceptionSystem.Security.Cryptography.CryptographicException: The parameter is incorrect.

 

Note: Logs are in the following location:
C:\ProgramData\Solarwinds\Logs\Orion\NCM\

 

  • When you adjust the Orion logging level to DEBUG, the NcmBusinessLayerPlugin.log file contains the following error:

    DEBUG SolarWinds.Orion.Common.SqlHelper - SQL: SELECT SettingValue FROM NCM_NCMSettings WHERE SettingName=@settingName AND EngineID=@engineId (@settingName=SCP User Name, @engineId=6)
    ERROR SolarWinds.Cirrus.BusinessLayer.TransferExtensions - NCMTransfer RefreshDeviceCommands error. DeviceTemplateXml: <Configuration-Management
    ......
    </Configuration-Management>System.Security.Cryptography.CryptographicException: The parameter is incorrect.

     
  • NCM returns an error when you click Settings > All Settings > NCM Settings > SCP Server.

Resolution

Scenario #1

  1. Double check command lines and make sure they are correct in the templates. To access device templates:
    • In NCM 7.3.2 or earlier, the device templates are located on the Orion server in the following location:
      C:\Program Files\SolarWinds\Orion\NCM\Device Type 
    • In NCM 7.4.0 through NCM 7.6.x:
      1. In the Orion Web Console, click Settings > All Settings.
      2. Under Product Specific Settings, click NCM Settings.
      3. Under Advanced, click Device Templates.
    • In NCM 7.7 and later:
      1. In the Orion Web Console, click Settings > All Settings.
      2. Under Node and Group Management, click Manage Device Templates.
  2. When you copy commands from a text file or another document, make sure there is no strange formatting. To remove any formatting, paste the command into Notepad, and then copy it from there and paste it into the XML editor. Or manually type in the command.
  3. For NCM 7.3.2 or earlier, make sure the device template is on the Orion server in the location below. (If the there was a recent migration, the Device Templates must be copied over from the original server and placed in the same directory.)
    C:\Program Files\SolarWinds\Orion\NCM\Device Type

Scenario #2

You will notice that a particular Polling Engine is not able to download device configurations.

  1. Look at the DEBUG message in the NcmBusinessLayerPlugin.log file and find the EngineID of the Polling Engine that is affected. (In the example above, the message contains EngineID=6).
  2. To verify, you can use the following SQL query:
    SELECT * FROM Engines WHERE EngineID = __
    For example:
    SELECT * FROM Engines WHERE EngineID = 6
  3. First, remove the Orion certificate and re-run Configuration Wizard to recreate it.
  4. If the problem persists, run the following query to drop the credentials:
    DELETE FROM NCM_NCMSettings where SettingName='SCP User Name' and EngineID = __
    DELETE FROM NCM_NCMSettings where SettingName='SCP Password' and EngineID = __


    For example:
    DELETE FROM NCM_NCMSettings where SettingName='SCP User Name' and EngineID = 6
    DELETE FROM NCM_NCMSettings where SettingName='SCP Password' and EngineID = 6
Last modified

Tags

Classifications

Public