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

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

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

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

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

नीचे दिए गए निर्देशों या स्क्रिप्ट को चलाने के लिए, उपयोगकर्ता के पास रूट ऐक्सेस या फिर 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.
  • apigee-all कमांड, जैसे कि start, stop, restart, configure.

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

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

1. रूट की मदद से किए गए टास्क:
   1. bootstrap_4.53.00.sh फ़ाइल डाउनलोड करके चलाएं:

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.00.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. नोड पर Edge RPM इंस्टॉल करने के लिए, apigee-setup टूल का इस्तेमाल करें:

      /opt/apigee/apigee-service/bin/apigee-service compName install

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

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

Data

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

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

ENABLE_SYSTEM_CHECK=y

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