एपीआई के माध्यम से राउटरओएस मिकरोटिक से इंटरनेट रिले का प्रबंधन

MikroTik रूटर्स में PDUs के प्रबंधन के लिए एक आसान उपकरण

PDU प्रबंधन के लिए राउटरओएस सुविधाएँ

• पीडीयू से जुड़े उपकरणों की शक्ति को दूर से चालू / बंद करें
• नेटवर्क में विभिन्न घटनाओं की घटना पर दूरस्थ रूप से पीडीयू को नियंत्रित करें (यदि किसी वीपीएन क्लाइंट, एक वाईफाई नेटवर्क क्लाइंट, आदि, राउटर से जुड़ा है, तो समय के आधार पर, किसी भी डिवाइस से पिंग की कोई प्रतिक्रिया नहीं है)। (मुक्त)
• पीडीयू पर रिले की स्थिति में ई-मेल या फोन नंबर (एसएमएस के माध्यम से) के बारे में व्यवस्थापक या उपयोगकर्ताओं को सूचित करें

"लाने" रूटर आदेश के माध्यम से PDUs का प्रबंधन

/tool fetch url="http://[:]@192.168.1.20/protect/rb0n" 

 /tool fetch url="http://[:]@192.168.1.20/protect/rb0n" mode=http dst-path="Rodosanswer.txt"; :local Rodosanswer [/file get Rodosanswer.txt contents]; 

• «सफलता! "- कमांड के सफल निष्पादन के मामले में
• "दोष" - यदि कमांड को निष्पादित नहीं किया जाता है (एक नियम के रूप में, URL लाइन में पीडीयू लॉगिन और पासवर्ड को इंगित किए बिना एक्सेस करने पर, अगर पीडीयू "संरक्षित" मोड में है)

हम मिक्रोटिक राउटर के भंडार में रोडोस पीडीयू प्रबंधन फ़ंक्शन बनाते हैं

 ################ FuncRODOS10rele ###################### #     PDU RODOS-10 # by Sergej Serkov 23.12.2017 ####################################################### #  ,   :global FuncRODOS10rele do={ :local Sport ""; :if ([:len $Rport]=0) do={:set Sport "80";} else={:set Sport $Rport;} :global FuncPing; :local PingAnswer [$FuncPing PingAdr=$Radr]; :if ($PingAnswer="OK") do={ :local Rprotect; :local Wprotect; :local Rmode "0"; :local Nrele 0; :local Act; :if (([:len $Rlogin]=0) and ([:len $Rpass]=0)) do={:set Rprotect ""; set Wprotect "";} else={:set Rprotect ("$Rlogin".":"."$Rpass"."@"); set Wprotect "/protect";} :if ($Rstatus="on") do={:set Rmode "1"; :set Act "n"} :if ($Rstatus="off") do={:set Rmode "1"; :set Act "f"} :if ($Rstatus="inv") do={:set Rmode "1"; :set Act "s"} else={} :if ($Rmode="1") do={ :set Nrele ([:tonum $Rrele] - 1); :if (($Nrele > -1 and ($Nrele < 4)) do={ :local StrFetchRodos; :set StrFetchRodos ("http://"."$Rprotect"."$Radr".":"."$Sport"."$Wprotect"."/rb"."$Nrele"."$Act".".cgi"); do { [/tool fetch url=$StrFetchRodos mode=http dst-path="Rodosanswer.txt";]; } on-error={: log info ""; :log error ("Call ERROR function <RODOS10rele> ERROR fetch command"); :local Rodosanswer "ERROR: command ROS <fetch>"; : log info ""; :return $Rodosanswer} :log info ""; :log warning ("all "."$Wprotect "."function <RODOS10rele> set rele #"."$Rrele "."is ["."$Rstatus"."]"); :log info ""; :delay 2s; :local Rodosanswer [/file get Rodosanswer.txt contents]; /file remove Rodosanswer.txt; :return $Rodosanswer; } else={ :log info ""; :log error ("all ERROR"."$Wprotect "."function <RODOS10rele> set rele#"."$Rrele"." but NUMBER RELE MISMATCH"); :log info ""; :local Rodosanswer "ERROR: rele range mismath"; :return $Rodosanswer;} } else={ :log info ""; :log error ("all ERROR"."$Wprotect "."function <RODOS10rele> set rele#"."$Rrele"." but RELE REGIME SET MISMATCH"); :log info ""; :local Rodosanswer "ERROR: rele regime set mismatch"; :return $Rodosanswer;} } else={ :log info ""; :log error ("all ERROR"."$Wprotect "."function <RODOS10rele> but DEVICE NOT RESPONDED"); :log info ""; :local Rodosanswer "ERROR: device not responded"; :return $Rodosanswer;} } 

 :global FuncPing do={ :local PingCount 3; #  ; :local Result [/ping $PingAdr count=$PingCount]; :delay 2s; :local PingAnswer ""; :local MainIfInetOk false; :set MainIfInetOk ((3*$Result) >= (2 * $PingCount)) :put "MainIfInetOk=$MainIfInetOk" if (!$MainIfInetOk) do={ :set PingAnswer "ERROR" } if ($MainIfInetOk) do={ :set PingAnswer "OK" } :return $PingAnswer;} 

रिले नियंत्रण समारोह के अनुप्रयोग

• रडार - डिवाइस आईपी पता
• Rport - http पोर्ट। यदि http (80) के लिए मानक पोर्ट कॉन्फ़िगर किया गया है, तो यह पैरामीटर छोड़ा जा सकता है
• Rrele - रिले की संख्या जिस पर हम एक कार्रवाई करते हैं (RODOS-10 [1-4] के लिए), -
  RODOS-9 [1-2] के लिए, RODOS-8 प्रेषित नहीं है)
