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

आम तौर पर, 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.50.00.sh फ़ाइल को /tmp/bootstrap_4.50.00.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 for Private Cloud के डेवलपर और एडमिन के लिए बेहतर यूज़र इंटरफ़ेस है.

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

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

इंस्टॉल करने की अनुमति किसे है

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

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

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

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

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

  • apigee-service की सुविधा वाले कमांड, जिनमें ये शामिल हैं:
    • apigee-service कमांड, जैसे कि start, stop, restart, configure.
    • start, stop, restart, configure जैसे apigee-all निर्देश.

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

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

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

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

    2. किसी उपयोगकर्ता को "apigee" उपयोगकर्ता का पूरा sudo ऐक्सेस देने के लिए कॉन्फ़िगर करें. इसके बारे में ज़्यादा जानने के लिए, "apigee" उपयोगकर्ता का पूरा sudo ऐक्सेस रखने वाला उपयोगकर्ता बनाना लेख पढ़ें.
    3. apigee-setup यूटिलिटी इंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. नोड पर Edge RPM इंस्टॉल करने के लिए, 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 रिपॉज़िटरी का मिरर किया गया वर्शन ऐक्सेस कर सकते हैं जिसे आपने अंदरूनी तौर पर सेट अप किया है. इस रिपॉज़िटरी में सभी Edge RPM मौजूद होते हैं. हालांकि, आपको यह पक्का करना होगा कि आपके पास इंटरनल नेटवर्क पर मौजूद रिपॉज़िटरी से, सभी अन्य डिपेंडेंसी उपलब्ध हों.

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

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

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

RPM इंस्टॉलेशन की डिपेंडेंसी को हल करना

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

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

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

/opt/apigee

Private Cloud के लिए 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

एज राउटर को 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
Qpidd /opt/apigee/var/log/apigee-qpidd
PostgreSQL डेटाबेस /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

Data

कॉम्पोनेंट जगह
मैनेजमेंट सर्वर /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
Qpidd /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" होती है.