इंस्टॉल करने से जुड़ी ज़रूरी बातें

Edge for Private Cloud v. 4.16.05

Edge के सामान्य इंस्टॉलेशन में, Edge के कॉम्पोनेंट कई नोड में बंटे होते हैं. किसी नोड पर Edge इंस्टॉल करने के बाद, उस नोड पर एक या उससे ज़्यादा Edge कॉम्पोनेंट इंस्टॉल और कॉन्फ़िगर किए जाते हैं.

इंस्टॉल करने की प्रोसेस

किसी नोड पर Edge इंस्टॉल करने की प्रोसेस में कई चरण शामिल होते हैं:

• नोड पर SELinux को बंद करें या इसे परमिट मोड पर सेट करें. ज़्यादा जानकारी के लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करना लेख पढ़ें.
• सुझाई गई टोपोलॉजी की सूची में से, अपने Edge का कॉन्फ़िगरेशन चुनें. उदाहरण के लिए, टेस्टिंग के लिए Edge को एक नोड पर इंस्टॉल किया जा सकता है या प्रोडक्शन के लिए 13 नोड पर इंस्टॉल किया जा सकता है. ज़्यादा जानकारी के लिए, इंस्टॉलेशन टोपोलॉजी देखें.
• चुनी गई टोपोलॉजी के हर नोड पर, Edge apigee-setup यूटिलिटी इंस्टॉल करें:
  • Edge bootstrap_4.16.05.sh फ़ाइल को /tmp/bootstrap_4.16.05.sh में डाउनलोड करें.
  • Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें.
  • Edge apigee-setup यूटिलिटी और डिपेंडेंसी इंस्टॉल करें.
    
    ज़्यादा जानकारी के लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करना लेख पढ़ें.
• चुनी गई टोपोलॉजी के आधार पर, हर नोड पर एक या उससे ज़्यादा Edge कॉम्पोनेंट इंस्टॉल करने के लिए, apigee-setup यूटिलिटी का इस्तेमाल करें.
  किसी नोड पर Edge कॉम्पोनेंट इंस्टॉल करने का तरीका देखें.
• मैनेजमेंट सर्वर नोड पर, apigee-provision को इंस्टॉल करने के लिए, apigee-setup यूटिलिटी का इस्तेमाल करें. यह ऐसी यूटिलिटी है जिसका इस्तेमाल Edge संगठनों को बनाने और मैनेज करने के लिए किया जाता है.
  ज़्यादा जानकारी के लिए, किसी संगठन को शामिल करना लेख पढ़ें.

इंस्टॉल न हो पाने की समस्या को हल करना

Edge कॉम्पोनेंट इंस्टॉल करते समय कोई गड़बड़ी होने पर, उसे ठीक करने की कोशिश करें. इसके बाद, इंस्टॉलर को फिर से चलाएं. इंस्टॉलर को इस तरह डिज़ाइन किया गया है कि अगर उसे किसी गड़बड़ी का पता चलता है, तो वह बार-बार चलाया जा सके. इसके अलावा, अगर आपको इंस्टॉलेशन के बाद किसी कॉम्पोनेंट को बदलना या अपडेट करना है, तो भी इंस्टॉलर को बार-बार चलाया जा सकता है.

Postgres मास्टर-स्टैंडबाय रेप्लिकेशन को कॉन्फ़िगर करना

डिफ़ॉल्ट रूप से, Edge सभी Postgres नोड को मास्टर मोड में इंस्टॉल करता है. हालांकि, कई Postgres नोड वाले प्रोडक्शन सिस्टम में, उन्हें मास्टर-स्टैंडबाय रेप्लिकेशन का इस्तेमाल करने के लिए कॉन्फ़िगर किया जाता है. इससे, मास्टर नोड के काम न करने पर, स्टैंडबाय नोड सर्वर ट्रैफ़िक को जारी रख सकता है. ज़्यादा जानकारी के लिए, Postgres के लिए मास्टर-स्टैंडबाय रेप्लिकेशन सेट अप करना लेख पढ़ें.

