डेटापावर ट्यूटोरियल

सामग्री wedmeed द्वारा सह-लेखक

2017 में, जब हमारी परियोजना वियतनाम में शुरू हुई, तो हमने हमारे लिए नए जानवर आईबीएम डेटापावर का सामना किया। IBM DataPower क्लाइंट और बैकएंड के बीच का एक गेटवे उत्पाद है, जो इसके माध्यम से गुजरने वाले संदेशों के फ़िल्टरिंग, राउटिंग, संवर्धन या अन्य परिवर्तनों के लिए डिज़ाइन किया गया है (बाद में अनुरोधों के रूप में संदर्भित)। यह जल्दी से सीखना आवश्यक था, बिल्डअप के लिए कोई समय नहीं था, इसलिए हमें इसके साथ खुद को परिचित करने के लिए कहा गया था, जिसके बाद मॉस्को के हमारे सहयोगी के साथ कई घंटों के स्काइप सम्मेलन थे, जो इस उत्पाद के साथ हमारे ज्ञान और अनुभव से गुजरते थे।

स्व-अध्ययन प्रलेखन का अध्ययन करने और इंटरनेट से प्रशिक्षण वीडियो देखने पर आधारित था - और यहां मैं एक पकड़ने की प्रतीक्षा कर रहा था। मैं रूसी में जानकारी प्राप्त करने में व्यावहारिक रूप से असमर्थ था। वैसे, उस समय अंग्रेजी भाषा का मेरा ज्ञान उच्चतम स्तर पर नहीं था, इसके अलावा यह मेरी पहली परियोजना थी और शायद, इन कारकों ने मेरे जीवन को जटिल बना दिया। इसने मुझे रूसी में एक प्रशिक्षण लेख लिखा और शुरुआती डेवलपर्स के लिए सबसे सरल संभव तरीके से जो इस उत्पाद के पार आए और अपनी मूल बातें जल्दी से समझने की कोशिश कर रहे हैं। लेख आपको दस्तावेज़ पढ़ने से मुक्त नहीं करेगा, लेकिन यह "यह कैसे काम करता है" समझने के शुरुआती चरणों में जीवन को आसान बना देगा।

यह भी ध्यान देने योग्य है कि व्यवहार में दी गई संरचना वास्तविक परियोजना के करीब होगी, जो आपको अपनी आवश्यकताओं के विस्तार, और पूरक के रूप में आधार के रूप में उपयोग करने की अनुमति देगा। निष्कर्ष में, "थ्योरी" अनुभाग पहले से लागू परियोजना के बारे में कुछ शब्द देगा, साथ ही कुछ विशेषताएं जो ध्यान देने योग्य हैं।

भाग 1. डॉकटर टूलबॉक्स के साथ डेटापॉवर स्थापित करना

डॉकर टूलबॉक्स ऐप इंस्टॉल करें और चलाएं। शुरू करने के तुरंत बाद, आपको मशीन का आईपी पता दिखाई देगा, जिसके माध्यम से भविष्य में डेटापॉवर उपलब्ध होगा:

छवि शुरू करने के लिए, आपको वर्चुअल मशीन की कुछ सेटिंग्स बदलने की जरूरत है (संस्करण IDG.2018.4.1.0 के लिए प्रासंगिक) और इसे फिर से शुरू करें:

1. आदेश के साथ docker मशीन बंद करो:
   
   

   docker-machine stop 

2. सिस्टम -> मदरबोर्ड -> मुख्य मेमोरी: न्यूनतम 4096 एमबी;
   
3. सिस्टम -> प्रोसेसर: न्यूनतम 2;
   
4. प्रदर्शन -> स्क्रीन -> वीडियो मेमोरी: कम से कम 128Mb;
   
5. हम कमांड के साथ docker मशीन लॉन्च करते हैं:
   
   

    docker-machine start 

   
   नोट। यदि docker- मशीन को पुनः आरंभ करने के लिए कहा जाए, तो चलाएँ:
   
   

    docker-machine env 

6. अगला, आपको आईबीएम डेटापावर छवि को अपवित्र करने की आवश्यकता है:
   
   

    docker pull ibmcom/datapower 

7. फिर निम्नलिखित कमांड के साथ डॉक कंटेनर लॉन्च करें:
   
   

    docker run -it \ -v $PWD/config:/drouter/config \ -v $PWD/local:/drouter/local \ -e DATAPOWER_ACCEPT_LICENSE=true \ -e DATAPOWER_INTERACTIVE=true \ -p 9090:9090 \ -p 3630:3630 \ -p 9022:22 \ -p 7170:7170 \ --name idg \ ibmcom/datapower 

