Skip to content
DataMiner DoJo

More results...

Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors
Search in posts
Search in pages
Search in posts
Search in pages
Log in
Menu
  • Blog
  • Questions
  • Learning
    • E-learning Courses
    • Open Classroom Training
    • Certification
      • DataMiner Fundamentals
      • DataMiner Configurator
      • DataMiner Automation
      • Scripts & Connectors Developer: HTTP Basics
      • Scripts & Connectors Developer: SNMP Basics
      • Visual Overview – Level 1
      • Verify a certificate
    • Tutorials
    • Video Library
    • Books We Like
    • >> Go to DataMiner Docs
  • Expert Center
    • Solutions & Use Cases
      • Solutions
      • Use Case Library
    • Markets & Industries
      • Media production
      • Government & defense
      • Content distribution
      • Service providers
      • Partners
      • OSS/BSS
    • DataMiner Insights
      • Security
      • Integration Studio
      • System Architecture
      • DataMiner Releases & Updates
      • DataMiner Apps
    • Agile
      • Agile Webspace
      • Everything Agile
        • The Agile Manifesto
        • Best Practices
        • Retro Recipes
      • Methodologies
        • The Scrum Framework
        • Kanban
        • Extreme Programming
      • Roles
        • The Product Owner
        • The Agile Coach
        • The Quality & UX Coach (QX)
    • DataMiner DevOps Professional Program
  • Downloads
  • More
    • Feature Suggestions
    • Climb the leaderboard!
    • Swag Shop
    • Contact
      • General Inquiries
      • DataMiner DevOps Support
      • Commercial Requests
    • Global Feedback Survey
  • PARTNERS
    • All Partners
    • Technology Partners
    • Strategic Partner Program
    • Deal Registration
  • >> Go to dataminer.services

Setting a protocol version.

Solved1.44K views12th January 2022Automation script
2
ryan yahia878 24th November 2021 0 Comments

Hi all,

I want to create an automation script that updates an element to use another protocol version. Is there any method that does this in the automation module?

Thanks,

Ryan

ryan yahia Selected answer as best 12th January 2022

2 Answers

  • Active
  • Voted
  • Newest
  • Oldest
3
Mieke Dryepondt [SLC] [DevOps Advocate]3.58K Posted 26th November 2021 3 Comments

Hi Ryan,
to change the version of a protocol you can use the below piece of code in your Automation script.
Do note that this will only change the version and not configure any extra items that might be required with the (major) version change.
The use-case should only be to update an iteration of a specific range.
For example 1.0.0.x to 1.0.0.y or 1.1.0.x tot 1.1.0.y

public static class MyElementExtentions
{
public static void AssignProtocolVersion(this Element element, Engine engine, string versionToSet)
{
AddElementMessage msg = new AddElementMessage
{
DataMinerID = element.DmaId,
ElementName = element.ElementName,
ElementID = element.ElementId,
ProtocolVersion = versionToSet,
};

engine.SendSLNetMessage(msg);
}
}

Example of usage:

public class Script
{
/// <summary>
/// The Script entry point.
/// </summary>
/// <param name="engine">Link with SLAutomation process.</param>
public void Run(Engine engine)
{
Element element = engine.FindElementsByName("MyTestElement").FirstOrDefault();
string versionToSet = "1.0.0.1";
if (element.ProtocolVersion == "1.0.0.1")
{
versionToSet = "1.0.0.2";
}

element.AssignProtocolVersion(engine, versionToSet);
}
}

Disclaimer: 
"Note that this is an internal call and we do not recommend using this, as it is not officially supported and we cannot guarantee that it will still work in the future. As a rule, you should avoid using SLNet calls, as these are subject to change without notice. We recommend to instead always use the correct UI or automation options provided in DataMiner Automation or through our web API."

ryan yahia Posted new comment 14th January 2022
ryan yahia commented 12th January 2022

Hi Mieke,

Thank you for the solution it works for normal protocol versions. When trying to upgrade to a production version it doesn’t find any of them, is there any particular format I need to do it for Production versions of protocols/ is there any other parameters I need to add for upgrades to Production versions.

Thanks,
Ryan

Mieke Dryepondt [SLC] [DevOps Advocate] commented 13th January 2022

Hi Ryan,
When using “Production” instead of the version (for example “1.0.0.2”) the element will switch to the version that is defined as Production.
You do need to have a version set as production.
Could it be it is failing because none of the versions are set as Production?

I have tested it by using this on the code I shared previously :

Element element = engine.FindElementsByName(“MyTestElement”).FirstOrDefault();
string versionToSet = “1.0.0.1”;
if (element.ProtocolVersion == “1.0.0.1”)
{
versionToSet = “Production”;
}

element.AssignProtocolVersion(engine, versionToSet);

ryan yahia commented 14th January 2022

Thank you that works for me now!

You are viewing 1 out of 2 answers, click here to view all answers.
Please login to be able to comment or post an answer.

My DevOps rank

DevOps Members get more insights on their profile page.

My user earnings

0 Dojo credits

Spend your credits in our swag shop.

0 Reputation points

Boost your reputation, climb the leaderboard.

Promo banner DataMiner DevOps Professiona Program
DataMiner Integration Studio (DIS)
Empower Katas

Recent questions

Web Applications exception in Cube due to invalid certificate 0 Answers | 0 Votes
Redundancy Groups and Alarming – Duplicate Alarms 0 Answers | 0 Votes
Correlation Engine: “Test rule” doesn’t result in a hit, despite functional rule 1 Answer | 3 Votes

Question Tags

adl2099 (115) alarm (62) Alarm Console (82) alarms (100) alarm template (83) Automation (223) automation scipt (111) Automation script (167) backup (71) Cassandra (180) Connector (109) Correlation (69) Correlation rule (52) Cube (151) Dashboard (194) Dashboards (188) database (83) DataMiner Cube (57) DIS (81) DMS (71) DOM (140) driver (65) DVE (56) Elastic (83) Elasticsearch (115) elements (80) Failover (104) GQI (159) HTTP (76) IDP (74) LCA (152) low code app (166) low code apps (93) lowcodeapps (75) MySQL (53) protocol (203) QAction (83) security (88) SNMP (86) SRM (337) table (54) trending (87) upgrade (62) Visio (539) Visual Overview (345)
Privacy Policy • Terms & Conditions • Contact

© 2025 Skyline Communications. All rights reserved.

DOJO Q&A widget

Can't find what you need?

? Explore the Q&A DataMiner Docs

[ Placeholder content for popup link ] WordPress Download Manager - Best Download Management Plugin