ऐप्लिकेशन कौन इंस्टॉल कर सकता है

Apigee Edge की डिस्ट्रिब्यूशन फ़ाइलें, आरपीएम और डिपेंडेंसी के सेट के तौर पर इंस्टॉल की जाती हैं. Edge को इंस्टॉल, अनइंस्टॉल, और अपडेट करने के लिए, Edge के कमांड को रूट उपयोगकर्ता या ऐसे उपयोगकर्ता को चलाना चाहिए जिसके पास sudo का पूरा ऐक्सेस हो. पूरे sudo ऐक्सेस का मतलब है कि उपयोगकर्ता के पास sudo ऐक्सेस है, ताकि वह रूट के तौर पर वही कार्रवाइयां कर सके.

इन निर्देशों या स्क्रिप्ट को चलाने वाले उपयोगकर्ता के पास रूट ऐक्सेस या sudo का पूरा ऐक्सेस होना चाहिए:

• apigee-service यूटिलिटी:
  • apigee-service कमांड: install, uninstall, update.
  • apigee-all कमांड: install, uninstall, update.
• Edge कॉम्पोनेंट इंस्टॉल करने के लिए, setup.sh स्क्रिप्ट (जब तक आपने ज़रूरी आरपीएम इंस्टॉल करने के लिए, "apigee-service install" का इस्तेमाल न किया हो. इसके बाद, रूट या sudo का पूरा ऐक्सेस दें. हालांकि, ऐसा तब करें, जब इसकी ज़रूरत न हो.)
• Edge के कॉम्पोनेंट अपडेट करने के लिए, update.sh स्क्रिप्ट

इसके अलावा, Edge इंस्टॉलर आपके सिस्टम पर "apigee" नाम का एक नया उपयोगकर्ता बनाता है. Edge के कई निर्देश, "apigee" उपयोगकर्ता के तौर पर चलाने के लिए sudo को शुरू करते हैं.

अगर किसी उपयोगकर्ता को ऊपर दिखाए गए कमांड के अलावा, अन्य सभी कमांड चलाने हैं, तो उसके पास "apigee" उपयोगकर्ता के लिए, sudo का पूरा ऐक्सेस होना चाहिए. इन निर्देशों में ये शामिल हैं:

• apigee-service यूटिलिटी कमांड, जिनमें ये शामिल हैं:
  • apigee-service कमांड, जैसे कि start, stop, restart, configure.
  • apigee-all कमांड, जैसे कि start, stop, restart, configure.

किसी उपयोगकर्ता को "apigee" उपयोगकर्ता के लिए sudo का पूरा ऐक्सेस देने के लिए, sudoers फ़ाइल में बदलाव करें और यह जोड़ें:

installUser        ALL=(apigee)      NOPASSWD: ALL

जहां installUser, Edge के साथ काम करने वाले व्यक्ति का उपयोगकर्ता नाम है.

Edge कमांड से इस्तेमाल की जाने वाली सभी फ़ाइलें या संसाधन, "apigee" उपयोगकर्ता के लिए ऐक्सेस किए जा सकने चाहिए. इसमें Edge की लाइसेंस फ़ाइल और कोई भी कॉन्फ़िगरेशन फ़ाइल शामिल है.

कॉन्फ़िगरेशन फ़ाइल बनाते समय, उसके मालिक को "apigee:apigee" में बदला जा सकता है. इससे यह पक्का किया जा सकता है कि Edge कमांड से उसे ऐक्सेस किया जा सके:

1. किसी भी उपयोगकर्ता के तौर पर, एडिटर में फ़ाइल बनाएं.
2. फ़ाइल के मालिक को "apigee:apigee" पर सेट करें. इसके अलावा, अगर आपने Edge सेवा को चलाने वाले उपयोगकर्ता को "apigee" उपयोगकर्ता से बदल दिया है, तो फ़ाइल को Edge सेवा चलाने वाले उपयोगकर्ता पर सेट करें.

Edge के कॉम्पोनेंट का साइलेंट इंस्टॉलेशन