8. कमांड पूरा करने के बाद, Enter दबाएं और उपयोगकर्ता नाम और पासवर्ड के रूप में व्यवस्थापक / व्यवस्थापक दर्ज करें
   
9. वेब प्रबंधन इंटरफ़ेस शुरू करने के लिए, कमांड का उपयोग करें:
   
   

    co 

   
   और
   
   

    web-mgmt 0 9090 

10. इन सभी चरणों के बाद, ब्राउज़र में निष्पादित करें https://192.168.99.100:9090/
    

भाग 2. डोमेन

2.1। सिद्धांत

DataPower में डोमेन आपको प्रशासन और विकास उपकरण अलग करने की अनुमति देता है, साथ ही सुरक्षा प्रदान करता है।

स्थापना के बाद, केवल एक डिफ़ॉल्ट डोमेन है जहां से एप्लिकेशन डोमेन बनाया जा सकता है। प्रत्येक डोमेन में मापदंडों का अपना कॉन्फ़िगरेशन होता है।

कुछ सामान्य संसाधनों और मापदंडों को केवल डिफ़ॉल्ट डोमेन में परिभाषित किया जा सकता है, इनमें नेटवर्क इंटरफेस, उपयोगकर्ता और एक्सेस कंट्रोल, एप्लिकेशन डोमेन और अन्य शामिल हैं।

एक एप्लिकेशन डोमेन अनुरोध प्रसंस्करण सेवाओं के लिए एक विकास खंड है। इसमें परिभाषित सेवाओं को किसी अन्य एप्लिकेशन डोमेन के साथ साझा नहीं किया जा सकता है। डेटापॉवर के पूर्ण पुनरारंभ की आवश्यकता के बिना, एप्लिकेशन डोमेन को अलग और स्वतंत्र रूप से फिर से शुरू किया जा सकता है।

आप डोमेन बना सकते हैं, पुनरारंभ कर सकते हैं, रीसेट कर सकते हैं, रोक सकते हैं, नवीनीकृत कर सकते हैं या हटा सकते हैं। आप आधिकारिक दस्तावेज में सभी प्रशासन सुविधाओं के बारे में अधिक विस्तृत जानकारी पा सकते हैं।

थोड़ा पूरा प्रोजेक्ट के बारे में। हमने 3 डोमेन का उपयोग किया:

• डिफ़ॉल्ट - साझा संसाधनों और मापदंडों वाले डिफ़ॉल्ट डोमेन;
• ट्रंक - प्रसंस्करण अनुरोधों के लिए आवश्यक सब कुछ युक्त मुख्य डोमेन;
• सेटिंग्स - सेटिंग्स और सुरक्षा डोमेन, स्थानीय फ़ाइलों में सेवा रूटिंग नियमों और सुरक्षा सेटिंग्स के बारे में जानकारी होती है।

एक सरल तैनाती पथ के लिए खोज के संबंध में एक अलग डोमेन के लिए सभी सेटिंग्स को स्थानांतरित करने की आवश्यकता है। जैसा कि कई परियोजनाओं में, देव, परीक्षण और ठेस वातावरण को अलग किया गया था, और एक अलग सेटिंग्स डोमेन में स्थानांतरण ने हमें पर्यावरण सेटिंग्स को खोने के जोखिम के बिना, निर्यात / आयात के माध्यम से अन्य वातावरण में देव वातावरण से सभी मुख्य डोमेन स्थापित करने की अनुमति दी।

2.2। अभ्यास

• खोज फ़ील्ड में, "डोमेन" दर्ज करें, "एप्लिकेशन डोमेन" चुनें और "जोड़ें" पर क्लिक करें
  
• यहां आपको डोमेन नाम निर्दिष्ट करना होगा, टिप्पणी (यदि वांछित हो) और ऑडिटिंग और लॉगिंग को सक्रिय करना होगा। खेतों में पानी भरें और बदलाव लागू करें
  
• इसी तरह एक और डोमेन "ट्रंक" जोड़ें
• बदलावों की समीक्षा करने जाएं
  
• और डोमेन कॉन्फ़िगरेशन को सहेजें
  
• आप नैविगेशन ट्री में डिफ़ॉल्ट डोमेन पर जाकर स्टेटस -> मुख्य -> ​​ऑब्जेक्ट स्टेटस में निर्मित वस्तुओं की स्थिति देख सकते हैं
  
• इसके द्वारा देखें: प्रकार चुनें
  
• सूची में एप्लिकेशन डोमेन खोजें और वस्तुओं की स्थिति की जांच करें: उनमें से प्रत्येक को सहेजना, चालू करना और अप स्थिति में होना चाहिए। यदि ऐसा है, तो अगले अध्याय को जारी रखें।

भाग 3. कतार प्रबंधक

