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

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

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

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

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

7. मैनेजमेंट सर्वर नोड पर, apigee-setup यूटिलिटी का इस्तेमाल करके apigee-provision इंस्टॉल करें. यह यूटिलिटी, Edge के संगठन बनाने और उन्हें मैनेज करने के लिए इस्तेमाल की जाती है.

   ज़्यादा जानकारी के लिए, किसी संगठन को ऑनबोर्ड करना लेख पढ़ें.

8. इंस्टॉल पूरा होने के बाद, New Edge UI कॉम्पोनेंट को हर नोड पर रीस्टार्ट करें. जैसा कि यहां दिए गए उदाहरण में दिखाया गया है:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. New Edge UI के लिए पुष्टि करने की सुविधा और ज़रूरी सेटिंग कॉन्फ़िगर करें. इसके कॉम्पोनेंट के नाम edge-management-ui और edge-management-ui-static हैं.

   ज़्यादा जानकारी के लिए, New Edge UI को कॉन्फ़िगर करना लेख पढ़ें.

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

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 का पूरा ऐक्सेस देने के लिए, sudoers फ़ाइल में बदलाव करने के लिए "visudo" कमांड का इस्तेमाल करें इसके लिए, यह जोड़ें:

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.54.00.sh फ़ाइल डाउनलोड और रन करना:

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.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 के आरपीएम इंस्टॉल करने के लिए, 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-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

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

इंस्टॉल या अपग्रेड करने के बाद, New Edge UI कॉम्पोनेंट को हर उस नोड पर रीस्टार्ट करें जिस पर वह चल रहा है.

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

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

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

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

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

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

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