आपको apigee-setup यूटिलिटी को एक कॉन्फ़िगरेशन फ़ाइल पास करनी होगी. इसमें Edge इंस्टॉलेशन के बारे में जानकारी होती है. साइलेंट इंस्टॉलेशन के लिए सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके. उदाहरण के लिए, फ़ाइल को नोड पर /tmp डायरेक्ट्री में डालें और उसे "apigee:apigee" पर chown करें.

कॉन्फ़िगरेशन फ़ाइल में मौजूद सभी जानकारी ज़रूरी है. हालांकि, Edge सिस्टम एडमिन का पासवर्ड ज़रूरी नहीं है. अगर आपने पासवर्ड नहीं डाला है, तो apigee-setup यूटिलिटी आपको कमांड लाइन पर पासवर्ड डालने के लिए कहेगी.

ज़्यादा जानकारी के लिए, नोड पर Edge कॉम्पोनेंट इंस्टॉल करना लेख पढ़ें.

इंटरनेट या बिना इंटरनेट के इंस्टॉल करना

किसी नोड पर Edge इंस्टॉल करने के लिए, नोड के पास Apigee डेटाबेस को ऐक्सेस करने की अनुमति होनी चाहिए:

• बाहरी इंटरनेट कनेक्शन वाले नोड
  
  बाहरी इंटरनेट कनेक्शन वाले नोड, Edge आरपीएम और डिपेंडेंसी इंस्टॉल करने के लिए, Apigee रिपॉज़िटरी को ऐक्सेस करते हैं.
• बाहरी इंटरनेट कनेक्शन के बिना काम करने वाले नोड
  
  बाहरी इंटरनेट कनेक्शन के बिना काम करने वाले नोड, Apigee रिपॉज़िटरी के उस मिरर किए गए वर्शन को ऐक्सेस कर सकते हैं जिसे आपने इंटरनल तौर पर सेट अप किया है. इस रिपॉज़िटरी में सभी Edge RPM मौजूद हैं. हालांकि, आपको यह पक्का करना होगा कि आपके पास इंटरनल नेटवर्क पर मौजूद रिपॉज़िटरी से, अन्य सभी डिपेंडेंसी उपलब्ध हों.

आरपीएम इंस्टॉल करने से जुड़ी डिपेंडेंसी की समस्या हल करना

Apigee Edge डिस्ट्रिब्यूशन फ़ाइलें, आरपीएम फ़ाइलों के सेट के तौर पर इंस्टॉल की जाती हैं. इनमें से हर फ़ाइल की अपनी इंस्टॉल डिपेंडेंसी चेन हो सकती है. इनमें से कई डिपेंडेंसी, तीसरे पक्ष के कॉम्पोनेंट से तय होती हैं. ये कॉम्पोनेंट, Apigee के कंट्रोल से बाहर होते हैं और इनमें कभी भी बदलाव हो सकता है. इसलिए, दस्तावेज़ में हर डिपेंडेंसी का वर्शन नंबर साफ़ तौर पर नहीं बताया गया है.

अगर इंटरनेट का ऐक्सेस वाली मशीन पर इंस्टॉल किया जा रहा है, तो नोड ज़रूरी आरपीएम और डिपेंडेंसी डाउनलोड कर सकता है. हालांकि, अगर आपको इंटरनेट ऐक्सेस के बिना किसी नोड से इंस्टॉल करना है, तो आम तौर पर आपको एक इंटरनल रिपॉज़िटरी सेट अप करनी होगी. इसमें सभी ज़रूरी डिपेंडेंसी शामिल होती हैं. यह पक्का करने का एकमात्र तरीका है कि सभी डिपेंडेंसी आपके लोकल रिपॉज़िटरी में शामिल हों. इसके लिए, आपको इंस्टॉलेशन की कोशिश करनी होगी, किसी भी मौजूद डिपेंडेंसी की पहचान करनी होगी, और उन्हें लोकल रिपॉज़िटरी में कॉपी करना होगा. ऐसा तब तक करना होगा, जब तक इंस्टॉलेशन पूरा न हो जाए.

वर्चुअल होस्ट सेट अप करना