कतार प्रबंधक आईबीएम डेटापावर का अनिवार्य घटक नहीं है, लेकिन यह एमक्यू के उदाहरण के माध्यम से है कि आप इस उत्पाद की पूरी शक्ति दिखा सकते हैं। हम IBM से MQ का उपयोग करेंगे। अध्याय 6 में वर्णित परीक्षण के दौरान, हमें स्थानीय कतार प्रबंधक को एक संदेश भेजने की आवश्यकता होगी। इस लेख में, मैं rfhutil उपयोगिता का उपयोग करके ऐसा करूंगा, लेकिन आप अपने लिए उपलब्ध किसी भी विधि का उपयोग कर सकते हैं। परीक्षण के लिए, आपको MQ कतार प्रबंधक का उपयोग करके DP से अपने स्थानीय कतार प्रबंधक के लिए एक कनेक्शन बनाने की आवश्यकता होगी।

3.1। सिद्धांत

कतार प्रबंधक गेटवे और दूरस्थ कतार प्रबंधकों के बीच डेटा विनिमय प्रदान करता है।

आप एमक्यू कतार प्रबंधक समूह को भी कॉन्फ़िगर कर सकते हैं, जिससे सिस्टम की गलती सहनशीलता बढ़ जाएगी। यह उपयोगी हो सकता है, उदाहरण के लिए, यदि आप क्लाइंट को काम करने वाले कतार प्रबंधकों के किसी सेट से और कुछ मामलों में कनेक्ट करना चाहते हैं, जिसे आप आधिकारिक दस्तावेज में पा सकते हैं।

परियोजना के अनुभव से, केवल एक विशेषता को नोट किया जाना चाहिए: एक समय में हम डेटापावर का उपयोग करके लोड संतुलन को लागू करने का प्रयास करना चाहते थे, विशेष रूप से, कतार प्रबंधकों के समूहों का उपयोग करते हुए, लेकिन व्यवहार में हमें ऐसा अवसर नहीं मिला। एक वैकल्पिक समाधान कतार प्रबंधकों का एक समूह बनाना है।

3.2। अभ्यास

3.2.1। ट्रेनिंग

1. WebSphere MQ स्थापित करें;
2. पोर्ट 3630 पर सुलभ एक स्थानीय LOCAL_DP_QM कतार प्रबंधक बनाएँ;
3. DP.SVRCONN चैनल कॉन्फ़िगर करें;
   
   

   चैनल बनाते समय, निम्नलिखित कमांड आपके लिए उपयोगी हो सकते हैं:

   
   

    strmqm LOCAL_DP_QM /*  mq*/ runmqsc LOCAL_DP_QM /*   mq*/ DEFINE CHANNEL (DP.SVRCONN) CHLTYPE(SVRCONN) MCAUSER('evlasenko') /* */ SET CHLAUTH('DP.SVRCONN') TYPE(USERMAP) CLNTUSER('evlasenko') USERSRC(channel) ADDRESS('*') ACTION(ADD) /*      */ SET CHLAUTH(DP.SVRCONN) TYPE(BLOCKUSER) USERLIST('nobody') /*   */ ALTER LISTENER (SYSTEM.DEFAULT.LISTENER.TCP) TRPTYPE(TCP) PORT(3630) control(QMGR) /*    3630*/ ALTER AUTHINFO (SYSTEM.DEFAULT.AUTHINFO.IDPWOS) AUTHTYPE(IDPWOS) CHCKCLNT(OPTIONAL) /* */ REFRESH SECURITY TYPE(CONNAUTH) /*  */ endmqm LOCAL_DP_QM /*  mq*/ strmqm LOCAL_DP_QM /*  mq*/ END 

   
   
4. कतार बनाएं DP.IIB.REQIN और DP.IIB.RESIN
5. जिस उपयोगकर्ता के लिए चैनल बनाया गया था उसके नाम के तहत rfhutil चलाएं। कतार प्रबंधक नाम में (कनेक्ट करने के लिए) पंक्ति, लिखें:
   
   

    DP.SVRCONN/TCT/127.0.0.1(3630) 

   
   
6. कतार नामों की सूची लोड करने का प्रयास करें; संदेश विंडो में कोई त्रुटि नहीं होनी चाहिए। चैनल से कनेक्शन सत्यापित किया गया है।
   

3.2.2। IBM MQ कतार प्रबंधक बनाएँ

1. ट्रंक डोमेन पर जाएं।
2. खोज में, MQ टाइप करें, IBM MQ Queue Manager का चयन करें, और Add पर क्लिक करें।
3. आपको नाम (TEST_QM), कतार प्रबंधक होस्टनाम, कतार प्रबंधक नाम और चैनल नाम निर्दिष्ट करने की आवश्यकता है, साथ ही साथ टाइमआउट भी। कॉन्फ़िगर करें और परिवर्तनों को सहेजें।
   
   