• रैस्टैटस - कार्रवाई की जा रही है ("बंद" - अक्षम; "चालू" - सक्षम; "आमंत्रित" - एक आवेग दें)
• Rlogin - लॉगिन, Rpass - डिवाइस एक्सेस पासवर्ड
  (यदि वे सेट नहीं हैं, तो कमांड कॉल "/ प्रोटेक्ट" के बिना उपयोग किया जाता है)
  

 [$FuncRODOS10rele Radr="192.168.1.20" Rrele="2" Rstatus="on"] 

 [$FuncRODOS10rele Radr="192.168.1.20" Rport="8021" Rrele="2" Rstatus="off" Rlogin="login" Rpass="password"] 

  • "सफलता!" - एक टीम के सफल कॉल और निष्पादन के मामले में

  • "दोष" - गलत तरीके से निपटने और एक कमांड के गैर-निष्पादन के मामले में

  • "त्रुटि: रीले रेंज बेमेल" - यदि एक अवैध रिले संख्या निर्दिष्ट है 
	 डिवाइस के इस संस्करण के लिए Rrele फ़ंक्शन के पैरामीटर में

  • "त्रुटि: रील शासन सेट बेमेल" - अनिर्दिष्ट या गलत के मामले में 
     रैस्टैटस फ़ंक्शन के निर्दिष्ट पैरामीटर ("पर", "बंद", "आमंत्रित")

  • "त्रुटि: डिवाइस ने जवाब नहीं दिया" - अगर डिवाइस से कोई प्रतिक्रिया नहीं है 
     पिंग करने के लिए

  • "त्रुटि: आदेश ROS <fetch>" - सीधे त्रुटि के मामले में
     राउटरओएस लाने पर URL कमांड (आमतौर पर नहीं तो)
     Rport में निर्दिष्ट पोर्ट संख्या, गलत तरीके से निर्दिष्ट Rlogine पैरामीटर
     और / या रस्स)

1. सबसे पहले आपको उन लिपियों को निष्पादित करना होगा जो राउटर रिपॉजिटरी चर के वातावरण में आवश्यक कार्य करते हैं। यह एक बार किया जा सकता है, उदाहरण के लिए, राउटरओएस शेड्यूलर ( / सिस्टम शेड्यूलर ) से राउटर शुरू करते समय
   
   

    #          /system script run Func_RODOS10rele; #      «FuncPing» # (  FuncRODOS10rele) /system script run Func_Ping; 