Edge पर मौजूद वर्चुअल होस्ट, उन डोमेन और Edge राऊटर पोर्ट के बारे में बताता है जिन पर एपीआई प्रॉक्सी को एक्सपोज़ किया जाता है. साथ ही, यह उस यूआरएल के बारे में भी बताता है जिसका इस्तेमाल ऐप्लिकेशन, एपीआई प्रॉक्सी को ऐक्सेस करने के लिए करते हैं. वर्चुअल होस्ट से यह भी तय होता है कि एपीआई प्रॉक्सी को एचटीटीपी प्रोटोकॉल का इस्तेमाल करके ऐक्सेस किया जाए या एन्क्रिप्ट किए गए एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करके.

Edge में शामिल होने की प्रोसेस के तहत, आपको एक संगठन, एनवायरमेंट, और वर्चुअल होस्ट बनाना होगा. Edge, नए उपयोगकर्ताओं के लिए इस प्रोसेस को आसान बनाने के लिए, setup-org कमांड उपलब्ध कराता है.

वर्चुअल होस्ट बनाते समय, आपको यह जानकारी देनी होगी:

• वर्चुअल होस्ट का नाम, जिसका इस्तेमाल एपीआई प्रॉक्सी में रेफ़रंस के तौर पर किया जाता है.
• वर्चुअल होस्ट के लिए, राऊटर पर मौजूद पोर्ट. आम तौर पर, ये पोर्ट 9001 से शुरू होते हैं और हर नए वर्चुअल होस्ट के लिए एक-एक करके बढ़ते हैं.
• वर्चुअल होस्ट का होस्ट उपनाम. आम तौर पर, वर्चुअल होस्ट का डीएनएस नेम.

Edge Router, आने वाले अनुरोध के होस्ट हेडर की तुलना, उपलब्ध होस्ट के उपनामों की सूची से करता है. इससे, अनुरोध को मैनेज करने वाले एपीआई प्रॉक्सी का पता चलता है. वर्चुअल होस्ट के ज़रिए अनुरोध करते समय, वर्चुअल होस्ट के होस्ट उपनाम से मैच करने वाला डोमेन नेम डालें. इसके अलावा, राऊटर का आईपी पता और होस्ट उपनाम वाला होस्ट हेडर डालें.

उदाहरण के लिए, अगर आपने पोर्ट 9001 पर myapis.apigee.net के होस्ट उपनाम के साथ कोई वर्चुअल होस्ट बनाया है, तो उस वर्चुअल होस्ट के ज़रिए किसी एपीआई को cURL अनुरोध भेजने के लिए, इनमें से किसी एक फ़ॉर्म का इस्तेमाल किया जा सकता है:

• अगर आपके पास myapis.apigee.net के लिए डीएनएस एंट्री है, तो:
  
  curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}
• अगर आपके पास myapis.apigee.net के लिए डीएनएस एंट्री नहीं है, तो:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
  
  इस फ़ॉर्म में, आपको राऊटर का आईपी पता डालना होगा. साथ ही, होस्ट हेडर में होस्ट का उपनाम डालना होगा.
  
  ध्यान दें: curl कमांड, ज़्यादातर ब्राउज़र, और कई अन्य सुविधाएं, अनुरोध के हिस्से के तौर पर डोमेन के साथ होस्ट हेडर को अपने-आप जोड़ देती हैं. इसलिए, curl कमांड का इस्तेमाल इस तरह किया जा सकता है:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}

वर्चुअल होस्ट के लिए डीएनएस एंट्री न होने पर उपलब्ध विकल्प

अगर आपके पास डीएनएस एंट्री नहीं है, तो होस्ट के उपनाम को राऊटर के आईपी पते और वर्चुअल होस्ट के पोर्ट पर सेट करें. इसके लिए, <routerIP>:port का इस्तेमाल करें. उदाहरण के लिए:

192.168.1.31:9001

इसके बाद, नीचे दिए गए फ़ॉर्म में curl कमांड बनाएं:

curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} 