डोमेन की स्थिति की जाँच के रूप में उसी तरह कतार प्रबंधक वस्तु की स्थिति की जाँच करें। ऐसा करने के लिए, ऑब्जेक्ट स्थिति और दृश्य चुनें: प्रकार ट्रंक डोमेन से फ़िल्टर करें। "आईबीएम एमक्यू क्यू प्रबंधक" अनुभाग में, उचित ऑब्जेक्ट ढूंढें और इसकी स्थिति की जांच करें।

भाग 4. मल्टीप्रोटोकॉल गेटवे

4.1। सिद्धांत

मल्टी-प्रोटोकॉल गेटवे (एमपीजी) एक मल्टी-प्रोटोकॉल गेटवे है जो आपको विभिन्न प्रोटोकॉल का उपयोग करके ग्राहकों से अनुरोध प्राप्त करने की अनुमति देता है, और फिर उन्हें विभिन्न प्रोटोकॉल का उपयोग करके विभिन्न सर्वरों में स्थानांतरित करता है। क्लाइंट द्वारा उपयोग किया जाने वाला प्रोटोकॉल रिमोट एक्सेस सर्वर द्वारा उपयोग किए गए प्रोटोकॉल से मेल नहीं खा सकता है।

मुख्य MPG सेटिंग्स में, आप निम्नलिखित घटकों को परिभाषित कर सकते हैं:

• XML प्रबंधक - दस्तावेज़ों के कैशिंग, स्टाइल शीट (xsl, xslt) के संकलन और कैशिंग को नियंत्रित करता है।
• नीति - इसमें नियम शामिल हैं, जिनमें से प्रत्येक गेटवे से गुजरने वाले संदेश पर लागू किए गए कार्यों के एक सेट को परिभाषित करता है।
• फ्रंट और बैक साइड सेटिंग (url सेट करना, इनकमिंग और आउटगोइंग मैसेज के प्रकार, टाइमआउट और बहुत कुछ)।

परियोजना के बारे में कुछ शब्द:

परियोजना में 4 मल्टी-प्रोटोकॉल गेटवे (राउटिंग, विभिन्न अंत प्रणालियों के लिए 2 परिवर्तनशील और सेटिंग्स से फ़ाइलें प्राप्त करने के लिए डिज़ाइन किया गया एक अतिरिक्त) का उपयोग किया जाता है। नीचे दिए गए आरेख सामान्य इंटरैक्शन स्कीम को दिखाते हैं:

एमपीजी की मात्रा एक पूरे के रूप में समाधान की वास्तुकला के आधार पर भिन्न हो सकती है। हमारे मामले में, डेटापॉवर एक एकीकरण बस (IIB) और माइक्रोसर्विसेस का सामना करता है, जिसमें इंटरफेस (json / http बनाम xml / mq) के महत्वपूर्ण अंतर हैं, इसलिए प्रत्येक विशिष्ट बैकेंड के लिए परिवर्तनशील MPGs बनाने और उसके अनुसार नाम रखने का निर्णय लिया गया। सभी क्लाइंट के लिए, हम json / http पर काम करते हैं, इसलिए MPG को रूट करना एक है। मुख्य MPG में संदेशों के प्रसंस्करण के लिए 3 नियम होते हैं - अनुरोध, प्रतिक्रिया और त्रुटियां। प्रत्येक नियम में आवश्यक क्रियाएं शामिल हैं, जैसे कि परिवर्तन, लॉगिंग, रूटिंग और अन्य।

सुविधाओं से - यदि नीति में आप क्रिया ConvertQueryParamToXML का उपयोग करते हैं, तो InputConversion के प्रति चौकस रहें। यदि आप JSON पर डिफ़ॉल्ट एन्कोडिंग सेट करते हैं और GET अनुरोध भेजने का प्रयास करते हैं, तो आपको यह जानकर आश्चर्य होगा कि संदेश ने आपके द्वारा निर्दिष्ट किए गए किसी भी परिवर्तन से नहीं गुजरा है और आपको इसका कोई निशान नहीं मिलेगा। यह सुविधा GET अनुरोधों के लिए एक अलग नियम के निर्माण को दूर करने में मदद करेगी।

4.2। अभ्यास

4.2.1। ट्रेनिंग

आप लिंक पर काम करने के लिए आवश्यक सभी फाइलें https://github.com/EvgenyaVlasenko/IBM_DataPl.it पर पा सकते हैं

4.2.1.1। डोमेन ट्रंक

