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

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. इंस्टॉल होने के बाद, Classic UI कॉम्पोनेंट को हर नोड पर फिर से चालू करें. यहां दिए गए उदाहरण में दिखाया गया है कि ऐसा कैसे किया जाता है:

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

इन निर्देशों या स्क्रिप्ट को चलाने के लिए, उपयोगकर्ता के पास रूट का ऐक्सेस होना चाहिए या उसके पास sudo का पूरा ऐक्सेस होना चाहिए:

• apigee-service यूटिलिटी:
  • apigee-service कमांड: install, uninstall, update.
  • apigee-all कमांड: install, uninstall, update.
• Edge कॉम्पोनेंट इंस्टॉल करने के लिए, setup.sh स्क्रिप्ट. हालांकि, अगर आपने ज़रूरी RPM इंस्टॉल करने के लिए पहले ही "apigee-service install" का इस्तेमाल कर लिया है, तो इसकी ज़रूरत नहीं है. इसके बाद, अगर ज़रूरत न हो, तो रूट या फ़ुल सूडो ऐक्सेस दें.)
• 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" उपयोगकर्ता के लिए, सूडो का पूरा ऐक्सेस देने के लिए, "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.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. नोड पर 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. रूट उपयोगकर्ता के नोड पर 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 UI कॉम्पोनेंट को हर उस नोड पर रीस्टार्ट करना न भूलें जिस पर यह चल रहा है.

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

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

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

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

• ऐसे नोड जिनमें बाहरी इंटरनेट कनेक्शन नहीं है

  जिन नोड में बाहरी इंटरनेट कनेक्शन नहीं होता वे 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 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

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

Data

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

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

ENABLE_SYSTEM_CHECK=y

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