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

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

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

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

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

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

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

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

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

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

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

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

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

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

  1. रूट के ज़रिए किए गए काम:
    1. bootstrap_4.52.01.sh फ़ाइल डाउनलोड करें और चलाएं:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
      sudo bash /tmp/bootstrap_4.52.01.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. जब रूट उपयोगकर्ता नोड पर एज आरपीएम इंस्टॉल कर देता है, तो जिस उपयोगकर्ता के पास पूरा सूडो ऐक्सेस होता है "पिजी" उपयोगकर्ता कॉन्फ़िगरेशन की प्रोसेस पूरी करता है:
    1. Edge का कॉन्फ़िगरेशन पूरा करने के लिए, setup.sh सुविधा का इस्तेमाल करें नोड पर मौजूद कॉम्पोनेंट. कमांड का टाइप, उन कॉम्पोनेंट पर निर्भर करता है जिन्हें आपने नोड पर इंस्टॉल किया जाएगा. पूरी सूची के लिए, यह देखें किसी नोड पर Edge कॉम्पोनेंट इंस्टॉल करें.

      उदाहरण के लिए, ZooKeeper और कैसंड्रा की इंस्टॉलेशन पूरी करने के लिए, निम्नलिखित का उपयोग करें आदेश:

      /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

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
क्यूपिड /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" है को बंद करने के लिए चेक करें.