1. ट्रंक डोमेन पर जाएं।
2. नियंत्रण कक्ष में, फ़ाइल प्रबंधन का चयन करें।
3. स्थानीय निर्देशिका में, निम्न निर्देशिका संरचना बनाएं और उसमें संबंधित फ़ाइलों को रखें (प्रत्येक फ़ाइल में यह क्या कार्य करता है, साथ ही साथ लेख में बाद में इस बारे में अधिक विस्तृत चर्चा की गई एक संक्षिप्त विवरण शामिल है)।
   
   

4.2.1.2। डोमेन सेटिंग्स

1. सेटिंग डोमेन पर जाएं।
2. नियंत्रण कक्ष में, फ़ाइल प्रबंधन का चयन करें।
3. स्थानीय निर्देशिका में, निम्न निर्देशिका संरचना बनाएं और उसमें उपयुक्त फ़ाइलों को रखें (फाइलों में उनका संक्षिप्त विवरण भी होता है)।
   
   

4.2.2। GetFileMPG बनाएं

सबसे पहले, एक साधारण सहायक MPG बनाएं जो सेटिंग्स डोमेन से फाइलें लौटाएगा।

1. सेटिंग डोमेन पर जाएं।
2. नियंत्रण कक्ष में, मल्टी-प्रोटोकॉल गेटवे चुनें और क्रिएट पर क्लिक करें।
3. नाम (GetFileMPG), विवरण (वैकल्पिक), और बैकेंड प्रकार (गतिशील) निर्दिष्ट करें। वास्तव में, चूंकि बैकएंड पर कोई कॉल नहीं होगा, और केवल फ़ाइल स्थानीय सिस्टम से वापस आ जाएगी, इस उदाहरण में आप किसी भी प्रकार के बैकेंड को निर्दिष्ट कर सकते हैं।
   
   
4. अनुरोध और प्रतिक्रिया प्रकार निर्दिष्ट करें। स्पष्ट रूप से निर्दिष्ट प्रकार इनलाइन चेक की संख्या को कम कर देंगे। पास के प्रकार को निर्दिष्ट करने से आप एक नियम नहीं बना सकते हैं (इस मामले में, प्रतिक्रिया को बदलने के लिए)। यदि हम अनुरोध प्रकार को भी निर्दिष्ट करते हैं, तो हम संदेश को किसी भी तरह से संसाधित नहीं कर पाएंगे। यह विकल्प हमें शोभा नहीं देता है, इसलिए हम गैर-एक्सएमएल का उपयोग करके अनुरोध के प्रकार को प्रतिबंधित करते हैं।
   
   
   
5. + पर क्लिक करें और नया फ्रंट साइड प्रोटोकॉल बनाने के लिए HTTP हैंडलर का चयन करें।
   
   
   
6. यहां आपको एक नाम, आईपी-पता, पोर्ट और अनुमत विधियों की एक सूची निर्दिष्ट करनी चाहिए। आईपी ​​पते पर ध्यान दें। यदि आप 0.0.0.0 निर्दिष्ट करते हैं, तो हर कोई इस प्रवेश द्वार तक पहुंच सकता है। यदि 127.0.0.1 - एक ही DataPower के अंदर अन्य गेटवे। चूंकि सेटिंग्स के बीच सुरक्षा पैरामीटर हैं, हम दूसरे विकल्प का उपयोग करते हैं। फ़ील्ड भरें और "लागू करें" पर क्लिक करें, प्रोटोकॉल स्वचालित रूप से गेटवे में जोड़ा जाएगा।
   
   
   
7. नई नीति जोड़ने के लिए + पर क्लिक करें।
   
   
   
8. पॉलिसी का नाम "GetFilePolicy" भरें।
   
9. एक नया नियम बनाएं, नियम का नाम और दिशा भरें। चूंकि वास्तव में कोई बैकएंड नहीं है, और केवल वांछित फ़ाइल वापस आ गई है, केवल एक नियम (क्लाइंट से सर्वर) होगा।
   
   
   
10. इसे कॉन्फ़िगर करने के लिए मैच कार्रवाई पर डबल-क्लिक करें, मौजूदा नियम का चयन करें और परिवर्तन लागू करें। यह केवल वैचारिक अनुरोध प्राप्त करने की क्षमता पर प्रतिबंध लगाने के लिए वैचारिक रूप से सही होगा, लेकिन प्रशिक्षण कार्य के ढांचे के भीतर, आप मौजूदा एक का चयन कर सकते हैं।
    
11. एक और कार्रवाई जोड़ें - गेटवेस्क्रिप्ट को नियम पर खींचकर और इसे कॉन्फ़िगर करें। परिवर्तन के रूप में, हम तैयार फ़ाइल का उपयोग करेंगे, जो कि स्थानीय में: /// फ़ाइल सिस्टम फ़ाइल को आने वाले अनुरोध के यूआरआई से नाम से पता करेगा और इसे संदेश निकाय में रखेगा। ऑपरेशन का परिणाम सीधे नियम के आउटपुट बफर में स्थानांतरित किया जाएगा। परिवर्तन सहेजें।
    
    
    