इस विकल्प को प्राथमिकता दी जाती है, क्योंकि यह Edge के यूज़र इंटरफ़ेस (यूआई) के साथ अच्छी तरह से काम करता है.

अगर आपके पास एक से ज़्यादा राऊटर हैं, तो हर राऊटर के लिए एक होस्ट उपनाम जोड़ें. साथ ही, हर राऊटर का आईपी पता और वर्चुअल होस्ट का पोर्ट बताएं.

इसके अलावा, होस्ट के उपनाम को किसी वैल्यू पर सेट किया जा सकता है. जैसे, temp.hostalias.com. इसके बाद, आपको हर अनुरोध पर होस्ट हेडर पास करना होगा:

curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path}  -H 'host: temp.hostalias.com'

इसके अलावा, /etc/hosts फ़ाइल में होस्ट का दूसरा नाम जोड़ें. उदाहरण के लिए, /etc/hosts में यह लाइन जोड़ें:

192.168.1.31   temp.hostalias.com

इसके बाद, अनुरोध किया जा सकता है. ऐसा लगेगा कि आपके पास डीएनएस एंट्री है:

curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}

इंस्टॉलेशन के बाद, Edge के कॉम्पोनेंट कॉन्फ़िगर करना

इंस्टॉल करने के बाद Edge को कॉन्फ़िगर करने के लिए, .properties फ़ाइलों और Edge की सुविधाओं का इस्तेमाल किया जाता है. उदाहरण के लिए, Edge के यूज़र इंटरफ़ेस (यूआई) पर टीएलएस/एसएसएल को कॉन्फ़िगर करने के लिए, .properties फ़ाइलों में बदलाव करके ज़रूरी प्रॉपर्टी सेट की जाती हैं. .properties फ़ाइलों में बदलाव करने के लिए, आपको Edge के उस कॉम्पोनेंट को रीस्टार्ट करना होगा जिस पर असर पड़ा है.

.properties फ़ाइलें, /opt/apigee/customer/application डायरेक्ट्री में मौजूद होती हैं. हर कॉम्पोनेंट की अपनी .properties फ़ाइल होती है, जो उस डायरेक्ट्री में मौजूद होती है. उदाहरण के लिए, router.properties और management-server.properties.

किसी कॉम्पोनेंट के लिए प्रॉपर्टी सेट करने के लिए, उससे जुड़ी .properties फ़ाइल में बदलाव करें. इसके बाद, कॉम्पोनेंट को रीस्टार्ट करें:

> /opt/apigee/apigee-service/bin/apigee-service component restart

उदाहरण के लिए:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Edge को अपडेट करने पर, /opt/apigee/customer/application डायरेक्ट्री में मौजूद .properties फ़ाइलें पढ़ी जाती हैं. इसका मतलब है कि अपडेट करने पर, कॉम्पोनेंट पर सेट की गई कोई भी प्रॉपर्टी बनी रहती है.

Edge के कॉन्फ़िगरेशन के बारे में ज़्यादा जानकारी के लिए, Edge को कॉन्फ़िगर करने का तरीका देखें.

पक्का करें कि Edge राऊटर, /etc/rc.d/init.d/functions को ऐक्सेस कर सके

Edge राऊटर और BaaS पोर्टल, दोनों Nginx राऊटर का इस्तेमाल करते हैं. साथ ही, उन्हें /etc/rc.d/init.d/functions के लिए रीड ऐक्सेस की ज़रूरत होती है.

अगर आपकी सुरक्षा प्रक्रिया के लिए, आपको /etc/rc.d/init.d/functions पर अनुमतियां सेट करनी हैं, तो उन्हें 700 पर सेट न करें. ऐसा करने पर, राऊटर चालू नहीं होगा. अनुमतियों को 744 पर सेट किया जा सकता है, ताकि /etc/rc.d/init.d/functions को पढ़ने का ऐक्सेस दिया जा सके.

Edge कॉम्पोनेंट पर कमांड लागू करना

