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

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.00.sh फ़ाइल को /tmp/bootstrap_4.52.00.sh में डाउनलोड करें.
   • Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें.
   • Edge apigee-setup यूटिलिटी और डिपेंडेंसी इंस्टॉल करें.

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

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

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

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

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

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

      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
      sudo bash /tmp/bootstrap_4.52.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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 की इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में यह प्रॉपर्टी इस्तेमाल की जा सकती है:

ENABLE_SYSTEM_CHECK=y

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