12. अंतिम नीति परिणाम इस तरह दिखना चाहिए:
    
    
    
13. MPG निर्माण पूर्ण है, परिवर्तनों को सहेजें।
    
14. आप डोमेन की स्थिति और कतार प्रबंधक की जाँच के समान ऑब्जेक्ट स्थिति का उपयोग करके इसके निर्माण की सफलता को सत्यापित कर सकते हैं। ऐसा करने के लिए, सेटिंग डोमेन से ऑब्जेक्ट स्थिति और दृश्य चुनें: सेवाएँ फ़िल्टर करें। "मल्टी-प्रोटोकॉल गेटवे" अनुभाग में, संबंधित ऑब्जेक्ट को खोजें और उसकी स्थिति देखें।
    
15. आप इस MPG को बाहर से नहीं बुला सकते, क्योंकि आपने इसे ip से सुरक्षित किया है। अस्थायी रूप से आईपी को 127.0.0.1 से 0.0.0.0 तक और पोर्ट को 7171 से 7170 तक बदल दें और निम्नलिखित क्वेरी चलाएँ:
    
    

     curl -vv -k "http://192.168.99.100:7170/trunk/route/routeRules.xml" 

    
    
16. आपको निम्नलिखित उत्तर मिलना चाहिए:
    
    
    
17. दोबारा, आईपी और पोर्ट को मूल 127.0.0.1:7171 पर बदलें।
    

4.2.3। RoutingMPG बनाना

अब RoutingMPG बनाएं। इनपुट अनुरोध और रूटिंग नियमों के आधार पर, वह यह निर्धारित करेगा कि अनुरोध कहां और किन मापदंडों के साथ भेजा जाना चाहिए।

1. ट्रंक डोमेन पर जाएं।
2. निम्नलिखित मानों का उपयोग करते हुए खंड 4.2.2 के 2-10 खंडों के अनुसार एक नया मल्टी-प्रोटोकॉल गेटवे बनाएं:
   
   • 3 - नाम: रूटिंगएमपीजी, बैकएंड प्रकार: डायनामिक (यदि आवश्यक हो तो विभिन्न एमपीजी के लिए मार्ग अनुरोध की क्षमता के लिए)।
   • 4 - Rq: गैर- xml, रु: गैर- xml।
   • 6 - नाम: RoutingHTTP_FSH, ip: 0.0.0.0, port: 7170, + प्राप्त विधि।
   • 8 - नाम: रूटिंगपॉलिश।
   • 9 - नाम: RoutingPolicy_rule_req, दिशा: क्लाइंट से सर्वर।
   
   
3. अनुरोध को रूट करने के लिए एक और कार्रवाई जोड़ें। ऐसा करने के लिए, नियम पर "रूट" कार्रवाई खींचें, इसे कॉन्फ़िगर करने के लिए डबल-क्लिक करें, फ़ील्ड भरें और परिवर्तन लागू करें। Path.xsl फ़ाइल पहले प्राप्त किए गए GetFileMPG के माध्यम से सेटिंग डोमेन से रूटिंग सेटिंग्स फ़ाइल प्राप्त करता है। उसके बाद, यूआरआई के आधार पर, इस ऑपरेशन के लिए आवश्यक सेटिंग्स पहले से ही फ़ाइल से चुनी गई हैं। उनमें से कुछ का उपयोग रूट करने के लिए किया जाता है, और कुछ को अन्य एमपीजी में उपयोग के लिए हेडर में जोड़ा जाता है। इनपुट और आउटपुट पैरामीटर केवल संदेश निकाय के साथ काम करने का तरीका निर्धारित करते हैं और किसी भी तरह से हेडर और चर को प्रभावित नहीं करते हैं। इसलिए: अशक्त से इनपुट - चूंकि संदेश निकाय से जानकारी रूटिंग के लिए उपयोग नहीं किया जाता है। आउटपुट शून्य है - चूंकि परिवर्तन का परिणाम केवल सेवा की जानकारी में बदलाव है।
   
   
   