Edge, /opt/apigee/apigee-service/bin में मैनेजमेंट यूटिलिटी इंस्टॉल करता है. इनका इस्तेमाल करके, Edge इंस्टॉलेशन को मैनेज किया जा सकता है. उदाहरण के लिए, नोड पर सभी Edge कॉम्पोनेंट को शुरू करने, रोकने, रीस्टार्ट करने या उनकी स्थिति का पता लगाने के लिए, apigee-all यूटिलिटी का इस्तेमाल किया जा सकता है:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

अलग-अलग कॉम्पोनेंट को कंट्रोल और कॉन्फ़िगर करने के लिए, apigee-service यूटिलिटी का इस्तेमाल करें. apigee-service यूटिलिटी का फ़ॉर्मैट इस तरह का होता है:

/opt/apigee/apigee-service/bin/apigee-service component action

उदाहरण के लिए, Edge राऊटर को रीस्टार्ट करने के लिए:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

/opt/apigee डायरेक्ट्री की जांच करके, नोड पर इंस्टॉल किए गए कॉम्पोनेंट की सूची देखी जा सकती है. उस डायरेक्ट्री में, नोड पर इंस्टॉल किए गए हर Edge कॉम्पोनेंट के लिए एक सबडायरेक्ट्री होती है. हर सबडायरेक्ट्री के नाम से पहले यह प्रीफ़िक्स होता है:

• apigee - तीसरे पक्ष का कॉम्पोनेंट, जिसका इस्तेमाल Edge करता है. उदाहरण के लिए, apigee-cassandra.
• edge - Apigee का एक Edge कॉम्पोनेंट. उदाहरण के लिए, edge-management-server.
• edge-mint - कमाई करने की सुविधा वाला कॉम्पोनेंट. उदाहरण के लिए, edge-mint-management-server.
• baas - एपीआई BaaS कॉम्पोनेंट. उदाहरण के लिए, baas-usergrid.

किसी कॉम्पोनेंट के लिए कार्रवाइयों की पूरी सूची, उस कॉम्पोनेंट पर निर्भर करती है. हालांकि, सभी कॉम्पोनेंट के लिए ये कार्रवाइयां की जा सकती हैं:

• चालू करना, बंद करना, रीस्टार्ट करना
• status, version
• बैकअप, रीस्टोर
• install, uninstall

लॉग फ़ाइलें ऐक्सेस करना

apigee-setup और setup.sh स्क्रिप्ट की लॉग फ़ाइल, /tmp/setup-root.log में लिखी जाती है.

हर कॉम्पोनेंट की लॉग फ़ाइलें, /opt/apigee/var/log डायरेक्ट्री में मौजूद होती हैं. हर कॉम्पोनेंट की अपनी सबडायरेक्ट्री होती है. उदाहरण के लिए, मैनेजमेंट सर्वर के लॉग इस डायरेक्ट्री में होते हैं:

/opt/apigee/var/log/edge-management-server

Yum के सामान्य निर्देश

Linux के लिए Edge इंस्टॉलेशन टूल, कॉम्पोनेंट इंस्टॉल और अपडेट करने के लिए Yum का इस्तेमाल करते हैं. किसी नोड पर इंस्टॉल करने के तरीके को मैनेज करने के लिए, आपको कई Yum कमांड इस्तेमाल करने पड़ सकते हैं.

• सभी Yum कैश मेमोरी मिटाएं:
  sudo yum clean all
• Edge कॉम्पोनेंट को अपडेट करने के लिए:
  sudo yum update componentName
  उदाहरण के लिए:
  sudo yum update apigee-setup
  sudo yum update edge-management-server

फ़ाइल सिस्टम का स्ट्रक्चर

Edge, सभी फ़ाइलों को /opt/apigee डायरेक्ट्री में इंस्टॉल करता है.

इस गाइड और Edge Operations Guide में, रूट इंस्टॉलेशन डायरेक्ट्री को इस तरह नोट किया गया है:

<inst_root>/apigee

Apigee Edge for Private Cloud को डिप्लॉय करने के लिए, इंस्टॉलेशन के दौरान इस फ़ाइल सिस्टम स्ट्रक्चर का इस्तेमाल किया जाता है.

लॉग फ़ाइलें

डेटा