2. फ़ंक्शन परिभाषित होने के बाद, आप उनका उपयोग कर सकते हैं (विशेष रूप से, FuncRODOS10rele पर कॉल करें)
   
   एक उदाहरण के रूप में, हम PDU RODOS-10 के रिले नंबर 4 में एक नाड़ी लगाकर अपने कार्य को कहते हैं:
   
   

    :global FuncRODOS10rele; :local Rodosanswer [$FuncRODOS10rele Radr="192.168.1.20" Rport="8021" Rrele="4" Rstatus="inv" Rlogin="login" Rpass="password"]; :log info $Rodosanswer; 

   
   प्रतिक्रिया को रोडोस शेयर चर में लौटाया जाएगा और इस मामले में, राउटर लॉग में प्रदर्शित किया जाएगा।
   
   

   पीडीयू के साथ काम करने के लिए कार्यों के लिए तैयार पुस्तकालय

   
   उपयोग में आसानी के लिए, मैंने DIN निष्पादन के मॉडल 8, 9, 10 और 10 के रोडोस पीडीयू के लिए फ़ंक्शंस की लाइब्रेरी बनाई (लाइब्रेरी संस्करण 1.0 दिनांक 25 दिसंबर, 2017)। लाइब्रेरी स्क्रिप्ट्स को Func_RODOS.rsc फ़ाइल में संयोजित किया गया है, जिसे निम्नलिखित WINBOX यूटिलिटी टर्मिनल कमांड द्वारा राउटरओएस में आयात किया जा सकता है:
   
   

    /import file= Func_RODOS.rsc 

   
   आयात प्रक्रिया को मिकरोटिक राउटर (इसकी गति) के मॉडल के आधार पर 20 सेकंड से 1 मिनट तक का समय लग सकता है।
   इस स्थिति में, राउटर में पहले से मौजूद सभी स्क्रिप्ट प्रभावित नहीं होती हैं, फ़नकार_ओआरडीओएस लाइब्रेरी के कार्यों और लिपियों को मौजूदा रिपॉजिटरी स्क्रिप्ट में जोड़ा जाता है।
   
   
   Rodos.rsc लाइब्रेरी संस्करण 1.0 में निम्नलिखित स्क्रिप्ट हैं:

   • start_RODOS - इस स्क्रिप्ट को चलाने से सभी कार्य पर्यावरण चर पर सेट हो जाते हैं
   • Func_Ping - "पिंग" के लिए पते की जांच करने का कार्य
   • Func_Mail - व्यवस्थापक के मेल पर एक मनमाना संदेश भेजने के लिए कार्य करता है
   • फंक_रो डीओएस 8रेले - आरओडीओएस -8 पीडीयू रिले नियंत्रण समारोह
   • Func_RODOS8reset - PDU RODOS-8 रिले के रीसेट फ़ंक्शन ("रीसेट")
   • Func_RODOS9rele - ... इसी तरह से संकेतित मॉडल के लिए ...
   • Func_RODOS9reset
   • Func_RODOS10rele
   • Func_RODOS10reset
   • call_example [...] - लाइब्रेरी फ़ंक्शन कॉल के उदाहरण
   • Func_RODOS_lib - सभी PDU फ़ंक्शन (पिंग और मेल को छोड़कर) एक स्क्रिप्ट फ़ाइल में
   
   लाइब्रेरी को आयात करने के बाद, आप रिपॉजिटरी से अनावश्यक कार्यों और स्क्रिप्ट को हटा सकते हैं, केवल अपने पीडीयू मॉडल और फ़ंकमेल और फ़ंकपिंग कार्यों के साथ स्क्रिप्ट को छोड़ सकते हैं।
   
   पुस्तकालय में, समर्थित पीडीयू मॉडल में से प्रत्येक के लिए, सुविधाजनक रीसेट ("रीसेट") फ़ंक्शन ("~ रीसेट" के रूप में नामों में चिह्नित) भी हैं। रीसेट फ़ंक्शंस के पैरामीटर रिले इंस्टॉलेशन फ़ंक्शंस के मापदंडों के समान हैं, "रैस्टैटस" पैरामीटर के अपवाद के साथ, जिसका उपयोग "रीसेट" और वैकल्पिक वैकल्पिक पैरामीटर RIME के ​​दौरान नहीं किया जाता है, जो रिले को स्विच करने के बीच सेकंड में समय को परिभाषित करता है और फिर से (यदि फ़ंक्शन के लिए RIME पास नहीं किया गया है) डिफ़ॉल्ट रूप से उपयोग किया जाता है। समय 5 सेकंड)।
   
   रिबूट कार्य निम्नानुसार काम करते हैं:
   
   1. निर्दिष्ट रिले को एक शटडाउन कमांड भेजा जाता है
   2. फिर यह बाद के समावेशन कमांड के साथ RIME सेकंड का इंतजार करता है। इस स्थिति में, रीसेट फ़ंक्शंस संबंधित रिले इंस्टॉलेशन फ़ंक्शन को संदर्भित करता है, जिसे पहले से पहले निर्धारित किया जाना चाहिए
   
   इस प्रकार, यदि, रीसेट फ़ंक्शन को कॉल करने से पहले, एक निश्चित रिले चालू किया गया था, तो इसे बंद कर दिया जाएगा और एक निर्दिष्ट समय के बाद फिर से चालू किया जाएगा (और इससे जुड़ा लोड "रीसेट" होगा)। इसी तरह का ऑपरेशन एक स्विच ऑफ रिले पर किया जाता है, और फ़ंक्शन के सक्रिय होने के बाद, रिले स्विच ऑन हो जाता है (अर्थात, इस मामले में फ़ंक्शन रिले स्विचिंग फ़ंक्शन के रूप में खुद को पूरा करता है)। रोडोस पीडीयू (एक्सेस पॉइंट, राउटर, स्विच, विभिन्न सर्वर, आदि ...) से जुड़े "त्रिशंकु" नेटवर्क उपकरणों को रिबूट करने के लिए रीसेट फ़ंक्शन का उपयोग करना सुविधाजनक है।
   
   Rodos.rsc पुस्तकालय के स्रोत कोड (फ़ंक्शन और स्क्रिप्ट, उन तक पहुंचने के उदाहरण) पर्याप्त विवरण में "टिप्पणी" किए गए हैं, जो उन लोगों के लिए उपयोगी हो सकते हैं जो पुस्तकालय को विस्तार से समझना चाहते हैं (या शायद उन्हें खुद को संशोधित करें, या अपना खुद का संस्करण लिखें)।
   
   रीबूट फ़ंक्शन को कॉल के उदाहरणों में, फ़ंक्शन के काम करने के बाद, राउटर व्यवस्थापक के ईमेल पते पर संदेश भेजना संभव है (स्क्रिप्ट चर सेटिंग्स में, आप अपना मेल पता निर्दिष्ट कर सकते हैं)। इस स्थिति में, स्क्रिप्ट / उपकरण ई-मेल से राउटरओएस मेल सेवा का उपयोग करते हैं, जिनमें से पैरामीटर को आपके द्वारा अग्रिम में सही ढंग से कॉन्फ़िगर किया जाना चाहिए।
   
   

   भविष्य की योजना

   
   भविष्य में, रोडोस पीडीयू के लिए स्क्रिप्ट लाइब्रेरी का विस्तार किया जाएगा - यह रिले, इनपुट / आउटपुट लाइनों और तापमान / आर्द्रता / वायुमंडलीय दबाव सेंसर के अलावा, इंटरनेट मौसम स्टेशन RODOS-16 के लिए फ़ंक्शंस बनाने की योजना है। यह न केवल राउटर के लॉग और मेल पर, बल्कि उपयोगकर्ता की पसंद के निर्दिष्ट फोन नंबर (राउटर के मॉडम के माध्यम से एसएमएस संदेश भेजकर) के कार्यों को भी लागू करने की योजना है।
   
   शायद, उपयोगकर्ताओं (इस सामग्री के पाठकों सहित) द्वारा पुस्तकालय का उपयोग करने की प्रक्रिया में, कुछ त्रुटियां सामने आएंगी, जो, एक नियम के रूप में, किसी भी विकास के दौरान अपरिहार्य हैं। कृपया मुझे उनके सुधार के लिए किसी भी त्रुटि, टिप्पणी और सुझाव की जानकारी दें।
   
   मिक्रोटिक राउटर्स के लिए फ़ॉच कमांड के विवरण के लिए लिंक
   उपयोग किए गए पीडीयू के लिए प्रलेखन के लिए लिंक
   रोडोस पीडीयू के लिए स्क्रिप्ट फ़ंक्शन लाइब्रेरी से लिंक करें
   
   सर्कोव सर्गेई व्लादिमीरोविच, 26 दिसंबर, 2017