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

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

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

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

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

      ज़्यादा जानकारी के लिए, Edge apigee-setup सुविधा को इंस्टॉल करना लेख पढ़ें.

  6. अपनी चुनी गई टोपोलॉजी के आधार पर, हर नोड पर एक या उससे ज़्यादा Edge कॉम्पोनेंट इंस्टॉल करने के लिए apigee-setup सुविधा का इस्तेमाल करें.

    किसी नोड पर Edge कॉम्पोनेंट इंस्टॉल करना देखें.

  7. मैनेजमेंट सर्वर नोड पर, apigee-setup यूटिलिटी का इस्तेमाल apigee-provision इंस्टॉल करने के लिए करें. यह ऐसी सुविधाएं हैं जिनका इस्तेमाल Edge संगठन बनाने और उन्हें मैनेज करने के लिए किया जाता है.

    ज़्यादा जानकारी के लिए, किसी संगठन को शामिल करना लेख पढ़ें.

  8. इंस्टॉल पूरा होने के बाद, हर नोड पर क्लासिक यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें, जैसा कि नीचे दिए गए उदाहरण में बताया गया है: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (इसका सुझाव दिया जाता है) शुरुआती इंस्टॉलेशन पूरा करने के बाद, Apigee का सुझाव है कि आप नया Edge यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करें. इसके कॉम्पोनेंट का नाम edge-management-ui है. यह प्राइवेट क्लाउड के लिए Apigee Edge के डेवलपर और एडमिन के लिए बेहतर यूज़र इंटरफ़ेस है.

    ज़्यादा जानकारी के लिए, नया Edge यूआई इंस्टॉल करें देखें.

इंस्टॉलेशन पूरा होने के बाद, इंस्टॉल करने के बाद होने वाली सामान्य कार्रवाइयों की यह सूची देखें.

इंस्टॉल कौन कर सकता है

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

अगर कोई उपयोगकर्ता नीचे दिए गए निर्देश या स्क्रिप्ट चलाना चाहता है, तो उसका रूट होना ज़रूरी है या उसे ऐसा उपयोगकर्ता होना चाहिए जिसके पास सूडो का पूरा ऐक्सेस हो:

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

साथ ही, Edge इंस्टॉलर आपके सिस्टम पर "apigee" नाम से एक नया उपयोगकर्ता बनाता है. कई Edge कमांड, "apigee" उपयोगकर्ता के तौर पर चलने के लिए sudo का इस्तेमाल करते हैं.

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

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

"apigee" उपयोगकर्ता के लिए, पूरा सूडो ऐक्सेस वाला उपयोगकर्ता बनाना

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

Edge इंस्टॉल करने के टास्क को रूट और नॉन-रूट उपयोगकर्ता के बीच अलग-अलग करना

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

  1. रूट की मदद से किए गए टास्क:
    1. bootstrap_4.52.02.sh फ़ाइल डाउनलोड करें और चलाएं: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      यह चरण apigee-service यूटिलिटी इंस्टॉल करता है और "apigee" उपयोगकर्ता बनाता है.

    2. उपयोगकर्ता को "apigee" उपयोगकर्ता का पूरा सूडो ऐक्सेस पाने के लिए कॉन्फ़िगर करें. इसके बारे में, "apigee" उपयोगकर्ता के लिए पूरा सूडो ऐक्सेस वाला उपयोगकर्ता बनाना सेक्शन में बताया गया है.
    3. apigee-setup यूटिलिटी इंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. नोड पर एज आरपीएम इंस्टॉल करने के लिए, apigee-setup सुविधा का इस्तेमाल करें: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      नोड पर इंस्टॉल किए जाने वाले एज आरपीएम, आपकी टोपोलॉजी के हिसाब से तय होते हैं. उपलब्ध कॉम्पोनेंट की सूची में यह जानकारी शामिल है: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

  2. नोड पर रूट उपयोगकर्ता के एज आरपीएम इंस्टॉल करने के बाद, वह उपयोगकर्ता कॉन्फ़िगरेशन प्रोसेस पूरी करता है जिसके पास "apigee" उपयोगकर्ता का पूरा सूडो ऐक्सेस होता है:
    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 डायरेक्ट्री में रखें और chown को "apigee:apigee" में डालें.

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

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

इंस्टॉलेशन में होने वाली गड़बड़ी को ठीक करना

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

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

इंटरनेट या गैर-इंटरनेट इंस्टॉलेशन

किसी नोड पर Edge इंस्टॉल करने के लिए, नोड के लिए Apigee रिपॉज़िटरी को ऐक्सेस करना ज़रूरी है:

  • बाहरी इंटरनेट कनेक्शन वाले नोड

    बाहरी इंटरनेट कनेक्शन वाले नोड, Edge आरपीएम और डिपेंडेंसी इंस्टॉल करने के लिए, Apigee डेटा स्टोर करने की जगह को ऐक्सेस करते हैं.

  • बाहरी इंटरनेट कनेक्शन के बिना नोड

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

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

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

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

आरपीएम इंस्टॉलेशन डिपेंडेंसी को ठीक करना

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

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

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

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

/opt/apigee

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

लॉग फ़ाइलें

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

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

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

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

कॉम्पोनेंट जगह

मैनेजमेंट सर्वर

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

राऊटर

 /opt/apigee/var/log/edge-router

Edge राऊटर को Nginx का इस्तेमाल करके लागू किया गया है. अतिरिक्त लॉग के लिए, यह देखें:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

मैसेज प्रोसेसर

 /opt/apigee/var/log/edge-message-processor

Apigee Qpid सर्वर

 /opt/apigee/var/log/edge-qpid-server
Apigee Postgres सर्वर /opt/apigee/var/log/edge-postgres-server
क्लासिक यूआई (नया Edge यूज़र इंटरफ़ेस नहीं है, जिसके कॉम्पोनेंट का नाम edge-management-ui है) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
कास्सांद्रा /opt/apigee/var/log/apigee-cassandra/system.log
क्यूपिड /opt/apigee/var/log/apigee-qpidd
PostgreSQL डेटाबेस /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

डेटा

कॉम्पोनेंट जगह
मैनेजमेंट सर्वर /opt/apigee/data/edge-management-server
राऊटर /opt/apigee/data/edge-router
मैसेज प्रोसेसर /opt/apigee/data/edge-message-processor
Apigee Qpid एजेंट /opt/apigee/data/edge-qpid-server
Apigee Postgres का एजेंट /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
कास्सांद्रा /opt/apigee/data/apigee-cassandra/data
क्यूपिड /opt/apigee/data/apigee-qpid/data
PostgreSQL डेटाबेस /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

इंस्टॉल करने पर सिस्टम की जांच करने की सुविधा चालू करें

Edge इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल, इन प्रॉपर्टी के साथ काम करती है:

ENABLE_SYSTEM_CHECK=y

अगर इस प्रॉपर्टी को "y" पर सेट किया जाता है, तो इंस्टॉलर यह जांच करता है कि सिस्टम, इंस्टॉल किए जा रहे कॉम्पोनेंट के लिए, सीपीयू और मेमोरी से जुड़ी ज़रूरी शर्तों को पूरा करता है या नहीं. जांच को बंद करने के लिए, डिफ़ॉल्ट वैल्यू "n" होती है.