4. इसी तरह, 2 और नियम बनाएं और सभी परिवर्तनों को सहेजें:
   
   • दिशा: सर्वर-क्लाइंट, नाम: RoutingPolicy_rule_resp;
     परिवर्तन: इनपुट INPUT, आउटपुट NULL, परिवर्तन फ़ाइल स्थानीय: ///RoutMPG/transform/resp.xslt। Resp.xslt फ़ाइल परिवर्तन MPG प्रतिक्रिया की http स्थिति प्राप्त करती है और इसे स्पष्ट रूप से RoutingMPG प्रतिक्रिया पर सेट करती है। यदि ऐसा नहीं किया जाता है, तो डिफ़ॉल्ट कोड 200 में सेट हो जाएगा, भले ही रूपांतरण एमपीजी में कोई त्रुटि हुई हो।
     
   • दिशा: त्रुटि, नाम: RoutingPolicy_rule_error;
     परिवर्तन: इनपुट INPUT, आउटपुट PIPE (प्रलेखन के अनुसार, INPUT और OUTPUT के रूप में दो आसन्न क्रिया नोड्स के बीच PIPE का उपयोग करके अतिरिक्त प्रसंस्करण को समाप्त कर सकते हैं और उपयोग की जाने वाली मेमोरी को कम कर सकते हैं), परिवर्तन फ़ाइल स्थानीय है ///RoutMPG/transform/errors.xsl। त्रुटियों। Xsl फ़ाइल रूपांतरण MPG से प्रतिक्रिया से त्रुटि कोड और पाठ प्राप्त करती है और क्लाइंट द्वारा अपेक्षित प्रारूप में JSON त्रुटि संदेश उत्पन्न करती है।
     
   
   
5. अंतिम नीति परिणाम इस तरह दिखना चाहिए:
   
   
   
6. MPG निर्माण पूर्ण है, परिवर्तनों को सहेजें।
   
7. उदाहरण के लिए, कर्ल उपयोगिता का उपयोग करते हुए, निम्नलिखित क्वेरी चलाएँ:
   
   

    curl -vv -k "http://192.168.99.100:7170/dp/test/transformMessage" 

   
   
8. यदि आपको निम्न त्रुटि मिलती है, तो सब कुछ सही ढंग से किया जाता है। इस त्रुटि का मतलब है कि संदेश को सफलतापूर्वक प्राप्त किया गया था और संसाधित किया गया था, लेकिन बैकएंड (इस मामले में IIBMPG) को कॉल करने का प्रयास असफल रहा। अगले चरण पर जाएं।
   
   
   

4.2.4। IIBMPG का निर्माण

अगला कदम एक परिवर्तनकारी एमपीजी बनाना है। मान लीजिए कि बाहरी सिस्टम JSON अनुरोध प्रारूप में है और आंतरिक XML है। हमें इनपुट संदेश को बदलने की आवश्यकता है ताकि आंतरिक प्रणाली इसे समझ सके। यह ध्यान देने योग्य है कि यह हमेशा पूरे संदेश का एक साधारण रूपांतरण नहीं है। यह अक्सर एक पूरी तरह से पुनर्निर्मित संरचना के साथ, कभी-कभी एक छंटनी या संवर्धित संदेश को व्यक्त करने के लिए आवश्यक होता है।

1. ट्रंक डोमेन पर जाएं।
2. निम्नलिखित मानों का उपयोग करते हुए खंड 4.2.2 के 2-10 खंडों के अनुसार एक नया मल्टी-प्रोटोकॉल गेटवे बनाएं:
   
   • 3 - नाम: IIBMPG, बैकएंड प्रकार: गतिशील
   • 4 - Rq: JSON, रु: XML
   • 6 - नाम: IIBHTTP_FSH, आईपी: 127.0.0.1 (केवल समान डेटापॉवर से अनुरोध), पोर्ट: 7172, + प्राप्त विधि
   • 8 - नाम: IIBPolicy
   • 9 - नाम: IIBPolicy_rule_req, दिशा: क्लाइंट से सर्वर
   
   
3. विवरण जोड़ें। अनुरोध शीर्षलेखों में X-DP-Transform-Name के आधार पर, IIBRuleRoute.xsl फ़ाइल स्थानीय से प्राप्त होती है: ///IIB/route/IIBRouteRules.xml इस सेवा के लिए अनुरोध परिवर्तन, प्रतिक्रिया और त्रुटि फ़ाइलों के नाम दर्ज करते हैं और उनके मानों को संबंधित संदर्भ चर में सेट करते हैं। var: // Reference / IIB / reqTransform, var: // reference / IIB / ansTransform, var: // संदर्भ / IIB / इरेट्रांसफॉर्म। हेडर (url, uri, expire, timeout) से अन्य मान भी संदर्भ चर में रखे गए हैं।
   
   
   
4. अपने नियम में उन्नत खींचकर और सूची से XML में कनवर्ट क्वेरी परम का चयन करके एक और कार्रवाई जोड़ें, कॉन्फ़िगर करें। आपको एक नया इनपुट रूपांतरण मानचित्र जोड़ने की आवश्यकता है, इसे एक नाम (cmnJSONParseCNVM) और आवश्यक प्रकार (JSON) दिया गया है।
   
   
   
   
   
