एज इंस्टॉलेशन की खास जानकारी

Edge for Private Cloud v. 4.17.05

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

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

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

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

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

Apigee 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 के पूरे ऐक्सेस वाला उपयोगकर्ता बनाना

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

कॉन्फ़िगरेशन फ़ाइलों पर अनुमतियां सेट करना

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

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

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

रूट और नॉन-रूट उपयोगकर्ता के लिए, Edge इंस्टॉल करने के टास्क अलग-अलग करना

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

1. रूट से की गई कार्रवाइयां:
   1. bootstrap_4.17.05.sh फ़ाइल डाउनलोड करें और चलाएं:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
      
      यह चरण, apigee-service यूटिलिटी को इंस्टॉल करता है और "apigee" उपयोगकर्ता बनाता है.
   2. किसी उपयोगकर्ता को "apigee" उपयोगकर्ता के लिए sudo का पूरा ऐक्सेस देने के लिए, ऊपर बताया गया तरीका अपनाएं.
   3. apigee-setup यूटिलिटी इंस्टॉल करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. नोड पर Edge आरपीएम इंस्टॉल करने के लिए, apigee-setup यूटिलिटी का इस्तेमाल करें:
      > /opt/apigee/apigee-service/bin/apigee-service compName install
      
      नोड पर इंस्टॉल किए जाने वाले Edge आरपीएम, आपकी टोपोलॉजी पर निर्भर करते हैं. उपलब्ध कॉम्पोनेंट की सूची में ये शामिल हैं: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-ui, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.
2. रूट उपयोगकर्ता, नोड पर Edge आरपीएम इंस्टॉल करता है. इसके बाद, "apigee" उपयोगकर्ता के लिए sudo का पूरा ऐक्सेस रखने वाला उपयोगकर्ता, कॉन्फ़िगरेशन की प्रोसेस पूरी करता है:
   1. नोड पर Edge कॉम्पोनेंट का कॉन्फ़िगरेशन पूरा करने के लिए, setup.sh यूटिलिटी का इस्तेमाल करें. कमांड का फ़ॉर्म, उन कॉम्पोनेंट पर निर्भर करता है जिन्हें आपने नोड पर इंस्टॉल किया है. पूरी सूची देखने के लिए, नोड पर Edge कॉम्पोनेंट इंस्टॉल करना लेख पढ़ें.
      उदाहरण के लिए, ZooKeeper और Cassandra का इंस्टॉलेशन पूरा करने के लिए, इस कमांड का इस्तेमाल करें:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
      
      जहां configFile, Edge की कॉन्फ़िगरेशन फ़ाइल है.
      
      इसके अलावा, एक ही बार में सभी कॉम्पोनेंट इंस्टॉल करने के लिए, इस निर्देश का इस्तेमाल करें:
      > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइलों की जगह

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

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

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

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

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

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

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

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

Edge के वर्शन को मैनेज करने के लिए, Edge की लोकल रिपॉज़िटरी का इस्तेमाल करना

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

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

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

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

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

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

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

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 में, रूट इंस्टॉलेशन डायरेक्ट्री को इस तरह नोट किया गया है:

/opt/apigee

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

लॉग फ़ाइलें

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

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

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

यहां दी गई टेबल में, लॉग फ़ाइलों की जगह की जानकारी दी गई है:

डेटा

इंस्टॉल करने के बाद किए जाने वाले टास्क

इंस्टॉल होने के बाद, Edge के कॉम्पोनेंट पर अन्य कार्रवाइयां की जा सकती हैं.

इंस्टॉलेशन के बाद, 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 कॉम्पोनेंट पर कमांड लागू करना

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