5. मानक रूपांतरण के बाद परिवर्तन जोड़ें और इसे कॉन्फ़िगर करें। इस स्थिति में, परिवर्तन फ़ाइल को इंगित करने के लिए पिछले परिवर्तन में सेट चर का उपयोग किया जाता है। यह किया जाता है ताकि परिवर्तन सार्वभौमिक हो, और इनपुट संदेश के आधार पर फ़ाइल को "मक्खी पर" प्रतिस्थापित किया जाए। संदेश निकाय तैयार है। अगला कदम संदेश को रूट करना है, और संदेश का शरीर नहीं बदलेगा, इसलिए हम dpvar_1 चर बनाते हैं और परिणाम को उसमें सहेजते हैं। यह चर है कि हम परिणाम कार्रवाई के लिए इनपुट को इंगित करते हैं। परिवर्तन सहेजें।
   
   
   
6. एक रूटिंग क्रिया जोड़ें और निम्न पैरामीटर सेट करें। IIBURLRoute.xsl फ़ाइल को संदर्भ चर के मान प्राप्त होते हैं, उनमें से कुछ को सेवा अनुरोध चर के रूप में सेट किया जाता है, और बाकी से यह गंतव्य प्रणाली के अनुरोध के लिए एक यूआरआई बनाता है, जो सेवा चर में भी संग्रहीत होता है।
   
   
   
7. इसी तरह, 2 और नियम बनाएं और सभी परिवर्तनों को सहेजें:
   
   • दिशा: सर्वर-क्लाइंट, नाम: IIBPolicy_rule_resp;
     परिवर्तन: इनपुट INPUT, आउटपुट PIPE, परिवर्तन फ़ाइल var: // संदर्भ / IIB / ansTransform (प्रतिक्रिया के परिवर्तन को प्रतिस्थापित करने के लिए संदर्भ चर "मक्खी पर")।
   • दिशा: त्रुटि, नाम: IIBPolicy_rule_error;
     परिवर्तन: इनपुट NULL, आउटपुट PIPE, परिवर्तन फ़ाइल var: // संदर्भ / IIB / इरेट्रांसफ़ॉर्म (संदर्भ परिवर्तन मक्खी पर त्रुटि परिवर्तन के लिए)।
   
   
8. अंतिम नीति परिणाम इस तरह दिखना चाहिए:
   
   
9. MPG निर्माण पूर्ण है, परिवर्तनों को सहेजें।
   

भाग 5. परीक्षण

5.1। ट्रेनिंग

1. उदाहरण के लिए, कतार में संदेशों को पढ़ने और लिखने के लिए rfhutil उपयोगिता;
2. परीक्षण फ़ाइलें प्रोजेक्ट फ़ाइलों के समान निर्देशिका के परीक्षण फ़ोल्डर में स्थित हैं।

5.2। स्वास्थ्य की जाँच

1. कर्ल उपयोगिता का उपयोग करके अनुरोध भेजें (नीचे अनुरोध के लिए, वर्तमान निर्देशिका example.json के समान होनी चाहिए)।
   
   

    curl -vv -k "http://192.168.99.100:7170/dp/test/transformMessage" -H "Content-Type: application/json" --data-binary @example.json 

   
   
2. Rfhutil उपयोगिता के 2 उदाहरण खोलें और पहले उदाहरण के साथ DP.IIB.REQIN कतार से संदेश घटाएं;
   
3. MQMD टैब पर जाएं और MessageID को कॉपी करें;
   
4. दूसरे उदाहरण में, RQxml फ़ाइल खोलें, MQMD टैब में, CorrelID में संदेश पहचानकर्ता डालें और DP.IIB.RESIN कतार में संदेश डालें;
   
5. आपको एक समान उत्तर मिलना चाहिए:
   
   
   
6. दोहराएं चरण 1-3;
   
7. rs_error.xml correllId;
   
8. 
   
   
   

6.

6.1। सिद्धांत

Log Targets , .

Log Targets . , 4 1000Kb, . 2-4 . , . , DataPower, , , , , , - MPG, .

6.2.

1. trunk;
2. Log Target ;
3. :
   
   • (IIB_LOG);
   • (File);
   • (Text);
   • timestamp(zulu);
   • (logtemp:///IIB.log — IIBMPG);
   • (1000).
     
     
   
   
4. . MPG IIBMPG.
   
   
   
5. , , ( , ).
   
   
   
6. ;
   
7. ;
   
8. .
   
9. Log Targets MPG.
   
10. :
    
    • , , .
      
      
      
    • .
      
      
      
    
    

7. -

1. – , . – , , - .
   
2. . View Logs. , « », « » .
   
3. . . MPG Show Probe -> Enable Probe. . , .
   
   
   
4. , .
   

– .